Contas de serviço

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Neste guia, explicamos como acessar a API Google Ads com contas de serviço.

Uma conta de serviço é uma conta que pertence ao seu app, e não a um usuário final individual. As contas de serviço permitem interações entre servidores entre apps da Web e Serviços do Google. Seu app chama APIs do Google em nome da conta de serviço para que os usuários não sejam diretamente envolvidos.

As contas de serviço empregam um fluxo OAuth2 que não requer autorização humana, em vez disso, um arquivo de chave que só o app pode acessar.

O uso de contas de serviço oferece duas grandes vantagens:

  • A autorização de acesso à API do Google é feita como uma etapa de configuração, evitando as complicações associadas a outros fluxos do OAuth2 que exigem interações do usuário.
  • O fluxo de declaração OAuth2 permite que o app falsifique a identidade de outros usuários, se necessário.

Pré-requisitos

  • Um domínio do Google Workspace de sua propriedade, como mydomain.com ou mybusiness.com.
  • Um token de desenvolvedor da Google Ads API e, opcionalmente, uma conta de teste.
  • A biblioteca do cliente para a linguagem que você está usando.
  • Um projeto do Console de APIs do Google que foi configurado para a API Google Ads.
  • Um usuário do Google Ads com permissões na conta do Google Ads que você quer acessar. O Google Ads não permite o uso de contas de serviço sem falsificação de identidade.

Configuração de acesso à conta de serviço

Como a representação do usuário é controlada apenas no nível do domínio, o uso de contas de serviço e fluxo de declaração com o Google OAuth2 exige que você tenha seu próprio domínio registrado no Google Workspace. O app e os usuários dele poderão se representar por qualquer usuário no domínio.

  1. Comece criando uma conta de serviço e credenciais.

    Faça o download da chave da conta de serviço no formato JSON e anote o ID da conta de serviço.

  2. Compartilhe o ID da conta de serviço e o escopo da Google Ads API (https://www.googleapis.com/auth/adwords) com o administrador do seu domínio.

    Peça ao administrador do domínio para delegar a autoridade de todo o domínio à sua conta de serviço.

  3. Se você é o administrador do domínio, siga as instruções da Central de Ajuda.

Agora você pode usar a conta de serviço para acessar sua conta do Google Ads com o fluxo de declaração do OAuth2.

Configuração da biblioteca de cliente

Selecione sua linguagem abaixo para ver instruções sobre como configurar sua biblioteca cliente.

Preocupações com segurança

Como a conta de serviço tem controle de delegação no nível do domínio para seu domínio do Google Workspace, é importante proteger o arquivo de chave que permite que uma conta de serviço acesse os serviços do Google aos quais ela está autorizada. Isso é especialmente verdadeiro, porque essa conta de serviço tem a capacidade de representar qualquer usuário no domínio.

Outra prática recomendada é permitir que as contas de serviço acessem apenas o conjunto mínimo necessário de APIs. Essa é uma medida preventiva para limitar a quantidade de dados que um invasor pode acessar se o arquivo de chave da conta de serviço for comprometido.