วิธีดึงข้อมูลสถิติและปัญหาเกี่ยวกับผลิตภัณฑ์แบบรวมมีการเปลี่ยนแปลง ฟังก์ชันการทำงานที่ก่อนหน้านี้พร้อมใช้งานในทรัพยากร accountstatuses ใน Content API for Shopping ได้แยกออกเป็นทรัพยากรเฉพาะใน Merchant API แล้ว คู่มือนี้อธิบายวิธีย้ายข้อมูลการผสานรวมเพื่อใช้ทรัพยากร aggregateProductStatuses ใหม่
ความแตกต่างที่สำคัญ
ความแตกต่างที่สำคัญระหว่างฟีเจอร์สถานะผลิตภัณฑ์ใน Content API สำหรับ Shopping กับ Merchant API มีดังนี้
- แหล่งข้อมูลเฉพาะ: ตอนนี้แหล่งข้อมูล
accountstatusesจาก Content API for Shopping ได้แยกออกจากกันแล้ว ใน Merchant API ปัญหาระดับบัญชีจะพร้อมใช้งานผ่านทรัพยากรaccountissuesส่วนสถิติผลิตภัณฑ์ที่รวบรวมและปัญหาระดับสินค้าจะพร้อมใช้งานผ่านทรัพยากรaggregateProductStatusesใหม่ - โครงสร้างทรัพยากรใหม่:
AggregateProductStatusเป็นทรัพยากรใหม่ที่แสดงสถิติและปัญหาสำหรับชุดค่าผสมเฉพาะของบริบทการรายงานและประเทศ - กลไกการกรอง: แทนที่จะใช้พารามิเตอร์การค้นหา เช่น
destinationsเพื่อเลือกข้อมูล Merchant API จะใช้เมธอดlistกับสตริงfilterเพื่อค้นหาบริบทการรายงานและประเทศที่เฉพาะเจาะจง - การนำฟิลด์ช่องออก: ไม่มีการใช้ฟิลด์
channelอีกต่อไป ตอนนี้ข้อมูลนี้เป็นส่วนหนึ่งของreportingContextโดยนัย
คำขอ
Merchant API ใช้คำขอ GET ที่มีพารามิเตอร์ filter เพื่อดึงข้อมูลสถานะผลิตภัณฑ์ที่รวบรวมไว้ ดูข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับไวยากรณ์ของตัวกรองได้ที่ไวยากรณ์ของตัวกรอง
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
รูปแบบ URL คำขอ
| รายละเอียดสำหรับคำขอ | Content API for Shopping | Merchant API |
|---|---|---|
| ดูสถิติและปัญหาเกี่ยวกับผลิตภัณฑ์ | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
รหัสระบุ
วิธีระบุทรัพยากรมีการเปลี่ยนแปลงเพื่อรองรับโครงสร้างใหม่
รูปแบบตัวระบุ
| คำอธิบายตัวระบุ | Content API for Shopping | Merchant API |
|---|---|---|
| ตัวระบุทรัพยากร | accountId เป็นผู้ระบุทรัพยากร เลือกส่วนข้อมูลที่เฉพาะเจาะจงด้วยพารามิเตอร์การค้นหา |
ชื่อทรัพยากรจะระบุข้อมูลสำหรับบริบทการรายงานและประเทศที่เฉพาะเจาะจงโดยไม่ซ้ำกัน: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} |
เมธอด
เราได้อัปเดตวิธีดึงข้อมูลสถานะผลิตภัณฑ์เป็นวิธี list ที่รองรับการกรอง
| วิธีการใช้ Content API for Shopping | เมธอด Merchant API | ความพร้อมใช้งานและหมายเหตุ |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
เมธอด accountstatuses.get แสดงผลทรัพยากรเดียวที่มีสถิติสินค้าทั้งหมด เมธอด aggregateProductStatuses.list ใหม่จะแสดงรายการทรัพยากร โดยแสดง 1 รายการสำหรับบริบทการรายงานและชุดค่าผสมของประเทศแต่ละชุด ใช้พารามิเตอร์ filter เพื่อดึงข้อมูลที่เฉพาะเจาะจง สำหรับปัญหาระดับบัญชี ให้ใช้ accountissues.list |
การเปลี่ยนแปลงฟิลด์โดยละเอียด
ช่องสำหรับสถิติและปัญหาเกี่ยวกับผลิตภัณฑ์ได้รับการอัปเดตและปรับโครงสร้างใหม่ในทรัพยากร AggregateProductStatus ใหม่
| Content API for Shopping | Merchant API | คำอธิบาย |
|---|---|---|
products |
aggregate_product_statuses |
ระบบจะแทนที่อาร์เรย์ products ด้วยฟิลด์ที่ซ้ำได้ aggregate_product_statuses ในการตอบกลับรายการ |
destination |
reporting_context |
ฟิลด์ destination จะแทนที่ด้วย reporting_context ซึ่งระบุบริบทของโปรแกรมสำหรับสถิติ |
channel |
(ไม่มีช่องที่เทียบเท่า) | ระบบจะนำช่อง channel ออก ตอนนี้ข้อมูลนี้เป็นส่วนหนึ่งของ reporting_context แล้ว |
statistics |
stats |
เปลี่ยนชื่อออบเจ็กต์ statistics เป็น stats แล้ว ชื่อฟิลด์ภายในจะแปลงเป็น snake_case เช่น activeCount จะเป็น active_count |
itemLevelIssues.servability |
item_level_issues.severity |
ระบบจะแทนที่ enum servability ด้วย enum severity เพื่ออธิบายผลกระทบของปัญหา |
itemLevelIssues.attributeName |
item_level_issues.attribute |
ระบบจะเปลี่ยนชื่อช่อง attributeName เป็น attribute |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
ระบบจะเปลี่ยนชื่อช่อง documentation เป็น documentation_uri |
itemLevelIssues.numItems |
item_level_issues.product_count |
ระบบจะเปลี่ยนชื่อช่อง numItems เป็น product_count |