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

אתם יכולים להשתמש ב-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.

מקורות נתונים קיימים

אם אתם לא יודעים מהו הערך של accounts.dataSources.name במקורות נתונים קיימים, אתם יכולים להשתמש ב-dataSources.list כדי לאחזר אותו.

אפשרות נוספת היא לזהות את מקור הנתונים של כל אחד מהמבצעים באמצעות השיטה accounts.promotions.get ובדיקת השדה dataSource בתגובה של כל אחד מהמבצעים הקיימים בחשבון.

כדי להפנות אליהם ישירות בקריאות עתידיות ל-API, מומלץ מאוד לאחסן את accounts.dataSources.name במסד הנתונים המקומי שלכם לכל מבצע.

בקשות

כדי לשלוח בקשות, משתמשים בכתובת ה-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}
Methods
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

שינויים בשדה

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

דוגמה להמחשה זמינה ב-accounts.promotions.

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,
    ]
    }
  ]
}
הקודם
Migrate order tracking signals
הבא
Migrate conversion sources management