Journal des modifications de l'API

​

23 octobre 2026

​

Modifié

• Dates d’obsolescence : Les opérations, paramètres et champs obsolètes de l’API publique indiquent désormais la date à laquelle ils ont été marqués comme obsolètes. Les dates ci-dessous correspondent au premier marquage de chaque élément dans la spécification OpenAPI publique.
  • POST /public/v1/toptimize/forecasting/campaign — 2026-08-06. Utilisez POST /public/v1/toptimize/forecasting/campaigns/listing.
  • DELETE /public/v1/media-service/slots/{slot_id}/fallback — 2026-09-10. L’endpoint renvoie toujours 403. Gérez les fallbacks de bannière dans le tableau de bord Topsort.
  • sort_by_date sur GET /public/v1/campaign-service/campaigns — 2025-06-19. Utilisez order_by.
  • amountRemaining, amountCarryover et amountUsed sur budget — 2025-12-19.
  • bidCount dans les réponses de campagne — 2025-12-19.
  • externalVendorId dans les réponses de campagne — 2022-11-30. Utilisez vendorId.
  • campaignBehaviorData et campaignBehaviorDataByDay dans les réponses de campagne — 2023-08-31.
  • bidsBehaviorData dans les réponses d’enchère — 2023-09-22.
  • parentId sur les catégories — 2026-02-09. Utilisez path.
  • ean sur les produits et les mises à jour partielles de produit — 2026-08-06. Utilisez gtin.

​

16 octobre 2026

​

Ajouté

• Exports asynchrones : Choisissez et combinez les dimensions et mesures prises en charge, y compris de nouvelles options indisponibles via les anciens endpoints de reporting. Exportez des jeux de données plus volumineux dans un seul fichier Parquet pouvant atteindre 1 GiB, avec des fenêtres allant jusqu’à 31 jours et des données remontant à 120 jours. Les exports s’exécutent en arrière-plan : demandez un export, recevez un ID et téléchargez le fichier lorsqu’il est prêt. Voir Exports de données personnalisés.
  • /public/v1/export-service/exports (POST)
  • /public/v1/export-service/datasets (GET)
  • /public/v1/export-service/exports/{export_id} (GET)

​

9 octobre 2026

​

Modifié

• Réponses de budget des campagnes : amountRemaining, amountCarryover et amountUsed sur les objets budget des campagnes sont dépréciés. Le 19 octobre 2026, ces champs seront entièrement supprimés des réponses. amount et type restent inchangés. Le même objet budget est renvoyé pour les campagnes sponsored brand. Voir la référence Get campaigns.

​

Modifié

• Collections de l’API Assets : Les cinq endpoints beta de collections ci-dessous sont dépréciés depuis le 18 août 2026. Ils continuent de fonctionner comme avant jusqu’à leur suppression le 27 août 2026 ; après cette date, les requêtes vers ces endpoints échoueront. Les endpoints pour les assets individuels ne sont pas affectés. Voir la référence Assets API.
  • /public/v1/assets/collection (POST)
  • /public/v1/assets/collections (GET)
  • /public/v1/assets/collection/{collection-id} (GET, PATCH, DELETE)

​

Modifié

• Réponses des campagnes : promotionType est marqué comme déprécié depuis le 21 novembre 2024 ; utilisez adFormat dans les réponses des campagnes et formatProperties dans les réponses d’enchères à la place. Voir la référence Get campaigns. À partir du 23 avril 2026, promotionType sera renvoyé en null ; la suppression des requêtes et des réponses est prévue pour le 30 avril 2026 (sous réserve de confirmation).

​

Supprimé

• /public/v1/campaign-service/estimated-clicks a été supprimé après 1 an de dépréciation. Il n’a reçu aucun trafic pendant 7 mois.

​

Ajouté

• Endpoint /public/v1/offsite-ads/audiences/user-list pour gérer les audiences de listes d’utilisateurs dans les annonces hors site.

​

Modifié

• /v2/auctions : Champ filter ajouté avec schéma AttributesFilter pour le filtrage des attributs de produit (prend en charge les opérateurs and/or avec tableau d’attributs).

​

Modifié

• /v2/auctions : Objet page ajouté aux demandes d’enchères de listings sponsorisés et bannières.
• /v2/auctions/sponsored-brand : Champ optionnel page ajouté à la demande.

​

Ajouté

• Endpoints /public/v1/campaign-service/campaigns/exclusive-banner (POST) et /public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id} (GET, PATCH) pour la gestion des campagnes de bannière exclusive.
• Endpoints /public/v1/campaign-service/campaigns/exclusive-listing (POST) et /public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id} (GET, PATCH) pour la gestion des campagnes de listing exclusif.
• Endpoint /public/v1/media-service/slots/{slot-id} avec méthodes DELETE et PATCH pour la gestion individuelle des emplacements.
• Méthode POST ajoutée à /public/v1/offsite-ads/audiences pour créer des tâches d’audience.

​

Ajouté

• Endpoints /public/v1/campaign-service/json-templates (GET, POST) et /public/v1/campaign-service/json-templates/{json-template-id} (GET, PATCH) pour gérer les modèles JSON de campagne.
• Endpoint /public/v1/media-service/slots (GET, POST) pour lister et créer des emplacements médias.
• Endpoint /public/v1/media-service/slots/{slot-id}/fallback (DELETE) pour configurer le comportement de repli de l’emplacement.
• Endpoint /public/v1/offsite-ads/audiences (GET) pour lister les audiences dans les annonces hors site.
• Méthode DELETE ajoutée à /public/v1/campaign-service/campaigns/{campaign-id}/bids pour supprimer toutes les enchères.

​

Ajouté

• Endpoint /public/v1/toppie/reporting/file-reports/daily-kpis-by-product (GET) pour exporter les KPI quotidiens par produit.
• Endpoint /public/v1/campaign-service/campaigns/{campaign-id}/products (GET, PUT) pour gérer les produits au sein d’une campagne.
• Endpoints publics d’API d’annonces hors site sous /public/v1/offsite-ads

​

Ajouté

• Endpoints /public/v1/toptimize/forecasting/campaign (POST), /public/v1/toptimize/forecasting/inventory (POST) et /public/v1/toptimize/forecasting/marketplace (GET) pour les prévisions de campagne et d’inventaire.

​

Ajouté

• Endpoints bêta d’Annonces Hors Site (/v2/offsite-ads/)
• Endpoint bêta /toptimize/v1/predictions pour les prédictions CTR/CVR.
• Endpoint bêta /toptimize/v1/retrieval pour la récupération d’objets.
• Endpoint /public/v1/segment-service/segments/{segment-id}/upload (POST) pour télécharger des données de segment.
• Endpoints /public/v1/campaign-service/campaigns/{campaign-id}/restrictions (GET, POST) et /public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id} (PATCH) pour la gestion des restrictions de campagne.
• Endpoints /public/v1/campaign-service/restriction-types (GET) et /public/v1/campaign-service/restriction-types/{restriction-type-id} (GET) pour gérer les définitions des types de restriction.
• Endpoint /public/v1/reporting-service/file-reports/scored-attribution (GET) pour les rapports de fichiers d’attribution notée.
• Endpoint /public/v1/reporting-service/file-reports/interactions (GET) pour exporter les données d’interaction.
• Méthode DELETE ajoutée à /public/v1/toppie/campaigns/{campaign-id} pour supprimer les campagnes.

​

Modifié

• Événements : Références manquantes ajoutées pour afficher le nouvel objet pageview.
• /v2/events : Champs optionnels deviceType et channel ajoutés pour les impressions, clics, achats et pageviews.

​

Ajouté

• Endpoint bêta /toptimize/v1/rank pour classer les objets.
• Endpoints /public/v1/segment-service/segments (GET, PUT) et /public/v1/segment-service/segments/{segment-id} (DELETE) pour la gestion des segments.
• Endpoint /public/v1/segment-service/segments/{segment-id}/signed-url (GET) pour obtenir des URL signées pour les téléchargements de segments.
• Endpoint /public/v1/toppie/products (GET) pour lister les produits fournisseur dans Toppie.
• Endpoint /public/v1/reporting-service/interactions (GET) pour interroger les données d’interaction.
• Endpoint /public/v1/toppie/account/balance (GET) pour voir le solde du compte.
• Endpoint /public/v1/toppie/account/topups (GET) pour voir les rechargements du compte.
• Endpoint /public/v1/billing-service/campaign-billing-contact (GET, PUT).
• Endpoints /public/v1/billing-service/billing-contacts (GET) et /public/v1/billing-service/billing-contacts/{billing-contact-id} (GET, PUT) pour la gestion des contacts de facturation au niveau du marketplace.
• Endpoints /public/v1/billing-service/vendor-billing-contact (PUT) et /public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id} (DELETE) pour les contacts de facturation au niveau du fournisseur.
• Méthode PATCH ajoutée à /public/v1/toppie/campaigns/{campaign-id} pour mettre à jour les campagnes.

​

Modifié

• /v2/auctions/sponsored-brand : Champs optionnels opaqueUserId et vendorId ajoutés.
• Événements : Exemple de suivi de placement ajouté pour l’analyse de carrousel.
• /v2/auctions/travel : Étendu pour prendre en charge les vols en plus des hôtels.

​

Ajouté

• Endpoints /public/v1/toppie/campaigns (GET, POST) et /public/v1/toppie/campaigns/{campaign-id} (GET) pour la gestion des campagnes Toppie.
• Endpoint /public/v1/toppie/campaigns/{campaign-id}/bids (GET) pour gérer les enchères de campagne.
• Endpoints de rapport Toppie (/public/v1/toppie/reporting)
• Endpoints /public/v1/billing-service/vendors/{external-vendor-id}/wallets (GET, POST) et /public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust (POST) pour la gestion du portefeuille fournisseur.
• Méthode PATCH ajoutée à /public/v1/catalog-search-service/catalogs/products pour mettre à jour les produits.

​

Modifié

• Événements : Documenté que l’attribution halo nécessite vendorId.

​

Ajouté

• Endpoint /v2/auctions/travel pour les enchères de voyages d’hôtel.
• Endpoint bêta /v2/events/beta/link-users pour lier les comptes utilisateur.
• Endpoints /public/v1/reporting-service/marketplace/campaigns-kpis (GET) et /public/v1/reporting-service/marketplace/vendors-kpis (GET) pour les rapports KPI au niveau du marketplace.