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

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

คำขอ

หากต้องการส่งคำขอ ให้ใช้ 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/{merchantId}/promotions

ใน Merchant API จะกลายเป็น

https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

ตัวระบุ

ใน Content API for Shopping ให้ทำดังนี้

{merchantId}/promotions/{promotionId}

ใน Merchant API จะกลายเป็น

{name}

วิธีการ

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

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

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

วิธีการ API เนื้อหาสำหรับช็อปปิ้ง API ผู้ขาย
แทรก ได้ ได้
รับ ได้ ได้
list ได้ ได้
customBatch ไม่ได้ ไม่ได้
ลบ ไม่ได้ (รอการพิจารณา)

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

ตารางแสดงการเปลี่ยนแปลงสำหรับโปรโมชันใน API โปรโมชันจากผู้ขาย

หากต้องการดูตัวอย่างสำหรับการอ้างอิง โปรดดูที่สินค้าคงคลังในร้าน

API เนื้อหาสำหรับช็อปปิ้ง 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 กำลังเปลี่ยนชื่อรายการรหัสร้านค้าที่ใช้โปรโมชัน
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 ราคา
คือตัวเลขทศนิยมในรูปแบบสตริง

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

ชื่อช่อง amount เปลี่ยนจากค่าเป็น
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,
    ]
    }
  ]
}