דוגמה

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

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

כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של שפת השאילתה ב-Merchant Center ל-method 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'

הפעלה

לוחצים על הפעלה כדי לנסות את הדוגמה ב-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'"
}