Elementi interni OAuth2 per l'API Google Ads

Le nostre librerie client si occupano automaticamente dei dettagli illustrati di seguito, quindi continua a leggere solo se sei interessato a ciò che accade dietro le quinte o se non utilizzi una delle nostre librerie client.

Questa sezione è rivolta agli utenti avanzati che già conoscono la specifica OAuth 2.0 e sanno come utilizzare OAuth2 con le API di Google.

Vuoi saperne di più sull'autenticazione nell'API?

Libreria video: autenticazione e autorizzazione

Ambito

Un singolo token di accesso può concedere vari gradi 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, l'app invia uno o più valori nel parametro scope.

L'ambito dell'API Google Ads è:

https://www.googleapis.com/auth/adwords

Accesso offline

È frequente 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 naviga fisicamente online nel 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 di Google a OAuth2.

Per il tipo di app desktop, l'accesso offline è abilitato per impostazione predefinita, 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 elemento Credential a una 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 delle autorizzazioni.

Intestazioni REST

Quando utilizzi l'API REST, trasmetti il token di accesso tramite l'intestazione HTTP Authorization. Di seguito è riportato un esempio di richiesta HTTP:

GET /v16/customers/123456789 HTTP/2
Host: googleads.googleapis.com
User-Agent: INSERT_USER_AGENT
Accept: */*
Authorization: Bearer INSERT_ACCESS_TOKEN
developer-token: INSERT_DEVELOPER_TOKEN

Token di accesso e aggiornamento

Nella maggior parte dei casi, devi archiviare il token di aggiornamento in modo sicuro per un utilizzo futuro. Per saperne di più su come richiedere i token di accesso e di aggiornamento, leggi la guida corrispondente per il tuo tipo di applicazione:

Aggiorna scadenza token

Per ulteriori dettagli sulla scadenza del token di aggiornamento, consulta la documentazione relativa a OAuth di Google Identity Platform.

Scadenza del token di accesso

Un token di accesso ha una scadenza (in base al valore expires_in), trascorsa la quale non è più valido. Puoi usare il token di aggiornamento per aggiornare un token di accesso scaduto. Per impostazione predefinita, le librerie client aggiornano automaticamente i token di accesso scaduti.