迁移本地商品目录广告 (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
字段	类型	字段	类型	说明
(n/a)	(n/a)	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 类型之一，请在 create API 中设置至少一个 inStock 或 pickup 对象，但如果 lsfType 为 GHLSF，请仅设置 inStock。
storePickupActive	boolean	pickup	object (Pickup)	此 regionCode 的自提商品页面 URI 和投放状态。如果您选择了 MHLSF 类型之一，请在 create 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)	(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	(n/a)	(n/a)	此字段将被移除。
displayName	string	displayName	string	LFP 提供程序的显示名称

如需查看购物内容版本，请参阅 PosDataProvidersPosDataProvider。

GbpAccount

Shopping Content API		Merchant API
Field	Type	字段	类型	说明
name	string	name	string	英镑账号的资源名称 格式： 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。