Ao trabalhar com a API Google Ads, há vários lugares em que os endereços de e-mail são usados para gerenciamento de contato e acesso. Os mais importantes são os seguintes:
- E-mail de contato da API Google Ads: é o e-mail listado como o contato na API Center da interface do Google Ads.
- E-mail da conta do console do Google Cloud: é o e-mail que tem acesso de administrador à conta do console do Google Cloud usada para seu aplicativo OAuth 2.0.
- E-mails da conta de administrador do Google Ads: são os e-mails que têm permissões de administrador nas contas de administrador do Google Ads que você acessa pela API Google Ads. Ao gerar um token de atualização para seu aplicativo, normalmente você autentica o aplicativo da API Google Ads com um desses e-mails.
Recomendamos o uso de pseudônimos de equipe compartilhados para que você não perca o acesso a essas contas quando os membros da equipe mudarem de equipe ou saírem da empresa. O restante deste guia explica cada um dos e-mails listados anteriormente e como você pode atualizá-los para usar um alias de equipe compartilhado em vez do endereço de e-mail de um usuário individual.
E-mail de contato da API Google Ads
O e-mail de contato da API Google Ads é um endereço de e-mail que você informa ao se inscrever na API. Garanta o acesso a esse alias e monitore os e-mails enviados para esse endereço regularmente. O Google usa esse endereço de e-mail para entrar em contato com sua equipe durante análises de API, solicitações de auditoria ou emergências de produção que exigem atenção imediata. Use um alias de equipe compartilhado como o e-mail de contato para garantir que toda a equipe receba essas notificações.
Siga estas etapas para atualizar o e-mail de contato da API:
Faça login na sua conta de administrador do Google Ads.
Clique em Administrador no canto inferior esquerdo da tela.
Em Configurações da conta de administrador, clique em API Center.
Em Detalhes do desenvolvedor, anote o e-mail de contato da API. Clique na seta para baixo e edite o e-mail. Clique em Salvar.
Conta do Console do Google Cloud
O projeto do Console de APIs do Google contém as credenciais OAuth do seu app e controla o acesso à API Google Ads. Para garantir o acesso a essa conta, torne um alias compartilhado o proprietário da conta.
Siga estas etapas para atualizar o proprietário do projeto do Console de APIs do Google:
- Faça login no Console de APIs do Google.
- Selecione seu projeto no menu suspenso no canto superior esquerdo da página.
- Acesse IAM e administrador > IAM no menu à esquerda.
- Clique no botão Conceder acesso.
- Insira o endereço de e-mail compartilhado na seção Adicionar participantes.
- Atribua a função Proprietário.
- Clique no botão Salvar. Consulte a documentação do Cloud para saber mais sobre como conceder e revogar o acesso.
conta de administrador do Google Ads
Um método comum de gerenciamento de 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 mais alta. Nesta configuração:
- O desenvolvedor emite um token de atualização usando as credenciais de um usuário que tem acesso à conta de administrador do Google Ads.
- O desenvolvedor define o cabeçalho
login_customer_idcomo o ID de cliente da conta de administrador do Google Ads e o cabeçalhocustomer_idcomo o ID de cliente da conta para a qual as chamadas de API são feitas.
Um possível risco dessa configuração é que, se o usuário autorizado perder o acesso à conta de administrador do Google Ads, o token de atualização não será mais válido e todas as chamadas da API vão falhar. Para evitar esse cenário, convide um alias de e-mail compartilhado para gerenciar essa conta de administrador do Google Ads com os níveis de acesso adequados. Use esse alias de e-mail compartilhado para emitir o token de atualização para fazer chamadas de API.