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

เอกสารนี้จะอธิบายวิธีย้ายข้อมูลจาก Content API เวอร์ชัน 2.1 ไปยัง Merchant API

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

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

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

ทรัพยากรใน Merchant API แสดงถึงแนวคิดเดียว เช่น account, businessDetails, user, homepage และ program โดยจัดระเบียบตามลําดับชั้นเพื่อแสดงความสัมพันธ์ เช่น account เป็นทรัพยากรหลักของ user

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

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

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

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

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

  • การจัดการโปรแกรมและผู้ใช้ที่มีประสิทธิภาพมากขึ้น: โปรแกรมต่างๆ เช่น โฆษณา Shopping และข้อมูลที่แสดงฟรีจะรวมอยู่ในprogramแหล่งข้อมูลเดียว user ทรัพยากรมีความสามารถในการจัดการที่ครอบคลุมพร้อมสิทธิ์เข้าถึงแบบละเอียด
  • Structured Business Information และ Business Identity: มีแหล่งข้อมูลเฉพาะสำหรับ 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

POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

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

  Content API for Shopping Merchant Accounts API
URL https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accounts/accountId/ https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
รหัสระบุ merchantId/accounts/accountId accounts/accountId

แหล่งข้อมูล

ระบบจะส่งผ่านข้อมูลบัญชีโดยใช้แหล่งข้อมูล 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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)
youtubeChannelLinks ยังไม่พร้อมใช้งาน
googleMyBusinessLink ยังไม่พร้อมใช้งาน
businessInformation ในทรัพยากร [businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)
businessIdentity ในทรัพยากร [businessIdentity](/merchant/api/reference/rest/v1/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
businessInformation businessInfo
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 ใน MerchantAPI

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/accounts/accountId/homepage:claim
ดูข้อมูลเพิ่มเติมได้ที่ Method: accounts.v1beta.accounts.homepage.claim
accounts.custombatch ไม่พร้อมใช้งาน Merchant API ไม่รองรับการเรียกใช้ข้อมูลหลายรายการพร้อมกันที่กำหนดเอง
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get GET https://merchantapi.googleapis.com/accounts/v1beta/accountId`
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
ดูข้อมูลเพิ่มเติมได้ที่สร้างและกำหนดค่าบัญชีผู้ขาย
accounts.link ทรัพยากร AccountService
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks GET https://merchantapi.googleapis.com/accounts/v1beta/accountId/services
accounts.update แมปกับคําขออัปเดตสําหรับทรัพยากรที่กําหนดฟิลด์หรือชุดฟิลด์ที่จําเป็น
ก่อนหน้า
ภาพรวม
ถัดไป
ย้ายข้อมูลการจัดการพื้นที่โฆษณา