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 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
È normale che un'app client API di Google Ads richieda l'accesso offline. Ad esempio, la tua app potrebbe voler eseguire job batch quando l'utente non è fisicamente online e naviga 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 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. Viene mostrata 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}" \