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

คุณใช้ 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 กับโปรโมชันจากผู้ขาย 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 สำหรับ Shopping และ Merchant API

วิธีการ Content API for Shopping API ผู้ขาย
แทรก ใช่ ใช่
รับ ใช่ ใช่
list ใช่ ใช่
customBatch ไม่ได้ ไม่ได้
ลบ ไม่ได้ (รอการพิจารณา)

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

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

ดูตัวอย่างสำหรับการอ้างอิงได้ที่ท้องถิ่น พื้นที่โฆษณา

Content API for Shopping 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 ล้านไมโครมีค่าเท่ากับสกุลเงินของคุณ
หน่วยมาตรฐาน

ชื่อช่องจำนวนเงินเปลี่ยนจากค่าเป็น
amountMicros

ชื่อช่องสกุลเงินเปลี่ยนเป็น
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,
    ]
    }
  ]
}