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

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

נקודה חשובה: הדוגמה הזו מציגה את בקשת ה-HTTP הבסיסית רק בתור הוראה method; מומלץ מאוד להשתמש באחת מספריות הלקוח כדי לשלוח בקשות באפליקציה שלכם.

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

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

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

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

הנה דוגמה מלאה להגדרת הדוח למעלה, בתוך ה-HTTP בקשת POST.

POST /v17/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, אבל דומה בכל השפות.