Quando chiami l'API Google Ads, sono necessari sia le credenziali dell'applicazione OAuth 2.0 sia un token
per sviluppatori. Se effettui chiamate API con un account amministratore Google Ads, devi anche specificare un'intestazione login-customer-id per ogni richiesta. Questa pagina descrive come impostare questi valori e documenta diverse intestazioni HTTP aggiuntive specifiche dell'API 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 API. È possibile configurare sia i client OAuth 2.0 sia gli account di servizio. Per ulteriori 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 provare le credenziali dell'applicazione e l'API Google Ads prima di scrivere il codice dell'app.
Utilizzo dei flussi di app desktop o web
Segui i passaggi per configurare un progetto della console API di Google per l'API Google Ads. Registra l'ID client e il client secret, quindi torna a questa pagina.
Una volta 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 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 all'account Google Ads, segui la guida sull'utilizzo di OAuth 2.0 per applicazioni server-server, assicurandoti di selezionare la scheda HTTP/REST. Il scope da utilizzare per accedere all'API Google Ads è https://www.googleapis.com/auth/adwords.
Generazione di nuovi token di accesso
Dopo aver ottenuto un ID client, un client secret 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
Potrai quindi utilizzare il token di accesso restituito dalla richiesta curl nell'intestazione HTTP Authorization di ogni chiamata API all'API Google Ads:
GET /v17/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 di un token sviluppatore, consulta l'articolo 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 /v17/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 gestore a un account cliente (ovvero quando
esegui l'accesso come gestore 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'inserimento di questa intestazione equivale a scegliere 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 tutti i trattini (—),
ad esempio: 1234567890, non 123-456-7890.
GET /v17/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 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. Durante il debug o la risoluzione di problemi con chiamate API specifiche, request-id è un identificatore importante a portata di mano quando si contatta l'assistenza per gli sviluppatori di Google.
request-id: 2a5Cj89VV7CNhya1DZjjrC