คุณใช้ 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 ราคา
ตอนนี้ระบบบันทึกจำนวนราคาเป็นไมโคร
ชื่อช่อง amount เปลี่ยนจากค่าเป็น
ชื่อช่อง currency เปลี่ยนเป็น |
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, ] } ] } |