Mesure et intégrations · YouTube Data API

YouTube Data API ajoute l'image jointe aux commentaires, disponible pour tous en novembre 2026

Propriété documentée, généralisation annoncée en novembre 2026Échéance : novembre 2026État de la documentation au : 20 octobre 2026

Ne pas perdre cette date

Ajouter l’échéance au calendrier

La date est enregistrée comme une journée entière. La fiche reste la source à consulter en cas de report.

01 · Mécanisme

Ce qui change réellement

L'historique de révision de la YouTube Data API indique qu'à la date du 30 septembre 2026, la définition de la ressource comments a été mise à jour. Elle inclut désormais la nouvelle propriété snippet.imageUrl, qui fournit l'URL d'une image ou d'un GIF animé joint à un commentaire. Cette URL est un lien signé d'une durée de vie de six heures : elle expire six heures après sa récupération. La même entrée précise que cette fonctionnalité sera disponible pour tous les utilisateurs en novembre 2026.

L'entrée de l'historique ne précise pas à partir de quel jour de novembre 2026 la fonctionnalité est généralisée. Elle n'indique pas non plus si la propriété est déjà renvoyée pour une partie des commentaires, ni si elle peut être renseignée lors de l'insertion d'un commentaire par l'API.

02 · Impact

Ce que cela change dans le mix

Le risque porte sur les connecteurs qui lisent la ressource comments en supposant un ensemble fixe de propriétés. Un connecteur qui filtre strictement les champs ne récupérera pas snippet.imageUrl. Un connecteur qui valide le schéma à l'identique peut rejeter une réponse comportant une propriété supplémentaire. L'écart se constate en comparant les propriétés effectivement reçues à celles attendues par le connecteur.

Un commentaire peut désormais porter une image ou un GIF animé en plus de son texte. Les outils de modération, d'export ou d'analyse qui ne traitent que le texte des commentaires laisseront donc ce contenu hors de leur périmètre, et ne pourront pas réutiliser l'URL de l'image au-delà du TTL de six heures de l'URL renvoyée. La documentation ne décrit aucune règle de modération propre à ces images : la conservation et le traitement de ces images restent une décision interne à instruire.

03 · Périmètre

Qui doit reparamétrer

Concerné

Connecteurs, scripts d'export et outils de modération qui lisent la ressource comments via comments.list ou commentThreads.list.

Non concerné

Les intégrations qui n'appellent pas comments.list ni commentThreads.list, ou qui ignorent déjà les propriétés inconnues de l'objet snippet.

04 · Réglages

Qu’est-ce que je reparamètre ?

  1. 01

    Recenser les lectures de la ressource comments

    Avant novembre 2026, lister les services, scripts d'export, outils de modération et connecteurs qui appellent les méthodes comments.list et commentThreads.list. Rattacher chacun à un responsable identifié.

    Avant quand
    Avant novembre 2026
    Où
    Journal des appels API · comments.list et commentThreads.list
  2. 02

    Contrôler la tolérance du schéma d'ingestion

    Avant novembre 2026, vérifier connecteur par connecteur le comportement face à la propriété snippet.imageUrl : ignorée, stockée ou rejetée. Consigner le résultat observé plutôt que le comportement supposé.

    Avant quand
    Avant novembre 2026
    Où
    Connecteurs d'ingestion · schéma de l'objet snippet
  3. 03

    Relever les réponses effectivement reçues

    Avant novembre 2026, interroger un échantillon de commentaires récents et relever si snippet.imageUrl apparaît déjà dans les réponses, l'entrée ne précisant pas le jour de généralisation.

    Avant quand
    Avant novembre 2026
    Où
    Réponse API comments.list · propriété snippet.imageUrl
  4. 04

    Étendre la modération aux images jointes

    Avant novembre 2026, vérifier si les outils de modération et de réponse aux commentaires affichent l'image ou le GIF joint. Désigner qui examine ces contenus lorsque l'outil ne traite que le texte.

    Avant quand
    Avant novembre 2026
    Où
    Outils de modération et de réponse aux commentaires
  5. 05

    Décider du traitement de l'URL d'image

    Avant novembre 2026, arbitrer si snippet.imageUrl est stocké, affiché dans les tableaux de bord ou ignoré, en tenant compte du TTL de six heures de l'URL signée renvoyée. Consigner la décision, sa date et son motif.

    Avant quand
    Avant novembre 2026
    Où
    Tableaux de bord et politique de conservation des URL d'image

05 · Rectification

Ce qui circule et ce qui est exact

À écarter

snippet.imageUrl est déjà renvoyée pour tous les commentaires portant une image jointe.

Correction vérifiée

L'historique de révision annonce seulement une disponibilité pour tous les utilisateurs en novembre 2026, sans préciser le jour ni si la propriété est déjà renvoyée pour une partie des commentaires.

06 · Preuves

Sources primaires

07 · Révisions

Historique public

  1. Création de l’entrée depuis la documentation primaire.

  2. Mise à jour validée : les sources, le mécanisme, l'impact, les contrôles.