Dieser Leitfaden enthält Beispiele für das direkte Aufrufen der REST-Endpunkte ohne Verwendung einer Clientbibliothek.
Voraussetzungen
Alle folgenden Beispiele sollen leicht mit dem Befehl curl in eine Bash-Shell kopiert und eingefügt werden können. Sie benötigen ein Search Ads 360-Verwaltungskonto mit mindestens einem Kundenkonto.
Umgebungsvariablen
Geben Sie unten Anmeldedaten und IDs für das Konto ein und kopieren Sie sie dann in Ihr Terminal, um die in den folgenden Beispielen verwendeten Umgebungsvariablen zu konfigurieren.
API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"
Weitere optionale Objekt-IDs
Die folgenden Beispiele beziehen sich auf bereits vorhandene Kampagnen. Wenn Sie IDs einer vorhandenen Kampagne für diese Beispiele verwenden möchten, geben Sie sie unten ein.
CAMPAIGN_ID=CAMPAIGN_ID
Suche mit nummerierten Seiten
Bei der Methode search wird die Paginierung verwendet, wobei ein anpassbarer pageSize-Parameter 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 Query Language
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
Die Methode searchStream streamt alle Ergebnisse in einer einzigen Antwort. Daher wird das Feld pageSize 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 Query Language
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'