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

如果您之前在 Shopping Content API 下使用了本地商品目录广告设置，那么 Merchant API 发生了一些重大变化。

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

核心组件 资源
全渠道服务的账号配置 OmnichannelSetting
与 Local Feed Partnership (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

资源

此外，该服务的行为因 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（商家自管的本地店面页面 [完整版]，指显示实体店库存状况的商品页面）
（不适用） （不适用） 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 和状态 regionCode
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
字段 类型 字段 类型 说明
lsfType string lsfType enum (LsfType) 本地店面页面 (LSF) 类型。可能的值包括：
  • GHLSF（Google 托管的本地店面页面）
  • MHLSF_BASIC（商家自管的本地店面页面 [基本版]）
  • MHLSF_FULL（商家自管的本地店面页面 [完整版]）

InStock

Shopping Content API Merchant API
字段 类型 字段 类型 说明
（不适用） （不适用） uri string 商品着陆页 URI。如果您选择了 MHLSF 类型，则为必填项。如果设置了对象，则此字段为必填字段。对于 GHLSF，它必须为空；但对于 MHLSF，它必须为非空。该服务仅使用此数据来检查库存情况。此 URI 网域应与商家首页一致。
（不适用） （不适用） state enum
(ReviewState.State)		 仅限输出。“有现货”广告的投放状态。可用的值包括
  • ACTIVE
  • FAILED
  • RUNNING
  • ACTION_REQUIRED

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

自提

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

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

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}
（不适用） （不适用） 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 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