Questa sezione è rivolta agli utenti avanzati 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 chiamato scope controlla l'insieme di risorse e operazioni consentite da un token di accesso. Durante la richiesta del token di accesso, la tua 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
È comune 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 a navigare 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 nella guida di Google a OAuth 2.0.
Per il tipo di app desktop, l'accesso offline è abilitato per impostazione predefinita, quindi non è necessario 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 passare queste credenziali utilizzando gRPC e REST.
Intestazioni gRPC
Quando utilizzi l'API gRPC, includi il token di accesso in ogni richiesta. Puoi associare
un Credential a un Channel da utilizzare per 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, passa il token di accesso tramite l'intestazione HTTP Authorization: Bearer <ACCESS_TOKEN>. Di seguito è riportato un esempio di richiesta HTTP:
# 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}" \