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 vari 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
È 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 naviga sul tuo sito web. I token di accesso hanno una durata di 3600 secondi (1 ora), dopodiché la tua 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 per computer, l'accesso offline è abilitato 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
un Credential a un Channel da utilizzare in 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>. Viene mostrata 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}" \