Intestazioni per l'autorizzazione e HTTP

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 per ogni richiesta. Questa pagina descrive come impostare questi valori e documenti diverse intestazioni HTTP aggiuntive 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

Potrai quindi utilizzare 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 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 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 tutti 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. 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