Os clientes OAuth do Google que solicitam determinados escopos OAuth confidenciais estão sujeitos à verificação do Google.
Se você não verificar o cliente OAuth do projeto de script, os usuários fora do seu domínio verão uma tela de app não verificado quando tentarem autorizar seu script. Um fluxo de autorização não verificado permite que esses usuários autorizem apps não verificados e os usem, mas somente depois de confirmar que entendem os riscos. O número total de usuários não verificados do app também é limitado.
Para mais informações, consulte os seguintes artigos:
- Apps não verificados
- Perguntas frequentes sobre a Verificação de aplicativos OAuth
- Serviços de API do Google: política de dados do usuário
Essa mudança se aplica aos clientes da Web OAuth do Google, incluindo os usados por todos os projetos do Apps Script. Ao verificar seu aplicativo com o Google, você pode remover a tela do aplicativo não verificado do fluxo de autorização e oferecer aos usuários a confiança de que o aplicativo não é malicioso.
Apps não verificados
Complementos, apps da Web e outras implantações (como apps que usam a API Apps Script) podem precisar de verificação.
Aplicabilidade
Se o app usar escopos OAuth confidenciais, talvez a tela do app não verificado apareça como parte do fluxo de autorização. A presença dele (e o fluxo de autorização de app não verificado resultante) depende da conta em que o app foi publicado e da conta que está tentando usá-lo. Por exemplo, apps publicados em uma organização específica do Google Workspace não resultam no fluxo de autorização de app não verificado para contas nesse domínio, mesmo que o app não tenha sido verificado.
A tabela a seguir ilustra quais situações resultam no fluxo de autorização não verificado do app:
| O cliente foi verificado | O editor é uma conta do Google Workspace do cliente A | O script está em um drive compartilhado do cliente A | O editor é uma conta do Gmail | |
|---|---|---|---|---|
| O usuário é uma conta do Google Workspace do cliente A | Fluxo de autenticação normal | Fluxo de autenticação normal | Fluxo de autenticação normal | Fluxo de autenticação não verificado |
| O usuário é uma conta do Google Workspace que não é do cliente A | Fluxo de autenticação normal | Fluxo de autenticação não verificado | Fluxo de autenticação não verificado | Fluxo de autenticação não verificado |
| O usuário é uma conta do Gmail1 | Fluxo de autenticação normal | Fluxo de autenticação não verificado | Fluxo de autenticação não verificado | Fluxo de autenticação não verificado |
1Uma conta do Gmail, incluindo a usada para publicar o app.
Limite de usuários
O número de usuários que podem autorizar um aplicativo por meio do fluxo não verificado é limitado para limitar possíveis abusos. Consulte Limites de usuários do aplicativo OAuth para mais detalhes.
Solicitando verificação
É possível solicitar uma verificação do cliente OAuth usado pelo seu app e o projeto do Cloud Platform (GCP) associado a ele. Depois que seu app for verificado, os usuários não vão mais ver a tela do app não verificado. Além disso, seu app não estará mais sujeito ao limite de usuários.
Requisitos
Para enviar seu cliente OAuth para verificação, é necessário atender aos seguintes requisitos:
Você precisa ter um site em um domínio. O site precisa hospedar páginas acessíveis publicamente que descrevam seu app e a Política de Privacidade dele. Também é necessário verificar sua propriedade do site com o Google.
O projeto do Google Cloud usado pelo projeto de script precisa ser um projeto padrão do Google Cloud a que você tem acesso para editar. Se o script estiver usando o projeto padrão do Google Cloud, mude para um projeto padrão do Google Cloud.
Além disso, você precisa ter os seguintes recursos obrigatórios:
- Nome do aplicativo. Nome do aplicativo. Ele é exibido na tela de consentimento. Ele precisa corresponder ao nome usado para o app em outros locais, como a listagem do Google Workspace Marketplace para apps publicados.
- Logotipo do aplicativo. Uma imagem JPEG, PNG ou BMP do logotipo do app para usar na tela de consentimento. O arquivo precisa ter até 1 MB.
- E-mail de suporte. Esse é um e-mail exibido na tela de consentimento para os usuários entrarem em contato se precisarem de suporte do app. Pode ser seu endereço de e-mail ou um Grupo do Google que você possui ou gerencia.
- Escopos. A lista de todos os escopos usados pelo app. É possível ver seus escopos no editor do Apps Script.
- Domínios autorizados. Esta é uma lista de domínios que contêm informações sobre seu app. Todos os links do app (como a página da Política de Privacidade necessária) precisam estar hospedados em domínios autorizados.
- URL da página inicial do aplicativo. É o local de uma página inicial que descreve seu app. Esse local precisa estar hospedado em um domínio autorizado.
- URL da Política de Privacidade do aplicativo. É o local de uma página que descreve a Política de Privacidade do seu app. Esse local precisa estar hospedado em um domínio autorizado.
Além dos recursos obrigatórios acima, você tem a opção de fornecer um URL dos Termos de Serviço do aplicativo que direcione para uma página que descreva os termos de serviço do seu app. Se informado, esse local precisa estar em um domínio autorizado.
Passos
- Caso ainda não tenha feito isso, verifique a propriedade de todos os domínios autorizados que você usa para hospedar a política de privacidade do seu projeto de script e outras informações. Os proprietários verificados dos domínios precisam ser editores ou proprietários do projeto de script.
- No projeto do Apps Script, clique em Visão geral . Em Escopos do OAuth do projeto, copie os escopos usados pelo projeto de script.
Preencha a tela de permissão OAuth para o projeto do Google Cloud do seu aplicativo usando os recursos de texto e URL coletados.
- Liste os domínios autorizados em que as informações do app (como a Política de Privacidade) estão hospedadas.
Para adicionar os escopos do seu aplicativo, clique em Adicionar ou remover escopos. A caixa de diálogo resultante tenta detectar automaticamente escopos das APIs ativadas no console do Google Cloud (como serviços avançados). É possível selecionar escopos nesta lista marcando as caixas correspondentes.
Essa lista detectada automaticamente nem sempre inclui escopos usados pelos serviços integrados do Apps Script. Insira esses escopos em Adicionar escopos manualmente.
Quando terminar, clique em Atualizar.
Depois de inserir todas as informações necessárias, clique em Salvar.
Clique em Enviar para verificação para iniciar um pedido de verificação.
A maioria das solicitações de verificação recebe uma resposta dentro de 24 a 72 horas. Veja o Status da verificação na parte de cima do formulário da tela de consentimento do OAuth. Quando a verificação do cliente OAuth for confirmada, o app também será verificado.