דוגמה

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

כדי לאחזר את הדוח הזה, צריך להיות לכם תפקיד של מנהל דוחות.

כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה reports.search:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

ריצה

לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer. אחרי שלוחצים על Run (הפעלה), מעדכנים את placeholder מזהה המוכר למזהה המוכר שלכם בכתובת ה-URL של הבקשה. אפשר לשנות את השאילתה. כדי שהשאילתה תפעל עם API Explorer, היא צריכה להיות בשורה אחת.

הערה: במדריך הזה מוצגת בקשת ה-HTTP הבסיסית ככלי לימוד, אבל מומלץ להשתמש באחת מספריות הלקוח כדי לשלוח את הבקשות.

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

הבקשה מורכבת מבקשת HTTP POST לשרת Content API for Shopping בכתובת ה-URL הבאה:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

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

הנה דוגמה מלאה שמציגה את הגדרת הדוח שלמעלה בתוך בקשת HTTP POST:

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}