A adição de uma referência de URL para um aplicativo existente é um caminho efetivo para compartilhar seu trabalho com membros da sua organização e o público (dependendo dos seus privilégios de compartilhamento). Além da URL, você pode compartilhar outros detalhes como o tipo de aplicativo, sua finalidade, resumo e descrição, e um arquivo .zip com o código usado para criar o aplicativo. Adicionar um aplicativo no ArcGIS Online apenas adiciona uma referência à URL do aplicativo; o ArcGIS Online não armazena os arquivos do aplicativo.
Como um desenvolvedor de aplicativo com uma conta organizacional, você também pode registrar aplicativos com a plataforma. Isso envolve o registro de um aplicativo OAuth para que membros da organização e usuários fora da organização possam entrar no aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.
Caso não seja necessário registrar seu aplicativo—por exemplo, ao carregar uma amostra de código—siga as etapas na seção Adicionar um aplicativo a partir de uma URL abaixo.
Dica:
Outra maneira de compartilhar aplicativos com membros da sua organização e o público é criar aplicativos com mapas e aplicativos de galeria com grupos.
Adicionar um aplicativo a partir de uma URL
Siga estas etapas para adicionar um item que usa uma URL para acessar um aplicativo na web, mas não precisa ser registrado (por exemplo, amostras de código):
Anotação:
Para adicionar um aplicativo registrado, siga as etapas para adicionar e registrar um aplicativo usando credenciais de desenvolvedor.
- Verifique se você está registrado e tem privilégios para criar conteúdo.
- Na guia Meu conteúdo da página de conteúdo, clique e Novo item e clique em Aplicativo.
- Escolha o tipo de aplicativo:
- Mapeamento da web—Um aplicativo da web construído com uma API da web como JavaScript.
- Desktop—Um aplicativo para desktops, construído em uma plataforma de desktop como Java ou .NET (Microsoft WindowsDesktop).
- Móvel—Um aplicativo que pode ser baixado, construído para dispositivos móveis com um SDK como iOS ou Android.
- Outra aplicação—Um aplicativo de desktop, script Python ou qualquer tipo de aplicativo genérico para o qual você não tenha detalhes sobre a finalidade, API, SDK ou endereço URL do aplicativo.
- Para mapeamento móvel, desktop ou da web, digite a URL do aplicativo, por exemplo,https://<myServer>/myWebMapApp.
- Para aplicativos de desktop, clique em Procurar e escolha o arquivo .zip que contém o aplicativo.
- Clique em Avançar.
- Digite um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
- Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar as pessoas a encontrar o item.
Você também pode começar digitando um nome de categoria para restringir a lista de categorias.
- Opcionalmente, digite as tags que descrevem o item.
Separe os termos com vírgulas (por exemplo, Território federal são considerados uma tag; Federal, território são considerados duas tags).
Enquanto você digitar, será possível selecionar quaisquer tags sugeridas que apareçam; as sugestões são geradas a partir de tags que você adicionou anteriormente.
- Opcionalmente, adicione um resumo que descreva o aplicativo.
- Clique em Salvar.
Após adicionar o aplicativo, ele aparecerá em seu conteúdo. Se você precisar registrá-lo posteriormente, poderá fazer na guia Configurações da página de item do aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.
Você pode configurar os detalhes do item, anexar código, se necessário, e compartilhar o aplicativo se você tiver privilégios de compartilhamento.
Adicione e registre um aplicativo usando credenciais de desenvolvedor
Como um desenvolvedor com uma conta organizacional, você pode adicionar e registrar seu aplicativo com a plataforma para gerar um ID do Aplicativo. Utilize o ID do aplicativo no aplicativo para coletar as estatísticas de uso e permitir aos usuários entrar na plataforma com OAuth 2.0, uma estrutura de trabalho de autorização padronizada. Com o OAuth 2.0, os aplicativos guiam o usuário para entrar na plataforma através de uma página de registro da plataforma hospedada. Também permite ao aplicativo trabalhar com conteúdo de usuário associado com sua organização, como também, trabalhar com outros recursos do ArcGIS Online tais como, geocodificação, rota e GeoEnriquecimento. Para mais informações sobre autenticação e OAuth 2.0, consulte Esri Developer.
O tipo de credenciais de desenvolvedor que você pode incluir no aplicativo depende de seus privilégios na organização. Se você for membro da papel de administrador padrão ou membro de um papel personalizado com privilégio para gerar chaves API, poderá usar um OAuth 2.0 ou uma credencial de chave API em seu aplicativo. Caso contrário, você poderá usar apenas credenciais de desenvolvedor do OAuth 2.0 em um aplicativo.
Anotação:
O padrão de implementação para logins de usuário difere um pouco, dependendo se você está desenvolvendo um aplicativo baseado na web ou um aplicativo nativo.A documentação do Esri Developer inclui detalhes e amostras de código para aplicativos baseados na web e aplicativos nativos.
Adicionar e registrar um aplicativo com credenciais OAuth 2.0 incorporadas
Quando você usa credenciais do OAuth 2.0 com os aplicativos criados, o token de acesso é gerado dinamicamente quando o aplicativo é acessado. O token de acesso é válido por no máximo 14 dias.
Siga as etapas abaixo se o seu papel não incluir o privilégio para criar chaves API.
- Verifique se você está conectado com uma conta organizacional que tenha privilégios para criar conteúdo.
- Clique na guia Meu Conteúdo da página de conteúdo, e clique em Novo item.
- Na janela Novo item, clique em Credenciais do desenvolvedor.
- Escolha a opção Credenciais OAuth 2.0 e clique em Avançar.
- Em URLs de Redirecionamento, forneça a URL para uma página da web ou parâmetro do servidor que será usado para redirecionar os usuários após o registro bem-sucedido. Clique em Adicionar para adicionar mais URLs de redirecionamento conforme necessário.
As URLs de redirecionamento especificadas durante a autorização devem corresponder a uma das URLs registradas, caso contrário, a autorização será rejeitada.
Um valor especial de urn:ietf:wg:oauth:2.0:oob também pode ser especificado para concessões de autorização. Isso resulta na entrega do código de autorização a uma, URL do portal (/oauth2/approval). Esse valor normalmente é usado por aplicativos que não têm um servidor da web ou um esquema de URL personalizado onde o código pode ser entregue.
Veja a seguir exemplos de formatos de URL de redirecionamento suportados:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- Em URLs de Referência, forneça uma URL ou endereço IP com permissão para conexão. Clique em Adicionar para adicionar mais URLs de referência ou endereços IP conforme necessário.
- Em Ambiente do aplicativo, escolha um ambiente do aplicativo para o aplicativo—Múltiplo, Nativo, Navegador ou Servidor.
- Na caixa URL, digite uma URL para seu aplicativo no formato https://<myServer>/myWebMapApp.
- Clique em Avançar.
Se você for membro de um papel com privilégio para atribuir privilégios a aplicativos OAuth 2.0, clicar em Avançar levará a uma janela onde você poderá definir o que o aplicativo tem permissão para fazer. Se você não tiver esse privilégio, vá para a etapa 12.
- Escolha quais ações as credenciais permitirão que o aplicativo execute atribuindo privilégios e clique em Avançar.
A lista de privilégios disponíveis varia dependendo se você possui uma assinatura do ArcGIS Location Platform e quais privilégios possui na organização. Você não pode conceder privilégios que sua conta não tem.
- Clique em Procurar itens e escolha quais itens as credenciais incorporadas podem ser usadas para acessar e clique em Adicionar itens.
Como alternativa, você pode clicar em Ignorar. Se você ignorar a especificação de quais itens os usuários da credencial OAuth 2.0 têm acesso, as credenciais poderão ser usadas para acessar todos os itens de sua propriedade.
- Digite um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
- Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar as pessoas a encontrar o item.
Você também pode começar digitando um nome de categoria para restringir a lista de categorias.
- Opcionalmente, digite as tags que descrevem o item.
Separe os termos com vírgulas (por exemplo, Território federal são considerados uma tag; Federal, território são considerados duas tags).
Enquanto você digitar, será possível selecionar quaisquer tags sugeridas que apareçam; as sugestões são geradas a partir de tags que você adicionou anteriormente.
- Opcionalmente, adicione um resumo que descreva o aplicativo.
- Clique em Avançar.
- Revise o resumo de credencial. Para alterar as configurações, clique em Voltar para fazer alterações antes de criar o item. Se as configurações de credencial estiverem corretas, clique em Criar.
O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um selo de 
indicando que as credenciais OAuth 2.0 são usadas com o aplicativo aparece na página do item e quando o item é visualizado na página de conteúdo ou nos painéis de visualização do item.
Você pode configurar detalhes do item para o aplicativo.
Na guia Configurações da página de item do aplicativo, você pode visualizar as informações de registro, que incluem o ID do aplicativo (ID do Cliente), um segredo do aplicativo (Segredo do Cliente) e os ambientes do aplicativo. Você pode atualizar a URL da fonte de dados ou URLs de redirecionamento, redefinir o segredo, cancelar o registro do aplicativo ou, copiar ou renovar o token temporário do aplicativo. Você também pode alterar os privilégios do aplicativo e alterar quais camadas o aplicativo pode acessar.
Anotação:
A redefinição de segredo do aplicativo invalida todos os tokens de usuário e aplicativo existentes emitidos para o aplicativo. Os usuários devem entrar no aplicativo novamente e os aplicativos configurados com o segredo podem precisar ser atualizados.
Clique em Visualizar uso na guia Configurações para acessar informações sobre quem entrou no aplicativo e o número de créditos consumidos.
Adicionar e registrar um aplicativo com credenciais de chave API incorporadas
Use credenciais de chave API caso necessário incorporar as credenciais no aplicativo e precisar que a chave seja válida por mais de 14 dias.
Siga as etapas abaixo para adicionar um aplicativo e criar uma chave API incorporada a ele para usar para fins de autenticação.
- Verifique se você está registrado com uma conta organizacional e tem privilégios para criar conteúdo e criar chaves API.
- Clique na guia Meu Conteúdo da página de conteúdo, e clique em Novo item.
- Na janela Novo item, clique em Credenciais do desenvolvedor.
- Escolha a opção Credenciais de chave API e clique em Avançar.
- Use o calendário para especificar uma data de vencimento para as credenciais.
As credenciais podem expirar no dia seguinte (mínimo) ou 365 dias depois (máximo). Elas expiram às 23h59 na data que você escolher para vencimento. A hora é armazenada com base na hora do seu navegador quando você adiciona o aplicativo e gera as credenciais.
- Em URLs de Referência, forneça a URL ou endereço IP que tenha permissão para se conectar ao aplicativo. Clique em Adicionar para adicionar mais URLs de referência ou endereços IP necessários.
As URLs de redirecionamento especificadas durante a autorização devem corresponder a uma das URLs registradas, caso contrário, a autorização será rejeitada.
- Clique em Avançar.
- Escolha quais ações as credenciais permitirão que o aplicativo execute atribuindo privilégios e clique em Avançar.
A lista de privilégios disponíveis varia dependendo se você possui uma assinatura do ArcGIS Location Platform e quais privilégios possui na organização. Você não pode conceder privilégios que sua conta não tem.
- Clique em Procurar itens, escolha quais itens as credenciais incorporadas podem ser usadas para acessar e clique em Adicionar itens.
Como alternativa, você pode clicar em Ignorar. Se você ignorar a especificação de quais itens os usuários da chave API têm acesso, as credenciais poderão ser usadas para acessar todos os itens de sua propriedade.
- Digite um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
- Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar as pessoas a encontrar o item.
Você também pode começar digitando um nome de categoria para restringir a lista de categorias.
- Opcionalmente, digite as tags que descrevem o item.
Separe os termos com vírgulas (por exemplo, Território federal são considerados uma tag; Federal, território são considerados duas tags).
Enquanto você digitar, será possível selecionar quaisquer tags sugeridas que apareçam; as sugestões são geradas a partir de tags que você adicionou anteriormente.
- Opcionalmente, adicione um resumo que descreva o aplicativo.
- Clique em Avançar.
- Revise o resumo de credencial. Para alterar as configurações, clique em Voltar para fazer alterações antes de criar o item. Se as configurações de credencial estiverem corretas, clique em Criar.
O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um selo de 
indicando que uma chave API está incorporada ao aplicativo aparece na página do item e quando o item é visualizado na página de conteúdo ou nos painéis de visualização do item.
Você pode configurar detalhes do item para o aplicativo.
Na guia Configurações da página de item do aplicativo, você pode visualizar as informações de registro, que incluem o ID do aplicativo (ID do Cliente), um segredo do aplicativo (Segredo do Cliente) e os ambientes do aplicativo. Você pode atualizar a URLs de redirecionamento, redefinir o segredo, cancelar o registro do aplicativo ou, copiar ou renovar o token temporário do aplicativo. Você também pode alterar os privilégios do aplicativo e alterar quais camadas o aplicativo pode acessar.
Anotação:
A redefinição de segredo do cliente invalida todos os tokens de usuário e aplicativo existentes emitidos para o aplicativo. Os usuários devem entrar no aplicativo novamente e os aplicativos configurados com o segredo podem precisar ser atualizados.
Clique em Visualizar uso na guia Configurações para acessar informações sobre quem entrou no aplicativo e o número de créditos consumidos.