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

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

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

คำขอ

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

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

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

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
ตัวระบุ {merchantId}/accounts/{accountId} {accountId}

แหล่งข้อมูล

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

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

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
id account_id
name account_name
kind ไม่มี
websiteUrl ช่อง uri ในทรัพยากร homepage
adultContent adult_content
sellerId ไม่มี
users ในทรัพยากร User
youtubeChannelLinks ยังไม่พร้อมใช้งาน
googleMyBusinessLink ยังไม่พร้อมใช้งาน
businessInformation ในทรัพยากร businessInfo
businessIdentity ในทรัพยากร businessIdentity
automaticImprovements ยังไม่พร้อมใช้งาน
adsLinks ยังไม่พร้อมใช้งาน
cssId ใช้ได้เฉพาะใน CSS API เท่านั้น
labelIds ใช้ได้เฉพาะใน CSS API เท่านั้น
accountManagement ยังไม่พร้อมใช้งาน
automaticLabelIds ใช้ได้เฉพาะใน CSS API เท่านั้น
conversionSettings ยังไม่พร้อมใช้งาน

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

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
emailAddress email เป็นส่วนหนึ่งของ name
(accounts/{account}/users/{email})
admin user#access_rights.ADMIN
orderManager ไม่มี
paymentsManager ไม่มี
paymentsAnalyst ไม่มี
reportingManager user#access_rights.PERFORMANCE_REPORTING

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

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
businessInformation businessinfo
phoneNumber phone
phoneVerificationStatus phone_verification_state
customerService customer_service
koreanBusinessRegistrationNumber ไม่มี

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

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
blackOwned black_owned
womenOwned women_owned
veteranOwned veteran_owned
latinoOwned latino_owned
smallBusiness small_business
includeForPromotions promotions_consent
true หมายถึง PROMOTION_CONSENT_GIVEN
false หมายถึง PROMOTION_CONSENT_DENIED

ตารางต่อไปนี้แสดงการเปรียบเทียบระหว่างทรัพยากร AccountIdentityType ใน Content API for Shopping กับทรัพยากร identityAttribute ใน Merchant Accounts API

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
self_identified identity_declaration
true หมายถึง SELF_IDENTIFIES_AS
false หมายถึง DOES_NOT_SELF_IDENTIFY_AS

วิธีการ

เราได้แนะนำวิธีการต่อไปนี้ใน Merchant Accounts API

API เนื้อหาสำหรับช็อปปิ้ง API ของบัญชีผู้ขาย
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts ที่ไม่มีตัวกรอง
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim
ดูข้อมูลเพิ่มเติมได้ที่เมธอด: accounts.v1beta.accounts.homepage.claim
accounts.custombatch ไม่พร้อมใช้งาน Merchant API ไม่รองรับกลุ่มที่กำหนดเอง
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get แมปไปยังคำขอ GET สำหรับทรัพยากรที่กำหนดช่องที่ต้องกรอกหรือชุดช่องไว้
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างและกำหนดค่าบัญชีผู้ขาย
accounts.link ยังไม่สนับสนุน
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks ยังไม่สนับสนุน
accounts.update แมปไปยังคำขออัปเดตสำหรับทรัพยากรซึ่งมีการกำหนดช่องที่ต้องกรอกหรือชุดช่อง