Antes de lançar um aplicativo que solicita credenciais de usuário para a API Data Manager a usuários externos, seu projeto na nuvem do Google Cloud precisa passar pela verificação de apps do Google OAuth.
Este guia aborda as transições recomendadas de configuração de Público-alvo durante o desenvolvimento e as etapas para concluir a verificação de apps do Google OAuth.
Fases do público-alvo do app
Dependendo do estágio de desenvolvimento, configure a página Público no console do Google Cloud com diferentes configurações de Tipo de usuário e Status de publicação. Siga estas fases para uma transição tranquila do teste inicial para o lançamento de produção.
Fase 1: desenvolvimento inicial (teste)
Ao iniciar o desenvolvimento e testar solicitações básicas de API:
Status de publicação: definido como Teste.
Tipo de usuário:
Se o projeto na nuvem do Google Cloud pertencer a uma organização do Google Workspace e apenas os usuários da sua organização usarem o app, selecione Interno.
Caso contrário, selecione Externo.
Usuários de teste: se você definir o Tipo de usuário como Externo, clique em Adicionar usuários para adicionar manualmente as Contas do Google que você usa para gerar credenciais. Somente as Contas do Google listadas podem autorizar o app, e os limites de teste e as regras de validade do token são aplicáveis.
A verificação não é necessária durante os testes. Se você usar Externo, os usuários de teste vão ver uma tela de aviso confirmando que têm acesso de teste a um app não verificado antes de prosseguir para a tela de permissão.
Fase 2: próximo ao lançamento (envio para verificação)
Quando a integração estiver concluída, a interface do usuário estiver criada e você planejar o lançamento para o próximo mês:
Atualize as configurações da página "Público-alvo":
Status de publicação: mude para Em produção.
Tipo de usuário: defina como Externo se o app atender a clientes fora da sua organização, como clientes anunciantes.
Envie o app para verificação. O processo de verificação do app OAuth do Google pode levar várias semanas. Por isso, envie o quanto antes, assim que a interface estiver pronta.
Requisitos de verificação de apps
Para enviar seu app para verificação na Central de verificação, defina as configurações da Plataforma de autenticação do Google e prepare os materiais de verificação necessários.
Branding e Política de Privacidade
Na página Branding no console do Google Cloud, verifique os seguintes detalhes antes de enviar:
Página inicial do aplicativo: sua página inicial precisa ser acessível ao público e incluir um link visível para a Política de Privacidade do aplicativo.
Link da Política de Privacidade: o URL da Política de Privacidade configurado na página de branding precisa corresponder ao URL da Política de Privacidade vinculado à página inicial do aplicativo.
Escopos de verificação
Na página Acesso a dados, solicite apenas os escopos necessários para o aplicativo. A API Data Manager usa escopos sensíveis:
https://www.googleapis.com/auth/datamanager(escopo principal)https://www.googleapis.com/auth/datamanager.partnerlink(para links de parceiros)
No envio da verificação, forneça uma explicação detalhada por escrito sobre o motivo pelo qual o aplicativo precisa de acesso aos escopos solicitados.
Dados de contato
A equipe de verificação do OAuth do Google envia todas as comunicações para os proprietários e editores configurados no seu projeto do Google Cloud. Mantenha esses detalhes de contato atualizados no console do Google Cloud para não perder solicitações de informações.
Se a equipe de verificação enviar perguntas de acompanhamento ou solicitar atualizações (como mudanças no vídeo de demonstração ou nas configurações da tela de permissão), a análise será pausada até que você responda. Se o envio estiver pendente há mais de algumas semanas sem atualização, verifique as caixas de entrada de e-mail (incluindo as pastas de spam e lixo eletrônico) de todos os proprietários do projeto e editores do projeto.
Vídeo de demonstração
Forneça um link para um vídeo de demonstração acessível ao público (como um vídeo não listado do YouTube ou um link público do Google Drive) mostrando como seu aplicativo usa os escopos solicitados.
Verifique se o vídeo atende a todos os requisitos de vídeo de demonstração da funcionalidade do app, incluindo estas verificações da API Data Manager:
Jornada do usuário completa e permissão de acesso OAuth: mostre a jornada completa do usuário no seu aplicativo, desde o início do login ou da autorização até a conclusão do fluxo de permissão de acesso OAuth.
Identidade do app correspondente: verifique se o nome, o logotipo e a marca do aplicativo mostrados no vídeo correspondem à configuração da página de branding no console do Google Cloud.
Tela de permissão OAuth completa em inglês: mostre toda a tela de permissão OAuth com o seletor de idioma no canto inferior esquerdo definido como Inglês e verifique se a tela mostra os escopos exatos da API Data Manager que seu app solicita.
Uso do escopo na interface do app: demonstre os recursos do app que usam os escopos solicitados (por exemplo, criar um link de parceiro, criar uma lista de público-alvo ou configurar a ingestão de dados na interface do aplicativo).
Fase 3: pronto para lançamento (verificado)
Depois que a equipe de verificação do OAuth do Google notificar você de que aprovou seu pedido de verificação de apps, nenhuma ação será necessária. Seu app foi verificado, e os usuários externos podem autorizá-lo sem que a tela de aviso de app não verificado apareça.