Release Notes

v2.1 (2019-08-14)

New services

Added new Returnpolicy and Returnaddress services for Shopping Actions.

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

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:

  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

Inventory services are not yet available in v2.1. New services supporting both online and local inventory cases will be added soon. These services will also support management of supplemental data. If you're currently using the Inventory API and decide to migrate to v2.1 before the new services are available, please note it is possible to continue using the v2 Inventory API with other v2.1 services. Services in the v2 API will be supported for at least 12 months after the replacement functionality is released.

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:

  • 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.

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.

Typ zpětné vazby...

Content API for Shopping