Per chiamare l'API Search Ads 360 Reporting, devi disporre delle credenziali dell'applicazione OAuth 2.0. Se effettui chiamate API come account amministratore Search Ads 360, 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 che vengono inviate e ricevute quando si utilizza l'interfaccia REST.
Credenziali OAuth 2.0
L'API Search Ads 360 Reporting utilizza le credenziali dell'applicazione per identificare e autorizzare le richieste all'API. È possibile configurare i client OAuth 2.0. Tutte le chiamate all'API Search Ads 360 Reporting devono essere autorizzate tramite OAuth2. OAuth2 consente all'app client dell'API Search Ads 360 Reporting di accedere all'account Search Ads 360 di un utente senza dover gestire o memorizzare i dati di accesso dell'utente.
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 Search Ads 360 Reporting prima di scrivere il codice per la tua app. Puoi anche generare un token di aggiornamento OAuth eseguendo lo script di generazione delle credenziali utente fornito.
Generazione di nuovi token di accesso
Una volta che hai 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
Poi, utilizza il token di accesso restituito dalla richiesta curl nell'Authorization intestazione HTTP di ogni chiamata API all'API Search Ads 360 Reporting:
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Intestazioni delle richieste
ID cliente di accesso
Per le chiamate all'API Search Ads 360 Reporting 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 Search Ads 360 dell'amministratore che effettua la chiamata all'API.
L'inclusione di questo intestazione è equivalente alla scelta di un account nell'interfaccia utente di Search Ads 360
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 /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_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