使用这些端点检索 Feed 的当前产品，或根据 id 匹配更新部分产品更改。
GET /product_feeds/{id}/products 返回指定 Feed 的产品。PATCH /product_feeds/{id}/products 将产品更新至指定的 Feed。产品根据 id 进行匹配，未包含在请求中的产品保持不变。
返回指定 Feed 的产品。
| 字段 | 类型 | 必需 | 描述 |
|---|
id | string | 是 | Feed 的标识符。 |
此端点不定义请求体。
200 OK
| 字段 | 类型 | 必需 | 描述 |
|---|
target_country | string | 否 | 符合 ISO 3166 的两位国家/地区代码。 |
products | Product[] | 是 | 指定 Feed 的产品数组。 |
404 Not Found
当找不到 Feed 时返回。
将产品更新至指定的 Feed。产品根据 id 进行匹配。未包含在请求中的产品保持不变。
| 字段 | 类型 | 必需 | 描述 |
|---|
id | string | 是 | Feed 的标识符。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
target_country | string | 否 | 符合 ISO 3166 的两位国家/地区代码。 |
products | Product[] | 是 | 产品 Feed 的产品数组。 |
200 OK
返回以下接受对象
| 字段 | 类型 | 必需 | 描述 |
|---|
id | string | 是 | Feed 的标识符。 |
accepted | boolean | 是 | 产品有效负载是否被接受。 |
400 Bad Request
当产品有效负载无效时返回。
404 Not Found
当找不到 Feed 时返回。
| 字段 | 类型 | 必需 | 描述 |
|---|
id | string | 是 | 此产品的稳定全局标识符。 |
标题 | string | 否 | 产品标题。 |
description | 描述 | 否 | 产品描述内容。 |
url | string (uri) | 否 | 规范产品 URL。 |
media | Media[] | 否 | 产品级媒体资产。 |
variants | Variant[] | 是 | 与产品关联的变体。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
id | string | 是 | 此变体的稳定全局标识符。 |
标题 | string | 是 | 变体标题。 |
description | 描述 | 否 | 变体描述内容。 |
url | string (uri) | 否 | 变体 URL。 |
barcodes | Barcode[] | 否 | 变体条形码值。 |
价格 | Price | 否 | 此变体的当前销售价格。 |
list_price | Price | 否 | 应用折扣前的参考价格。 |
unit_price | UnitPrice | 否 | 单价元数据。 |
库存状况 | Availability | 否 | 变体的可用性状态。 |
分类 | Category[] | 否 | 与变体关联的类别。 |
condition | Condition | 否 | 适用的商品状况。 |
variant_options | VariantOption[] | 否 | 变体的选项选择集，例如颜色或尺寸。 |
media | Media[] | 否 | 变体媒体资产。第一个条目被视为主要条目。 |
seller | Seller | 否 | 变体的卖家元数据。 |
必须至少存在以下字段之一。
| 字段 | 类型 | 必需 | 描述 |
|---|
plain | string | 否 | 纯文本描述。 |
html | string | 否 | HTML 描述。 |
markdown | string | 否 | Markdown 描述。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
available | boolean | 否 | 指示变体当前是否可购买。 |
status | string | 否 | 报告可用性时的履约状态，例如 in_stock（有货）、backorder（缺货待补）、preorder（预购）、out_of_stock（无货）或 discontinued（已停产）。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
amount | 整数 | 是 | 以 ISO 4217 小数单位表示的金额。 |
currency | string | 是 | 三字母 ISO 4217 货币标识符。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
amount | 整数 | 是 | 单价金额。 |
currency | string | 是 | 货币代码。 |
measure | Measure | 是 | 测量的数量。 |
reference | ReferenceMeasure | 是 | 参考数量。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
value | number | 是 | 测量值。 |
unit | string | 是 | 测量单位。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
value | 整数 | 是 | 参考值。 |
unit | string | 是 | 参考单位。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
type | string | 是 | 条形码类型。 |
value | string | 是 | 条形码值。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
type | string | 是 | 媒体类型。 |
url | string (uri) | 是 | 媒体 URL。 |
alt_text | string | 否 | 替代文本。 |
width | 整数 | 否 | 媒体宽度。 |
height | 整数 | 否 | 媒体高度。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
name | string | 是 | 选项名称，例如颜色或尺寸。 |
value | string | 是 | 选定的选项值。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
value | string | 是 | 类别标签或层级路径。 |
taxonomy | string | 否 | 用于类别值的分类系统，例如 google_product_category、shopify 或 merchant。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
name | string | 否 | 卖家名称。 |
links | Link[] | 否 | 卖家相关链接。 |
| 字段 | 类型 | 必需 | 描述 |
|---|
type | string | 是 | 目标类型，例如 privacy_policy（隐私政策）、terms_of_service（服务条款）、refund_policy（退款政策）、shipping_policy（配送政策）或 faq（常见问题）。 |
标题 | string | 否 | 链接标题。 |
url | string | 是 | 链接目标 URL。 |
Condition 是一个字符串数组，描述适用的商品状况，例如 new（全新）或 secondhand（二手）。可以适用多个值。
