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

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

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

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

ใน Content API for Shopping Account เป็นออบเจ็กต์แบบ Monolithic ที่มีทุกอย่างตั้งแต่ชื่อบัญชีและ 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 resource) หมายเหตุ
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.list ของ Content API for Shopping โดยตรง ในรูปแบบเมธอด accounts.listSubaccounts เพื่อให้การย้ายข้อมูลสำหรับบัญชีขั้นสูงเป็นไปอย่างราบรื่น เราขอแนะนำวิธี 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