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 về tài khoản để tạo và quản lý tài khoản người bán của mình. Để biết thêm thông tin, hãy xem bài viết Tổng quan về API Tài khoản Merchant Center.

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 Merchant Center:

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 API Tài khoản Merchant Center 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 truyền bằng tài nguyên Account trong Content API for Shopping. API Tài khoản Merchant cung cấp nhiều tài nguyên để truyền dữ liệu tài khoản. Các tài nguyên này bao gồm tài nguyên Account, User, BusinessInfoBusinessIdentity.

Bảng sau đây cung cấp thông tin so sánh giữa tài nguyên Account trong Content API for Shopping và tài nguyên Account trong MerchantAccounts API.

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à tài nguyên 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ó
paymentsAnalyst Không có
reportingManager user#access_rights.PERFORMANCE_REPORTING

Bảng sau đây cung cấp thông tin so sánh giữa tài nguyên AccountBusinessInformation trong Content API for Shopping và tài nguyên tương đương businessinfo trong Merchant Account API.

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 for Shopping và tài nguyên businessIdentity trong Merchant Account API.

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 for Shopping và tài nguyên identityAttribute trong API Tài khoản Merchant.

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.