Intestazioni per l'autorizzazione e HTTP

Video: autenticazione

Per chiamare l'API Google Ads, sono necessarie sia le credenziali dell'applicazione OAuth 2.0 sia un token sviluppatore. Se effettui chiamate API con un account amministratore Google Ads, devi anche specificare un login-customer-id header con ogni richiesta. Questa pagina descrive come impostare questi valori e documenta diverse intestazioni HTTP specifiche dell'API aggiuntive che vengono inviate e ricevute quando si utilizza l'interfaccia REST.

Credenziali OAuth 2.0

L'API Google Ads utilizza le credenziali dell'applicazione per identificare e autorizzare le richieste all'API. È possibile configurare sia i client OAuth 2.0 sia gli account di servizio. Per maggiori dettagli sulla configurazione dell'autorizzazione lato client, consulta OAuth2 nell'API Google Ads.

Se non hai dimestichezza con le API di Google, puoi utilizzare oauth2l o OAuth 2.0 Playground per fare esperimenti con le credenziali dell'applicazione e l'API Google Ads prima di scrivere il codice per la tua app.

Utilizzare i flussi di app web o desktop

Segui i passaggi per configurare un progetto della console API di Google per l'API Google Ads. Prendi nota dell'ID client e del client secret, quindi torna a questa pagina.

Dopo aver creato un client OAuth, segui le istruzioni per il flusso dell'app desktop o le istruzioni per il flusso dell'app web per generare un token di aggiornamento e un token di accesso.

Utilizzo degli account di servizio

Segui le istruzioni comuni riportate nella guida agli account di servizio per configurare l'accesso all'account di servizio per l'API Google Ads.

Dopo aver configurato un account di servizio per accedere al tuo account Google Ads, segui la guida Utilizzo di OAuth 2.0 per applicazioni da server a server, assicurandoti di selezionare la scheda HTTP/REST. Il valore scope da utilizzare per l'accesso all'API Google Ads è https://www.googleapis.com/auth/adwords.

Generazione di nuovi token di accesso

Una volta che hai un ID client, una chiave client e un token di aggiornamento, puoi generare un nuovo token di accesso da utilizzare nelle chiamate API con lo strumento a riga di comando curl:

Nota: la versione v3 nell'URL dell'endpoint OAuth non è correlata alla versione dell'API Google Ads e non deve cambiare durante la migrazione alle versioni più recenti dell'API Google Ads.

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://www.googleapis.com/oauth2/v3/token

Poi utilizzi il token di accesso restituito dalla richiesta curl nell'Authorization intestazione HTTP di ogni chiamata API all'API Google Ads:

GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Intestazioni delle richieste

Token sviluppatore

L'API Google Ads richiede anche un token sviluppatore per effettuare chiamate all'API. Puoi richiedere un token per il tuo account amministratore direttamente dall'interfaccia utente di Google Ads. Per ulteriori dettagli sulla configurazione di un token sviluppatore, consulta Ottenere il token sviluppatore.

Devi includere il valore del token sviluppatore nell'intestazione HTTP developer-token di ogni chiamata API all'API Google Ads:

GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

ID cliente di accesso

Per le chiamate all'API Google Ads effettuate da un amministratore a un account cliente (ovvero quando si accede come amministratore per effettuare chiamate all'API a uno dei suoi account cliente), devi anche fornire l'intestazione HTTP login-customer-id. Questo valore rappresenta l'ID cliente Google Ads del gestore che effettua la chiamata all'API.

L'inclusione di questo intestazione è equivalente alla scelta di un account nell'interfaccia utente di Google Ads dopo aver eseguito l'accesso o aver fatto clic sull'immagine del profilo nell'angolo in alto a destra della pagina. Quando specifichi l'ID cliente, assicurati di rimuovere i trattini (-), ad esempio: 1234567890, non 123-456-7890.

GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

Punto chiave: se non esegui l'autorizzazione come account amministratore, in altre parole se le tue credenziali OAuth 2.0 sono per un utente dell'account client Google Ads di destinazione, non devi fornire un'intestazione login-customer-id.

ID cliente collegato

Questo intestazione viene utilizzato solo dai provider di analisi dati delle app di terze parti quando caricano le conversioni in un account Google Ads collegato. Per ulteriori dettagli, consulta la guida alla struttura delle chiamate API.

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID

Intestazioni della risposta

Le seguenti intestazioni vengono restituite nelle risposte HTTP dell'API.

ID richiesta

request-id è una stringa che identifica in modo univoco la richiesta API. Quando si esegue il debug o si risolvono i problemi relativi a chiamate API specifiche, request-id è un identificatore importante da avere a portata di mano quando si contatta l'assistenza sviluppatori Google.

request-id: 2a5Cj89VV7CNhya1DZjjrC