ย้ายข้อมูลการลิงก์บัญชี

การจัดการความสัมพันธ์ของบัญชีได้พัฒนาจากlinkวิธีเดียว ใน Content API for Shopping ไปเป็นระบบที่ละเอียดยิ่งขึ้นและชัดเจนมากขึ้นใน Merchant API API ใหม่ใช้ทรัพยากรเฉพาะ เช่น AccountRelationship และ AccountService เพื่อกำหนดบริการที่เฉพาะเจาะจงซึ่งบัญชีหนึ่งมอบให้ อีกบัญชีหนึ่ง โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อ ความสัมพันธ์ระหว่างบัญชี

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

  • แหล่งข้อมูลเฉพาะสำหรับความสัมพันธ์และบริการ: ใน Merchant API แหล่งข้อมูล AccountRelationship จะกำหนดการเชื่อมต่อระหว่างผู้ให้บริการ และผู้ขาย ส่วนแหล่งข้อมูล AccountService จะระบุ บริการที่ให้บริการอย่างชัดเจน (เช่น accountAggregation) ซึ่งจะแทนที่ฟิลด์ linkType และ services ทั่วไปจาก Content API for Shopping
  • เมธอดการดำเนินการที่ชัดเจน: Merchant API ใช้เมธอดที่แตกต่างกันในการจัดการบริการ เช่น propose, approve และ reject แทนที่จะใช้เมธอด link เดียวที่มีพารามิเตอร์ action
  • การลิงก์ Google Business Profile โดยเฉพาะ: การลิงก์กับ Google Business Profile ซึ่งก่อนหน้านี้จัดการโดยการตั้งค่าฟิลด์ googleMyBusinessLink ตอนนี้ มีวิธีการเฉพาะแล้ว gbpAccounts.linkGbpAccount
  • การสร้างบัญชีลูกค้าเป็นบริการ: ตอนนี้การสร้างบัญชีลูกค้าภายใต้บัญชีขั้นสูงจะถือว่าเป็นการเสนอaccountAggregation บริการ โดยใช้วิธีการaccounts.createAndConfigure ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีได้ในหน้าMerchant Accounts API ไม่จำเป็นต้องมีการแฮนด์เชค เนื่องจากผู้ใช้มีสิทธิ์เข้าถึงทั้งบัญชีขั้นสูง และบัญชีลูกค้า

คำขอ

Merchant API มีปลายทางที่เฉพาะเจาะจงสำหรับการจัดการลิงก์บัญชีและบริการประเภทต่างๆ ดังนี้

URL ของคำขอ Merchant API

  • เสนอการให้บริการใหม่: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • อนุมัติบริการ: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • ปฏิเสธบริการ: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • ลิงก์กับ Google Business Profile: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • สร้างบัญชีลูกค้า (ลิงก์การรวบรวมบัญชี): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

การเปรียบเทียบ URL คำขอ

รายละเอียดสำหรับคำขอ Content API for Shopping Merchant API
ลิงก์บัญชี (เช่น แพลตฟอร์มของบุคคลที่สาม) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
ลิงก์ไปยัง Google Business Profile PUT .../v2.1/{merchantId}/accounts/{accountId} (มีฟิลด์ googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
สร้างบัญชีลูกค้า POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

เมธอด

เมธอด Content API for Shopping เมธอดของ Merchant API ความพร้อมใช้งานและหมายเหตุ
accounts.link accountServices.propose ใช้วิธีนี้เพื่อเริ่มบริการใหม่ด้วยบัญชีอื่น
accounts.link (พร้อม action: "approve") accountServices.approve ใช้วิธีนี้เพื่ออนุมัติข้อเสนอการให้บริการที่รอดำเนินการ
accounts.link (พร้อม action: "remove") accountServices.reject ใช้วิธีนี้เพื่อปฏิเสธบริการที่รอดำเนินการหรือที่สร้างขึ้น
accounts.insert (สำหรับบัญชีลูกค้า) accounts.createAndConfigure ใช้วิธีนี้กับบริการ accountAggregation เพื่อสร้างบัญชีลูกค้าใหม่ภายใต้บัญชีขั้นสูง
accounts.update (พร้อม googleMyBusinessLink) gbpAccounts.linkGbpAccount ใช้วิธีการเฉพาะนี้เพื่อลิงก์บัญชี Merchant Center กับ Google Business Profile
accounts.update (พร้อม adsLinks) AccountRelationship แหล่งข้อมูล การลิงก์กับ Google Ads จะได้รับการจัดการจาก UI ของ Google Ads ลิงก์ที่ได้จะแสดงเป็น AccountRelationship ใน Merchant API ซึ่งดูได้แต่สร้างโดยตรงไม่ได้

การเปลี่ยนแปลงช่องโดยละเอียด

Content API for Shopping Merchant API คำอธิบาย
AccountsLinkRequest.action propose, approve, reject วิธี ฟิลด์ action เดียวจะถูกแทนที่ด้วยเมธอด API เฉพาะสำหรับการเปลี่ยนแปลงสถานะแต่ละครั้งในวงจรของบริการ
AccountsLinkRequest.linkType AccountService.service_type สตริง linkType ทั่วไปจะแทนที่ด้วยฟิลด์ service_type oneof ที่มีโครงสร้างภายในทรัพยากร AccountService เช่น productsManagement หรือ accountAggregation
AccountsLinkRequest.services AccountService.service_type ตอนนี้รายการบริการที่อิงตามสตริงจะแสดงด้วย service_type ที่เฉพาะเจาะจงซึ่งเลือกไว้ภายในทรัพยากร AccountService
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider ตอนนี้มีการระบุรหัสของบัญชีที่ให้บริการในช่อง provider ของคำขอ propose แล้ว
Account.googleMyBusinessLink LinkGbpAccountRequest ระบบจะแทนที่ออบเจ็กต์ที่มีรายละเอียดลิงก์ GBP ด้วยข้อความคำขอเฉพาะสำหรับเมธอด linkGbpAccount
Account.adsLinks AccountRelationship ลิงก์ Google Ads จะแสดงเป็นAccountRelationshipทรัพยากรที่providerคือ providers/GOOGLE_ADS โดยปกติแล้วความสัมพันธ์นี้จะได้รับการจัดการจาก UI ของ Google Ads