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