Aliases compartilhados

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 acesso e contato. Os mais importantes são:

• E-mail de contato da API Google Ads: é o e-mail listado como contato na Central de APIs 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 a que você acessa pela API Google Ads. Ao gerar um token de atualização para seu aplicativo, geralmente você autentica o aplicativo da API Google Ads com um desses e-mails.

Recomendamos usar aliases de equipe compartilhados para não perder o acesso a essas contas quando membros individuais mudarem de equipe ou saírem da empresa. O restante deste guia explica cada um dos e-mails listados anteriormente e como 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 Google Ads. Verifique se você tem acesso a esse alias e monitore regularmente os e-mails enviados para esse endereço. 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 compartilhada como 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:

1. Faça login na sua conta de administrador do Google Ads.

2. Clique em Administrador no canto inferior esquerdo da tela.

3. Em Configurações da conta de administrador, clique em Central de APIs.

4. 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 aplicativo e controla o acesso à API Google Ads. Para garantir o acesso, defina um alias compartilhado como 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 o projeto no menu suspenso no canto superior esquerdo da página.
• No menu à esquerda, acesse IAM e administrador > IAM.
• 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 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 principal. 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_id como o ID de cliente da conta de administrador do Google Ads e o cabeçalho customer_id como o ID de cliente da conta para a qual as chamadas de API são feitas.

Um risco potencial 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 de API vão falhar. Para evitar essa situação, 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 e fazer chamadas de API.