Starting with v2.1 of the Content API, you can use
supplemental feeds
to perform partial updates of product data. Partial updates with supplemental
feeds let you make requests that only include the fields that you want to
modify, without affecting the rest of the product data. Once you create your
supplemental feeds in Merchant Center, you can make partial updates by including
the feedId query parameter when calling Products.insert and
Products.delete.
Supplemental feeds
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-13 UTC.
[null,null,["Last updated 2025-08-13 UTC."],[[["\u003cp\u003eGoogle is introducing the beta version of the Merchant API, which is the new version of the Content API for Shopping and its future.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the Merchant API and its benefits through the announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eStarting with Content API v2.1, supplemental feeds enable partial product data updates, modifying only specific fields without affecting others.\u003c/p\u003e\n"],["\u003cp\u003ePartial updates using supplemental feeds maintain the existing product expiration date; a full product insert request is needed to reset it.\u003c/p\u003e\n"],["\u003cp\u003eSupplemental feeds are exclusively for updating existing products, not for creating new ones.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is now available. Version 2.1 allows partial product data updates using supplemental feeds, modifying specific fields without affecting other data. To perform these partial updates include the `feedId` query parameter when using `Products.insert` and `Products.delete`. Supplemental feed updates do not reset product expiration dates; use a full `Products.insert` request for that. Supplemental feeds cannot create new products, only modify existing ones.\n"],null,["# Supplemental feeds\n\nStarting with v2.1 of the Content API, you can use\n[supplemental feeds](//support.google.com/merchants/answer/7439058#supplemental)\nto perform partial updates of product data. Partial updates with supplemental\nfeeds let you make requests that only include the fields that you want to\nmodify, without affecting the rest of the product data. Once you create your\nsupplemental feeds in Merchant Center, you can make partial updates by including\nthe `feedId` query parameter when calling `Products.insert` and\n`Products.delete`.\n| **Key Point:** Partial updates with supplemental feeds do not reset the product expiration date. Submit a full `Products.insert` request to [reset the product\n| expiration date](/shopping-content/guides/best-practices#update-items-before-they-expire).\n| **Note:** You can only use supplemental feeds to update existing products. You cannot create new products with supplemental feed requests."]]