Esempi

Questa guida contiene esempi di chiamata diretta degli endpoint REST, senza l'uso di una libreria client.

Prerequisiti

Tutti gli esempi riportati di seguito sono pensati per essere facilmente copiati e incollati in una shell bash utilizzando il comando curl. Devi disporre di un account amministratore Search Ads 360 contenente almeno un account cliente.

Importante: in questi esempi si presume che tu stia accedendo a un account cliente (CUSTOMER_ID) da un utente che dispone dell'accesso amministrativo a un account amministratore (MANAGER_CUSTOMER_ID) che gestisce direttamente l'account cliente. Se invece accedi direttamente a un singolo account cliente, ometti l'intestazione login-customer-id o impostala sullo stesso valore di CUSTOMER_ID.

Variabili di ambiente

Inserisci le credenziali e gli ID account di seguito, quindi copia e incolla nel terminal per configurare le variabili di ambiente utilizzate negli esempi successivi.

Nota: la guida sull'autorizzazione fornisce istruzioni per la generazione di un token di accesso OAuth 2.0.

API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"

ID oggetto facoltativi aggiuntivi

I seguenti esempi funzionano con le campagne preesistenti. Se hai gli ID di una campagna esistente da utilizzare con questi esempi, inseriscili di seguito.

CAMPAIGN_ID=CAMPAIGN_ID

Ricerca con pagine

Il metodo search utilizza la paginazione, con un parametro pageSize regolabile specificato accanto a query.

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:search" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"pageSize": 10,
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

Linguaggio di query SA360

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'

Streaming

Il metodo searchStream trasmette in streaming tutti i risultati in un'unica risposta, pertanto il campo pageSize non è supportato.

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:searchStream" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

Linguaggio di query SA360

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'