Notes de version (version 2.1)

3 mai 2021

Service Order Returns Label

Ajout de méthodes permettant d'importer des étiquettes pour les retours gérés par le marchand. Grâce à orderreturns.labels.create, vous pouvez désormais importer les étiquettes de retour et les partager avec le client.

26 avril 2021

Shipping Settings API

Nouveau champ warehouseBasedDeliveryTimes dans DeliveryTime permettant aux services de livraison de calculer la date de livraison estimée en fonction de l'emplacement de l'entrepôt et du service de transporteur choisi.

Nouveau champ eddServices dans l'objet CarriersCarrier permettant de renvoyer les noms des services applicables pour calculer la date de livraison estimée.

12 avril 2021

Service Products

Ressource Product

Nouveau champ additionalSizeType permettant d'ajouter jusqu'à deux types de coupe par produit.

Modification du champ de livraison : minHandlingTime, maxHandlingTime, minTransitTime et maxTransitTime ont été ajoutés à ProductShipping pour indiquer le délai de livraison de l'offre.

28 janvier 2021

Service Accounts

Ajout de la compatibilité des libellés automatiques avec les ressources AccountLabel et Account. Pour en savoir plus, consultez la section Types de libellés CSS dans le guide de gestion des libellés CSS.

5 octobre 2020

Service CSSES

Ressource CSS

Ajout d'un service csses pour récupérer des informations sur les domaines CSS et leur attribuer des libellés. La ressource AccountLabel peut également être utilisée pour créer et répertorier des libellés au niveau du groupe CSS. Pour en savoir plus, consultez la page Gestion des libellés CSS.

24 août 2020

Service Products

Ressource Products

Nouveau champ shoppingAdsExcludedCountries permettant d'exclure des offres des annonces dans certains pays.

Ressource Productstatuses

Nouveaux champs approvedCountries, pendingCountries et disapprovedCountries dans l'objet destinationStatuses, qui fournissent des informations sur l'état de l'offre au-delà de targetCountry.

Nouveau champ itemLevelIssues.applicableCountries.

10 août 2020

Service Accounts

Ajout d'une nouvelle ressource AccountLabel pour la gestion des libellés de compte Merchant Center pour CSS Center. Les utilisateurs de CSS Center peuvent désormais répertorier leurs comptes Merchant Center et leur attribuer des libellés à l'aide des méthodes accounts.list, accounts.get et accounts.updatelabels. Pour en savoir plus, consultez la page Gestion des libellés CSS.

19 juin 2020

Service Products

Ressource Product

Nouveaux champs

Nouveaux champs productDetails, productHighlights, subscriptionCost et canonicalLink.

2 juin 2020

Service Orders

Ajout de méthodes permettant de proposer des remboursements sans retour. Avec les nouvelles méthodes orders.refunditem et orders.refundorder, vous pouvez procéder à des remboursements sur les commandes même si celles-ci ne sont pas renvoyées par le client.

27 avril 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.

14 avril 2020

Settlement Report API

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

9 mars 2020

Local Inventory API

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

2 mars 2020

Pub/Sub Notification Settings API

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

3 décembre 2019

Service Products

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

11 septembre 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.

14 août 2019

Nouveaux services

Ajout des services Returnpolicy et Returnaddress pour Acheter sur Google.

Service Orders

Ressource Order

Nouveau champ

Nouveau champ quantityUndeliverable.

7 août 2019

Service Orders

Ressource Order

Nouveaux champs

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

1er juillet 2019

Service Products

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

11 juin 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.

14 février 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

Le service inventory de la version 2 a été supprimé et remplacé par deux nouvelles fonctionnalités dans la version 2.1 :

  • Utilisez de nouveaux flux supplémentaires pour les mises à jour partielles des données produit.
  • Utilisez le nouveau service localinventory pour les mises à jour des données produit en magasin.

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.