דוגמה

אנחנו שמחים להציג את גרסת הבטא של Merchant API. זאת הגרסה החדשה של ה-Content API, של העתיד.

זו שאילתה לדוגמה של השדה 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'

הפעלה

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

הערה: במדריך הזה מוצגת בקשת ה-HTTP שעליה מבוסס בקשת ה-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'"
}