Beispiele

Dieser Leitfaden enthält Beispiele für den direkten Aufruf der REST-Endpunkte ohne Verwendung einer Clientbibliothek.

Vorbereitung

Alle unten aufgeführten Beispiele sind so konzipiert, dass sie mit dem Befehl curl einfach in eine Bash-Shell kopiert und eingefügt werden können. Sie benötigen ein Search Ads 360-Verwaltungskonto mit mindestens einem Kundenkonto.

Wichtig :In diesen Beispielen gehen wir davon aus, dass Sie über einen Nutzer, der Administratorzugriff auf ein Verwaltungskonto (MANAGER_CUSTOMER_ID) hat, auf ein Kundenkonto (CUSTOMER_ID) zugreifen, das direkt über das Verwaltungskonto verwaltet wird. Wenn Sie stattdessen direkt auf ein einzelnes Kundenkonto zugreifen, lassen Sie den login-customer-id-Header weg oder legen Sie ihn auf denselben Wert wie CUSTOMER_ID fest.

Umgebungsvariablen

Geben Sie unten Anmeldedaten und IDs ein und kopieren Sie sie dann in Ihr Terminal, um die Umgebungsvariablen zu konfigurieren, die in den folgenden Beispielen verwendet werden.

Hinweis: In der Anleitung zur Autorisierung finden Sie eine Anleitung zum Generieren eines OAuth 2.0-Zugriffstokens.

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

Zusätzliche optionale Objekt-IDs

Die folgenden Beispiele beziehen sich auf bestehende Kampagnen. Wenn Sie IDs einer bestehenden Kampagne haben, die Sie mit diesen Beispielen verwenden möchten, geben Sie sie unten ein.

CAMPAIGN_ID=CAMPAIGN_ID

Suche mit Seitenumbruch

Die search-Methode verwendet die Paginierung mit einem anpassbaren pageSize-Parameter, der zusammen mit dem query angegeben wird.

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]

SA360-Abfragesprache

  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

Bei der Methode searchStream werden alle Ergebnisse in einer einzigen Antwort gestreamt. Das Feld pageSize wird daher nicht unterstützt.

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]

SA360-Abfragesprache

  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'