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.
