ย้ายข้อมูลจาก accountstatuses ไปยัง Account Issues

เราได้เปลี่ยนแปลงวิธีดึงข้อมูลปัญหาระดับบัญชีที่อาจส่งผลต่อผลิตภัณฑ์และ ประสิทธิภาพของบัญชี เมื่อเทียบกับaccountstatusesใน Content API for Shopping แล้ว Merchant API มีAccountIssue เฉพาะที่ให้ข้อมูลที่มีโครงสร้างและรายละเอียดมากขึ้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ฟีเจอร์ใหม่ได้ในดูปัญหาเกี่ยวกับบัญชี

หมายเหตุ: ใน Merchant API ปัญหาที่ระดับบัญชีและสถานะผลิตภัณฑ์รวม จะแยกกัน นอกจากนี้ โปรดอ่านคู่มือการย้ายข้อมูลจาก accountstatuses ไปยังสถานะผลิตภัณฑ์รวม

ความแตกต่างที่สำคัญ

การปรับปรุงและความแตกต่างที่สำคัญในAccountIssue แหล่งข้อมูล Merchant API มีดังนี้

  • แหล่งข้อมูลเฉพาะ: ปัญหาเกี่ยวกับบัญชีเป็นแหล่งข้อมูลของตัวเอง ใน 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/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 และระบุรหัสบัญชี 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
ก่อนหน้า
Overview
ถัดไป
Migrate accountstatuses to Aggregate Product Statuses