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

אפשר להשתמש ב-Merchant Promotion API כדי ליצור ולנהל מבצעים Google. accounts.promotions משאב מאפשר לכם להציג מבצעים מיוחדים על המוצרים שאתם מוכרים ב-Google. מידע נוסף זמין בקטע סקירה כללית של קידום מכירות מוצרים API.

בקשות

כדי לשלוח בקשות, צריך להשתמש בכתובת ה-URL הבאה.

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

מעבר מ-Content API for Shopping

בטבלה הבאה ניתן לראות השוואה בין Content API for Shopping לבין התכונה 'קידום מכירות מוצרים' 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 עבור שופינג ו-Merchant API:

שיטה Content API for Shopping ממשק API של Merchant
הוספה כן כן
הורדה כן כן
list כן כן
customBatch לא לא
מחיקה לא (לא נקבע)

שם המשאב

בטבלה אפשר לראות אילו שינויים במבצעים ב-Merchant אנחנו API.

אפשר לראות דוגמה לעיון, ב-Local מלאי.

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