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

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

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

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