ย้ายข้อมูลสถานะบัญชีไปยังสถานะผลิตภัณฑ์รวม

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