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

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

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

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

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

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

リクエスト

新しいドメイン 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（ユニバーサル リソース識別子）と配信ステータス。MHLSF タイプのいずれかを選択した場合は、作成 API で inStock オブジェクトまたは pickup オブジェクトの少なくとも 1 つを設定します。ただし、lsfType が GHLSF の場合は、inStock のみ設定します。
storePickupActive boolean pickup object
(Pickup)		 この regionCode の店舗受け取り商品ページの URI と配信ステータス。MHLSF タイプのいずれかを選択した場合は、作成 API で inStock オブジェクトまたは Pickup オブジェクトの少なくとも 1 つを設定します。ただし、GHLSF が lsfType として設定されている場合は設定しません。
posDataProvider object
(LiaPosDataProvider)		 lfpLink object
(LfpLink)		 出力専用。LFP プロバイダへの確立されたリンク
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)		 odo object
(OnDisplayToOrder)		 この regionCode の「見本展示あり」ポリシーの 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
 です。

ショッピング コンテンツのバージョンを確認するには、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
 です。

ショッピング コンテンツのバージョンを確認するには、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 local feeds partnership management
次へ
Migrate online return policy management