Fluxo de trabalho da conta de serviço

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

Uma conta de serviço pertence ao app, e não a um usuário final individual. As contas de serviço empregam um fluxo do OAuth 2.0 que não requer autorização humana, usando, em vez disso, um arquivo de chave que só pode ser acessado pelo app.

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

• A autorização para o acesso da API Google Ads às contas do Google Ads é feita como uma etapa de configuração, aproveitando os recursos de autorização e gerenciamento de contas oferecidos pela interface do Google Ads. Isso poupa o trabalho do desenvolvedor, que não precisa criar fluxos do OAuth 2.0 e lidar com complicações que envolvem a interação do usuário, o armazenamento de credenciais do usuário e o gerenciamento de tokens.

• A autorização para acessar contas do Google Ads não está vinculada às credenciais de usuários individuais, o que pode ser útil nos casos em que essa autorização precisa continuar mesmo que o funcionário que autorizou o acesso originalmente saia da equipe ou da empresa.

Configuração de acesso à conta

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 e o e-mail da conta de serviço.

2. Faça login na sua conta do Google Ads como administrador. Acesse Administrador > Acesso e segurança.

3. Clique no botão + na guia Usuários.

4. Digite o e-mail da conta de serviço na caixa de entrada E-mail. Selecione o nível de acesso adequado da conta (as contas de serviço não são compatíveis com o nível de acesso Somente e-mail) e clique no botão Adicionar conta.

   A conta de serviço recebe acesso.

5. Opcional: por padrão, não é possível conceder acesso de administrador a uma conta de serviço. Siga o princípio de privilégio mínimo e conceda acesso de administrador apenas se as chamadas de API exigirem. É possível fazer upgrade do acesso da seguinte maneira:

   • Clique na seta suspensa ao lado do nível de acesso da conta de serviço na coluna Nível de acesso.
   • Selecione Administrador na lista suspensa.

Configuração da biblioteca de cliente

Selecione a guia correspondente à sua linguagem de programação para ver instruções sobre como configurar a biblioteca de cliente. Se a conta de serviço acessar contas de cliente por uma conta de administrador do Google Ads, defina também login-customer-id (ou loginCustomerId) como o ID de cliente de 10 dígitos dessa conta de administrador sem hifens (consulte ID de cliente de login).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
    // ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=JSON_KEY_FILE_PATH

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST \
  https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}