Use these endpoints to retrieve the current products for a feed or upsert
partial product changes matched by id.
GET /product_feeds/{id}/products returns the products
for the specified feed.PATCH /product_feeds/{id}/products upserts products
into the specified feed. Products are matched by id, and products
not included in the request remain unchanged.
Returns the products for the specified feed.
| Field | Type | Required | Description |
|---|
id | string | Yes | Identifier for the feed. |
This endpoint does not define a request body.
200 OK
| Field | Type | Required | Description |
|---|
target_country | string | No | Two letter country code per ISO 3166. |
products | Product[] | Yes | Array of products for the specified feed. |
404 Not Found
Returned when the feed is not found.
Upserts products into the specified feed. Products are matched by id. Products not included in the request remain unchanged.
| Field | Type | Required | Description |
|---|
id | string | Yes | Identifier for the feed. |
| Field | Type | Required | Description |
|---|
target_country | string | No | Two letter country code per ISO 3166. |
products | Product[] | Yes | Array of products for the product feed. |
200 OK
Returns the following acceptance object:
| Field | Type | Required | Description |
|---|
id | string | Yes | Identifier for the feed. |
accepted | boolean | Yes | Whether the product payload was accepted. |
400 Bad Request
Returned when the product payload is invalid.
404 Not Found
Returned when the feed is not found.
| Field | Type | Required | Description |
|---|
id | string | Yes | Stable global identifier for this product. |
title | string | No | Product title. |
description | Description | No | Product description content. |
url | string (uri) | No | Canonical product URL. |
media | Media[] | No | Product-level media assets. |
variants | Variant[] | Yes | Variants associated with the product. |
| Field | Type | Required | Description |
|---|
id | string | Yes | Stable global identifier for this variant. |
title | string | Yes | Variant title. |
description | Description | No | Variant description content. |
url | string (uri) | No | Variant URL. |
barcodes | Barcode[] | No | Variant barcode values. |
price | Price | No | Active sale price for this variant. |
list_price | Price | No | Reference price before any discount is applied. |
unit_price | UnitPrice | No | Unit pricing metadata. |
availability | Availability | No | Availability state for the variant. |
categories | Category[] | No | Categories associated with the variant. |
condition | Condition | No | Applicable item conditions. |
variant_options | VariantOption[] | No | Set of option selections for the variant, such as color or size. |
media | Media[] | No | Variant media assets. The first entry is treated as primary. |
seller | Seller | No | Seller metadata for the variant. |
At least one of the following fields must be present.
| Field | Type | Required | Description |
|---|
plain | string | No | Plain-text description. |
html | string | No | HTML description. |
markdown | string | No | Markdown description. |
| Field | Type | Required | Description |
|---|
available | boolean | No | Indicates whether the variant is currently purchasable. |
status | string | No | Fulfillment state when availability is reported, for example in_stock, backorder, preorder, out_of_stock, or discontinued. |
| Field | Type | Required | Description |
|---|
amount | integer | Yes | Monetary amount expressed in ISO 4217 minor units. |
currency | string | Yes | Three-letter ISO 4217 currency identifier. |
| Field | Type | Required | Description |
|---|
amount | integer | Yes | Unit price amount. |
currency | string | Yes | Currency code. |
measure | Measure | Yes | Measured quantity. |
reference | ReferenceMeasure | Yes | Reference quantity. |
| Field | Type | Required | Description |
|---|
value | number | Yes | Measure value. |
unit | string | Yes | Measure unit. |
| Field | Type | Required | Description |
|---|
value | integer | Yes | Reference value. |
unit | string | Yes | Reference unit. |
| Field | Type | Required | Description |
|---|
type | string | Yes | Barcode type. |
value | string | Yes | Barcode value. |
| Field | Type | Required | Description |
|---|
type | string | Yes | Media type. |
url | string (uri) | Yes | Media URL. |
alt_text | string | No | Alternate text. |
width | integer | No | Media width. |
height | integer | No | Media height. |
| Field | Type | Required | Description |
|---|
name | string | Yes | Option name, such as color or size. |
value | string | Yes | Selected option value. |
| Field | Type | Required | Description |
|---|
value | string | Yes | Category label or hierarchical path. |
taxonomy | string | No | Taxonomy system used for the category value, such as google_product_category, shopify, or merchant. |
| Field | Type | Required | Description |
|---|
name | string | No | Seller name. |
links | Link[] | No | Seller-related links. |
| Field | Type | Required | Description |
|---|
type | string | Yes | Kind of destination, such as privacy_policy, terms_of_service, refund_policy, shipping_policy, or faq. |
title | string | No | Link title. |
url | string | Yes | Link destination URL. |
Condition is an array of strings describing applicable item conditions, such as new or secondhand. More than one value may apply.
