Ao trabalhar com a API Google Ads, os endereços de e-mail são usados em vários lugares para contato e gerenciamento de acesso. As mais importantes são:
- E-mail de contato da API Google Ads: os endereços de e-mail atribuídos ao papel de Proprietário ou Editor no seu projeto na nuvem do Google Cloud, que o Google usa para enviar avisos obrigatórios de serviço (MSAs, na sigla em inglês) e notificações administrativas.
- E-mail da conta do console do Google Cloud: o e-mail que tem acesso de administrador ao projeto na nuvem do Google Cloud usado para seu aplicativo OAuth 2.0.
- Acesso à conta de administrador do Google Ads: a conta de serviço (recomendado) ou o alias de e-mail compartilhado que tem permissões de acesso nas contas de administrador do Google Ads acessadas pela API Google Ads.
O restante deste guia detalha cada uma das contas listadas anteriormente e como configurá-las para que sua integração não dependa do endereço de e-mail de um usuário individual.
E-mail de contato da API Google Ads
O Google envia notificações administrativas, atualizações de revisão de API, solicitações de auditoria, avisos obrigatórios de serviço (MSAs, na sigla em inglês) e comunicações de emergência de produção para os endereços de e-mail associados aos papéis de Proprietário e Editor do seu projeto do Google Cloud. Consulte Novos e-mails de contato da API, já que a configuração de e-mail de contato da Central de APIs legada na interface do Google Ads foi desativada.
Para atualizar seu e-mail de contato e garantir que toda a equipe receba essas notificações, conceda o papel de Proprietário ou Editor a um alias de equipe compartilhado no projeto do Google Cloud e monitore regularmente os e-mails enviados para esse alias.
Conta do console do Google Cloud
O projeto do console do Google Cloud contém as credenciais OAuth do seu aplicativo e controla o acesso à API Google Ads. Para garantir o acesso a este projeto, conceda o papel de Proprietário (ou Editor) a um alias de equipe compartilhado.
Siga estas etapas para adicionar um alias compartilhado como proprietário do projeto do Google Cloud:
- Faça login no Console do Google Cloud.
- Selecione o projeto no seletor na parte de cima da página.
- No menu de navegação, acesse IAM e administrador > IAM.
- Clique em Permitir acesso.
- Na seção Adicionar principais, insira o endereço de e-mail compartilhado no campo Novos principais.
- Na seção Atribuir papéis, clique em Selecionar um papel e selecione Básico > Proprietário (ou Básico > Editor).
- Clique em Salvar. Se você concedeu o papel de Proprietário a um endereço de e-mail fora da sua organização do Google Cloud (ou em um projeto sem uma organização), o Google Cloud envia um e-mail de convite para o alias compartilhado, que precisa ser aceito antes que o papel entre em vigor. Consulte a documentação do Cloud para saber mais sobre como conceder e revogar acesso.
conta de administrador do Google Ads
Um método comum de gerenciar contas usando a API Google Ads é vincular todas as suas contas a uma conta de administrador comum e fazer chamadas de API para todas as contas usando as credenciais da conta de administrador de nível mais alto. Nessa configuração, o desenvolvedor define o cabeçalho da solicitação login-customer-id (ou a configuração login_customer_id da biblioteca de cliente) como o ID de cliente de 10 dígitos (sem hifens) da conta de administrador do Google Ads e define o customer_id de destino como a conta operacional em que as chamadas de API são feitas.
Recomendado: usar uma conta de serviço
Usar uma conta de serviço é a abordagem preferida para autenticar e acessar uma conta de administrador do Google Ads. Ao contrário das contas de usuário individuais, uma conta de serviço é gerenciada no projeto do Google Cloud e não está vinculada a uma pessoa específica, o que evita interrupções quando os membros da equipe mudam de função ou saem da empresa. Siga o guia da conta de serviço para criar uma conta de serviço e conceder a ela acesso à sua conta de administrador do Google Ads.
Alternativa: usar um alias de e-mail compartilhado
Se a integração não puder usar uma conta de serviço e depender do fluxo de trabalho de autenticação de usuário único, um usuário com acesso à conta de administrador do Google Ads vai emitir um token de atualização do OAuth 2.0.
Para evitar esse cenário ao usar credenciais de usuário:
- Convide um alias de e-mail compartilhado (com uma Conta do Google ativa com a verificação por chave de acesso ativada) para gerenciar essa conta de administrador do Google Ads com os níveis de acesso adequados.
- Aceite o convite usando o alias de e-mail compartilhado.
- Use esse alias de e-mail compartilhado para emitir o token de atualização do OAuth para fazer chamadas de API.