從 Content API for Shopping 遷移帳戶管理

您可以使用 accounts 資源至 可以建立及管理商家帳戶。詳情請參閱總覽 Merchant Accounts API

本頁面說明如何將帳戶管理從 Content API 遷移至 商家 API。

要求

請使用以下 Merchant Accounts API 要求網址格式:

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

以下是 Content API for Shopping 與商家的差異範例 用於帳戶建立和管理要求的 Accounts API:

Content API for Shopping 商家帳戶 API
網址 https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
ID {merchantId}/accounts/{accountId} {accountId}

資源

系統會使用 「內容」中有 Account 項資源 API for Shopping。Merchant Accounts API 提供多種資源 帳戶資料這些資源包括 AccountUserBusinessInfoBusinessIdentity 資源。

下表比較了 Account敬上 和 Account資源位於 Merchant Accounts API。

Content API for Shopping 商家帳戶 API
id account_id
name account_name
kind 不適用
websiteUrl homepage 資源中的 uri 欄位
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 尚未提供

下表比較了 Content API for Shopping 中的 AccountUser 資源和 User 透過 Merchant Accounts API 建立資源

Content API for Shopping 商家帳戶 API
emailAddress emailname
(accounts/{account}/users/{email})的一部分。
admin user#access_rights.ADMIN
orderManager 不適用
paymentsManager 不適用
paymentsAnalyst 不適用
reportingManager user#access_rights.PERFORMANCE_REPORTING

下表比較了 AccountBusinessInformation敬上 Content API for Shopping 的資源和同等資源 businessinfo

Content API for Shopping 商家帳戶 API
businessInformation businessinfo
phoneNumber phone
phoneVerificationStatus phone_verification_state
customerService customer_service
koreanBusinessRegistrationNumber 不適用

下表比較了 Content API 中的 AccountBusinessIdentity 資源 購物和 businessIdentity 項資源 。

Content API for Shopping 商家帳戶 API
blackOwned black_owned
womenOwned women_owned
veteranOwned veteran_owned
latinoOwned latino_owned
smallBusiness small_business
includeForPromotions promotions_consent
truePROMOTION_CONSENT_GIVEN
false 代表 PROMOTION_CONSENT_DENIED

下表比較了 Content API 中的 AccountIdentityType 資源 Merchant Accounts API 中的購物和 identityAttribute 資源。

Content API for Shopping 商家帳戶 API
self_identified identity_declaration
trueSELF_IDENTIFIES_AS
false 代表 DOES_NOT_SELF_IDENTIFY_AS

方法

Merchant Accounts API 已導入下列方法:

Content API for Shopping 商家帳戶 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 對應至已定義必填欄位或欄位組合的資源更新要求。