Aliases compartilhados

Ao trabalhar com a Google Ads API, há vários locais em que os endereços de e-mail são usados para o gerenciamento de contatos e acesso. Os mais importantes são os seguintes:

• E-mail de contato da API Google Ads: é o e-mail listado como contato na Central de API da interface do Google Ads.
• E-mail da conta do Console do Google Cloud: esse é o e-mail que tem acesso de administrador à conta do Console do Google Cloud usada para o 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 com a API Google Ads. Quando você gera um token de atualização para seu aplicativo, normalmente você autentica o aplicativo da Google Ads API com um desses e-mails.

Recomendamos o uso de aliases de equipe compartilhados para não perder o acesso a essas contas quando membros individuais da equipe trocarem de equipe ou saírem da empresa. O restante deste guia detalha cada um dos e-mails listados anteriormente e como você pode atualizá-lo 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 é o endereço de e-mail fornecido quando você se inscreve nessa 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 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 conta de administrador do Google Ads que você usou na solicitação de acesso à API Google Ads. Essa é a mesma conta em que seu token de desenvolvedor está localizado.
• Acesse Ferramentas e configurações > Central de API.
• Clique na seta abaixo da seção E-mail de contato da API.
• Atualize o endereço de e-mail e clique no botão Salvar.

Conta do console do Google Cloud

O projeto do Console de APIs do Google contém as credenciais do OAuth do seu aplicativo e controla o acesso à API Google Ads. Para garantir o acesso a essa conta, defina um alias compartilhado como proprietário.

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.
• Navegue até IAM e administrador > IAM no menu à esquerda.
• Clique no botão Permitir acesso.
• Insira o endereço de e-mail compartilhado na seção Adicionar participantes.
• Atribua o papel Proprietário.
• Clique no botão Save. 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 gerenciamento de contas usando a API Google Ads é vincular todas as suas contas em uma conta de administrador comum e fazer chamadas de API a todas elas 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 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 de API falharão. 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 apropriados. Use esse alias de e-mail compartilhado para emitir o token de atualização para fazer chamadas de API.