Questa sezione è destinata agli utenti esperti che hanno già familiarità con la specifica OAuth 2.0 e sanno come utilizzare OAuth 2.0 con le API di Google.
Ambito
Un singolo token di accesso può concedere diversi livelli di accesso a più API. Un parametro variabile denominato scope controlla l'insieme di risorse e operazioni consentite da un token di accesso. Durante la richiesta del token di accesso, l'app invia uno o più valori nel parametro scope.
L'ambito dell'API Google Ads è:
https://www.googleapis.com/auth/adwords
Accesso offline e durata dei token
È normale che un'app client dell'API Google Ads richieda l'accesso offline. Ad esempio, la tua app potrebbe voler eseguire job batch quando l'utente non è fisicamente online e non sta navigando sul tuo sito web. I token di accesso hanno una durata di 3600 secondi (1 ora), dopodiché l'app deve scambiare un token di aggiornamento con un nuovo token di accesso.
Per richiedere l'accesso offline per un tipo di app web, assicurati di impostare il parametro access_type su offline. Puoi trovare ulteriori informazioni in
nella guida di Google su OAuth 2.0.
Per il tipo di app desktop, l'accesso offline è attivato per impostazione predefinita, quindi non devi richiederlo esplicitamente.
Intestazioni delle richieste
Tutte le richieste all'API Google Ads devono includere il token di accesso OAuth 2.0 nell'intestazione della richiesta. Le sezioni seguenti descrivono come trasmettere queste credenziali utilizzando gRPC e REST.
Intestazioni gRPC
Quando utilizzi l'API gRPC, includi il token di accesso in ogni richiesta. Puoi associare una Credential a un Channel per l'utilizzo su tutte le richieste su quel canale. Puoi anche inviare una credenziale personalizzata per ogni chiamata. La guida all'autorizzazione gRPC
contiene ulteriori dettagli sulla gestione dell'autorizzazione.
Intestazioni REST
Quando utilizzi l'API REST, trasmetti il token di accesso tramite l'intestazione HTTP
Authorization: Bearer <ACCESS_TOKEN>. Di seguito è riportata una richiesta HTTP di esempio:
# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
# API_VERSION,
# 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 "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \