דוגמה

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

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

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

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

כתובת 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'"
}