本地商品目录 Feed 列出了您的各个商店中出售的所有商品。属性分为三种:有些是每个商品都必须提供的,有些仅适用于部分类型的商品,而其他的则是推荐属性。
商品目录价格和库存状况可能会经常变动,并且在每个商店都可能会有所不同。您可以提高 Feed 频率,对商品目录数据进行更高频的更新。如果您遇到 Feed 频率方面的问题,请使用此联系表单与我们的支持团队联系。请注意,系统最长可能需要 24 小时才能将您的营业地点同步到您的 Merchant Center 帐号,因此我们建议您在关联帐号 24 小时后再上传商品目录 Feed,或者在商家资料中的商店代码更改或更新了之后再上传商品目录 Feed。
如需通过 API 提交商品数据,请先详细了解 Google Content API。
提交本地商品目录 Feed
文件类型:本地商品目录 Feed 支持制表符分隔的文本文件、XML 文件,也可以通过 API 提交。
创建新的本地商品目录 Feed:如需创建并注册新的本地商品目录 Feed,请按照此处的说明操作。
重要提示:以下本地商品目录 Feed 规范中的某些属性包含空格和下划线。为确保提交的属性使用了正确的字符和分隔符号,请遵循下文中与您的文件类型相对应的准则:
- 制表符分隔的 Feed:必须使用空格。如果属性带有下划线,请用空格代替“_”。
- XML API 或 JSON API:必须使用下划线。系统会在收到文件后将下划线转换为空格符。
属性要求汇总
属性 | 提交要求 | |
---|---|---|
必需的商品目录详细信息 |
实体店代码 |
必须为所有商品提供。 注意:实体店代码 |
可选的商品目录详细信息 |
促销价有效期 数量 |
如果适用,建议为 Feed 中的所有商品使用这些属性提供有关价格、数量和当天送达服务的详细信息。 请注意,如果某商品的价格是整个国家/地区范围内的默认价格,则其价格属性是可选属性。如果该商品在某个商店中的价格发生变化,不再采用默认价格,则您必须为其提供价格属性。 |
可选的门店自提详细信息 |
提货方法 提货服务等级协议 (SLA) |
如果适用,建议为 Feed 中可以从店内自提的所有商品使用这些属性。 重要提示:自 2024 年 9 月 1 日起,在为商品启用门店自提功能时,提货方法 |
可选的本地送货服务详细信息 | 本地配送标签 [local shipping label] |
当一个商店内仅特定商品支持当天送达时,如果您想启用“当天送达”标签,则必须在 Feed 中使用此属性。 |
必需的商品目录详细信息
下列属性用来描述各个商店中各种商品的基本商品目录信息。
[store_code]
- 商家资料中的商店标识符
每家本地商家的唯一标识码,由字母和数字构成。此属性区分大小写,而且必须与在您的商家资料中提交的商店代码一致。
在什么情况下需要提供:Feed 中的所有商品都需要提供此属性。
类型 | 文本(字符串) |
文本/制表符分隔示例 | 商店123 |
XML 示例 | <g:store_code>商店123</g:store_code> |
[id]
- 商品的标识码
每件商品的唯一商品标识码,用字母和数字表示,在您的所有商店内通用。
如果同一件商品在多个商店有售,那么同一个 ID 会与多个商店代码出现在一起。您应为每个商店添加一个 ID [id]
属性,并使用库存状况 [availability]
属性指明该商店中每件商品是否有货。
如果您针对一个国家/地区创建了多个相同类型的 Feed,则不同 Feed 中商品的 ID 也必须是独一无二的,不得重复。如果您的 SKU 在整个商品目录中是独一无二的且满足以下要求,那么我们建议您针对此属性使用 SKU。
在什么情况下需要提供:Feed 中的所有商品都需要提供此属性。
类型 | 文本(字符串) |
文本/制表符分隔示例 | 421486 |
XML 示例 | <g:id>421486</g:id> |
重要提示:
- 在主要 Feed 和本地商品目录 Feed 中使用相同的 ID 值。
- 开头和结尾的空格和回车符 (0x0D) 会被移除。
- 系统会将每个序列的回车符 (0x0D) 和空白字符(具有空格属性的 Unicode 字符)替换为一个空格 (0x20)。
- 请仅使用有效的 Unicode 字符,不包括以下字符:
- 控制字符(回车符 0x0D 除外)
- 功能字符
- 私人使用区字符
- 代理项对
- 非指定的码位(特别是大于 0x10FFFF 的所有码位)
- 商品提交后,在更新数据 Feed 时便无法再更改 ID
[id]
属性,以后也无法再将此 ID 用于其他商品。 - 只能添加可在商店中购买的商品。
[availability]
- 商品的库存情况
- “in stock”[有货]:表示商品在您的本地店面有货。
- “out of stock”[缺货]:表示商品在您的本地店面缺货。
- “limited availability”[存货有限]:表示商品在您的本地店面仅有少量存货。
- “on display to order”[样品,仅接受预定]:表示商品仅供展示,需要在您的本地店面预定(例如,需要从仓库发货的冰箱)。如果您还提供了数量
[quantity]
属性,请为“样品,仅接受预定”商品使用值“1”。
类型 | 文本(字符串)。只能从 4 个接受的值中选择一个:“in stock”[有货]、“out of stock”[缺货]、“limited availability”[存货有限] 或“on display to order”[样品,仅接受预定]。 |
文本/制表符分隔示例 | in stock [有货] |
XML 示例 | <g:availability>in stock</g:availability> |
可选的商品目录详细信息
您可以使用下列属性来提供有关商品价格、数量和库存状况的更多信息。
[price]
- 商品的价格
商品的正常价格。如果您在商品目录 Feed 和主要 Feed 中提交了价格值,则商品目录 Feed 中的价格将覆盖关联商店的主要 Feed 中的价格。
在什么情况下需要提供:Feed 中的所有商品都需要提供此属性。
类型 | 数字(系统会根据商店所在的国家/地区自动指定币种) |
文本/制表符分隔示例 | 299.99 |
XML 示例 | <g:price>299.99</g:price> |
[sale_price]
- 用于宣传商品的促销价格
用于宣传商品的临时促销价,表示在特定的商店覆盖这种 Feed 和本地商品 Feed 中的价格 [price]
属性。
我们建议您为任何具有促销价的商品提交促销价有效期 [sale_price_effective_date]
属性,这将决定您的促销价何时生效。如果不提交促销价有效期,则该商品通过 Feed 提交后,促销价就会生效。
类型 | 数字 |
文本/制表符分隔示例 | 279.99 |
XML 示例 | <g:sale_price>279.99</g:sale_price> |
[sale_price_effective_date]
属性中添加表示有效期的值。[sale_price_effective_date]
- 商品促销的日期范围
用于宣传商品促销价的有效时间。
类型 | 文本(字符串),采用 ISO 8601 格式,起止日期用正斜线 (/) 分隔 |
文本/制表符分隔示例 |
世界协调时间 (UTC) 示例: 所有时间值均使用 24 小时制。 |
XML 示例 | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity]
- 有货商品的数量
商店中有货商品的数量。如果您提交的商品暂时缺货,请将此属性的值设为“0”。
数量不再是必需属性。请务必为所有商品目录提交库存状况属性。
类型 | 整数 |
文本/制表符分隔示例 | 4 |
XML 示例 | <g:quantity>4</g:quantity> |
重要提示:
- Google 会将库存为 3 件以上的商品视为“有货”,将库存为 1-2 件的商品视为“存货有限”,而将库存为 0 件的商品视为“缺货”。
- 如果您选择提交数量和库存状况,系统会根据库存状况和数量中的值较小的一项对商品目录进行分类。
可选的门店自提详细信息
在本地商品目录 Feed 中添加下列属性可提供具体商店的自提信息。
提货方法[pickup_method]
- 商品的门店自提选项
[pickup_method]
将不再是必需字段。为此商品指定自提选项。
- 'buy':整个交易都在线进行。
- 'reserve':商品可在线预留,在门店内完成交易。
- 'ship to store':客户在线购买商品,并在商品运送到本地门店后到门店自提。
- 'not supported':商品不支持门店自提。
类型 | 文本(字符串)。只能从 4 个接受的值中选择一个:
'buy'、'reserve'、'ship to store' 或 'not supported' |
文本/制表符分隔示例 | buy |
XML 示例 | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla]
- 商品的门店自提时间表
指明预计可提货的日期(相对于下单日期)。
- 'same day':表示商品在下单当天即可提货,但要在当天的截止时间前。
- 'next day':表示商品在下单次日即可提货。
- '2-day':表示商品将运送到门店,客户可以在 2 天后提货。
- '3-day':表示商品将运送到门店,客户可以在 3 天后提货。
- '4-day':表示商品将运送到门店,客户可以在 4 天后提货。
- '5-day':表示商品将运送到门店,客户可以在 5 天后提货。
- '6-day':表示商品将运送到门店,客户可以在 6 天后提货。
- ‘multi-week':表示商品将运送到门店,客户需要等待一周或多周才可提货。
类型 | 文本(字符串)。只能从 8 个接受的值中选择一个:
'same day'、'next day'、'2-day'、'3-day'、'4-day'、'5-day'、'6-day' 或 'multi-week' |
文本/制表符分隔示例 | same day |
XML 示例 | <g:pickup_sla>same day</g:pickup_sla> |
可选的本地送货服务详细信息
向本地商品目录 Feed 中添加以下属性可提供本地送货服务的信息。
本地配送标签 [local_shipping_label]
当特定商店内只有部分本地商品支持当天送达时,如果您想启用“当天送达”标签,则必须向本地商品目录 Feed 中添加本地配送标签 [local_shipping_label]
属性。
为此属性提交的值应是您在账号级当天送达配送设置中创建的一个或多个“当天送达”标签的名称。每个“当天送达”标签都代表一组特定的当天送达设置,您可以在自己的本地商品目录 Feed 中选择一些符合条件的商品并将该标签添加到这些商品。
如要进一步配置当天送达商品,您可以设置一个最大配送范围半径(以英里或公里为单位)。您还可以设置接受当天送达订单的截止时间,指明只有不晚于闭店前几个小时或特定时间点下单的商品才确保当天送达。您可以指明如果支持当天送达的商品是在截止时间之后下单的,那么该商品是否能在次日送达。
如果您的所有商店及所有商品都支持当天送达,或者符合条件的一系列商店中的所有商品都支持当天送达,则该属性为可选属性。不妨详细了解当天送达。