העברת ניהול מבצעים

תוכלו להשתמש ב-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 השתנה מהערך ל-
amountMicros..

שם השדה currency השתנה ל-
currencyCode. הפורמט נשאר
ISO 4217. (Wikipedia)

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,
    ]
    }
  ]
}