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

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

סקירה כללית של השינויים מ-Content API for Shopping ל-Merchant API

ההבדל המשמעותי הוא ש-Content API for Shopping יוצר באופן אוטומטי את מקור הנתונים כשמוסיפים את המבצע הראשון, מה שלא קורה עם Merchant API. כדי להוסיף מבצע באמצעות Merchant API, קודם צריך ליצור מקור לנתוני מבצעים. מידע על השדות באובייקט promotionDataSource במשאב accounts.dataSources זמין במאמר PromotionDataSource.

בקשות

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

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

מעבר מ-Content API for Shopping

בהמשך מוצגות השוואות בין Content API for Shopping לבין Merchant Promotions API לבקשות שקשורות למבצעים.

כתובת URL

ב-Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

ב-Merchant API הופך ל:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

מזהים

ב-Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

ב-Merchant API הופך ל:

{NAME}

Methods

‫Merchant API תומך בשיטות הבאות ליצירת מבצעים:

  • הוספת מבצעים
  • קבלת מבצעים
  • הצגת רשימת מבצעים

הטבלה הבאה מציגה השוואה בין שיטות הקידום שזמינות ב-Content API for Shopping וב-Merchant API:

תכונה Content API for Shopping Merchant API
כתובת URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
מזהים {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
שיטות
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

שינויים בשדה

בטבלה מוצגים השינויים שבוצעו ב-Merchant Promotions API.

לדוגמה, אפשר לעיין במלאי בחנויות מקומיות.

Content API for Shopping Merchant API תיאור
(לא נתמך) 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 השם של רשימת מזהי החנויות שאליהן המבצע חל
משתנה.
product_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)
  }
ההגדרה של מחיר השתנתה.

ב-Content API for Shopping, הערך של מחיר
היה מספר עשרוני בפורמט של מחרוזת.

סכום המחיר מתועד עכשיו במיקרו,
כאשר מיליון מיקרו שווה ליחידה הסטנדרטית של המטבע שלכם,
.

שם השדה amount השתנה מ-value ל-
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,
    ]
    }
  ]
}