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
Update
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:
adwordsLinks->adsLinksadwordsLinks.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
This service has been removed from v2.1. A new service will be added at a later stage to support management of supplemental data.
Orders Service
CancelLineItem
The fields amount, amountPretax, and amountTax in the request have been
removed. The refunded amount is now calculated automatically.
CustomBatch
CustomBatch has been removed from v2.1.
InStoreRefundLineItem
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.
Refund
This method has been removed. Please use returnRefundLineItem instead.
ReturnLineItem
This method has been removed. Please use returnRefundLineItem without
providing a refund amount instead.
ReturnRefundLineItem
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.
ShipLineItem
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:
channelcontentLanguageidofferIdtargetCountry
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.
Renaming of AdWords-related fields
With AdWords becoming Google Ads, the following AdWords-related fields have been renamed:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Removal of deprecated fields
The following deprecated fields have been removed:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
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.
List
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
DestinationsStatuses
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.
