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 usuários 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, é possível escolher 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.
Criar itens de credenciais de desenvolvedor
Como desenvolvedor com uma conta organizacional, crie um item de credenciais de desenvolvedor para gerar um ID de 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.
Você também pode criar credenciais de desenvolvedor para autenticação de aplicativos e para gerar chaves de API.
O tipo de credenciais de desenvolvedor que você cria depende dos seus privilégios na organização. Se você for membro do papel de administrador padrão ou membro de um papel personalizado com o privilégio para gerar chaves de API, você pode usar uma credencial OAuth 2.0 ou uma chave de API. Caso contrário, você só poderá usar credenciais de desenvolvedor OAuth 2.0.
Após criar as credenciais de desenvolvedor, clique em Visualizar uso na guia Configurações da página do aplicativo para acessar informações sobre quem efetuou o login no aplicativo e a quantidade de créditos que consumiram. Você também pode gerenciar as configurações das credenciais incorporadas ao aplicativo.
Anotação:
A seção Visualizar uso não está disponível quando conectado por meio de uma assinatura do ArcGIS Location Platform.
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.
Criar credenciais OAuth 2.0 para autenticação de usuários
Siga as etapas abaixo se o seu aplicativo exigir que os usuários efetuem o login com uma conta do ArcGIS Online.
- 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.
A primeira janela apresentada será diferente dependendo dos seus privilégios na organização. Se você for membro de um papel que não inclua o privilégio para criar chaves API, vá para a etapa 5. Se o seu papel incluir privilégios para criar chaves API, vá para a etapa 4.
- Escolha a opção Credenciais OAuth 2.0—Para autenticação de usuário 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
- Na caixa URL, digite uma URL para seu aplicativo no formato https://<myServer>/myWebMapApp.
- 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 usuários 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, é possível escolher 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.
O resumo das credenciais é exibido.
- Revise o resumo de credencial. Para alterar as configurações, clique em Voltar para fazer alterações antes de criar o item.
- 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. 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.
Criar credenciais OAuth 2.0 para autenticação de aplicativos
Siga as etapas abaixo se seu aplicativo público não exigir que os usuários efetuem o login e gerem tokens de acesso no servidor.
- 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.
A primeira janela apresentada será diferente dependendo dos seus privilégios na organização. Se você for membro de um papel que não inclua o privilégio para criar chaves API, vá para a etapa 5. Se o seu papel incluir privilégios para criar chaves API, vá para a etapa 4.
- Escolha a opção Credenciais OAuth 2.0—Para autenticação de aplicativo e clique em Avançar.
- Em Onde você usará essas credenciais, escolha uma das seguintes opções:
- Aplicativo privado com privilégios e acesso selecionados—Selecione esta opção para conceder acesso a qualquer conjunto de seus itens e privilégios. Você pode incorporar isso em um aplicativo privado ou em um componente do lado do servidor usado por um aplicativo público.
- Aplicativo privado que se faz passar por você—Selecione esta opção para conceder todos os seus privilégios atuais, juntamente com o seu acesso ao conteúdo, aos membros e às configurações da organização.
- Clique em Avançar.
- Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha uma das seguintes opções:
- Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
- Conceder acesso ao item usando privilégios—São necessárias algumas permissões para permitir o acesso a itens com esta credencial. Clique em Avançar.
- Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens que possui e aos quais deseja conceder acesso. Clique em Avançar.
- Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha quais ações as credenciais permitirão que o aplicativo execute, atribuindo privilégios. 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 você tem 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 Avançar.
- 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.
- 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 usuários 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, é possível escolher 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.
O resumo das credenciais é exibido.
- Revise o resumo de credencial. Para alterar as configurações, clique em Voltar para fazer alterações antes de criar o item.
- Se você selecionou Aplicativo privado que se faz passar por você, clique na caixa ao lado de Eu reconheço e aceito os requisitos de segurança associados aos privilégios selecionados.
- Clique em Criar.
O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um distintivo indicando que as credenciais OAuth 2.0 aparecem quando o item é visualizado na página de conteúdo ou nos painéis de pré-visualização do item. Na guia Visão geral da página do item, o distintivo Credenciais OAuth 2.0 - Representa o proprietário do item aparece se você escolherAplicativo privado que se faz passar por você em Onde você usará essas credenciais.
Criar credenciais da chave API
Siga as etapas abaixo para criar as credenciais da chave API.
- 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.
- Em Onde você usará essas credenciais, escolha uma das seguintes opções:
- Aplicativo público—Selecione esta opção para conceder acesso a itens específicos e privilégios de serviço.
- Aplicativo privado com privilégios e acesso selecionados—Selecione esta opção para conceder acesso a qualquer conjunto de seus itens e privilégios. Você pode incorporar isso em um aplicativo privado ou em um componente do lado do servidor usado por um aplicativo público.
- Aplicativo privado que se faz passar por você—Selecione esta opção para conceder todos os seus privilégios atuais, juntamente com o seu acesso ao conteúdo, aos membros e às configurações da organização.
- Clique em Avançar.
- Opcionalmente, se você selecionou Aplicativo público, escolha uma das seguintes opções:
- Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
- Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens que possui e, em seguida, clicar em Avançar.
- Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha uma das seguintes opções:
- Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
- Conceder acesso ao item usando privilégios—São necessárias algumas permissões para permitir o acesso a itens com esta credencial. Clique em Avançar.
- Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens que possui e, em seguida, clicar em Avançar.
- Opcionalmente, se você selecionou Aplicativo público ou Aplicativo privado com os privilégios e o acesso selecionados, escolha quais ações as credenciais permitirão que o aplicativo execute, atribuindo privilégios. 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.
- Opcionalmente, se você selecionou Aplicativo privado que se passa por você, use o calendário para especificar uma data de expiração para as credenciais.
As credenciais podem expirar no dia seguinte (mínimo) ou 365 dias depois (máximo). Elas expiram às 23h59 do dia 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 se 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.
- 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 usuários 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, é possível escolher 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.
O resumo das credenciais é exibido.
- Revise o resumo de credencial. Para alterar as configurações, clique em Voltar para fazer alterações antes de criar o item.
- Se você selecionou Aplicativo privado que se faz passar por você, clique na caixa ao lado de Eu reconheço e aceito os requisitos de segurança associados aos privilégios selecionados.
- 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. 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.