Esta seção é destinada a usuários avançados que já estão familiarizados com a especificação do OAuth 2.0 e sabem como usar o OAuth 2.0 com as APIs do Google.
Escopo
Um único token de acesso pode conceder diferentes graus de acesso a várias APIs. Um parâmetro variável chamado scope controla o conjunto de recursos e operações que um token de acesso permite. Durante a solicitação de token de acesso, seu app envia um ou mais valores no parâmetro scope.
O escopo da API Google Ads é:
https://www.googleapis.com/auth/adwords
Acesso off-line
É comum que um app cliente da API Google Ads solicite acesso off-line. Por exemplo, seu app pode querer executar jobs em lote quando o usuário não estiver on-line navegando no seu site.
Para solicitar acesso off-line para um tipo de app da Web, defina o parâmetro access_type como offline. Você pode encontrar mais informações no
guia do OAuth2 do Google.
Para o tipo de app para computador, o acesso off-line é ativado por padrão. Não é necessário solicitá-lo explicitamente.
Cabeçalhos de solicitação
Cabeçalhos gRPC
Ao usar a API gRPC, inclua o token de acesso em cada solicitação. Você pode vincular uma Credential a um Channel para uso em todas as solicitações nesse canal. Também é possível enviar uma credencial personalizada para cada chamada. O guia
de autorização gRPC contém mais detalhes sobre como processar a
autorização.
Cabeçalhos REST
Ao usar a API REST, transmita o token de acesso pelo cabeçalho HTTP Authorization. Um exemplo de solicitação HTTP é mostrado abaixo:
# Returns the resource names of customers directly accessible by the user # authenticating the call. # # Variables: # API_VERSION, # DEVELOPER_TOKEN, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # curl -f --request GET \ "https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \