ローカル在庫広告（LIA）の設定を移行する

Shopping Content API でローカル在庫広告の設定を使用していた場合、Merchant API ではいくつかの重要な変更があります。

LIA の設定は、3 つのコア コンポーネントのいずれかに属するようになり、それぞれに関連付けられたリソースがあります。

コア コンポーネント リソース
オムニチャネル サービスのアカウント設定 OmnichannelSetting
在庫データに関するローカル フィード パートナー（LFP）との接続 LfpProvider
ローカル店舗データ用の Google ビジネス プロフィール（GBP）アカウントへの接続 GbpAccount

また、LIA 設定では、アカウントごとに 1 つのリソースがあり、各国のエンティティの設定リストが含まれていました。OmnichannelSettings を使用すると、複数のリソースを 1 つのアカウントに関連付けることができます。各リソースは、特定の国別エンティティの設定を表します。

リクエストとリソースの変更内容は次のとおりです。

リクエスト

新しいドメイン Content API メソッド名 Merchant API メソッド名
accounts.omnichannelSettings liasettings.custombatch このメソッドは廃止されます。Merchant API は、複数のリクエストを一度に送信する機能をサポートしています。
liasettings.get accounts.omnichannelSettings.list
liasettings.list すべてのサブアカウントのすべての LIA 設定を取得するメソッドは、直接使用できなくなりました。代わりに、すべてのサブアカウントをクエリし、accounts.omnichannelSettings.list を使用して、関心のあるサブアカウントの omnichannelSettings を取得します。
liasettings.update accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
liasettings.requestinventoryverification accounts.omnichannelSettings.requestInventoryVerification
liasettings.setinventoryverificationcontact このメソッドは廃止されます。代わりに、accounts.omnichannelSettings.create または accounts.omnichannelSettings.update を更新されたマスクとともに使用します。
liasettings.setomnichannelexperience このメソッドは廃止されます。代わりに、accounts.omnichannelSettings.create または accounts.omnichannelSettings.update を更新されたマスクとともに使用します。
accounts.omnichannelSettings.lfpProvider liasettings.listposdataproviders accounts.omnichannelSettings.lfpProviders.findLfpProviders
liasettings.setposdataprovider accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount liasettings.getaccessiblegmbaccounts accounts.gbpAccount.list
liasettings.requestgmbaccess accounts.gbpAccount.linkGbpAccount

リソース

また、PickupType の場合、サービスの動作が異なります。受け取りをご覧ください。

OmnichannelSetting

Shopping Content API Merchant API
Field 種類 Field 種類 説明
（なし） （なし） name string このオムニチャネル設定のリソース名。形式:
形式: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string 必須。 Common Locale Data Repository（CLDR）の国コード（「US」など）
hostedLocalStorefrontActive boolean lsfType enum (LsfType) 必須。 この regionCode の ローカル店舗詳細（LSF）タイプ。有効な値は次のとおりです。
  • GHLSF（Google ホスト型店舗詳細ページ）
  • MHLSF_BASIC（販売者ホスト型店舗詳細ページ（標準版）。商品ページ（店舗の在庫状況を含む）を指します）
  • MHLSF_FULL（販売者ホスト型店舗詳細ページ（完全版）。商品ページ（店舗の在庫状況を含む）を指します）
（なし） （なし） inStock object
(InStock)		 この regionCode の在庫あり商品ページの URI（Universal Resource Identifier）と配信ステータス。MHLSF タイプのいずれかを選択した場合は、create API で inStock オブジェクトまたは pickup オブジェクトを少なくとも 1 つ設定します。ただし、lsfType が GHLSF の場合は、inStock のみを設定します。
storePickupActive boolean pickup object
(Pickup)		 この regionCode の受け取り商品ページの URI と配信ステータス。MHLSF タイプのいずれかを選択した場合は、create API で inStock オブジェクトまたは Pickup オブジェクトの少なくとも 1 つを設定します。ただし、GHLSF が lsfType として設定されている場合は設定しないでください。
posDataProvider object
(LiaPosDataProvider)		 lfpLink object
(LfpLink)		 出力専用。LFP プロバイダへのリンクが確立されている
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)		 odo object
(OnDisplayToOrder)		 この regionCode の「見本展示あり」（ODO）ポリシーの URI とステータス
about object
(LiaAboutPageSettings)		 about object
(About)		 この regionCode の概要ページの URI とステータス
inventory object
(LiaInventorySettings)		 inventoryVerification object
(InventoryVerification)		 この regionCode の在庫確認プロセスのステータスと連絡先情報
omnichannelExperience object (LiaOmnichannelExperience) （なし） （なし） lsfType と pickup（上記）を使用します。

LsfType

Shopping Content API Merchant API
Field 種類 Field 種類 説明
lsfType string lsfType enum (LsfType) 店舗詳細ページ（LSF）のタイプ。指定できる値は次のとおりです。
  • GHLSF（Google がホストする店舗詳細ページ）
  • MHLSF_BASIC（販売者ホスト型店舗詳細ページ（標準版））
  • MHLSF_FULL（販売者ホスト型店舗詳細ページ（完全版））

InStock

Shopping Content API Merchant API
Field 種類 Field 種類 説明
（なし） （なし） uri string 商品のランディング ページの URI。MHLSF タイプのいずれかを選択した場合は必須です。オブジェクトが設定されている場合は必須です。GHLSF の場合は空にする必要がありますが、MHLSF の場合は空にしないでください。このサービスは、在庫ありの配信を確認するためにのみ使用されます。この URI ドメインは、販売者のホームページと一致している必要があります。
（なし） （なし） state enum
(ReviewState.State)		 出力専用。在庫ありの配信のステータス。使用可能な値は
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED
です。

ショッピング コンテンツ のバージョンを確認するには、LiaCountrySettings と LiaOmnichannelExperience をご覧ください。

受け取り

Shopping Content API Merchant API
Field 種類 Field 種類 説明
（なし） （なし） uri string 受け取り商品ページの URI。オブジェクトが設定されている場合は必須です。API は、受け取りサービスの確認にのみ使用します。この URI ドメインは、販売者のホームページと一致している必要があります。
LiaInventorySettings.status string state enum (ReviewState.State) 出力専用。受け取りサービスのステータス。使用可能な値は
  • ACTIVE
  • FAILED
  • RUNNING
    •
です。

ショッピング コンテンツ のバージョンを確認するには、LiaCountrySettings と LiaOmnichannelExperience をご覧ください。

Shopping Content API Merchant API
Field 種類 Field 種類 説明
posDataProviderId string lfpProvider string 必須。LFP プロバイダのリソース名
posExternalAccountId string externalAccountId string 必須。LFP プロバイダに認識されている、この販売者のアカウント ID
（なし） （なし） state enum (ReviewState.State) 出力専用。LfpLink のステータス。使用可能な値は
  • ACTIVE
  • RUNNING
    •
です。

ショッピング コンテンツ のバージョンを確認するには、LiaPosDataProvider をご覧ください。

OnDisplayToOrder

Shopping Content API Merchant API
Field 種類 Field 種類 説明
shippingCostPolicyUrl string uri string 必須。「見本展示あり」（ODO）ポリシーの URI。
status string state enum (ReviewState.State) 出力専用。URI のステータス。指定できる値は
  • ACTIVE
  • FAILED
  • RUNNING
 です。

Shopping Content のバージョンを確認するには、LiaOnDisplayToOrderSettings をご覧ください。

概要

Shopping Content API Merchant API
Field 種類 Field 種類 説明
url string uri string 必須。概要ページの URI
status string state enum (ReviewState.State) 出力専用。URI のステータス。指定できる値は次のとおりです。
  • ACTIVE
  • FAILED
  • RUNNING

ショッピング コンテンツのバージョンを確認するには、LiaAboutPageSettings をご覧ください。

InventoryVerification

Shopping Content API Merchant API
Field 種類 Field 種類 説明
status string state enum (InventoryVerification.State) 出力専用。在庫確認プロセスのステータス。指定できる値は
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
 です。
inventoryVerificationContactName string contact string 必須。在庫確認プロセスの連絡先名
inventoryVerificationContactEmail string contactEmail string 必須。在庫確認プロセスの連絡先のメールアドレス
inventoryVerificationContactStatus string contactState enum (ReviewState.State) 出力専用。連絡先の確認ステータス。指定できる値は
  • ACTIVE
  • RUNNING
 です。

Shopping Content のバージョンを確認するには、LiaCountrySettings と LiaInventorySettings をご覧ください。

LfpProvider

Shopping Content API Merchant API
Field 種類 Field 種類 説明
fullName string name string LFP プロバイダのリソース名。
形式: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
（なし） （なし） regionCode string 必須。CLDR 国コード
providerId string （なし） （なし） このフィールドは削除されます。
displayName string displayName string LFP プロバイダの表示名

ショッピング コンテンツのバージョンを確認するには、PosDataProvidersPosDataProvider をご覧ください。

GbpAccount

Shopping Content API Merchant API
Field Type Field 種類 説明
name string name string GBP アカウントのリソース名
形式: accounts/{account}/gbpAccount/{gbp_account}
（なし） （なし） gbpAccountId string ビジネス プロフィールの ID
type string type enum (GbpAccount.Type) ビジネス プロフィールの種類。使用可能な値は次のとおりです。
  • USER（個人アカウント）
  • BUSINESS_ACCOUNT（ビジネス アカウント）
email string gbpAccountName string ビジネス プロフィールの名前:
  • 個人アカウントの場合は、オーナーのメール ID です。
  • ビジネス アカウントの場合は、ビジネス アカウントの名前です。
listingCount string listingCount int64 このアカウントに関連付けられているリスティングの数

ショッピング コンテンツのバージョンを確認するには、GmbAccountsGmbAccount をご覧ください。

前へ
Migrate Comparison Shopping Services management
次へ
Choose between file feeds and API data sources