Di chuyển hoạt động quản lý tài khoản từ Content API for Shopping

Bạn có thể sử dụng Tài nguyên accounts để tạo và quản lý tài khoản người bán. Để biết thêm thông tin, hãy xem bài viết Tổng quan về Merchant Account API.

Trang này mô tả cách bạn có thể di chuyển hoạt động quản lý tài khoản từ Content API sang API người bán.

Yêu cầu

Hãy sử dụng định dạng URL yêu cầu sau đây cho API tài khoản người bán:

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

Dưới đây là ví dụ so sánh giữa Content API for Shopping với người bán API Tài khoản cho các yêu cầu tạo và quản lý tài khoản:

Content API for Shopping API tài khoản người bán
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
Giá trị nhận dạng {merchantId}/accounts/{accountId} {accountId}

Tài nguyên

Dữ liệu tài khoản được chuyển bằng cách sử dụng Tài nguyên Account trong phần Nội dung API cho Mua sắm. Merchant Account API cung cấp nhiều tài nguyên để truyền dữ liệu tài khoản của bạn. Các tài nguyên này bao gồm Account, User, BusinessInfo và Tài nguyên BusinessIdentity.

Bảng sau đây cung cấp dữ liệu so sánh giữa Account trong Content API for Shopping và Tài nguyên Account ở API tài khoản người bán.

Content API for Shopping API tài khoản người bán
id account_id
name account_name
kind Không có
websiteUrl Trường uri trong tài nguyên homepage
adultContent adult_content
sellerId Không có
users Trong tài nguyên User
youtubeChannelLinks Chưa có
googleMyBusinessLink Chưa có
businessInformation Trong tài nguyên businessInfo
businessIdentity Trong tài nguyên businessIdentity
automaticImprovements Chưa có
adsLinks Chưa có
cssId Chỉ có trong CSS API
labelIds Chỉ có trong CSS API
accountManagement Chưa có
automaticLabelIds Chỉ có trong CSS API
conversionSettings Chưa có

Bảng sau đây cung cấp dữ liệu so sánh giữa Tài nguyên AccountUser trong Content API for Shopping và User trong Merchant Account API.

Content API for Shopping API tài khoản người bán
emailAddress email là một phần của name
(accounts/{account}/users/{email}).
admin user#access_rights.ADMIN
orderManager Không có
paymentsManager Không có sẵn
paymentsAnalyst Không có
reportingManager user#access_rights.PERFORMANCE_REPORTING

Bảng sau đây cung cấp dữ liệu so sánh giữa AccountBusinessInformation tài nguyên trong Content API for Shopping và tài nguyên tương đương businessinfo trong API tài khoản Merchant Center.

Content API for Shopping API tài khoản người bán
businessInformation businessinfo
phoneNumber phone
phoneVerificationStatus phone_verification_state
customerService customer_service
koreanBusinessRegistrationNumber Không có

Bảng sau đây cung cấp dữ liệu so sánh giữa Tài nguyên AccountBusinessIdentity trong Content API cho Mua sắm và Tài nguyên businessIdentity trong API tài khoản Merchant Center.

Content API for Shopping API tài khoản người bán
blackOwned black_owned
womenOwned women_owned
veteranOwned veteran_owned
latinoOwned latino_owned
smallBusiness small_business
includeForPromotions
promotions_consent true biểu thị PROMOTION_CONSENT_GIVEN
false biểu thị PROMOTION_CONSENT_DENIED

Bảng sau đây cung cấp dữ liệu so sánh giữa Tài nguyên AccountIdentityType trong Content API cho Mua sắm và tài nguyên identityAttribute trong API Tài khoản Merchant Center.

Content API for Shopping API tài khoản người bán
self_identified
identity_declaration true biểu thị SELF_IDENTIFIES_AS
false biểu thị DOES_NOT_SELF_IDENTIFY_AS

Phương thức

Sau đây là các phương thức đã được ra mắt trong API tài khoản Merchant Center:

Content API for Shopping API tài khoản người bán
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts không có bộ lọc
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim
Để biết thêm thông tin, hãy xem Phương thức: accounts.v1beta.accounts.homepage.claim
accounts.custombatch Không có. Lô tuỳ chỉnh không được hỗ trợ trong API Merchant.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get Liên kết đến yêu cầu GET dành cho tài nguyên nơi đã xác định trường hoặc nhóm trường bắt buộc.
accounts.insert
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Để biết thêm thông tin, hãy xem bài viết Tạo và thiết lập tài khoản người bán.
accounts.link Chưa được hỗ trợ
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks Chưa được hỗ trợ
accounts.update Liên kết đến yêu cầu cập nhật của tài nguyên nơi trường hoặc nhóm trường bắt buộc được xác định.