תוכלו להשתמש ב-Merchant Listings API כדי ליצור ולנהל מבצעים ב-Google. בעזרת המשאב accounts.promotions תוכלו להציג מבצעים מיוחדים על המוצרים שאתם מוכרים ב-Google. מידע נוסף זמין במאמר סקירה כללית של Merchant promotion API.
בקשות
כדי לשלוח בקשות, צריך להשתמש בכתובת ה-URL הבאה.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
מעבר מ-Content API for Shopping
בהמשך מוצגת השוואה בין ה-Content API for Shopping לבין Merchant promotion API בבקשות שקשורות למבצעים.
כתובת URL
ב-Content API for Shopping:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
ב-Merchant API הופך ל:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
מזהים
ב-Content API for Shopping:
{merchantId}/promotions/{promotionId}
ב-Merchant API הופך ל:
{name}
שיטות
ב-Merchant API יש תמיכה בשיטות הבאות להפעלת מבצעים:
- הוספת מבצעים
- לקבלת מבצעים
- הצגת רשימה של מבצעים
השוואה בין הזמינות של שיטות המבצע ב-Content API for Shopping לבין הזמינות ב-Merchant API:
שיטה | Content API for Shopping | ממשק API של Merchant |
---|---|---|
הוספה | כן | כן |
הורדה | כן | כן |
list | כן | כן |
customBatch | לא | לא |
מחיקה | לא | (לא נקבע) |
שם המשאב
בטבלה אפשר לראות אילו שינויים במבצעים ב-Merchant אנחנו API.
כדי לראות דוגמה, ראו מלאי בחנות מקומית.
Content API for Shopping | ממשק API של Merchant | תיאור |
---|---|---|
(לא אפשרי) | custom_attributes |
רשימה של מאפיינים מותאמים אישית (שהמוכר סיפק). אפשר
להשתמש בו גם כדי לשלוח כל מאפיין של מפרט בצורתו הגנרית. לדוגמה: { "name": "size type", "value": "regular" }האפשרות הזו שימושית לשליחת מאפיינים שאינם שנחשפו על ידי ה-API. |
לא נתמכים | data_source | כדי ליצור מבצע צריך להיות מקור נתונים קיים. |
לא נתמכים | מאפיינים |
מאפיינים ספציפיים למבצע, כמו
long_tile, promotion_effective_timeperiod, ואחרים, הם חלק מהודעת המאפיין. |
item_id | item_id_inclusion |
השם של רשימת מזהי הפריטים שעליהם חל המבצע
ישתנה. |
store_id | store_id_inclusion |
השם של רשימת מזהי החנויות שעליהם חל המבצע
ישתנה. |
prduct_type | product_type_inclusion |
השם של רשימת סוגי המוצרים שהמבצע חל עליהם
ישתנה. |
item_group_id | item_group_id_inclusion |
השם של רשימת מזהי קבוצות הפריטים שהמבצע חל עליהם
ישתנה. |
brand | brand_inclusion |
השם של רשימת המותגים שעליהם חל המבצע
ישתנה. |
store_code | store_codes_inclusion |
השם של רשימת קודי החנויות שעליהם חל המבצע
ישתנה. |
price: { object (Price) } |
price: { object (Price) } |
ההגדרה של Price השתנתה.
ב-Content API for Shopping, Price
הסכום ב-Price מתועד עכשיו במיליוניות השנייה,
שם השדה amount השתנה מהערך
ל-
שם השדה currency השתנה ל-
|
order_limit | (לא אפשרי) | המאפיין order_limit לא נתמך. |
shippingServiceNames[] | (לא אפשרי) | אין תמיכה במאפיין shippingServiceNames[]. |
money_budget | (לא אפשרי) | המאפיין money_budget לא נתמך. |
promotion_destination_ids | promotion_destinations | השם של promotionDestinationIds זהה. |
סטטוס המבצע
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
סטטוס המבצע השתנה.
אפשר לקבל פרטים נוספים ברמה מפורטת יותר לגבי הבעיות. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |