本頁面由 Cloud Translation API 翻譯而成。

從 Content API for Shopping 遷移帳戶管理

本文說明如何從 Content API v2.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 和其子帳戶的帳戶匯總，或第三方服務供應商和帳戶之間的匯總) 皆透過統一的 accountService 資源進行管理。服務供應商可以使用 accountRelationship 資源管理關係。

簡化的網址結構

網址現在使用單一帳戶 ID (例如 merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId})，而非多個 ID。網址路徑會反映精細的資源結構。

其他改良功能

強化的計畫和使用者管理功能：購物廣告和免費產品資訊等計畫會整合在單一 program 資源下。user 資源包含完整管理功能，並提供精細的存取權。
結構化商家資訊和商家身分：businessInfo 和 businessIdentity 有專屬的資源。這些欄位可支援法規遵循，並提供特定區域的資料欄位。例如韓國商業登記號碼。
簡化首頁聲明程序：專屬的 homepage 資源會管理商店的首頁網址。claim 和 unclaim 等方法會直接透過 API 處理網站聲明。
遵守 Google API 規範：Merchant API 的目標是與 Google 的 API 改善建議保持一致。

遷移帳戶管理

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

本頁面說明如何將帳戶管理功能從 Content API 遷移至 Merchant API。

要求

請使用下列要求網址格式，針對 Merchant Accounts API 進行要求：

https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/accounts

以下是 Content API for Shopping 與 Merchant Accounts API 的比較範例，可用於建立及管理帳戶：

	Content API for Shopping	Merchant Accounts API
網址	`https://shoppingcontent.googleapis.com/content/v2.1/`{merchantId}`/accounts/`{accountId}/	`https://merchantapi.googleapis.com/accounts/v1beta/`*{name=accounts/}**
ID	merchantId`,`accountId	``name

資源

系統會使用 Content API for Shopping 中的 Account 資源傳送帳戶資料。Merchant Accounts API 提供多種資源，可用於傳遞帳戶資料。這些資源包括 Account、User、BusinessInfo 和 BusinessIdentity 資源。

下表比較了 Content API for Shopping 中的 Account 資源，以及 Merchant Accounts API 中的 Account 資源。

Content API for Shopping	Merchant Accounts API
`id`	`name`
`name`	`accountName`
`kind`	不適用
`websiteUrl`	`Homepage` 資源中的 `uri` 欄位
`adultContent`	`adultContent`
`sellerId`	`AccountRelationship` 資源中的 `accountIdAlias` 欄位
`users`	在 `User` 資源中
`youtubeChannelLinks`	尚未提供
`googleMyBusinessLink`	尚未提供
`businessInformation`	在 `businessInfo` 資源中
`businessIdentity`	在 `businessIdentity` 資源中
`automaticImprovements`	尚未提供
`adsLinks`	`AccountService` 資源中的 `campaignsManagement` 欄位
`cssId`	僅適用於 CSS API
`labelIds`	僅適用於 CSS API
`accountManagement`	`AccountService` 資源中的 `accountManagement` 欄位
`automaticLabelIds`	僅適用於 CSS API
`conversionSettings`	尚未提供

下表比較了 Content API for Shopping 中的 AccountUser 資源，以及 Merchant Center API 中的 User 資源。

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`

下表比較了 Content API for Shopping 中的 AccountBusinessInformation 資源，以及 Merchant Center API 中的同等資源 businessInfo。

Content API for Shopping	Merchant Accounts API
`address`	`address`
`phoneNumber`	`phone`
`phoneVerificationStatus`	`phoneVerificationState`
`customerService`	`customerService`
`koreanBusinessRegistrationNumber`	`koreanBusinessRegistrationNumber`

下表比較了 Content API for Shopping 中的 AccountBusinessIdentity 資源，以及 Merchant Accounts API 中的 businessIdentity 資源。

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`

Content API 中的 AccountIdentityType 資源，會以 MerchantAPI 中的 IdentityAttribute 類型和其欄位 identityDeclaration 表示。

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/`*{parent=accounts/}**`/homepage:claim` 詳情請參閱「方法：accounts.v1beta.accounts.homepage.claim」
`accounts.custombatch`	不適用。Merchant API 不支援自訂批次。
`accounts.delete`	`DELETE https://merchantapi.googleapis.com/accounts/v1beta/`*{name=accounts/}**
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{name=accounts/}**`
`accounts.insert`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure` 詳情請參閱「建立及設定商家帳戶」
`accounts.link`	`AccountService` 資源
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`/services`
`accounts.requestphoneverification`	不支援。
`accounts.update`	對應至資源的更新要求，其中定義了必要欄位或一組欄位。
`accounts.updatelabels`	僅適用於 CSS API
`accounts.verifyphonenumber`	不支援。

總覽

遷移商品目錄管理