Notes de version (version 2.1)

Service d'assistance pour les marchands

10 février 2025

Ajout de champs prerendered_out_of_court_dispute_settlement à ProductIssue et à AccountIssue.

Champs alternate_dispute_resolution obsolètes de RenderProductIssuesResponse et RenderAccountIssuesResponse.

12 décembre 2024

Service des produits

Ajout du champ sustainability_incentives pour spécifier les incitations à la durabilité, telles qu'un crédit d'impôt ou une remise sur le prix de vos produits. Si la valeur du champ n'est pas fournie, l'article n'est pas éligible aux incitations en faveur de la durabilité.

15 novembre 2024

Service des produits

Pour LoyaltyProgram, ajout du champ shipping_label pour spécifier l'éligibilité. Si le champ contient une valeur, cette offre bénéficie d'un avantage de livraison du programme de fidélité. Si la valeur du champ n'est pas fournie, l'article n'est pas éligible à la livraison du programme de fidélité pour le niveau de fidélité donné.

30 octobre 2024

Dans le cadre de l'arrêt des API liées aux règlements, les services suivants sont obsolètes : - settlementreports - settlementtranscations

L'arrêt des API liées aux règlements est lié au programme BuyOnGoogle, qui a été arrêté précédemment, et aux API liées aux commandes.

Les appels aux services susmentionnés devraient échouer et renvoyer une réponse Service was not found on the server.

16 octobre 2024

update_mask dans UpdateConversionSourceRequest est désormais OPTIONAL. Si aucun masque de mise à jour n'est spécifié, tous les champs dont la valeur n'est pas vide sont mis à jour.

26 août 2024 (plus tôt que prévu)

Dans le cadre de l'arrêt des API liées aux commandes, les services suivants ont été abandonnés : - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

Les appels aux services susmentionnés devraient échouer et renvoyer une réponse Service was not found on the server.

Le service OrderTrackingSignals n'est pas obsolète et reste disponible.

10 août 2024

Services Acheter sur Google

Dans le cadre de l'arrêt des API Acheter sur Google, toutes les méthodes de BuyOnGoogleProgramService échoueront avec service was not found on the server.

19 juillet 2024

Service des produits

Ajout du champ member_price_effective_date. Cette modification vous permet de spécifier, le cas échéant, la période pendant laquelle le prix réservé aux membres du programme de fidélité est valable. Si aucune valeur n'est définie pour le champ, le prix réservé aux membres est toujours appliqué.

20 mai 2024

Service des produits

Ajout de LoyaltyPrograms. Cette mise à jour vous permet de proposer plusieurs niveaux avec des points de fidélité, des prix, etc. différents pour un même produit. Vous devez utiliser ce champ à la place du champ LoyaltyProgram au singulier.

Service Reports

Métriques Acheter sur Google obsolètes dans le tableau MerchantPerformanceView. Après cette mise à jour, la valeur renvoyée pour toute métrique Acheter sur Google est 0. Cela s'applique également aux valeurs historiques pour les dates passées.

Pour en savoir plus, consultez la page Abandon d'Acheter sur Google.

13 mai 2024

Service des produits

Ressource Product

Modifications apportées au champ "Certifications" : ajout de certificationValue au champ ProductCertification pour indiquer la valeur de certification (également appelée classe, niveau ou note), ce qui permet aux utilisateurs d'importer des informations de certification même si l'autorité de certification n'émet pas de code ou de numéro de certification.

Pour en savoir plus, consultez nos guides sur les produits.

6 mai 2024

Service Reports

Ajout d'un bucket d'efficacité au tableau PriceInsightsProductView. L'efficacité indique quels produits bénéficieraient le plus d'un changement de prix. Cette note tient compte de l'amélioration des performances prévue en ajustant le prix soldé, ainsi que de la différence entre le prix actuel et le prix suggéré.

24 avril 2024

Service des produits

Ressource Product

Ajout des champs facultatifs downpayment et creditType pour les paiements en plusieurs versements:

  • downpayment indique le montant que l'acheteur doit payer au préalable en un seul versement.
  • creditType indique le type de versements échelonnés (finance ou lease). Ce champ ne s'applique qu'aux annonces de véhicules.

11 avril 2024

Service des produits

Ressource Product

  • Ajout de l'attribut seuil pour la livraison gratuite (FreeShippingThreshold) pour la livraison au niveau de l'offre. Cet attribut permet aux marchands de saisir un prix minimal pour que les frais de port soient sans frais.
  • Modification de la visibilité de LoyaltyPoints

10 avril 2024

Service des produits

Ressource Product

LoyaltyProgram a été ajouté

09 avril 2024

Service des produits

Ressource Product

Ajout de structuredTitle et de structuredDescription pour fournir des titres et des descriptions de produits générés par IA.

3 avril 2024

Service d'assistance pour les marchands

Ajout du champ user_input_action_option qui permet aux partenaires de demander un nouveau type d'action: BuiltInUserInputAction. Cette action permet aux partenaires de créer des fonctionnalités en libre-service complexes pour les marchands, directement dans leur application au lieu de les rediriger vers Merchant Center.

Ajout d'une nouvelle méthode TriggerAction pour BuiltInUserInputAction. Pour accéder à cette méthode, envoyez une demande via ce formulaire.

27 mars 2024

Service des produits

Ressource Product

Ajout de AutoPricingMinPrice comme mesure de protection dans les projets "Remises automatiques" et "Promotions dynamiques", afin de s'assurer que les remises sur les offres des marchands ne réduisent pas le prix du produit en dessous de cette valeur. Vous préservez ainsi la valeur et la rentabilité de l'offre.

15 mars 2024

Fin du programme Acheter sur Google pour le Réseau de Recherche et Shopping Vous pourrez continuer à afficher les commandes existantes jusqu'au 31 octobre 2024 à l'aide de orders.list et de orders.get.

8 mars 2024

Service Reports

Ajout du rapport TopicTrendsView au service Reports.

Pour en savoir plus, consultez nos guides sur les rapports.

6 mars 2024

Service de rapports

Ajout d'un classement et d'un bucket de potentiel de clics pour les produits.

Pour en savoir plus, consultez nos guides sur les rapports.

19 février 2024

Service ConversionSources

Nous avons supprimé les valeurs suivantes en tant que sources de conversion valides:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Suppression des options 60 et 90 jours pour la période d'analyse et ajout de 40 jours comme option valide.

17 janvier 2024

Service de point de vente

Ajout de nouvelles valeurs pour le champ matching_status_hint dans PosStore, ce qui permet aux utilisateurs d'obtenir plus d'informations sur les raisons pour lesquelles la mise en correspondance de leurs magasins a échoué.

11 janvier 2024

Service des comptes

Ajout de localProductManager et localProductManagement en tant que type de lien et service, respectivement, pour la méthode link. Ils permettent d'associer des comptes dans le but de gérer les données produit en magasin.

29 novembre 2023

Service d'assistance pour les marchands

Ajout du type d'action externe VERIFY_IDENTITY_IN_MERCHANT_CENTER pour la validation de l'identité à effectuer dans Merchant Center.

Service de point de vente

Ajout des champs matching_status et matching_status_hint à PosStore, qui permettent aux utilisateurs de connaître l'état de la correspondance du magasin du point de vente avec celui de la fiche d'établissement Google et de savoir comment résoudre le problème en cas de problème.

15 novembre 2023

Les points de terminaison repricingrules et repricingrules.repricingreports ne sont plus compatibles.

1er novembre 2023

Service Shipping Settings

Le shipment_type=pickup n'est plus accepté.

18 octobre 2023

Service des comptes

Ajout du champ Business Identity qui permet aux marchands de s'identifier à certaines valeurs des consommateurs.

10 octobre 2023

Ajout de Collection Point en tant que nouveau type d'expédition du service de paramètres de livraison. La livraison en point de collecte est un service fourni par un tiers (par exemple, qui n'appartient pas au marchand) pour livrer l'article à un emplacement affilié tiers (comme les points d'accès UPS), au lieu de le livrer directement à domicile.

18 septembre 2023

Service de paramètres des annonces produits en magasin

Ajout de la méthode setOmnichannelExperience pour permettre aux utilisateurs de définir leur expérience omnicanal (c'est-à-dire les paramètres de la vitrine locale et du retrait en magasin). Pour le moment, cette fonctionnalité n'est disponible que pour les utilisateurs dont le fournisseur de point de vente est approuvé pour activer ces paramètres.

7 septembre 2023

Abandon d'Acheter sur Google

Ajout d'un état DEPRECATED dans la méthode GetBuyOnGoogleProgramStastus. Il est impossible de réactiver ou de suspendre le programme dans cet état.

4 septembre 2023

Service d'assistance pour les marchands

Ajout d'une action intégrée FIX_ACCOUNT_ISSUE pour les problèmes de produit à résoudre au niveau du compte. Ajout d'une action intégrée SHOW_ADDITIONAL_CONTENT qui sera utilisée pour fournir une justification de la part d'une autorité nationale.

28 août 2023

Service Promotions

Ouvrez la méthode list dans le service Promotions à partir d'un accès limité à tous.

22 août 2023

Service d'assistance pour les marchands

Lancement du service d'assistance pour les marchands. Ce service fournit du contenu d'assistance pour les problèmes liés aux comptes et aux produits.

4 août 2023

Service Reports

Ajout du rapport "Visibilité par rapport aux concurrents proches" au service Reports.

Pour en savoir plus, consultez nos guides sur les rapports.

25 juillet 2023

Service de point de vente

Ressource d'inventaire

Ajoutez les champs pickup_method et pickup_sla pour permettre aux marchands d'envoyer des informations de retrait avec leur inventaire.

14 juillet 2023

Service Reports

Ajout des rapports "Visibilité par rapport aux concurrents" au service Reports.

Pour en savoir plus, consultez nos guides sur les rapports.

7 juillet 2023

Service des produits

Ressource Product

Ajout de virtualModelLink pour fournir les URL d'images du modèle 3D.

4 juillet 2023

Service des produits

Ressource Product

Ajoutez le champ certifications pour fournir des certifications de produit, par exemple pour l'étiquetage énergétique des produits en fonction de la base de données EPREL de l'UE.

26 juin 2023

Service Shipping Settings

Traitement en local

Ajout du champ no_delivery_post_cutoff pour permettre aux marchands de désactiver l'affichage de la livraison en magasin sous n + 1 jour lorsqu'ils ont configuré un service de livraison en magasin sous n + 1 jour.

29 mai 2023

Service Promotions

Ajout de la méthode list au service Promotions

Service de recommandation

Activez l'interaction_dismiss pour une interaction ignorée dans la méthode ReportInteraction du service Recommendations.

9 mai 2023

Destination Cloud Retail

Propriétés supplémentaires Cloud Retail

Ajout du champ "Propriétés supplémentaires Cloud Retail". Il s'agit d'un champ répété destiné à être utilisé par les clients avec la destination Cloud Retail. Lorsque ce champ sera utilisé, il sera disponible dans le programme Cloud Retail. Il sera mis en correspondance avec le champ "Attributs" dans le modèle de produit Google Cloud Retail.

22 mai 2023

Service Promotions

Ajout de la méthode list au service Promotions

11 avril 2023

Service Shipping Settings

Traitement en local

Ajout de l'option de livraison locale pour les marchands qui créent un paramètre de livraison. Ils peuvent configurer les paramètres pour les magasins locaux dans le nouveau champ storeConfig. Cela inclut le rayon de la zone desservie, l'heure limite pour commander et le code des magasins proposant la livraison locale.

3 avril

Service Recommendations

Lancement du service Recommendations. qui suggère des moyens d'améliorer les performances de votre compte marchand. Il vous permet également de générer des rapports sur les clics que des marchands ont effectués sur des recommandations utiles.

20 févr. 2023

Service des comptes

Ressource Accounts

Ajout d'une nouvelle section Account.ConversionSettings dans la ressource Accounts.

Service ConversionSources

Ajout du service ConversionSources, qui permet de gérer les sources de conversion (dans la section "Paramètres des conversions" de Merchant Center).

16 févr. 2023

Service Shipping Settings

Validation des codes de magasin

Les codes de magasin sont désormais validés pour vérifier qu'ils appartiennent au marchand avant la mise à jour des paramètres de livraison.

Validation des marchands utilisant des APM

Les programmes auxquels un ID de marchand est inscrit sont désormais validés avant la mise à jour des paramètres de livraison. Les marchands doivent participer à l'un des programmes suivants:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 février 2023

Service Promotions

Service Promotions étendu à six options targetCountry supplémentaires grâce à la compatibilité locale de contentLanguage :

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

12 janv. 2023

Service des produits

Ressource Product

Ajout de lifestyleImageLinks pour fournir les URL d'images de style de vie.

24 novembre 2022

Service Promotion

Ajout d'un nouveau champ "promotionStatus" dans la section Promotions.PromotionStatus. Ce champ est en lecture seule.

15 nov. 2022

Service Reports

Ajout des rapports Market Insights au service Reports.

Vous pouvez désormais interroger le service Reports concernant:

Pour en savoir plus, consultez nos guides sur les rapports.

7 nov. 2022

Service Datafeeds

Ajout de la compatibilité de feedLabel avec le service Datafeeds.

14 septembre 2022

Mise à jour de feedLabel pour accepter n'importe quelle chaîne.

9 août 2022

Ajout de feedLabel pour les produits.

Vous pouvez désormais utiliser feedLabel au lieu de targetCountry pour préciser le pays des ID d'offres. Ces ID se présentent maintenant sous la forme suivante : online:language:feedLabel:offerId.

Votre valeur targetCountry a été automatiquement appliquée à feedLabel dans vos flux existants pour assurer la rétrocompatibilité.

Abandon de targetCountry.

Pour permettre la diffusion d'offres à l'international, Content API for Shopping a rendu obsolète le champ targetCountry. Nous vous recommandons plutôt d'utiliser le champ shipping pour indiquer les pays que vous ciblez.

La valeur que vous fournissez dans feedLabel est automatiquement appliquée à l'attribut targetCountry.

Pour en savoir plus, consultez l'article de blog Le libellé de flux remplace le pays cible dans Content API for Shopping.

8 déc. 2021

Service des comptes

Ressource Accounts

Ajout d'une nouvelle section Account.AutomaticImprovements dans la ressource Accounts.

Les marchands pourront ainsi mettre à jour automatiquement leurs articles, et améliorer leurs images et leurs paramètres de livraison.

25 oct. 2021

Service Promotion

Ajout de "Get Promotion" à Promotion API.

11 oct. 2021

API Shipping Settings

Ajout d'un nouveau champ warehouse dans la ressource ShippingSettings pour permettre aux marchands de gérer les entrepôts pouvant être utilisés dans WarehouseBasedDeliveryTime.

Ajout d'un champ warehouseName dans WarehouseBasedDeliveryTime pour faire référence à entrepôt par son nom.

4 octobre 2021

Service des comptes

Ressource Accounts

Ajout d'un nouveau champ "phone_verification_status" dans la section Accounts.BusinessInformation. Ce champ en lecture seule est défini par Accounts.VerifyPhoneNumber.

13 septembre 2021

Service BuyOnGooglePrograms

Ressource BuyOnGoogleProgramStatus

Ajout de champs à la ressource BuyOnGooglePrograms.BuyOnProgramStatus pour les canaux de ventes en ligne, les modèles économiques et le numéro de téléphone du service client.

Nouvelle méthode UpdateBuyOnGoogleProgramStatus

Ajout d'une nouvelle méthode UpdateBuyOnGoogleProgramStatus qui permettra de mettre à jour la ressource BuyOnGooglePrograms.BuyOnProgramStatus étendue.

6 septembre 2021

Service des comptes

Ressource Accounts

Ajout d'un nouveau champ "korean_business_registration_number" dans la section Accounts.BusinessInformation. Ce champ ne sera effacé que s'il est explicitement défini sur une chaîne vide.

30 août 2021

Service Promotion

Ajout du service Promotion offrant la possibilité d'insérer une promotion.

Service des commandes

Ajout d'une méthode orders/captureOrder pour récupérer les fonds avant l'expédition.

Nouveau motif d'annulation de commande FAILED_TO_CAPTURE_FUNDS

Service des produits

Ressource Product

Ajout de productLength, productHeight, productWidth et productWeight pour fournir les dimensions et le poids des produits.

9 août 2021

Service RepricingRule

Type RepricingRule

Nouvelle valeur d'énumération pour le champ RepricingRuleType.

Ajout de TYPE_SALES_VOLUME_BASED et de TYPE_COMPETITIVE_PRICE.

17 mai 2021

Service Order Returns Label

Ajout d'un nouveau champ "product_id" dans CreateReturnRequest. Les marchands peuvent spécifier les attributs product_id ou line_item_id pour identifier l'article à retourner.

Service des produits

Ajout d'une méthode pour mettre à jour des produits existants. Vous pouvez mettre à jour un produit en ne fournissant que les champs qui doivent être mis à jour, et non toutes les informations sur le produit.

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

API Shipping Settings

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 des produits

Ressource Product

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

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

28 janvier 2021

Service des comptes

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 lister 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 des produits

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 des comptes

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 lister 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 des produits

Ressource Product

Nouveaux champs

Nouveaux champs productDetails, productHighlights, subscriptionCost et canonicalLink.

2 juin 2020

Service des commandes

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 le client ne les renvoie pas.

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

API Settlement Report

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

API Pub/Sub Notification Settings

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

3 décembre 2019

Service des produits

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

11 septembre 2019

Service des commandes

Il est désormais possible de demander la livraison des commandes en point retrait 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 des commandes

Ressource Order

Nouveau champ

Nouveau champ quantityUndeliverable.

7 août 2019

Service des commandes

Ressource Order

Nouveaux champs

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

1er juillet 2019

Service des produits

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

11 juin 2019

Service des commandes

Ressources Order et TestOrder

Ajout du champ d'ajustement du prix

Le nouveau champ lineItem[].adjustments permet d'ajuster le prix d'origine de l'article 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.

Les méthodes "patch" ne sont plus disponibles

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

  • Comptes
  • Accounttax
  • Flux de données
  • Liasettings
  • Shippingsettings

Suppression des méthodes HTTP BATCH

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

  • Comptes
  • Accountstatuses
  • Flux de données
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos.
  • Produits
  • Productstatuses
  • Shippingsettings

Service des comptes

Mettre à jour

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 ( {}) pour les supprimer. Dans la version 2.1, les champs sont supprimés si vous indiquez un corps vide ou si vous ne les renseignez pas.

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

Ces champs ont été remplacés par itemLevelIssues.

Service Datafeed

Ressource Datafeed

Suppression des champs obsolètes

Les champs contentLanguage, targetCountry et intendedDestinations ont été supprimés et 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 d'inventaire

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 la mise à jour des données produit en magasin.

Service des commandes

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.

Remboursement

Cette méthode a été supprimée. Utilisez returnRefundLineItem à la place.

ReturnLineItem

Cette méthode a été supprimée. Utilisez returnRefundLineItem à la place, 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. Vous ne pouvez pas créer de commandes de test avec des promotions.

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 des produits

La réponse générée par la méthode insert ne contient que 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 des chiffres (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 en plus du champ d'origine value. Un seul de ces champs doit être défini, ce qui signifie 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 productType et additionalProductTypes par ProductTypes

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.

Liste

Le paramètre includeInvalidInsertedItems a été supprimé. Tous les produits sont désormais affichés, qu'ils soient valides ou non, ce qui signifie que 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

Ces champs ont été remplacés par itemLevelIssues.