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

เอกสารนี้อธิบายวิธีย้ายข้อมูลการจัดการบัญชีจาก Content API for Shopping ไปยัง Merchant API

ภาพรวมของการเปลี่ยนแปลงจาก Content API เวอร์ชัน 2.1 เป็น Merchant API

Merchant API มีการปรับปรุงที่สำคัญเมื่อเทียบกับ Content API เวอร์ชัน 2.1 โดยมีเป้าหมายเพื่อปรับปรุงความสามารถในการใช้งาน ความสอดคล้อง และความยืดหยุ่นสำหรับนักพัฒนาซอฟต์แวร์และธุรกิจ

โครงสร้างทรัพยากรแบบละเอียด

ทรัพยากรใน Merchant API จะแสดงถึงแนวคิดเดียว เช่น

• account
  • businessInfo
  • user
  • homepage
  • program

account เป็นทรัพยากรหลักสำหรับรายการอื่นๆ

บริการบัญชีแบบรวม

บริการบัญชีทั้งหมด (เช่น การรวมบัญชีสำหรับ MCA และบัญชีย่อยของ MCA หรือระหว่างผู้ให้บริการบุคคลที่สามกับบัญชี) จะจัดการผ่านแหล่งข้อมูล AccountService แบบรวม ผู้ให้บริการสามารถจัดการความสัมพันธ์โดยใช้แหล่งข้อมูล AccountRelationship

โครงสร้าง URL ที่เรียบง่าย

ตอนนี้ URL ใช้รหัสบัญชีเดียว (เช่น merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) แทนการใช้รหัสหลายรหัส เส้นทาง URL จะแสดงโครงสร้างทรัพยากรแบบละเอียด

การปรับปรุงอื่นๆ

• การจัดการโปรแกรมและผู้ใช้ที่มีประสิทธิภาพมากขึ้น: โปรแกรมต่างๆ เช่น โฆษณา Shopping และข้อมูลที่แสดงฟรีจะรวมอยู่ในแหล่งข้อมูล program เดียว ทรัพยากร user มีความสามารถในการจัดการที่ครอบคลุมพร้อมสิทธิ์เข้าถึงแบบละเอียด
• ข้อมูลทางธุรกิจและตัวตนทางธุรกิจที่เป็นรูปแบบ: มีแหล่งข้อมูลเฉพาะสำหรับ businessInfo และ businessIdentity ซึ่งรวมถึงการรองรับการปฏิบัติตามข้อกำหนดด้วยช่องสำหรับข้อมูลเฉพาะภูมิภาค เช่น หมายเลขจดทะเบียนธุรกิจของเกาหลี
• การอ้างสิทธิ์หน้าแรกที่มีประสิทธิภาพมากขึ้น: แหล่งข้อมูลโดยเฉพาะ homepage จะจัดการ URL หน้าแรกของร้านค้า เมธอดอย่าง claim และ unclaim จะจัดการการอ้างสิทธิ์เว็บไซต์ผ่าน API โดยตรง
• การปฏิบัติตามหลักเกณฑ์ของ Google API: Merchant API มีจุดมุ่งหมายเพื่อปรับให้สอดคล้องกับข้อเสนอการปรับปรุง API ของ Google

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

คุณใช้แหล่งข้อมูล accounts เพื่อสร้างและจัดการบัญชีผู้ขายได้ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ Merchant Accounts API

หน้านี้จะอธิบายวิธีย้ายข้อมูลการจัดการบัญชีจาก Content API ไปยัง Merchant API

คำขอ

ใช้รูปแบบ URL คำขอต่อไปนี้สำหรับ Merchant Accounts API

https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

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

	Content API	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accounts/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1beta/{NAME}
รหัสระบุ	{MERCHANT_ID}, {ACCOUNT_ID}	{NAME} จะมีรูปแบบเป็น accounts/{ACCOUNT_ID}

แหล่งข้อมูล

ระบบจะส่งผ่านข้อมูลบัญชีโดยใช้แหล่งข้อมูล Account ใน Content API for Shopping Merchant Accounts API มีแหล่งข้อมูลหลายแหล่งในการส่งข้อมูลบัญชี แหล่งข้อมูลเหล่านี้รวมถึงแหล่งข้อมูล Account , User, BusinessInfo และ BusinessIdentity

ตารางต่อไปนี้แสดงการเปรียบเทียบระหว่างแหล่งข้อมูล Account ใน Content API for Shopping กับแหล่งข้อมูล Account ใน Merchant Accounts API

Content API for Shopping	Merchant Accounts API
id	name
name	accountName
kind	ไม่พร้อมใช้งาน
websiteUrl	ฟิลด์ uri ในทรัพยากร Homepage
adultContent	adultContent
sellerId	ฟิลด์ accountIdAlias ในทรัพยากร AccountRelationship
users	ในแหล่งข้อมูล User
youtubeChannelLinks	ยังไม่พร้อมใช้งาน
googleMyBusinessLink	ยังไม่พร้อมใช้งาน
businessInformation	ในแหล่งข้อมูล businessInfo
businessIdentity	ในแหล่งข้อมูล businessIdentity
automaticImprovements	ยังไม่พร้อมใช้งาน
adsLinks	ฟิลด์ campaignsManagement ในทรัพยากร AccountService
cssId	ใช้ได้ใน CSS API เท่านั้น
labelIds	ใช้ได้ใน CSS API เท่านั้น
accountManagement	ฟิลด์ accountManagement ในทรัพยากร AccountService
automaticLabelIds	ใช้ได้เฉพาะใน CSS API
conversionSettings	ยังไม่พร้อมใช้งาน

ตารางต่อไปนี้แสดงการเปรียบเทียบระหว่างแหล่งข้อมูล AccountUser ใน Content API for Shopping กับแหล่งข้อมูล User ใน Merchant Accounts API

Content API for Shopping	Merchant Accounts API
emailAddress	อีเมลเป็นส่วนหนึ่งของ name (accounts/{ACCOUNT}/users/{EMAIL}})
admin	user#accessRights.ADMIN
orderManager	ไม่พร้อมใช้งาน
paymentsManager	ไม่มีให้บริการ
paymentsAnalyst	ไม่พร้อมใช้งาน
reportingManager	user#accessRights.PERFORMANCE_REPORTING

ตารางต่อไปนี้แสดงการเปรียบเทียบระหว่างแหล่งข้อมูล AccountBusinessInformation ใน Content API for Shopping กับแหล่งข้อมูลเทียบเท่า businessInfo ใน Merchant Accounts API

Content API for Shopping	Merchant Accounts API
address	address
phoneNumber	phone
phoneVerificationStatus	phoneVerificationState
customerService	customerService
koreanBusinessRegistrationNumber	koreanBusinessRegistrationNumber

ตารางต่อไปนี้แสดงการเปรียบเทียบระหว่างแหล่งข้อมูล AccountBusinessIdentity ใน Content API for Shopping กับแหล่งข้อมูล businessIdentity ใน Merchant Accounts API

Content API for Shopping	Merchant Accounts API
blackOwned	blackOwned
womenOwned	womenOwned
veteranOwned	veteranOwned
latinoOwned	latinoOwned
smallBusiness	smallBusiness
includeForPromotions	promotionsConsent
	- true หมายถึง PROMOTION_CONSENT_GIVEN
	- false หมายถึง PROMOTION_CONSENT_DENIED

แหล่งข้อมูล AccountIdentityType ใน Content API จะแสดงโดยประเภท IdentityAttribute และฟิลด์ IdentityDeclaration ใน Merchant API

Content API for Shopping	Merchant Accounts API
self_identified	identityDeclaration
	- true หมายถึง SELF_IDENTIFIES_AS
	- false หมายถึง DOES_NOT_SELF_IDENTIFY_AS

เมธอด

เราได้เปิดตัวเมธอดต่อไปนี้ใน Merchant Accounts API

Content API for Shopping	Merchant Accounts API
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts ที่ไม่มีตัวกรอง
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim ดูข้อมูลเพิ่มเติมได้ที่เมธอด: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	ไม่พร้อมใช้งาน Merchant API ไม่รองรับการประมวลผลเป็นกลุ่มที่กำหนดเอง
accounts.delete	DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
accounts.get	GET https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*} เมธอด accounts.get ไม่รองรับพารามิเตอร์ view
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure ดูข้อมูลเพิ่มเติมได้ที่สร้างและกำหนดค่าบัญชีผู้ขาย
accounts.link	ทรัพยากร AccountService
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}:listSubaccounts หากคุณเป็นผู้ใช้ CSS คุณสามารถใช้เมธอด ListChildAccounts เพื่อแสดงรายการบัญชีทั้งหมดที่เชื่อมโยงกับบัญชี CSS หนึ่งๆ
accounts.listlinks	GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification	Merchant API ไม่รองรับวิธีการยืนยันทางโทรศัพท์
accounts.update	แหล่งข้อมูล Accounts.patch
accounts.updatelabels	ใช้ได้เฉพาะใน CSS API
accounts.verifyphonenumber	ไม่รองรับ