דוגמאות

המדריך הזה מכיל דוגמאות לקריאה ישירה לנקודות הקצה של ה-REST, בלי להשתמש בספריית לקוח.

דרישות מוקדמות

כל הדוגמאות הבאות ניתנות להעתקה ולהדבקה בקלות במעטפת bash באמצעות הפקודה curl. תצטרכו חשבון ניהול ב-Search Ads 360 שמכיל לפחות חשבון לקוח אחד.

חשוב: בדוגמאות האלה אנחנו מניחים שהגישה שלכם לחשבון לקוח (CUSTOMER_ID) מתבצעת על ידי משתמש שיש לו הרשאת אדמין לחשבון ניהול (MANAGER_CUSTOMER_ID) שמנהל באופן ישיר את חשבון הלקוח. אם אתם ניגשים ישירות לחשבון לקוח מסוים, תוכלו להשמיט את הכותרת login-customer-id או להגדיר אותה לאותו ערך כמו CUSTOMER_ID.

משתני סביבה

מזינים את פרטי הכניסה והמזהים של החשבון שבהמשך, מעתיקים ומדביקים אותם במסוף כדי להגדיר את משתני הסביבה שבהם נעשה שימוש בדוגמאות הבאות.

הערה: במדריך הרשאה מפורטות הוראות ליצירת אסימון גישה מסוג OAuth 2.0.

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

מזהי אובייקטים אופציונליים נוספים

הדוגמאות הבאות רלוונטיות לקמפיינים קיימים. אם יש לכם מזהי קמפיין קיים שרוצים להשתמש בהם בדוגמאות האלה, מזינים אותם למטה.

CAMPAIGN_ID=CAMPAIGN_ID

חיפוש עם חלוקה לדפים

כשמשתמשים ב-method search, החלוקה לדפים מתבצעת עם פרמטר pageSize שאפשר לשנות יחד עם הפרמטר 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]

שפת השאילתה ב-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'

סטרימינג

השיטה searchStream מעבירה את כל התוצאות בסטרימינג בתגובה אחת, ולכן אין תמיכה בשדה pageSize.

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

  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'