ย้ายข้อมูลการจัดการบัญชี

Accounts API แบ่งออกเป็นคอลเล็กชันของทรัพยากรเพื่อให้จัดการบัญชี Merchant Center ได้อย่างมีประสิทธิภาพมากขึ้นด้วยการควบคุมที่แม่นยำยิ่งขึ้นในด้านต่างๆ ของบัญชี

คู่มือนี้จะอธิบายการเปลี่ยนแปลงที่สำคัญและช่วยคุณย้ายข้อมูลการผสานรวมการจัดการบัญชีที่มีอยู่จาก Content API for Shopping ไปยัง Merchant API

จากแหล่งข้อมูลเดียวไปสู่แหล่งข้อมูลมากมาย

ใน Content API for Shopping ทรัพยากร Account เป็นออบเจ็กต์แบบโมโนลิธิกที่มีทุกอย่างตั้งแต่ชื่อบัญชีและ URL ของเว็บไซต์ไปจนถึงรายชื่อผู้ใช้และข้อมูลทางธุรกิจ

Merchant API จะแบ่งข้อมูลนี้ออกเป็นทรัพยากรขนาดเล็กที่เจาะจงมากขึ้นหลายรายการ การเปลี่ยนแปลงนี้ช่วยให้การเรียก API มีการกำหนดเป้าหมายและมีประสิทธิภาพมากขึ้น ตัวอย่างเช่น หากต้องการอัปเดตเฉพาะที่อยู่ธุรกิจ ตอนนี้คุณสามารถส่งคำขอ PATCH ไปยังทรัพยากร BusinessInfo แทนการอัปเดตออบเจ็กต์ Account ทั้งหมดได้

ต่อไปนี้เป็นสรุปวิธีแมปแนวคิดจากแหล่งข้อมูล Content API for Shopping Account กับแหล่งข้อมูลใหม่ใน Merchant API

ความสามารถใหม่ๆ

นอกจากนี้ Merchant API ยังเปิดตัวความสามารถใหม่ๆ สำหรับการจัดการบัญชีที่ไม่มีใน Content API for Shopping ดังนี้

  • ข้อกำหนดในการให้บริการ: ดึงข้อมูลและยอมรับข้อกำหนดในการให้บริการแบบเป็นโปรแกรมโดยใช้ทรัพยากร TermsOfService และ TermsOfServiceAgreementState
  • การสร้างบัญชี: ตอนนี้เมธอด accounts.createAndConfigure รองรับการสร้างบัญชีที่มีความสัมพันธ์ (เช่น accountManagement) การตั้งค่า alias และการระงับการยืนยันอีเมลโดยใช้ช่อง user.verificationMailSettings.verificationMailMode เพื่อสนับสนุนการยืนยันตาม API โดยใช้เมธอด accounts.verifySelf ใหม่
  • การเข้าถึงบัญชีด้วยชื่อแทน: เข้าถึงบัญชีโดยใช้รูปแบบ providerId~accountAlias ซึ่งเป็นวิธีที่สอดคล้องกันสำหรับธุรกิจที่จัดการหลายบัญชีเพื่อใช้ตัวระบุบัญชีของตนเอง

คำขอ

ตารางนี้แสดงการเปรียบเทียบ URL คำขอแบบรวมสำหรับงานการจัดการบัญชีทั่วไป ระหว่าง Content API for Shopping กับ Merchant API

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
รับบัญชี GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
รับบัญชีตามชื่อแทน ไม่พร้อมใช้งานโดยตรง GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
แสดงรายการบัญชีย่อย GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
สร้างบัญชีย่อย POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
อัปเดตข้อมูลบัญชี PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCHในแหล่งข้อมูลที่เหมาะสม เช่น หากต้องการอัปเดตชื่อบัญชี ให้ใช้ PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
ลบบัญชีย่อย DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
อ้างสิทธิ์เว็บไซต์ POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
ลิงก์บัญชี POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

จัดการข้อมูลบัญชีหลัก

ทรัพยากร Account ใน Merchant API มีรายละเอียดที่สำคัญของบัญชี Merchant Center เช่น ชื่อ รหัส และการตั้งค่าพื้นฐาน

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
ดูรายละเอียดบัญชี GET /content/v2.1/{merchantId}/accounts/{accountId} (การเข้าถึงแอตทริบิวต์หลัก เช่น name, adult_content) GET /accounts/v1/accounts/{account}
สร้างบัญชีย่อย POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
อัปเดตรายละเอียดบัญชี PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์หลัก) PATCH /accounts/v1/accounts/{account}
ลบบัญชีย่อย DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (Account) Merchant API (Account) หมายเหตุ
id account_id ตอนนี้รหัสที่เป็นตัวเลขจะเป็นช่องแบบเอาต์พุตเท่านั้น ตัวระบุหลักคือทรัพยากร name
name account_name ชื่อบัญชีที่มนุษย์อ่านได้
language language_code ชื่อฟิลด์ตอนนี้คือ language_code

จัดการข้อมูลทางธุรกิจ

ใช้ทรัพยากร BusinessInfo เพื่อจัดการข้อมูลสาธารณะเกี่ยวกับธุรกิจ เช่น ที่อยู่และข้อมูลติดต่อของฝ่ายบริการลูกค้า ซึ่งจะแทนที่ออบเจ็กต์ businessInformation ใน Content API for Shopping

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
ดูข้อมูลทางธุรกิจ GET /content/v2.1/{merchantId}/accounts/{accountId} (การเข้าถึงแอตทริบิวต์ business_information) GET /accounts/v1/accounts/{account}/businessInfo
อัปเดตข้อมูลทางธุรกิจ PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (business_information) Merchant API (BusinessInfo) หมายเหตุ
phone_number phone ตอนนี้สนามเป็น phone และใช้ google.type.PhoneNumber
customer_service.url customer_service.uri ชื่อฟิลด์ตอนนี้คือ uri

จัดการหน้าแรกของคุณ

หากต้องการจัดการ URL ของเว็บไซต์ของร้านค้า รวมถึงทำการยืนยันและอ้างสิทธิ์ ให้ใช้ทรัพยากร Homepage ซึ่งจะแทนที่ฟิลด์ websiteUrl และเมธอด accounts.claimwebsite จาก Content API for Shopping

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
รับ URL ของหน้าแรก GET /content/v2.1/{merchantId}/accounts/{accountId} (การเข้าถึงแอตทริบิวต์ website_url) GET /accounts/v1/accounts/{account}/homepage
อัปเดต URL ของหน้าแรก PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ website_url) PATCH /accounts/v1/accounts/{account}/homepage
หน้าแรกของการอ้างสิทธิ์ POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
ถอนการอ้างสิทธิ์หน้าแรก ไม่พร้อมใช้งาน POST /accounts/v1/accounts/{account}/homepage:unclaim

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (Account) Merchant API (Homepage) หมายเหตุ
website_url uri URL ของหน้าแรกของร้านค้า
ไม่พร้อมใช้งานโดยตรง claimed ช่องบูลีนที่มีค่าเป็น true หากมีการอ้างสิทธิ์หน้าแรก

จัดการผู้ใช้

ทรัพยากร User ช่วยให้คุณจัดการผู้ที่มีสิทธิ์เข้าถึงบัญชี Merchant Center ได้ ซึ่งจะแทนที่อาร์เรย์ users ภายในทรัพยากร Account ความแตกต่างที่สำคัญคือกระบวนการสร้างผู้ใช้ ใน Merchant API การเพิ่มผู้ใช้จะเป็นการส่งคำเชิญ ผู้ใช้ต้องยอมรับคำเชิญก่อนจึงจะเข้าถึงบัญชีได้

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
สร้างรายการผู้ใช้ GET /content/v2.1/{merchantId}/accounts/{accountId} (การเข้าถึงแอตทริบิวต์ users) GET /accounts/v1/accounts/{account}/users
สร้างผู้ใช้ PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ users) POST /accounts/v1/accounts/{account}/users
อัปเดตผู้ใช้ PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ users) PATCH /accounts/v1/accounts/{account}/users/{email}
ลบผู้ใช้ PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ users) DELETE /accounts/v1/accounts/{account}/users/{email}

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (ออบเจ็กต์อาร์เรย์ users) Merchant API (แหล่งข้อมูล User) หมายเหตุ
email_address name (ในรูปแบบ accounts/{account}/users/{email}) ตอนนี้อีเมลของผู้ใช้เป็นส่วนหนึ่งของชื่อทรัพยากรแล้ว
admin, order_manager, reporting_manager ฯลฯ access_rights ตอนนี้สิทธิ์การเข้าถึงจะรวมอยู่ในช่อง enum ที่ซ้ำกัน
ไม่พร้อมใช้งาน state ช่องเอาต์พุตเท่านั้นใหม่ที่ระบุว่าผู้ใช้เป็น PENDING หรือ VERIFIED

จัดการความสัมพันธ์และบริการของบัญชี

ใน Content API for Shopping ระบบจะจัดการความสัมพันธ์ด้วย accounts.link Merchant API มีโมเดลที่ชัดเจนยิ่งขึ้นด้วยทรัพยากร AccountService และ AccountRelationship ซึ่งต้องใช้กระบวนการแฮนด์เชค (เสนอและยอมรับ)

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
ลิงก์บัญชี POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
แสดงรายการบัญชีที่ลิงก์ GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships และ GET /accounts/v1/accounts/{account}/services

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) หมายเหตุ
linked_account_id provider (ใน AccountService) รหัสของบัญชีที่ให้บริการ
service service_type (ใน AccountService) ประเภทของบริการที่มีให้ (เช่น ACCOUNT_AGGREGATION)
status handshake.approval_state (ใน AccountService) สถานะของลิงก์ (เช่น PENDING, ESTABLISHED)

การตั้งค่าภาษีของบัญชี

บริการ accounttax จาก Content API for Shopping ไม่พร้อมใช้งานใน Merchant API คุณไม่จำเป็นต้องระบุภาษีการขายในสหรัฐอเมริกาอีกต่อไป ดูข้อมูลเพิ่มเติมได้ที่การปรับปรุงข้อกำหนดในการจัดทำข้อมูลสินค้า Merchant Center ปี 2025

จัดการอัตลักษณ์ของธุรกิจ

ใช้ทรัพยากร BusinessIdentity เพื่อประกาศแอตทริบิวต์เกี่ยวกับธุรกิจของคุณด้วยตนเอง ซึ่งจะมาแทนที่ออบเจ็กต์ businessIdentity ใน Content API for Shopping

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
รับข้อมูลระบุตัวตนของธุรกิจ GET /content/v2.1/{merchantId}/accounts/{accountId} (การเข้าถึงแอตทริบิวต์ business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
อัปเดตข้อมูลระบุตัวตนของธุรกิจ PUT /content/v2.1/{merchantId}/accounts/{accountId} (การอัปเดตแอตทริบิวต์ business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

การเปรียบเทียบฟิลด์โดยละเอียด

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) หมายเหตุ
black_owned.self_identified (บูลีน) black_owned.identity_declaration (enum) บูลีนจะถูกแทนที่ด้วย enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) เพื่อให้ประกาศได้ชัดเจนยิ่งขึ้น ซึ่งจะมีผลกับแอตทริบิวต์ข้อมูลประจำตัวทั้งหมด
include_for_promotions (บูลีน) promotions_consent (enum) บูลีนส่วนกลางจะถูกแทนที่ด้วย enum ที่สื่อความหมายมากขึ้น (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED)

แสดงรายการบัญชี

ใน Content API for Shopping บัญชีขั้นสูงประเภทเดียวคือ "บัญชีหลายลูกค้า (MCA)" และแสดงเมธอด accounts.list เพื่อแสดงรายการบัญชีของบัญชีหลายลูกค้าที่ระบุ บัญชีขั้นสูงใน Merchant API มีประสิทธิภาพมากกว่ามาก โดยรองรับประเภทบัญชีและความสัมพันธ์ที่หลากหลายมากขึ้น เพื่อให้การย้ายข้อมูลสำหรับบัญชีขั้นสูงเป็นไปอย่างราบรื่น Merchant API จึงมีเมธอด accounts.listSubaccounts ที่เทียบเท่ากับ accounts.list ของ Content API for Shopping โดยตรง เราขอแนะนําเมธอด accounts.list ใหม่ที่มีประสิทธิภาพมากขึ้น ซึ่งช่วยให้กรองบัญชีขั้นสูงได้

ขอการเปรียบเทียบ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
แสดงรายการบัญชีของบัญชีขั้นสูง GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
แสดงรายการบัญชีทั้งหมดที่เข้าถึงได้ ไม่พร้อมใช้งาน GET /accounts/v1/accounts

การเปรียบเทียบฟิลด์โดยละเอียด (พารามิเตอร์คำขอ)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) หมายเหตุ
merchant_id (พารามิเตอร์เส้นทาง) provider (พารามิเตอร์เส้นทาง) รหัสของบัญชีขั้นสูงในรูปแบบ accounts/{account}
max_results page_size จำนวนบัญชีสูงสุดที่จะแสดงผล
ก่อนหน้า
Refactor code for concurrent requests
ถัดไป
Migrate accountstatuses to Account Issues