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

אתם יכולים להשתמש ב-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, הערך של מאפיין המחיר
היה מספר עשרוני בפורמט מחרוזת.

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

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