11 avril 2023
Service Shipping Settings
Livraison locale
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 Accounts
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évr. 2023
Service Promotions
Service Promotions étendu à six options targetCountry supplémentaires grâce à la compatibilité locale de contentLanguage :
BRESNLJPITKR
12 jan. 2023
Service Products
Ressource Product
Ajout de lifestyleImageLinks pour fournir les URL d'images de style de vie.
24 nov. 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 :
- les rapports Meilleures ventes avec les tableaux
BestSellersProductClusterViewetBestSellersBrandView; - le rapport Compétitivité tarifaire avec le tableau
PriceCompetitivenessProductView; - le rapport Tendances des prix avec le tableau
PriceInsightsProductView.
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 sept. 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 à l'attribut feedLabel de 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 Accounts
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
Shipping Settings API
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 nouveau champ warehouseName dans WarehouseBasedDeliveryTime pour faire référence à entrepôt par son nom.
4 oct. 2021
Service Accounts
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 sept. 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 sept. 2021
Service Accounts
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 Orders
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 Products
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 Products
Ajout d'une nouvelle 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
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 : ajout de minHandlingTime, maxHandlingTime, minTransitTime et maxTransitTime à 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 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 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 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 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 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
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 des commandes en point de retrait 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 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.
Les méthodes "patch" ne sont plus disponibles
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 ({}) 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 :
adwordsLinks->adsLinksadwordsLinks.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
localinventorypour la mise à 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. 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. Il est actuellement impossible 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 :
channelcontentLanguageidofferIdtargetCountry
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 : +, -, . ainsi que 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.
Étant donné que 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.
Modification du nom des champs associés à AdWords
Suite au changement de nom d'AdWords, qui est devenu Google Ads, les champs suivants associés à AdWords ont été renommés :
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Suppression des champs obsolètes
Les champs obsolètes suivants ont été supprimés :
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
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
dataQualityIssues a été remplacé par itemLevelIssues.