วิธีดึงสถิติและปัญหาเกี่ยวกับผลิตภัณฑ์ที่รวบรวมไว้ได้เปลี่ยนไปแล้ว ฟังก์ชันการทำงานที่ก่อนหน้านี้มีอยู่ในแหล่งข้อมูล accountstatuses ใน Content API for Shopping ตอนนี้แยกออกเป็นแหล่งข้อมูลเฉพาะใน Merchant API แล้ว คู่มือนี้อธิบายวิธีย้ายข้อมูลการผสานรวมเพื่อใช้ทรัพยากร aggregateProductStatuses
ใหม่
ความแตกต่างที่สำคัญ
ความแตกต่างที่สำคัญระหว่างฟีเจอร์สถานะผลิตภัณฑ์ใน Content API for Shopping กับ Merchant API มีดังนี้
- แหล่งข้อมูลเฉพาะ: ตอนนี้ระบบได้แยกแหล่งข้อมูล
accountstatusesจาก Content API for Shopping แล้ว ใน Merchant API ปัญหาระดับบัญชีจะพร้อมใช้งานผ่านแหล่งข้อมูลaccountissuesขณะที่สถิติผลิตภัณฑ์รวมและปัญหาระดับสินค้าจะพร้อมใช้งานผ่านแหล่งข้อมูลใหม่aggregateProductStatuses - โครงสร้างทรัพยากรใหม่:
AggregateProductStatusเป็นทรัพยากรใหม่ที่ แสดงสถิติและปัญหาสำหรับบริบทการรายงานและประเทศที่เฉพาะเจาะจง - กลไกการกรอง: Merchant API ใช้เมธอด
listที่มีสตริงfilterเพื่อค้นหาบริบทการรายงานและประเทศที่เฉพาะเจาะจง แทนที่จะใช้พารามิเตอร์การค้นหา เช่นdestinationsเพื่อเลือกข้อมูล - การนำฟิลด์ช่องออก: เราไม่ได้ใช้ฟิลด์
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 |
ระบบจะแทนที่ servability enum ด้วย severity enum เพื่ออธิบายผลกระทบของปัญหา |
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 |