Intestazioni per l'autorizzazione e HTTP

Video: Autenticazione

Quando chiami l'API Google Ads, devi disporre sia delle credenziali dell'applicazione OAuth 2.0 sia di un token dello sviluppatore. Se effettui chiamate API con un account amministratore Google Ads, devi anche specificare un'intestazione login-customer-id con ogni richiesta. Questa pagina descrive come impostare questi valori e documenta diverse intestazioni HTTP specifiche dell'API aggiuntive 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 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 mai utilizzato le API di Google, puoi utilizzare oauth2l o OAuth 2.0 Playground per sperimentare le credenziali dell'applicazione e l'API Google Ads prima di scrivere il codice per la tua app.

Utilizzo dei flussi dell'app web o del computer

Segui i passaggi per configurare un progetto nella console API di Google per l'API Google Ads. Registra l'ID client e il client secret, poi torna a questa pagina.

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

Utilizzo degli account di servizio

Segui le istruzioni comuni nella guida Service Accounts per configurare l'accesso al service account per l'API Google Ads.

Una volta configurato un service account 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 scope da utilizzare per l'accesso all'API Google Ads è https://www.googleapis.com/auth/adwords.

Generazione di nuovi token di accesso

Una volta ottenuti un ID client, un secret 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:

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

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

GET /v21/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 maggiori dettagli sulla configurazione con 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 /v21/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

ID cliente di accesso

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

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

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

ID cliente collegato

Questa intestazione viene utilizzata solo dai provider di analisi dati delle app di terze parti durante il caricamento delle conversioni in un account Google Ads collegato. Per maggiori 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 esegui il debug o la risoluzione dei problemi relativi a chiamate API specifiche, request-id è un identificatore importante da tenere a portata di mano quando contatti l'assistenza per gli sviluppatori Google.

request-id: 2a5Cj89VV7CNhya1DZjjrC
Indietro
Panoramica
Avanti
Panoramica