ย้ายข้อมูลการจัดการโปรโมชัน

คุณสามารถใช้ Merchant Promotions API เพื่อสร้างและจัดการโปรโมชันใน Google แหล่งข้อมูลนี้ช่วยให้คุณแสดงข้อเสนอพิเศษสำหรับผลิตภัณฑ์ที่ขายบน Google ได้accounts.promotions ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ Merchant Promotions API

คำขอ

หากต้องการส่งคำขอ ให้ใช้ URL ต่อไปนี้

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

ย้ายข้อมูลจาก Content API for Shopping

ข้อมูลต่อไปนี้เปรียบเทียบ Content API for Shopping กับ Merchant Promotions API สำหรับคำขอที่เกี่ยวข้องกับโปรโมชัน

URL

เปลี่ยน URL ตามที่แสดงสําหรับการติดตั้งใช้งานในตารางต่อไปนี้

Content API for Shopping Merchant API คำอธิบาย
https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions URL ปลายทางมีการเปลี่ยนแปลง

รหัสระบุ

เปลี่ยนตัวระบุตามที่แสดงสําหรับการติดตั้งใช้งานในตารางต่อไปนี้

Content API for Shopping Merchant API
{MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
countryCode เมธอด promotions.list ไม่รองรับ countryCode หากต้องการกรอง ให้ใช้การรายงาน Merchant API โดยเฉพาะ promotion_view
languageCode เมธอด promotions.list ไม่รองรับ languageCode หากต้องการกรอง ให้ใช้การรายงาน Merchant API โดยเฉพาะ promotion_view

เมธอด

Merchant API รองรับวิธีการต่อไปนี้สำหรับโปรโมชัน

  • แทรกโปรโมชัน
  • รับโปรโมชัน
  • แสดงโปรโมชัน

การเปรียบเทียบความพร้อมใช้งานของวิธีการโปรโมตใน Content API for Shopping และ Merchant API มีดังนี้

วิธีการ Content API for Shopping Merchant API
แทรก ใช่ ใช่
get ใช่ ใช่
list ใช่ ใช่
customBatch ไม่ ไม่
ลบ ไม่ (รอกำหนด)

ชื่อทรัพยากร

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงสำหรับโปรโมชัน

ดูตัวอย่างเพื่อใช้เป็นข้อมูลอ้างอิงได้ที่สินค้าคงคลังในร้าน

Content API for Shopping Merchant API คำอธิบาย
(ไม่สนับสนุน) custom_attributes รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) คุณยังใช้รูปแบบนี้เพื่อส่งแอตทริบิวต์ของข้อกําหนดฟีด
ในรูปแบบทั่วไปได้ด้วย

เช่น 
{
  "name": "size type", "value": "regular"
}
ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน
ไม่รองรับ data_source การสร้างโปรโมชันต้องใช้แหล่งข้อมูลที่มีอยู่
ไม่รองรับ attributes แอตทริบิวต์ที่เฉพาะเจาะจงสำหรับโปรโมชัน เช่น
long_tile, promotion_effective_timeperiod,
และอื่นๆ จะเป็นส่วนหนึ่งของข้อความแอตทริบิวต์
item_id item_id_inclusion เปลี่ยนชื่อรายการรหัสสินค้าที่โปรโมชันใช้
store_id store_id_inclusion เปลี่ยนชื่อรายการรหัสร้านค้าที่ใช้โปรโมชัน
prduct_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
คือตัวเลขทศนิยมในรูปแบบสตริง

ตอนนี้ระบบจะบันทึกจำนวนราคาเป็นหน่วยไมโคร โดยที่
1 ล้านหน่วยไมโครมีค่าเท่ากับหน่วยมาตรฐาน
ของสกุลเงิน

ชื่อช่อง amount เปลี่ยนจาก value เป็น
amountMicros

ชื่อช่อง currency เปลี่ยนเป็น
currencyCode รูปแบบจะยังคงเป็น
ISO 4217 (วิกิพีเดีย)

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,
    ]
    }
  ]
}