Sono necessarie le credenziali dell'applicazione OAuth 2.0 e uno sviluppatore
quando chiami l'API Google Ads. Se effettui chiamate API
con un account amministratore Google Ads, devi specificare anche un login-customer-id
un'intestazione con ogni richiesta. In questa pagina viene descritto come impostare questi valori e
documenta diverse intestazioni HTTP aggiuntive specifiche dell'API che vengono inviate
quando si utilizza l'interfaccia REST.
Credenziali OAuth 2.0
L'API Google Ads utilizza le credenziali dell'applicazione per identificare e autorizzare l'API richieste. Sia i client OAuth 2.0 che il servizio di rete. Per maggiori dettagli sulla configurazione dell'autorizzazione lato client, consulta OAuth2 dell'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 dell'app.
Utilizzo dei flussi di app desktop o web
Segui i passaggi per configurare un progetto della console API di Google per dell'API Google Ads. Registra l'ID client e client secret, quindi torna su questa pagina.
Dopo aver creato un client OAuth, segui il flusso delle app desktop istruzioni o il flusso delle app web istruzioni per generare un token di aggiornamento e un token di accesso.
Utilizzo degli account di servizio
Segui le istruzioni comuni nella pagina Servizio Account guida alla configurazione dell'accesso agli account di servizio per l'API Google Ads.
Dopo aver configurato un account di servizio per accedere al tuo account Google Ads, segui le
Utilizzo di OAuth 2.0 per le versioni da server a server
Applicazioni
guida, assicurandoti di selezionare la scheda HTTP/REST. Il scope da utilizzare per l'API Google Ads
è https://www.googleapis.com/auth/adwords.
Generazione di nuovi token di accesso
Una volta ottenuti un ID client, un client secret e un token di aggiornamento, puoi:
generare un nuovo token di accesso da utilizzare nelle chiamate API con
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 nel
Authorization intestazione HTTP 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 a l'API. Puoi richiedere un token per il tuo account amministratore direttamente dal UI di Google Ads. Per maggiori dettagli sulla configurazione di un token sviluppatore, consulta Ottenere il token sviluppatore.
Devi includere il valore del token sviluppatore nel campo HTTP developer-token
intestazione 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
accedendo 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'inclusione di questa intestazione equivale a scegliere un account nell'interfaccia utente di Google Ads
dopo aver effettuato l'accesso o fatto clic sull'immagine del profilo nell'angolo in alto a destra della
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 caricare le conversioni in un account Google Ads collegato Google Cloud. Consulta le Guida alla struttura delle chiamate API per ulteriori informazioni.
...
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
il debug o la risoluzione di problemi relativi a chiamate API specifiche, request-id
è un identificatore importante da avere a portata di mano quando si contatta lo sviluppatore Google
assistenza in tempo reale.
request-id: 2a5Cj89VV7CNhya1DZjjrC