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'