> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Journal des modifications de l'API

> Mises à jour et modifications de l'API

## Mises à jour et modifications de l'API pour 2026

<Update label="Avril 2026" description="2026-04-16">
  ### 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](/fr/api-reference/campaign-api/get-campaigns#response-campaigns-items-promotion-type). À 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).
</Update>

## Mises à jour et modifications de l'API pour 2025

<Update label="Décembre 2025" description="2025-12-01 au 2025-12-31">
  ### 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.
</Update>

<Update label="Novembre 2025" description="2025-11-03 au 2025-11-26">
  ### 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).
</Update>

<Update label="Septembre 2025" description="2025-09-03 au 2025-09-16">
  ### 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.
</Update>

<Update label="Août 2025" description="2025-08-12 au 2025-08-28">
  ### 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.
</Update>

<Update label="Juillet 2025" description="2025-07-01 au 2025-07-15">
  ### 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.
</Update>

<Update label="Juin 2025" description="2025-06-11 au 2025-06-30">
  ### 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`
</Update>

<Update label="Mai 2025" description="2025-05-01 au 2025-05-30">
  ### 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.
</Update>

<Update label="Avril 2025" description="2025-04-01 au 2025-04-30">
  ### 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.
</Update>

<Update label="Mars 2025" description="2025-03-03 au 2025-03-26">
  ### 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.
</Update>

<Update label="Février 2025" description="2025-02-04 au 2025-02-26">
  ### 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`.
</Update>

<Update label="Janvier 2025" description="2025-01-06 au 2025-01-28">
  ### 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.
</Update>