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