ローカル在庫広告(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 タイプのいずれかを選択した場合は、create API で inStock オブジェクトまたは pickup オブジェクトの少なくとも 1 つを設定します。ただし、lsfTypeGHLSF の場合は inStock のみを設定します。
storePickupActive boolean pickup object
(Pickup)
この regionCode の店舗受取用商品ページの URI と配信ステータス。MHLSF タイプのいずれかを選択した場合は、create API で inStock オブジェクトまたは Pickup オブジェクトを 1 つ以上設定します。ただし、GHLSFlsfType として設定されている場合は設定しません。
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) (なし) (なし) lsfTypepickup(上記)を使用します。

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
です。

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

受け取り

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

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

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

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

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 をご覧ください。