במקרה השימוש הזה מוצג סיכום של ביצועי החשבון ב-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, אבל התהליך דומה בכל השפות.