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

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

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

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

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

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

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