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á conectado e tem o privilégio de criar, atualizar e excluir 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.
- Forneça um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
Alternativamente, você pode optar por Criar nova pasta no menu e digite um nome de pasta para salvar o item em uma nova pasta.
Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.
- 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, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).
Conforme você digita, você pode selecionar qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das 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.
Adicionar e registrar 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 GeoEnrichment. Para mais informações sobre autenticação e OAuth 2.0, consulte Esri Developer.
Alternativamente, você pode incorporar uma chave API no aplicativo ao registrá-lo.
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 o privilégio de criar, atualizar e excluir 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.
Para obter informações sobre os tipos de privilégios, consulte o Guia de segurança e autenticação na ajuda de desenvolvedor da Esri.
- 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.
- Forneça um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
Alternativamente, você pode optar por Criar nova pasta no menu e digite um nome de pasta para salvar o item em uma nova pasta.
Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.
- 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, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).
Conforme você digita, você pode selecionar qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das 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 você concedeu privilégios pessoais para as credenciais, marque a caixa ao lado do aviso de segurança para confirmar que você leu e concorda com ele e clique em Criar para criar as credenciais.
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. Na guia Visão Geral da página do item, o emblema indica se privilégios pessoais estão incluídos ou se apenas privilégios padrão estão incluídos nas credenciais.
Você pode configurar detalhes do item para o aplicativo.
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.
Anotação:
A seção Visualizar uso não está disponível quando conectado por meio de uma assinatura do ArcGIS Location Platform.
Você também pode gerenciar as configurações das credenciais incorporadas ao aplicativo.
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á conectado com uma conta organizacional e tem privilégios para criar chaves API e criar, atualizar e excluir 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 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 especificadas durante a autorização devem corresponder a uma das URLs registradas, caso contrário, a autorização será rejeitada.
A seguir estão exemplos de formatos de URL de referência suportados:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- 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.
Para obter informações sobre os tipos de privilégios, consulte o Guia de segurança e autenticação na ajuda de desenvolvedor da Esri.
- 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.
- Forneça um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
Alternativamente, você pode optar por Criar nova pasta no menu e digite um nome de pasta para salvar o item em uma nova pasta.
Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.
- 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, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).
Conforme você digita, você pode selecionar qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das 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 você concedeu privilégios pessoais para as credenciais, marque a caixa ao lado do aviso de segurança para confirmar que você leu e concorda com ele e clique em Avançar.
- Escolha se deseja gerar a chave API imediatamente ou mais tarde e clique em Avançar.
Você deve copiar a chave API assim que ela for gerada.
- Se você clicar em Gerar a chave API e seguir para a página de detalhes do item. Estou pronto para copiar e salvar a chave. Opção, o pop-up Gerar chave API aparece quando você clica em Avançar. Clique no botão Copiar para copiar a chave. Cole a chave em um documento seguro. Feche o pop-up quando terminar.
- Se você clicar em Ir para a página de detalhes do item. Gerarei a chave API mais tarde. Opção, a página do item de credenciais aparece. A página do item aparece quando você clica em Avançar. Você pode gerar a chave API na guia Configurações da página do item.
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. Na guia Visão Geral da página do item, o emblema indica se privilégios pessoais estão incluídos ou se apenas privilégios padrão estão incluídos nas credenciais.
Você pode configurar detalhes do item para o aplicativo.
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.
Anotação:
A seção Visualizar uso não está disponível quando conectado por meio de uma assinatura do ArcGIS Location Platform.
Você também pode gerenciar as configurações das credenciais incorporadas ao aplicativo.