Quando chiami l'API Google Ads, devi disporre sia delle credenziali dell'applicazione OAuth 2.0 sia di 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 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 fare esperimenti con le credenziali dell'applicazione e l'API Google Ads prima di scrivere il codice per la tua 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.
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 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 all'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
Dopodiché utilizzerai il token di accesso restituito dalla richiesta curl nell'intestazione HTTP Authorization di ogni chiamata API all'API Google Ads:
GET /v16/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 l'account amministratore direttamente dall'interfaccia utente di Google Ads. Per maggiori 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 /v16/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
accedi 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.
Includere 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 eventuali trattini (—),
ad esempio 1234567890, non 123-456-7890.
GET /v16/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 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 dall'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 Google.
request-id: 2a5Cj89VV7CNhya1DZjjrC