We will sunset v2 of the Content API on March 29th, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible. For more information, see Migrating to v2.1.

Release Notes

v2.1 (2020-10-05)

CSSES Service

CSS Resource

Added a new csses service for retrieving information about CSS domains and assigning labels to them. The AccountLabel resource can now also be used for creating and listing CSS group level labels. For more information, see CSS Label Management.

v2.1 (2020-08-24)

Products Service

Products Resource

New shoppingAdsExcludedCountries field to exclude offers from advertising in certain countries.

Productstatuses Resource

New approvedCountries, pendingCountries and disapprovedCountries fields in destinationStatuses object which provide for offer status information beyond targetCountry.

New itemLevelIssues.applicableCountries field.

v2.1 (2020-08-10)

Accounts Service

Added a new AccountLabel resource for managing Merchant Center account labels for CSS Center. CSS Center users can now also list their Merchant Center accounts and assign labels to them with accounts.list, accounts.get and accounts.updatelabels methods. For more information, see CSS Label Management.

v2.1 (2020-06-19)

Products Service

Product Resource

New fields

New productDetails, productHighlights, subscriptionCost, and canonicalLink fields.

v2.1 (2020-06-02)

Orders Service

Added new methods to initiate refunds without returns. With the new orders.refunditem and orders.refundorder, you can initiate refunds on orders even if they are not returned by the customer.

v2.1 (2020-04-27)

Orderreturns Service

Added new methods acknowledge and process, and new filters and fields for read methods (list, get).

GMB linking

Added the ability to link Merchant Center accounts to a GMB account using the GMB account ID.

v2.1 (2020-04-14)

Settlement Report APIs

Added a new service for getting settlement reports.

v2.1 (2020-03-09)

Local inventory API

Added a new service for submitting local inventory data.

v2.1 (2020-03-02)

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications.

v2.1 (2019-12-03)

Products Service

Added support for multi-client account supplemental Content API feeds.

v2.1 (2019-09-11)

Orders Service

Added support for pickup shipments in orders and corresponding sandbox functionality.

v2.1 (2019-08-14)

New services

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

New field

New quantityUndeliverable field.

v2.1 (2019-08-07)

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

v2.1 (2019-07-01)

Products Service

Support for supplemental Content API feeds added in the Products service.

v2.1 (2019-06-11)

Orders Service

Order and TestOrder Resources

Addition of price adjustment

Added new lineItem[].adjustments field that contains adjustment to original line item price and tax caused by applying promotions.

v2.1 (2019-02-14)

Changes introduced in this version

Dry runs no longer supported

The parameter dryRun has been removed from v2.1. This applies to all API calls.

Patch methods no longer supported

The following services no longer support the patch method:

  • Accounts
  • Accounttax
  • Datafeeds
  • Liasettings
  • Shippingsettings

Removal of HTTP BATCH methods

All HTTP BATCH methods have been removed from v2.1. Use customBatch instead. The affected services are the following:

  • Accounts
  • Accountstatuses
  • Datafeeds
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos
  • Products
  • Productstatuses
  • Shippingsettings

Accounts Service


The fields businessInformation and googleMyBusinessLink in the request were introduced after the initial launch of Content API v2. Due to this, there is a safeguard that prevents merchants from unintentionally deleting information in these two fields with update if they are not provided.

In v2, merchants must explicitly provide these fields with an empty body (i.e., {}) to delete them. In v2.1, this safeguard will be removed, and fields which are not provided will be deleted.

Account Resource

AdWords -> Google Ads rebranding

With AdWords becoming Google Ads, the following AdWords-related fields have been renamed:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId

Removal of deprecated fields and values

The deprecated field reviewsUrl has been removed. In addition, the link status inactive has been removed for adsLinks, googleMyBusinessLink, and youtubeChannelLinks.

Accountstatuses Service

AccountStatus Resource

Removal of dataQualityIssues

These have been superseded by itemLevelIssues.

Datafeed Service

Datafeed Resource

Removal of deprecated fields

The fields contentLanguage, targetCountry, and intendedDestinations have been removed and replaced by country, language, includedDestinations, and excludedDestinations in targets.

Removal of product inventory update

Feeds of type product inventory update have been removed.

Inventory Service

The v2 inventory service has been removed and replaced by two new features in v2.1:

Orders Service


The fields amount, amountPretax, and amountTax in the request have been removed. The refunded amount is now calculated automatically.


CustomBatch has been removed from v2.1.


The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount, respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.


This method has been removed. Please use returnRefundLineItem instead.


This method has been removed. Please use returnRefundLineItem without providing a refund amount instead.


The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount, respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.


The fields carrier, shipmentId, and trackingId in the request have been moved to shipmentInfos.

Order and TestOrder Resources

New promotion format

There is a new promotion format in v2.1. Currently, it is not possible to create test orders with promotions, but support will be added at a later stage.

Removal of deprecated fields

The field paymentMethod has been removed, and billingAddress andpredefinedBillingAddress are now top-level fields in Order and TestOrder, respectively.

Furthermore, customer.explicitMarketingPreference has been removed and replaced by customer.marketingRightsInfo in both Order and TestOrder.

The deprecated field customer.email has been removed.

The format of the promotions field has changed in the Order resource.

Orderpayments Service

This service has been removed from v2.1.

Products Service

Response from an insert will contain only the following attributes:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Non-fatal warnings and errors are no longer returned in the response. This allows for better integration with feed rules and other advanced feed management features.

There is now a delay of a few minutes before an inserted product can be retrieved by get or list.

The returned offer ID is no longer guaranteed to be the same as the input offer ID.

Prices are now validated before product insertion. Only the following characters are allowed in the value string: +, -, ., and digits (i.e., 0-9). Commas are no longer accepted.

Product Resource

CustomGroups replaced by recursive customAttributes

Previously, custom attributes could be grouped together by adding custom attributes under the same custom group in v2. Custom attributes are now recursive in v2.1, so this removes the need for custom groups.

Custom attributes now have an additional groupValues field in addition to the original value field; exactly one of them must be set, i.e., they cannot be simultaneously set or left out.

As merchants may switch between v2 and v2.1, it is possible for products to have recursive custom attributes which cannot be represented in v2 as custom groups have a maximum of two levels. In this case, the custom attribute group will be truncated.

Removal of type and unit in customAttributes

In v2.1, custom attributes will no longer contain a type and unit. Instead, units are to be appended to the value (if present), and types should be automatically detected. E.g., use "1.23 EUR" or "5.6 cm" as the value in v2.1.

ProductTypes supersedes productType and additionalProductTypes

Previously, product types were stored in two fields with the first type in the singular field productType and the remaining in the repeated field additionalProductTypes. In v2.1, the two fields have been replaced by a single repeated field productTypes.

Destinations attribute replaced by includedDestinations and excludedDestinations

Destinations were input as a list of destination name and intention pairs in v2 in the repeated field destinations. This field has been replaced by the following two repeated fields: includedDestinations and excludedDestinations. Destinations enabled by default need not be included in includedDestinations. This will match the configuration of destination overrides in feeds.

With AdWords becoming Google Ads, the following AdWords-related fields have been renamed:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect

Removal of deprecated fields

The following deprecated fields have been removed:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Service

Get and List

The product attribute was removed, along with the includeAttributes parameter. To retrieve attributes of the product corresponding to a status, use the Products service and the value of the new productId field.


The parameter includeInvalidInsertedItems has been removed. All products are now returned regardless of whether they are valid, i.e., list now behaves as if includeInvalidInsertedItems is always set to true.

ProductStatus Resource


The fields intention, approvalStatus, and approvalPending in destinationStatuses have been replaced by status, which is a string that can be one of approved, disapproved, or pending.

Removal of dataQualityIssues

These have been superseded by itemLevelIssues.