Quando chiami 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 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 Search Ads 360 Reporting utilizza le credenziali dell'applicazione per identificare e autorizzare le richieste API. È possibile configurare 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 archiviare le sue informazioni di accesso.
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 con 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
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 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 gestore a un account cliente (ovvero, quando accedi come gestore per effettuare chiamate 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 del gestore che effettua la chiamata API.
Includere questa intestazione equivale a scegliere 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 eventuali 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 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