เราได้เปลี่ยนวิธีเรียกข้อมูลปัญหาที่ส่งผลต่อผลิตภัณฑ์และคุณภาพของบัญชีในระดับบัญชี เมื่อเทียบกับทรัพยากร accountstatuses ใน Content API สำหรับ Shopping แล้ว Merchant API จะเปิดตัวทรัพยากร AccountIssue โดยเฉพาะซึ่งให้ข้อมูลที่มีโครงสร้างและรายละเอียดมากขึ้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ฟีเจอร์ใหม่ได้ในคู่มือการดูปัญหาเกี่ยวกับบัญชี
หมายเหตุ: ใน Merchant API ปัญหาระดับบัญชีและสถานะสินค้าโดยรวมจะแยกกัน นอกจากนี้ โปรดอ่านคู่มือการย้ายข้อมูลจาก accountstatuses ไปยังสถานะผลิตภัณฑ์แบบรวม
ความแตกต่างที่สำคัญ
การปรับปรุงและความแตกต่างที่สำคัญในแหล่งข้อมูล AccountIssue ของ Merchant API มีดังนี้
- แหล่งข้อมูลเฉพาะ: ปัญหาเกี่ยวกับบัญชีมีแหล่งข้อมูลของตนเอง ใน Content API for Shopping ปัญหาระดับบัญชีเป็นช่องที่ฝังอยู่ภายในทรัพยากร
AccountStatusทั่วไป Merchant API ช่วยให้คุณแสดงผลิตภัณฑ์ได้โดยตรงโดยใช้เมธอดaccounts.issues.list - ข้อมูลผลกระทบแบบมีโครงสร้าง: ทรัพยากร
AccountIssueมีช่องimpactedDestinationsที่ให้รายละเอียด ช่องนี้จะแสดงรายละเอียดที่ชัดเจนเกี่ยวกับผลกระทบของปัญหา รวมถึงปลายทาง (เช่น โฆษณา Shopping) ภูมิภาคที่เฉพาะเจาะจง และความรุนแรงของปัญหาในภูมิภาคนั้น - ความรุนแรงเป็น Enum: ตอนนี้ช่อง
severityเป็น Enum (ที่มีค่าต่างๆ เช่นCRITICAL,ERROR,SUGGESTION) ซึ่งช่วยให้ประมวลผลแบบเป็นโปรแกรมได้ง่ายขึ้นเมื่อเทียบกับค่าที่อิงตามสตริงใน Content API for Shopping - ตัวระบุมาตรฐาน: ปัญหาเกี่ยวกับบัญชีแต่ละรายการจะมีทรัพยากรแบบเต็มที่ไม่ซ้ำกัน
nameในรูปแบบaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}แนวทางที่เป็นมาตรฐานนี้จะแทนที่สตริงidจาก Content API for Shopping - การรองรับการแปลภาษา: เมธอด
accounts.issues.listช่วยให้คุณระบุlanguage_codeเพื่อรับรายละเอียดปัญหา เช่น ชื่อและคำอธิบาย ในภาษาที่ต้องการได้ ซึ่งไม่สามารถทำได้ใน Content API for 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/v1/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/v1/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 และระบุรหัสบัญชี Merchant 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 (สตริง), destination (สตริง) |
impactedDestinations (ข้อความซ้ำ) |
ตอนนี้ผลกระทบจะจัดโครงสร้างเป็นรายการ โดยจัดกลุ่มปลายทาง ภูมิภาค และความรุนแรงสำหรับแต่ละพื้นที่ที่ได้รับผลกระทบ ระบบจะแทนที่ช่อง country ด้วย regionCode ภายในข้อความ Impact |
| (ไม่สามารถใช้ได้) | language_code, time_zone (พารามิเตอร์คำขอ) |
พารามิเตอร์ใหม่ในคำขอ list ช่วยให้สามารถแปลช่องที่มนุษย์อ่านได้ เช่น title และ detail |