Aliases compartilhados

Ao trabalhar com a Google Ads API, há vários locais onde 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 o contato na Central de API da interface do Google Ads.
• E-mail da conta do Console do Google Cloud: é o e-mail com 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 com permissões de administrador nas contas de administrador do Google Ads que você acessa por meio da API Google Ads. Ao gerar um token de atualização para seu aplicativo, você geralmente autentica seu aplicativo da Google Ads API com um desses e-mails.

É altamente recomendável usar aliases de equipe compartilhados para não perder o acesso a essas contas quando membros individuais da equipe trocarem de equipe ou sairem da empresa. No restante deste guia, você vai conferir mais detalhes sobre 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 é aquele fornecido por você ao se inscrever nela. Você precisa garantir o acesso a esse alias e monitorar os e-mails enviados para ele regularmente. O Google usa esse endereço de e-mail para entrar em contato com sua equipe durante revisões 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 conta de administrador do Google Ads que você usou ao solicitar 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 na 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 de OAuth do seu aplicativo e controla o acesso à API Google Ads. Torne um alias compartilhado proprietário da conta para garantir o acesso.

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.
• Acesse IAM e administrador > IAM no menu à esquerda.
• Clique no botão Permitir acesso.
• Digite o endereço de e-mail compartilhado na seção Adicionar principais.
• Atribua o papel de 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 gerenciar contas usando a API Google Ads é vincular todas as contas em uma conta de administrador comum e fazer chamadas de API para 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 que recebe as chamadas de API.

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 falharão. 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 apropriados. Use esse alias de e-mail compartilhado para emitir o token de atualização e fazer chamadas de API.