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_consenttrue は PROMOTION_CONSENT_GIVEN を意味しますfalse は PROMOTION_CONSENT_DENIED を示します
|
次の表に、Content API for Shopping の AccountIdentityType リソースと Merchant Accounts API の identityAttribute リソースの比較を示します。
| Content API for Shopping | 販売アカウント API |
|---|---|
self_identified |
identity_declarationtrue は 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 つ以上の必須フィールドが定義されているリソースの更新リクエストにマッピングされます。 |