Passer de la version 2 à la version 2.1

Nouveaux comportements

Service Accounts

  • Vous pouvez désormais supprimer businessInformation et googleMyBusinessLink dans une requête de mise à jour sans avoir à indiquer un corps vide ({}).

  • Les champs suivants liés à AdWords ont été renommés :

    • adwordsLinks -> adsLinks
    • adwordsLinks.adwordsId -> adsLinks.adsId

Ressources Order et TestOrder

  • Les marchands ne doivent pas fournir les données relatives aux taxes dans leurs appels d'API, car elles sont automatiquement calculées. L'ajout de ces données fait échouer l'appel si la commande est exécutée dans un État où une loi sur l'équité du marché (Marketplace Fairness Act) ou similaire est en vigueur. Pour les marchands qui opèrent dans des États non soumis à ce type de législation, la taxe calculée dépend des paramètres définis dans Merchant Center. Si aucun paramètre n'est défini, la taxe calculée est égale à 0.

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.

  • 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 : +, -, . ainsi que les chiffres (ex. : 0-9). Les virgules ne sont plus acceptées.

Ressource Product

  • Les valeurs non valides pour les attributs ci-dessous ne déclenchent plus d'erreur d'insertion, mais sont renvoyées en tant que itemLevelIssues dans productstatus.

    • ageGroup
    • availability
    • condition
    • energyEfficiencyClass
    • gender
    • maxEnergyEfficiencyClass
    • minEnergyEfficiencyClass
    • sizeSystem
    • sizeType
  • Les attributs personnalisés sont désormais récursifs. De ce fait, les groupes personnalisés ne sont plus nécessaires.

  • Les attributs personnalisés disposent désormais du champ groupValues en plus du champ d'origine value. Un seul de ces champs doit être défini.

  • Les attributs personnalisés ne contiennent plus de type ni d'unité. À la place, les unités doivent être ajoutées à la valeur et les types sont automatiquement détectés.

  • Le champ répété productTypes remplace à la fois productType et additionalProductTypes.

  • Les champs répétés includedDestinations et excludedDestinations remplacent le champ répété destinations.

  • Les champs suivants liés à AdWords ont été renommés :

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

Fonctionnalités obsolètes

  • Le format XML n'est plus accepté. Si vous souhaitez connaître la procédure à suivre pour passer à JSON, consultez cet article de blog afin d'obtenir plus de détails et des suggestions.

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

  • Toutes les méthodes HTTP BATCH ont été supprimées de la version 2.1. Utilisez plutôt customBatch.

  • La méthode patch() a été supprimée des services suivants :

    • Accounts
    • Accounttax
    • Datafeeds
    • Liasettings
    • Shippingsettings

Accounts

  • Le champ obsolète reviewsUrl a été supprimé.

  • L'état inactive des liens a été supprimé pour adsLinks, googleMyBusinessLink et youtubeChannelLinks.

Datafeed

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

  • Les flux incluant contentType = "product inventory update" ont été supprimés.

Inventaire

Order et TestOrder

  • CancelLineItem

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

  • InStoreRefundLineItem et 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.
  • Refund a été supprimé. Utilisez returnRefundLineItem à la place.

  • ReturnLineItem a été supprimé. Utilisez returnRefundLineItem à la place, sans indiquer de montant de remboursement.

  • ShipLineItem

    • Les champs carrier, shipmentId et trackingId de la requête ont été déplacés vers shipmentInfos.
  • Le champ paymentMethod a été supprimé, et billingAddress ainsi que predefinedBillingAddress sont désormais des champs de premier niveau dans Order et TestOrder, respectivement.

  • customer.explicitMarketingPreference a été remplacé par customer.marketingRightsInfo.

  • Les champs obsolètes customer.email, channelType et lineItem.product.channel ont été supprimés.

  • Le champ promotions a été supprimé de TestOrder et son format a été modifié dans Order.

  • Le champ netAmount a été divisé en netPriceAmount et netTaxAmount.

  • shippingOption a été remplacé par lineItems[].shippingDetails.

Orderinvoice

  • Les soldes (marchand, client et Google) ont été supprimés de invoiceSummary et des champs liés aux promotions.

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

Orderpayments

  • Ce service a été supprimé.

Products

  • Le paramètre includeInvalidInsertedItems a été supprimé.

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

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

Productstatuses

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

  • Le paramètre includeInvalidInsertedItems a été supprimé. Le champ productId de chaque produit est désormais affiché, que le produit soit valide ou non.

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

  • dataQualityIssues a été remplacé par itemLevelIssues.