Esta seção é destinada a usuários avançados que já conhecem 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 do 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 aplicativo cliente da Google Ads API solicite acesso off-line. Por exemplo, o app pode querer executar trabalhos em lote quando o usuário não estiver navegando no site.
Para solicitar acesso off-line a um tipo de app da Web, defina o parâmetro
access_type como offline. Confira 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 solicitar explicitamente.
Cabeçalhos de solicitação
Cabeçalhos gRPC
Ao usar a API gRPC, inclua o token de acesso em cada solicitação. É possível vincular um Credential a um Channel para uso em todas as solicitações nesse canal. Você também pode enviar uma credencial personalizada para cada chamada. O guia de autorização
gRPC contém mais detalhes sobre como lidar com
autorizações.
Cabeçalhos REST
Ao usar a API REST, transmita o token de acesso pelo cabeçalho HTTP
Authorization. Confira um exemplo de solicitação HTTP:
# 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}" \