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