דוגמה לתרחיש נפוץ

במקרה השימוש הזה מוצג סיכום של ביצועי החשבון ב-30 הימים האחרונים לפי קמפיין, עם פילוח לפי מכשיר. השאילתה של הדוח הזה היא:

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

כדי להגיש את הבקשה הזו, צריך להעביר את ההצהרה הזו בשפת השאילתות של Google Ads לממשק GoogleAdsService.SearchStream.

כתובת URL של בקשת HTTP

הבקשה מורכבת מ-HTTP POST לשרת Google Ads API בכתובת ה-URL הבאה:

https://googleads.googleapis.com/v24/customers/{customer_id}/googleAds:searchStream

מחליפים את {customer_id} במזהה של חשבון Google Ads הספציפי שרוצים לשלוח אליו שאילתה. אל תכללו מקפים במזהה. אם רוצים לאחזר נתונים של חשבון משני, צריך להשתמש במזהה של החשבון המשני הזה. שאילתה עם מזהה של חשבון ניהול מחזירה רק נתונים שנמצאים בבעלות ישירה של חשבון הניהול הזה, ולא כוללת נתונים מחשבונות המשנה שלו.

דוגמה מלאה לבקשת HTTP

זוהי דוגמה מלאה להגדרת הדוח, שמופיעה בבקשת HTTP POST:

POST /v24/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]

Parameters:
{
  "query" : "SELECT campaign.name, campaign.status, segments.device,
                    metrics.impressions, metrics.clicks, metrics.ctr,
                    metrics.average_cpc, metrics.cost_micros
            FROM campaign
            WHERE segments.date DURING LAST_30_DAYS"
}

דוגמאות קוד

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