Intestazioni per l'autorizzazione e HTTP

Quando chiami l'API Search Ads 360 Reporting, devi disporre delle credenziali dell'applicazione OAuth 2.0. Se effettui chiamate API come un 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 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 API Search Ads 360 Reporting di accedere all'account Search Ads 360 di un utente senza dover gestire o archiviare i dati di accesso dell'utente.

Se non hai mai utilizzato le API di Google, puoi utilizzare oauth2l o OAuth 2.0 Playground per sperimentare 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 ottenuti un ID client, un secret client 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

Utilizza poi 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 accedi come amministratore 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 Search Ads 360 dell'amministratore che effettua la chiamata 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 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 dell'API.

ID richiesta

request-id è una stringa che identifica in modo univoco la richiesta API. Quando esegui il debug o la risoluzione dei problemi relativi a chiamate API specifiche, request-id è un identificatore importante da tenere a portata di mano quando contatti l'assistenza per gli sviluppatori Google.

request-id: 2a5Cj89VV7CNhya1DZjjrC