迁移本地商品目录广告 (LIA) 设置

如果您在 Shopping Content API 下使用了本地商品目录广告设置，则 Merchant API 会发生一些重要变化。

LIA 设置现在属于三个核心组件之一，每个组件都有一个关联的资源。

核心组件	资源
全渠道投放的账号配置	OmnichannelSetting
与本地 Feed 合作伙伴关系 (LFP) 合作伙伴建立连接，以获取商品目录数据	LfpProvider
关联到 Google 商家资料 (GBP) 账号，以获取本地实体店数据	GbpAccount

此外，对于 LIA 设置，每个账号只有一个资源，其中包含每个国家/地区实体的设置列表。借助 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

资源

• OmnichannelSetting
  • LsfType
  • InStock
  • 自提
  • LfpLink
  • OnDisplayToOrder
  • 简介
  • InventoryVerification
• LfpProvider
• GbpAccount

此外，该服务在 PickupType 方面的行为也有所不同。请参阅自提。

OmnichannelSetting

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
（不适用）	（不适用）	name	string	此全渠道设置的资源名称。格式： 格式：accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	必需。 通用语言区域数据仓库 (CLDR) 国家/地区代码（例如“US”）
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	必需。 此 regionCode 的 本地店面页面 (LSF) 类型。 可取值包括 GHLSF（Google 托管的本地店面页面） MHLSF_BASIC（商家自管的本地店面页面 [基本版]，指显示实体店库存状况的商品页面） MHLSF_FULL（商家自管的本地店面页面 [完整版]，即显示实体店库存状况的商品页面）
(n/a)	(n/a)	inStock	object (InStock)	此 regionCode 的有货商品页面 URI（通用资源标识符）和投放状态。如果您选择了其中一种 MHLSF 类型，请在创建 API 中设置至少一个 inStock 或 pickup 对象，但如果 lsfType 为 GHLSF，则仅设置 inStock。
storePickupActive	boolean	pickup	object (Pickup)	此 regionCode 的自提商品页面 URI 和投放状态。如果您选择了其中一种 MHLSF 类型，请在创建 API 中设置至少一个 inStock 或 Pickup 对象，但如果 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)	(n/a)	(n/a)	使用 lsfType 和 pickup（见上文）。

LsfType

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
lsfType	string	lsfType	enum (LsfType)	本地店面页面 (LSF) 类型。可能的值包括： GHLSF（Google 托管的本地店面页面） MHLSF_BASIC（商家自管的本地店面页面 [基本版]） MHLSF_FULL（商家自管的本地店面页面完整版）

InStock

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
(n/a)	(n/a)	uri	string	商品着陆页 URI。如果您选择了其中一种 MHLSF 类型，则必须提供此字段。如果设置了对象，则此字段为必填字段。对于 GHLSF，它必须为空，但对于 MHLSF，它必须不为空。该服务仅使用此信息来审核有货商品投放。此 URI 网域应与商家首页一致。
(n/a)	(n/a)	state	enum (ReviewState.State)	仅限输出。有货状态下的投放状态。可用的值包括 ACTIVE FAILED RUNNING ACTION_REQUIRED

如需查看带货内容版本，请参阅 LiaCountrySettings 和 LiaOmnichannelExperience。

自提

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
(n/a)	(n/a)	uri	string	自提商品页面 URI。如果设置了对象，则此字段为必填字段。该 API 仅使用此字段来查看自提服务。此 URI 网域应与商家的首页一致。
LiaInventorySettings.status	string	state	enum (ReviewState.State)	仅限输出。自提服务状态。可用的值包括 ACTIVE FAILED RUNNING

如需查看带货内容版本，请参阅 LiaCountrySettings 和 LiaOmnichannelExperience。

LfpLink

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
posDataProviderId	string	lfpProvider	string	必需。LFP 提供商的资源名称
posExternalAccountId	string	externalAccountId	string	必需。LFP 提供商用于识别此商家的账号 ID
(n/a)	（不适用）	state	enum (ReviewState.State)	仅限输出。LfpLink 的状态。可用的值包括 ACTIVE RUNNING

如需查看带货内容版本，请参阅 LiaPosDataProvider。

OnDisplayToOrder

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
shippingCostPolicyUrl	string	uri	string	必需。“样品，仅接受预定”(ODO) 政策 URI。
status	string	state	enum (ReviewState.State)	仅限输出。URI 的状态。可能的值为 ACTIVE FAILED RUNNING

如需查看带货内容版本，请参阅 LiaOnDisplayToOrderSettings。

简介

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
url	string	uri	string	必需。“关于”页面 URI
status	string	state	enum (ReviewState.State)	仅限输出。URI 的状态。可能的值包括 ACTIVE FAILED RUNNING

如需查看带货内容版本，请参阅 LiaAboutPageSettings。

InventoryVerification

Shopping Content API		Merchant API
字段	类型	字段	类型	说明
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
字段	类型	字段	类型	说明
fullName	string	name	string	LFP 提供商的资源名称。 格式：accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(n/a)	(n/a)	regionCode	string	必需。CLDR 国家/地区代码
providerId	string	（不适用）	（不适用）	此字段将被移除。
displayName	string	displayName	string	LFP 提供商的显示名称

如需查看带货内容版本，请参阅 PosDataProvidersPosDataProvider。

GbpAccount

Shopping Content API		Merchant API
Field	Type	字段	类型	说明
name	string	name	string	GBP 账号的资源名称 格式： accounts/{account}/gbpAccount/{gbp_account}
(n/a)	(n/a)	gbpAccountId	string	商家资料的 ID
type	string	type	enum (GbpAccount.Type)	商家资料的类型。可用的值包括 USER（个人账号） BUSINESS_ACCOUNT（企业账号）
email	string	gbpAccountName	string	商家资料的名称： 对于个人账号，这是所有者的邮箱 ID。 对于企业账号，这是企业账号的名称。
listingCount	string	listingCount	int64	与此账号关联的商品详情数量

如需查看带货内容版本，请参阅 GmbAccountsGmbAccount。