Fluxo de trabalho da conta de serviço

Este guia explica como acessar a API Google Ads com contas de serviço.

Uma conta de serviço é uma conta que pertence ao seu app, 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ó o app pode acessar.

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 economiza o trabalho do desenvolvedor, já que não é necessário 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 de acesso às contas do Google Ads não está vinculada às credenciais de usuários individuais, o que pode ser útil em casos em que essa autorização deve 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.

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 à conta. As contas de serviço não são compatíveis com o nível de acesso Somente e-mail. Clique no botão Adicionar conta.

5. A conta de serviço recebe acesso.

6. Opcional:por padrão, não é possível conceder acesso de administrador a uma conta de serviço. Siga o princípio de menor privilégio e conceda acesso de administrador apenas se as chamadas de API exigirem isso. É 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 instruções sobre como configurar a biblioteca de cliente. Se a sua conta de serviço acessar contas de cliente por uma conta de administrador do Google Ads (MCC), defina 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/v25/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"
}