Fluxo da conta de serviço do OAuth

Este guia vai mostrar como configurar o OAuth2 para acesso à API usando suas próprias credenciais com contas de serviço. Essas etapas só precisam ser seguidas uma vez, a menos que você revogue ou exclua suas credenciais do OAuth2.

Criar credenciais OAuth2

Observação: esse fluxo exige um domínio do Google Workspace, e a conta de serviço que você criou precisa receber acesso de delegação em todo o domínio de um superadministrador do domínio.

Gerencie um ID de conta de serviço (delegado) e um arquivo *.JSON seguindo as instruções vinculadas. Depois, volte a esta página.

Configurar a biblioteca de cliente

Defina o caminho do arquivo JSON da chave privada e o ID da conta delegada na configuração. Se você estiver usando um arquivo googleads.properties, adicione o seguinte:

jsonKeyFilePath=PRIVATE_KEY_FILE_PATH
impersonatedEmail=DELEGATE_ACCOUNT

Se você estiver usando variáveis de ambiente, adicione o seguinte à configuração ou ao ambiente do Bash:

export GOOGLE_ADS_JSON_KEY_FILE_PATH=PRIVATE_KEY_FILE_PATH
export GOOGLE_ADS_IMPERSONATED_EMAIL=DELEGATE_ACCOUNT_ID

Ponto-chave: ao carregar configurações, a biblioteca primeiro procura credenciais dos fluxos de apps da Web ou para computadores do OAuth2 e, em seguida, as usa se encontradas. Portanto, se você quer usar uma autenticação de conta de serviço, verifique se as credenciais dos outros fluxos não estão presentes na configuração.