Notes de version

Version 2.1 (27/04/2020)

Service Orderreturns

Ajout des nouvelles méthodes acknowledge et process, ainsi que de nouveaux filtres et champs pour les méthodes "read" (list, get).

Association à GMB

Ajout de la possibilité d'associer des comptes Merchant Center à un compte GMB à l'aide du numéro de compte GMB.

Version 2.1 (14/04/2020)

API Settlement Report

Ajout d'un nouveau service pour obtenir des rapports sur les règlements.

Version 2.1 (09/03/2020)

API Local Inventory

Ajout d'un nouveau service pour envoyer des données d'inventaire en magasin.

Version 2.1 (02/03/2020)

API Pub/Sub Notification Settings

Ajout d'un service de gestion des paramètres pour les notifications Pub/Sub.

Version 2.1 (03/12/2019)

Service Products

Ajout de la compatibilité avec les flux Content API multicomptes supplémentaires.

Version 2.1 (11/09/2019)

Service Orders

La livraison en point de retrait des commandes peut maintenant être indiquée via le service Orders. La fonctionnalité de bac à sable correspondante a également été ajoutée.

Version 2.1 (14/08/2019)

Nouveaux services

Les services Returnpolicy et Returnaddress ont été ajoutés pour Shopping Actions.

Service Orders

Ressource Order

Nouveau champ

Nouveau champ quantityUndeliverable.

Version 2.1 (07/08/2019)

Service Orders

Ressource Order

Nouveaux champs

Ajout de nouveaux champs loyaltyInfo et invoiceReceivingEmail à la ressource Order.

Version 2.1 (01/07/2019)

Service Products

Des flux de Content API supplémentaires sont disponibles dans le service Products.

Version 2.1 (11/06/2019)

Service Orders

Ressources Order et TestOrder

Le champ d'ajustement du prix a été ajouté

Le nouveau champ lineItem[].adjustments permet d'ajuster le prix d'origine de l'élément de la ligne et la taxe appliquée lorsqu'ils sont modifiés par une promotion.

Version 2.1 (14/02/2019)

Modifications apportées dans cette version

Les tests ne sont plus possibles

Le paramètre dryRun a été supprimé de la version 2.1. Cette modification s'applique à tous les appels d'API.

La méthode patch n'est plus disponible pour certains services

La méthode patch n'est plus disponible pour les services suivants :

  • Accounts
  • Accounttax
  • Datafeeds
  • Liasettings
  • Shippingsettings

Suppression des méthodes HTTP BATCH

Toutes les méthodes HTTP BATCH ont été supprimées de la version 2.1. Utilisez plutôt customBatch. Les services suivants sont concernés :

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

Service Accounts

Update

Les champs businessInformation et googleMyBusinessLink de la requête ont été ajoutés après le lancement initial de la version 2 de Content API. Par conséquent, une protection empêche les marchands de supprimer involontairement des informations de ces deux champs avec update s'ils ne sont pas renseignés.

Dans la version 2, les marchands doivent indiquer explicitement que le contenu de ces champs est vide (en utilisant {}) pour les supprimer. Dans la version 2.1, cette protection est supprimée, tout comme les champs qui ne sont pas renseignés.

Ressource Accounts

AdWords devient Google Ads

Suite au changement de nom d'AdWords qui est devenu Google Ads, les champs suivants associés à AdWords ont été renommés :

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

Suppression des champs et valeurs obsolètes

Le champ obsolète reviewsUrl a été supprimé. En outre, l'état inactive des liens a été supprimé pour adsLinks, googleMyBusinessLink et youtubeChannelLinks.

Service Accountstatuses

Ressource AccountStatus

Suppression de dataQualityIssues

dataQualityIssues a été remplacé par itemLevelIssues.

Service Datafeed

Ressource Datafeed

Suppression des champs obsolètes

Les champs contentLanguage, targetCountry et intendedDestinations ont été supprimés pour être remplacés par country, language, includedDestinations et excludedDestinations dans targets.

Suppression de la mise à jour de l'inventaire de produits

Les flux de type product inventory update ont été supprimés.

Service Inventory

Les services Inventory ne sont pas encore disponibles pour la version 2.1. Nous ajouterons bientôt des services compatibles avec les inventaires en ligne et en magasin. Ils permettront également de gérer les données des flux supplémentaires. Si vous utilisez actuellement Inventory API et décidez de migrer vers la version 2.1 avant que les nouveaux services ne soient disponibles, sachez que vous pouvez continuer à utiliser la version 2 de l'API avec d'autres services de la version 2.1. Les services de la version 2 de l'API seront compatibles pendant au moins 12 mois après la publication de la fonctionnalité de remplacement.

Service Orders

CancelLineItem

Les champs amount, amountPretax et amountTax de la requête ont été supprimés. Le montant remboursé est désormais calculé automatiquement.

CustomBatch

CustomBatch a été supprimé de la version 2.1.

InStoreRefundLineItem

Les champs amountPretax et amountTax ont été remplacés respectivement par priceAmount et taxAmount. Le champ priceAmount peut être hors taxes ou TTC, en fonction du lieu de la commande.

Refund

Cette méthode a été supprimée. Veuillez plutôt utiliser returnRefundLineItem.

ReturnLineItem

Cette méthode a été supprimée. Veuillez utiliser returnRefundLineItem sans indiquer de montant de remboursement.

ReturnRefundLineItem

Les champs amountPretax et amountTax ont été remplacés respectivement par priceAmount et taxAmount. Le champ priceAmount peut être hors taxes ou TTC, en fonction du lieu de la commande.

ShipLineItem

Les champs carrier, shipmentId et trackingId de la requête ont été déplacés vers shipmentInfos.

Ressources Order et TestOrder

Nouveau format de promotion

Un nouveau format de promotion est disponible dans la version 2.1. Il n'est actuellement pas possible de créer des commandes test avec des promotions, mais cette fonctionnalité sera ajoutée ultérieurement.

Suppression des champs obsolètes

Le champ paymentMethod a été supprimé, et billingAddress ainsi que predefinedBillingAddress sont désormais des champs de premier niveau dans Order et TestOrder, respectivement.

En outre, customer.explicitMarketingPreference a été supprimé pour être remplacé par customer.marketingRightsInfo dans Order et TestOrder.

Le champ obsolète customer.email a été supprimé.

Le format du champ promotions a changé dans la ressource Order.

Service Orderpayments

Ce service a été supprimé de la version 2.1.

Service Products

La réponse générée par la méthode insert contiendra uniquement les attributs suivants :

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Les avertissements et erreurs non fatals ne s'affichent plus dans la réponse. Cela se traduit par une meilleure intégration dans les règles de flux et d'autres fonctionnalités avancées de gestion des flux.

Un délai de quelques minutes est désormais nécessaire avant qu'un produit inséré ne puisse être récupéré par get ou list.

L'ID d'offre affiché n'est plus garanti comme étant l'ID d'offre saisi.

Les prix sont désormais validés avant l'insertion du produit. Seuls les caractères suivants sont autorisés dans la chaîne de valeur : +, - et ., ainsi que les chiffres (ex. : 0-9). Les virgules ne sont plus acceptées.

Ressource Product

Remplacement de CustomGroups par des customAttributes récursifs

Dans la version 2, vous pouviez regrouper les attributs personnalisés en les ajoutant sous le même groupe personnalisé. Dans la version 2.1, les attributs personnalisés sont récursifs. De ce fait, les groupes personnalisés ne sont plus nécessaires.

Les attributs personnalisés disposent désormais d'un champ groupValues supplémentaire en plus du champ d'origine value. Un seul de ces champs doit être défini, c'est-à-dire que vous ne pouvez pas les définir ni les laisser vides tous les deux.

Comme les marchands peuvent être amenés à basculer entre les versions 2 et 2.1, il est possible que les produits comportent des attributs personnalisés récursifs ne pouvant pas être représentés dans la version 2. Ceci est dû au fait que les groupes personnalisés ont deux niveaux au maximum. Le cas échéant, le groupe d'attributs personnalisés est tronqué.

Suppression du type et de l'unité dans customAttributes

Dans la version 2.1, les attributs personnalisés ne contiennent plus les champs type ni unit. À la place, les unités doivent être ajoutées à value (si ce champ est présent), et les types doivent être détectés automatiquement. Par exemple, utilisez "1.23 EUR" "ou" "5.6 cm" comme value dans la version 2.1.

Remplacement de ProductTypes par ProductType et additionalProductTypes

Auparavant, les types de produits étaient enregistrés dans deux champs, le premier type dans le champ unique productType et le reste dans le champ répété additionalProductTypes. Dans la version 2.1, les deux champs ont été remplacés par un seul champ répété productTypes.

Remplacement de l'attribut Destinations par includedDestinations et excludedDestinations

Dans la version 2, les destinations étaient saisies sous la forme d'une liste de noms de destination et d'intentions associés dans le champ répété destinations. Ce champ a été remplacé par les deux champs répétés suivants : includedDestinations et excludedDestinations. Les destinations activées par défaut n'ont pas besoin d'être incluses dans includedDestinations.. Ceci correspond à la configuration des remplacements de destination dans les flux.

Suite au changement de nom d'AdWords qui est devenu Google Ads, les champs suivants associés à AdWords ont été renommés :

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

Suppression des champs obsolètes

Les champs obsolètes suivants ont été supprimés :

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Service Productstatuses

Get et List

L'attribut product a été supprimé, de même que le paramètre includeAttributes. Pour extraire les attributs du produit correspondant à un état, utilisez le service Products et la valeur du nouveau champ productId.

List

Le paramètre includeInvalidInsertedItems a été supprimé. Tous les produits sont désormais affichés, qu'ils soient valides ou non. En d'autres termes, list se comporte à présent comme si includeInvalidInsertedItems était toujours défini sur true.

Ressource ProductStatus

DestinationsStatuses

Les champs intention, approvalStatus et approvalPending dans destinationStatuses ont été remplacés par le champ status, qui correspond à une chaîne pouvant être approved, disapproved ou pending.

Suppression de dataQualityIssues

dataQualityIssues a été remplacé par itemLevelIssues.