Questa sezione è destinata agli utenti esperti che conoscono già 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 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
È 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.
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 OAuth2 di Google.
Per il tipo di app desktop, l'accesso offline è attivato per impostazione predefinita, quindi non devi richiederlo esplicitamente.
Intestazioni delle richieste
Intestazioni gRPC
Quando utilizzi l'API gRPC, includi il token di accesso in ogni richiesta. Puoi associare un Credential a un Channel per l'utilizzo 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. 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, # 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}" \