เราได้เปลี่ยนแปลงวิธีดึงข้อมูลปัญหาระดับบัญชีที่อาจส่งผลต่อผลิตภัณฑ์และ
ประสิทธิภาพของบัญชี เมื่อเทียบกับaccountstatusesใน Content API for Shopping แล้ว Merchant API มีAccountIssue
เฉพาะที่ให้ข้อมูลที่มีโครงสร้างและรายละเอียดมากขึ้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ฟีเจอร์ใหม่ได้ในดูปัญหาเกี่ยวกับบัญชี
ความแตกต่างที่สำคัญ
การปรับปรุงและความแตกต่างที่สำคัญในทรัพยากร Merchant API AccountIssue
มีดังนี้
- แหล่งข้อมูลเฉพาะ: ปัญหาเกี่ยวกับบัญชีเป็นแหล่งข้อมูลของตัวเอง ใน Content
API สำหรับ Shopping ปัญหาระดับบัญชีเป็นฟิลด์ที่ซ้อนกันภายใน
AccountStatusทรัพยากรทั่วไป คุณสามารถแสดงรายการผลิตภัณฑ์เหล่านี้ได้โดยตรงโดยใช้เมธอดaccounts.issues.list - ข้อมูลผลลัพธ์ที่มีโครงสร้าง:
AccountIssueทรัพยากรมีฟิลด์impactedDestinationsโดยละเอียด ฟิลด์นี้จะแสดงรายละเอียดที่ชัดเจนเกี่ยวกับผลกระทบของปัญหา รวมถึงปลายทาง (เช่น โฆษณา Shopping) ภูมิภาคที่เฉพาะเจาะจง และความรุนแรงของปัญหาในภูมิภาคนั้น - ความรุนแรงเป็น Enum: ตอนนี้ฟิลด์
severityเป็น Enum แล้ว (มีค่าต่างๆ เช่นCRITICAL,ERROR,SUGGESTION) ซึ่งทำให้ประมวลผลได้ง่ายขึ้น โดยใช้โปรแกรมเมื่อเทียบกับค่าที่อิงตามสตริงใน Content API สำหรับ Shopping - ตัวระบุมาตรฐาน: ปัญหาระดับบัญชีแต่ละรายการมีทรัพยากรแบบเต็มที่ไม่ซ้ำกัน
nameในรูปแบบaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}แนวทางที่ได้มาตรฐานนี้จะแทนที่idสตริงจาก Content API for Shopping - การรองรับการแปล: วิธี
accounts.issues.listช่วยให้คุณระบุlanguage_codeเพื่อรับรายละเอียดปัญหา เช่น ชื่อและคำอธิบาย ในภาษาที่คุณต้องการได้ ซึ่งทำไม่ได้ใน Content API สำหรับ Shopping - ลักษณะการทำงานของบัญชีขั้นสูง: เมื่อคุณเรียกใช้
accounts.issues.listในบัญชีขั้นสูง ระบบจะแสดงเฉพาะปัญหาที่เกี่ยวข้องกับบัญชีขั้นสูงนั้นโดยตรง แต่จะไม่แสดงปัญหาสำหรับบัญชีย่อย ใน Content API for Shopping เมธอดaccountstatuses.listจะแสดงสถานะของบัญชีย่อยทั้งหมด หากต้องการดูปัญหาสำหรับบัญชีย่อยทั้งหมดใน Merchant API คุณต้องเรียกใช้accounts.listSubaccountsแล้วเรียกใช้accounts.issues.listสำหรับบัญชีย่อยแต่ละบัญชีแยกกัน
คำขอ
ใน Merchant API คุณสามารถแสดงปัญหาของบัญชีสำหรับบัญชี Merchant Center ที่เฉพาะเจาะจงได้
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues
การเปรียบเทียบ URL คำขอ
| รายละเอียดสำหรับคำขอ | Content API for Shopping | Merchant API |
|---|---|---|
| แสดงปัญหาระดับบัญชีสำหรับบัญชีเดียว | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} |
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues |
| แสดงปัญหาระดับบัญชีสำหรับบัญชีย่อยทั้งหมดของบัญชีขั้นสูง | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses |
ไม่พร้อมใช้งาน คุณต้องวนซ้ำผ่านบัญชีย่อย |
รหัสระบุ
ตัวระบุสำหรับบัญชีและปัญหาได้มีการเปลี่ยนแปลงใน Merchant API
การเปรียบเทียบตัวระบุ
| คำอธิบายตัวระบุ | Content API for Shopping | Merchant API |
|---|---|---|
| ตัวระบุบัญชี | {MERCHANT_ID} และ {ACCOUNT_ID} เป็นพารามิเตอร์เส้นทาง |
{ACCOUNT_ID} เป็นพารามิเตอร์เส้นทางในรูปแบบ accounts/{ACCOUNT_ID} |
| ตัวระบุปัญหา | id ในเนื้อหาการตอบกลับ (เช่น "products-that-enable-dishonest-behavior-hacking-policy") |
name ในเนื้อหาการตอบกลับ ซึ่งเป็นชื่อทรัพยากรแบบเต็ม (เช่น accounts/12345/issues/example-issue-id) |
เมธอด
เราได้รวมและลดความซับซ้อนของวิธีการดึงปัญหาเกี่ยวกับบัญชี ใน Merchant API
การเปรียบเทียบวิธีการ
| Content API for Shopping | Merchant API | ความพร้อมใช้งานและหมายเหตุ |
|---|---|---|
accountstatuses.get |
accounts.issues.list |
พร้อมใช้งาน หากต้องการดูปัญหาสำหรับบัญชีเดียว ให้ใช้ accounts.issues.list และระบุรหัสบัญชี API ของผู้ขายไม่มีเมธอด get สำหรับการซื้อเป็นรายฉบับ |
accountstatuses.list |
ไม่มีค่าเทียบเท่าโดยตรง | ไม่พร้อมใช้งาน accounts.issues.list ใน Merchant API จะแสดงปัญหาสำหรับบัญชีที่ระบุเท่านั้น ไม่ใช่บัญชีย่อย หากต้องการรับปัญหาสำหรับบัญชีย่อยทั้งหมด คุณต้องเรียกใช้ accounts.listSubaccounts ก่อน แล้วจึงเรียกใช้ accounts.issues.list สำหรับบัญชีย่อยแต่ละบัญชี |
accountstatuses.custombatch |
ไม่มีค่าเทียบเท่าโดยตรง | ไม่พร้อมใช้งาน Merchant API ไม่รองรับการประมวลผลแบบเป็นชุดสำหรับปัญหาเกี่ยวกับบัญชี คุณต้องlistโทรแยกกันสำหรับแต่ละบัญชี |
การเปลี่ยนแปลงช่องโดยละเอียด
เราได้อัปเดตฟิลด์ภายในแหล่งข้อมูลปัญหาเกี่ยวกับบัญชีเพื่อให้มีโครงสร้างและความชัดเจนมากขึ้น
การเปรียบเทียบฟิลด์
| Content API for Shopping | Merchant API | คำอธิบาย |
|---|---|---|
accountLevelIssues (อาร์เรย์ใน AccountStatus) |
accountIssues (อาร์เรย์ใน ListAccountIssuesResponse) |
ตอนนี้ปัญหาเป็นทรัพยากรเฉพาะระดับบนสุด ไม่ใช่ฟิลด์ที่ซ้อนกัน |
id (สตริง) |
name (สตริง) |
ตอนนี้ตัวระบุปัญหาคือชื่อทรัพยากรแบบเต็ม เช่น accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} |
title (สตริง) |
title (สตริง) |
ไม่มีการเปลี่ยนแปลง |
detail (สตริง) |
detail (สตริง) |
ไม่มีการเปลี่ยนแปลง |
documentation (สตริง) |
documentationUri (สตริง) |
เปลี่ยนชื่อฟิลด์เพื่อความชัดเจนเพื่อระบุว่าเป็น URL |
severity (สตริง) |
severity (enum) |
ตอนนี้ความรุนแรงเป็น enum ที่มีโครงสร้าง (CRITICAL, ERROR, SUGGESTION) แทนที่จะเป็นสตริง |
country (string), destination (string) |
impactedDestinations (ข้อความที่ซ้ำกัน) |
ตอนนี้เราได้จัดโครงสร้างผลกระทบเป็นรายการ โดยจัดกลุ่มจุดหมาย ภูมิภาค และความรุนแรงของแต่ละพื้นที่ที่ได้รับผลกระทบ ช่อง country จะแทนที่ด้วย regionCode ภายในข้อความ Impact |
| (ไม่สามารถใช้ได้) | language_code, time_zone (พารามิเตอร์คำขอ) |
พารามิเตอร์ใหม่ในคำขอ list ช่วยให้แปลฟิลด์ที่อ่านได้ เช่น title และ detail |