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

אתם יכולים להשתמש ב-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/v1beta/{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/v1beta/{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/v1beta/{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, השדה Price
היה מספר עשרוני בצורת מחרוזת.

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

שם השדה 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,
    ]
    }
  ]
}