accounts リソースを使用して、販売アカウントの作成と管理を行うことができます。詳しくは、Merchant Accounts API の概要をご覧ください。
このページでは、アカウント管理を Content API から Merchant API に移行する方法について説明します。
リクエスト
Merchant Accounts API のリクエスト URL 形式は次のとおりです。
POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
アカウントの作成と管理リクエストにおける Content API for Shopping と Merchant Accounts API の比較の例を次に示します。
Content API for Shopping | 販売アカウント API | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/accounts/ {accountId}/
|
https://merchantapi.googleapis.com/accounts/v1beta/ {accountId}/accounts
|
識別子 | {merchantId}/accounts/ {accountId} |
{accountId}
|
リソース
アカウント データは、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 | 販売アカウント 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
リソースと Merchant Accounts API の User
リソースの比較を示します。
Content API for Shopping | 販売アカウント API |
---|---|
emailAddress |
email は name (accounts/{account}/users/{email}) の一部です。 |
admin |
user#access_rights.ADMIN |
orderManager |
利用不可 |
paymentsManager |
利用不可 |
paymentsAnalyst |
利用不可 |
reportingManager |
user#access_rights.PERFORMANCE_REPORTING |
次の表に、Content API for Shopping の AccountBusinessInformation
リソースと、Merchant Accounts API の同等のリソース businessinfo
の比較を示します。
Content API for Shopping | 販売アカウント API |
---|---|
businessInformation |
businessinfo |
phoneNumber |
phone |
phoneVerificationStatus |
phone_verification_state |
customerService |
customer_service |
koreanBusinessRegistrationNumber |
利用不可 |
次の表に、Content API for Shopping の AccountBusinessIdentity
リソースと Merchant Accounts API の businessIdentity
リソースの比較を示します。
Content API for Shopping | 販売アカウント 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 を示します
|
次の表に、Content API for Shopping の AccountIdentityType
リソースと Merchant Accounts API の identityAttribute
リソースの比較を示します。
Content API for Shopping | 販売アカウント API |
---|---|
self_identified |
identity_declaration true は SELF_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 |
1 つ以上の必須フィールドが定義されているリソースの 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 |
1 つ以上の必須フィールドが定義されているリソースの更新リクエストにマッピングされます。 |