Release Notes (v2.1)

Stay organized with collections Save and categorize content based on your preferences.

Feb 20, 2023

Accounts Service

Account Resource

Added a new section Account.ConversionSettings in the Accounts resource.

ConversionSources Service

Added the Conversion Sources service, which allows managing conversion sources (part of the Conversion Settings section in Merchant Center).

Feb 16, 2023

Shipping Settings service

Store code validation

Store codes are now validated to ensure that they belong to the merchant before shipping settings are updated.

LIA merchant validation

Programs a Merchant ID is enrolled in are now validated before shipping settings are updated. Merchants must be in one of the following programs: * LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE * LOCAL_INVENTORY_ADS

Feb 9, 2023

Promotions Service

Expand Promotions service to 6 additional targetCountry options with local contentLanguage support.:

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

Jan 12, 2023

Products Service

Product Resource

Added lifestyleImageLinks to provide URLs to lifestyle images.

Nov 24, 2022

Promotion Service

Added a new field `promotionStatus' in the Promotions.PromotionStatus section. This is a read only field.

Nov 15, 2022

Reports Service

Added Market Insights reports to Reports service.

You can now query Reports service for the following:

For more information, see our Reporting guides.

Nov 7, 2022

Datafeeds Service

Added feedLabel support for Datafeeds service.

Sept 14, 2022

Updated feedLabel to accept any string.

Aug 9, 2022

Added feedLabel for products.

You can now use feedLabel instead of targetCountry to specify the country for offer IDs. Offer IDs are now constructed as online:language:feedLabel:offerId.

feedLabel has been automatically populated with your targetCountry value for existing feeds for backwards compatibility.

Deprecated targetCountry.

To support global offers, the Content API for Shopping has deprecated the targetCountry field. Instead, we recommend using the shipping field to specify your target countries.

targetCountry is now automatically populated with the value you provide in feedLabel.

See the blog post Feed label replaces target country in Content API for Shopping for more details.

Dec 8, 2021

Accounts Service

Account Resource

Added a new section Account.AutomaticImprovements in the Accounts resource.

This new section will allow merchants to automatically update items, improve images and shipping settings.

Oct 25, 2021

Promotion Service

Adding Get Promotion to the Promotion API.

Oct 11, 2021

Shipping Settings API

Added new warehouse field in ShippingSettings resource to allow merchants to manage the warehouses which can be used in WarehouseBasedDeliveryTime.

Add new warehouseName field in WarehouseBasedDeliveryTime to refer to warehouse by warehouse name.

Oct 4, 2021

Accounts Service

Account Resource

Added a new field 'phone_verification_status' in the Accounts.BusinessInformation section. This is a read only field, set by Accounts.VerifyPhoneNumber.

Sept 13, 2021

BuyOnGooglePrograms service

BuyOnGoogleProgramStatus resource

Added new fields in the BuyOnGooglePrograms.BuyOnProgramStatus resource respresnting: online sales channels, business models and customer service phone.

New UpdateBuyOnGoogleProgramStatus method

Added a new UpdateBuyOnGoogleProgramStatus method which will allow to update extended BuyOnGooglePrograms.BuyOnProgramStatus resource.

Sept 6, 2021

Accounts Service

Account Resource

Added a new field 'korean_business_registration_number' in the Accounts.BusinessInformation section. This field will only be cleared if explicitly set to an empty string.

Aug 30, 2021

Promotion Service

Added a new Promotion Service with Insert Promotion available.

Orders Service

Added a new method orders/captureOrder to capture funds before shipment.

New order cancellation reason FAILED_TO_CAPTURE_FUNDS

Products Service

Product Resource

Added productLength, productHeight, productWidth and productWeight to provide product dimensions and weight.

Aug 9, 2021

RepricingRule Service

RepricingRule Type

New enum value for RepricingRuleType field.


May 17, 2021

Order Returns Label Service

Added a new 'product_id' field in the CreateReturnRequest. Merchants can specify either the product_id or line_item_id to identify the item to return.

Products Service

Added a new method to update existing products. You can update a product by only providing the fields that need to be updated instead of the whole product.

May 3, 2021

Order Returns Label Service

Added new methods to upload labels for Merchant Managed Returns (MMR). With the new orderreturns.labels.create, you can upload the return labels, to share them with the customer.

April 26, 2021

Shipping Settings API

New warehouseBasedDeliveryTimes field in DeliveryTime to support shipping services calculating the estimated delivery date based on the warehouse location and the chosen carrier service.

New eddServices field in CarriersCarrier object to return names of the services applicable for calculating the estimated delivery date.

April 12, 2021

Products Service

Product Resource

New additionalSizeType field to support up to 2 size types per product.

Changes to shipping field: Added minHandlingTime, maxHandlingTime, minTransitTime and maxTransitTime to ProductShipping to provide offer level shipping speed.

January 28, 2021

Accounts Service

Added automatic labels support to AccountLabel and Account resources. For more information, see CSS Label types section in the CSS Label management guide.

October 5, 2020

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.

August 24, 2020

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.

August 10, 2020

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.

June 19, 2020

Products Service

Product Resource

New fields

New productDetails, productHighlights, subscriptionCost, and canonicalLink fields.

June 2, 2020

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.

April 27, 2020

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.

April 14, 2020

Settlement Report APIs

Added a new service for getting settlement reports.

March 9, 2020

Local inventory API

Added a new service for submitting local inventory data.

March 2, 2020

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications.

December 3, 2019

Products Service

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

September 11, 2019

Orders Service

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

August 14, 2019

New services

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

New field

New quantityUndeliverable field.

August 7, 2019

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

July 1, 2019

Products Service

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

June 11, 2019

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.

February 14, 2019

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 ( {}) to delete them. In v2.1, fields are deleted if you provide an empty body, or if you don't provide them.

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. Use returnRefundLineItem instead.


This method has been removed. 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 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 (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, meaning 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. For exammple, 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, meaning 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.