Un lecteur vidéo est relié à une fiche source, à une chronologie de notes et à une note vérifiée. Une fiche avec un point d’interrogation se trouve au-dessus.

Pour une vérification ponctuelle, commencez sur la page publique de la vidéo. Lisez le commentaire, regardez le moment indiqué et vérifiez le contexte des réponses. Utilisez la méthode de collecte ci-dessous pour enregistrer un ensemble que vous pourrez consulter et vérifier à nouveau.

Une proposition publique d’un lecteur, publiée le 20 novembre 2024 ; un problème de navigation signalé décrit la difficulté : « Parcourir la section des commentaires dans un navigateur peut être difficile. » Un index utile doit préserver la discussion tout en facilitant la recherche de ses repères temporels.

Ce guide explique comment créer cet index. Il porte sur une sélection de commentaires publics et de réponses. Il ne couvre pas le chat en direct, les données privées de YouTube Studio ni l’avis de chaque spectateur. Aucune collecte réelle de commentaires n’a été effectuée pour ce guide.

1. Définir le moment de la vidéo et les limites de collecte

Choisissez une vidéo publique connue. Notez son identifiant, son URL publique et sa durée. Un identifiant est un code qui permet de reconnaître un enregistrement source. La durée est le temps de lecture total de la vidéo.

Notez le moment à étudier avant de sélectionner les commentaires. Vous pouvez choisir une position exacte ou un intervalle avec un début et une fin. Précisez si la fin est incluse dans l’intervalle de recherche. Cela évite que vos choix ultérieurs modifient la question.

Une correspondance dans l’index signifie qu’un commentaire contient une référence vérifiée dans cet intervalle. Cela ne signifie pas que vous avez trouvé toutes les discussions sur la scène. Certains commentaires décrivent une scène sans indiquer sa position.

Définissez ensuite les limites de collecte :

1. Définir le moment de la vidéo et les limites de collecte
ParamètreÉléments à noter
VidéoIdentifiant connu et URL de la vidéo publique
DuréeDurée totale en secondes et source de la vérification
Moment ciblePosition exacte ou intervalle défini
Ordre des commentairesLes plus populaires, les plus récents ou les deux
Plafond de commentairesNombre maximal de commentaires de premier niveau demandés par vidéo
Plafond de réponsesNombre maximal de réponses demandées par commentaire de premier niveau
Date et heure de collecteMoment où les enregistrements ont été collectés

Un commentaire de premier niveau est un commentaire qui n’est pas une réponse. Un plafond est une limite maximale. Il ne garantit pas que la source renverra autant d’enregistrements.

L’ordre « Les plus populaires » suit le classement mis en avant par la source. L’ordre « Les plus récents » suit son classement par date récente. L’option « Les deux » utilise les deux listes et supprime les identifiants de commentaire répétés pendant l’exécution. Ces choix définissent un échantillon limité. Pour choisir l’ordre, consultez le guide d’échantillonnage des commentaires.

2. Collecter un petit ensemble avec les réponses

Un Actor est un programme hébergé qui collecte des données. Le contrat de YouTube Comments Scraper, vérifié le 25 octobre 2026 ; documentation uniquement décrit la collecte de commentaires publics à partir d’URL ou d’identifiants de vidéos connus. Il décrit aussi la collecte facultative des réponses, avec un plafond.

L’Actor fournit les enregistrements des commentaires. Vous devez extraire les repères temporels, vérifier la vidéo et créer l’index.

Utilisez ces quelques paramètres d’entrée comme point de départ :

json
{
  "startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "maxCommentsPerVideo": 20,
  "commentSortMode": "newest",
  "includeReplies": true,
  "maxRepliesPerComment": 5
}
2. Collecter un petit ensemble avec les réponses

Remplacez toute la liste `startUrls` par la vidéo publique souhaitée. L’URL de chanson fournie sert à illustrer le schéma d’entrée. Elle ne prouve pas que cette vidéo fournit des commentaires utiles pour cette méthode.

Ces paramètres demandent jusqu’à 20 commentaires uniques de premier niveau, dans l’ordre « Les plus récents ». Ils demandent aussi jusqu’à 5 réponses pour chaque commentaire de premier niveau collecté. Les réponses occupent des lignes supplémentaires. Elles ne sont pas décomptées du plafond de premier niveau. Ces nombres sont des limites demandées, pas des nombres de résultats renvoyés ni de personnes.

Le schéma d’entrée documenté accepte de 1 à 100 entrées vidéo. `maxCommentsPerVideo` accepte des nombres entiers de 1 à 1 000. Lorsque les réponses sont activées, `maxRepliesPerComment` accepte des nombres entiers de 1 à 100.

Une Task est un ensemble de paramètres d’entrée enregistré. La Task publique d’export des commentaires et réponses, vérifiée le 25 octobre 2026 ; présence de la page uniquement sert de point de départ pour cette collecte. Remplacez sa liste de vidéos d’exemple et vérifiez ses paramètres avant de l’utiliser.

Les paramètres d’entrée fournis ont passé une vérification selon les règles d’entrée documentées. La page publique de la Task et son identifiant ont été trouvés. Aucun paramétrage enregistré ni aucune exécution payante n’ont été vérifiés. Ces vérifications ne prouvent ni la réussite de la collecte ni la collecte complète des réponses.

3. Enregistrer les commentaires séparément des repères temporels

Conservez deux tables. La table des commentaires contient les enregistrements d’origine de la discussion. La table des relations contient les liens entre les commentaires et les positions dans la vidéo. Une relation est un lien enregistré entre deux éléments.

Conservez une seule ligne par identifiant stable de commentaire. Si vous regroupez plusieurs vidéos, utilisez l’identifiant de la vidéo avec celui du commentaire. Ne fusionnez pas des commentaires parce que leur texte est identique.

Enregistrez ces champs de la source lorsqu’ils sont présents :

3. Enregistrer les commentaires séparément des repères temporels
ChampUtilisation
`videoId`Identifier la vidéo
`videoUrl`Ouvrir la vidéo source
`commentId`Identifier le commentaire
`parentCommentId`Relier une réponse à son commentaire parent
`isReply`Distinguer une réponse d’un commentaire de premier niveau
`replyDepth`Conserver le niveau de réponse documenté
`text`Conserver le texte original du commentaire
`sortMode`Conserver l’ordre de la source utilisé pour cette ligne
`publishedAt`Conserver la date exacte de publication lorsqu’elle est disponible
`publishedTimeText`Conserver le libellé affiché du moment de publication
`updatedAt`Conserver la date exacte de mise à jour lorsqu’elle est disponible
`scrapedAt`Noter la date et l’heure de collecte
`status`Conserver le résultat de la ligne

La ressource des commentaires YouTube, vérifiée le 25 octobre 2026 ; notions d’identité et de temps uniquement distingue l’identifiant d’un commentaire de celui du parent d’une réponse. Son horodatage de publication indique quand le commentaire a été publié. Il ne désigne pas une position dans la vidéo. L’Actor possède ses propres champs documentés.

Laissez les valeurs manquantes telles quelles. Une valeur nulle dans `publishedAt` signifie que la date exacte est indisponible. Elle ne signifie pas zéro. Ne la remplacez pas par `scrapedAt` et ne la convertissez pas en position dans la vidéo.

Conservez les liens vers les commentaires parents, même si ces parents manquent dans votre export. Notez ce manque de contexte. Ne rattachez pas une réponse à un autre commentaire parce que les formulations semblent proches.

4. Extraire chaque repère temporel écrit comme candidat

Un repère temporel est un court fragment de texte qui peut désigner une position dans la vidéo. Par exemple : 37:07 ou 1:02:03. Un candidat est une référence possible que vous n’avez pas encore confirmée.

Lisez le texte original et créez une ligne de relation pour chaque occurrence candidate. Conservez le repère original et la position de son premier caractère. Comptez à partir de zéro : le premier caractère occupe la position 0.

Ne modifiez ni les espaces ni la ponctuation avant de noter les positions. Un autre lecteur doit pouvoir retrouver le même repère dans le texte enregistré. Si vous utilisez une autre règle de comptage, précisez-la et appliquez-la partout.

Votre table des relations doit contenir les champs suivants. Vous les créez pour l’index. Ils ne font pas partie des résultats garantis par l’Actor :

4. Extraire chaque repère temporel écrit comme candidat
Champ enregistréBut
Identifiant de la vidéo et du commentaireRetrouver le commentaire source
Repère originalConserver le repère temporel écrit
Position de début du repèreDistinguer les occurrences dans un même commentaire
Valeur convertie en secondesComparer les positions valides avec une même unité
Durée connueVérifier si la position se trouve dans la vidéo
Résultat de validationIndiquer si le candidat est valide, invalide ou en attente
Contexte du commentaire parentRelier le commentaire parent ou noter le contexte manquant
État de vérificationNoter ce que la vérification de la vidéo a établi
AnnotationExpliquer brièvement la décision
Date et heure de vérification et personne responsableNoter qui a vérifié la relation et quand

Un commentaire peut contenir plusieurs repères temporels. Un même repère peut aussi apparaître deux fois dans un commentaire. Gardez ces occurrences distinctes lors de l’extraction. Aucun de ces cas ne crée un commentaire supplémentaire ni une personne supplémentaire.

Une réponse peut traiter du moment indiqué par son commentaire parent sans contenir elle-même de repère temporel. Conservez cette réponse comme contexte. Ne lui inventez ni repère ni référence vérifiée à une scène.

5. Valider le repère avant la conversion

Vérifiez le repère entier avant de calculer les secondes. Ne transformez pas un repère négatif ou mal formé en position valide en n’en prenant qu’une partie.

Appliquez ces règles :

  1. Acceptez le format minutes-secondes ou le format heures-minutes-secondes.
  2. Les secondes doivent être inférieures à 60.
  3. Dans le format avec heures, le groupe central des minutes doit être inférieur à 60.
  4. Rejetez les valeurs négatives et les groupes invalides.
  5. Convertissez les repères valides en secondes.
  6. Comparez le résultat à la durée connue de la vidéo.

Pour les minutes et les secondes, multipliez les minutes par 60, puis ajoutez les secondes :

37:07 = 37 × 60 secondes + 7 secondes = 2 227 secondes.

Pour les heures, les minutes et les secondes, multipliez les heures par 3 600 et les minutes par 60, puis ajoutez les secondes :

1:02:03 = 1 × 3 600 secondes + 2 × 60 secondes + 3 secondes = 3 723 secondes.

Dans le format à deux groupes, les minutes forment le premier groupe. Elles peuvent dépasser 59. Dans le format à trois groupes, les heures forment le premier groupe. Les groupes suivants, minutes et secondes, doivent rester inférieurs à 60.

Ainsi, 37:67 échoue à la validation. Ne le corrigez pas sans le signaler. Conservez le repère original et la raison de son rejet.

Un repère qui dépasse la durée connue doit rester en attente de vérification. Ne le déplacez pas vers la position valide la plus proche. Si la durée est inconnue, laissez la vérification de durée non résolue. Un repère situé exactement à la fin exige aussi une vérification par lecture avant de le qualifier de référence à une scène.

Zéro est différent d’une valeur manquante. Le repère 0:00 désigne le début de la vidéo. Un champ de conversion vide signifie qu’aucune conversion acceptée n’est disponible.

6. Regarder le moment et lire la discussion

Un nombre valide reste un simple candidat. Il peut désigner autre chose. Regardez le moment indiqué avant de le classer.

Pour chaque candidat qui passe les vérifications :

  1. Ouvrez la vidéo correspondante et allez à la position convertie.
  2. Regardez et écoutez le passage autour de cette position.
  3. Lisez le commentaire original.
  4. Lisez son commentaire parent et les réponses disponibles.
  5. Notez brièvement ce que vous avez pu confirmer.
  6. Attribuez un état de vérification.

Utilisez ces états de façon constante :

6. Regarder le moment et lire la discussion
ÉtatSignification
Référence à une scène vérifiéeLa vidéo et la discussion confirment le lien avec ce moment
Repère sans rapportLe texte vérifié utilise le repère pour autre chose que cette position dans la vidéo
Non résoluUn fait ou une source nécessaire n’a pas pu être vérifié
Hors périmètreLa référence ne relève pas de l’étude définie

Gardez les résultats de validation séparés de ces états de vérification. Un repère invalide échoue à une vérification de format. Une référence non résolue manque d’un fait nécessaire. Une référence vérifiée hors de votre intervalle cible peut rester dans l’index général sans figurer dans les résultats ciblés.

Rédigez des annotations qui décrivent le lien. Ne déduisez ni l’intention d’un spectateur ni un avis partagé par le public. Le plafond de réponses peut aussi vous priver d’un contexte utile. Précisez cette limite.

Pour déterminer s’il manque une explication dans un tutoriel, poursuivez avec la vérification des lacunes pédagogiques. Une référence à une scène ne suffit pas à établir une lacune pédagogique. Pour trouver une explication qu’aucun commentaire ne mentionne, utilisez la méthode distincte de navigation par concept.

7. Suivre un exemple fictif original

Tout cet exemple est une fiction originale. La vidéo, les commentaires, la réponse et les notes de visionnage sont inventés pour enseigner la méthode. Ce ne sont pas des résultats de l’Actor. Aucune collecte réelle de commentaires ni aucune vérification par lecture n’ont eu lieu.

La vidéo fictive dure 40:00 :

40 × 60 secondes = 2 400 secondes.

Le commentaire C contient exactement ce texte :

« 37:07 explique le cadre ; 38:10 montre le résultat. »

Les guillemets servent à présenter l’exemple. Ils ne font pas partie du texte du commentaire enregistré. Le premier caractère de 37:07 occupe la position 0.

Conserver un commentaire et deux références

La table des commentaires contient C une seule fois. La réponse R occupe une ligne distincte sous C. Dans cette fiction, R dit : « Cette comparaison m’a aidé. » Elle ne contient aucun repère temporel.

7. Suivre un exemple fictif original
Identifiant du commentaireIdentifiant du parentTexte
CAucun ; commentaire de premier niveau37:07 explique le cadre ; 38:10 montre le résultat.
RCCette comparaison m’a aidé.

Les deux repères de C produisent deux lignes de relation :

7. Suivre un exemple fictif original
Identifiant du commentaireRepèrePosition de début, à partir de zéroPosition convertieVérification de durée
C37:0702 227 secondesDans la limite de 2 400 secondes
C38:10262 290 secondesDans la limite de 2 400 secondes

Le second repère commence à la position 26. La position 25 est l’espace après le point-virgule. Gardez cette position liée au texte inchangé.

Le second calcul est le suivant :

38:10 = 38 × 60 secondes + 10 secondes = 2 290 secondes.

Les deux références sont espacées de 2 290 − 2 227 = 63 secondes. Cet écart ne crée pas un intervalle de scène continu. Le commentaire désigne deux moments distincts.

Appliquer les notes de visionnage fictives

Supposons que les notes de visionnage fictives confirment le cadre à 37:07 et son résultat à 38:10. Les deux relations reçoivent l’état « Référence à une scène vérifiée ». R reste rattachée à C comme contexte de réponse. Aucune référence temporelle n’est inventée pour R.

7. Suivre un exemple fictif original
CommentairePositionÉtatAnnotationContexte des réponses
C37:07Référence à une scène vérifiéeLa note de visionnage fictive confirme le cadreR reste liée à C
C38:10Référence à une scène vérifiéeLa note de visionnage fictive confirme le résultatR reste liée à C

Pour un intervalle cible allant de 37:00 à 37:30 inclus, seule la première relation entre dans les résultats. La seconde reste dans l’index général. C reste un seul commentaire dans les deux vues.

L’exemple contient deux enregistrements de commentaires, dont une réponse. C contient deux mentions de repères temporels. Ces nombres ne permettent pas d’établir un nombre de personnes.

Garder en attente un repère qui dépasse la durée

Considérez maintenant un autre candidat fictif, 41:00 :

41 × 60 secondes = 2 460 secondes.

2 460 − 2 400 = 60 secondes au-delà de la durée de la vidéo fictive.

Le repère respecte le format, mais échoue à la vérification de durée. Gardez-le en attente et notez la raison. Ne le remplacez pas par 40:00. Ce candidat distinct ne modifie pas les nombres indiqués ci-dessus pour C et R.

8. Vérifier l’export et conserver les états d’échec

Exportez l’index de navigation vérifié avec l’URL de la vidéo, la position vérifiée, l’identifiant du commentaire, le contexte du commentaire parent, une courte annotation et l’état. Conservez à côté les tables d’origine des commentaires et des candidats.

Avant d’utiliser l’index, vérifiez que chaque relation renvoie à un commentaire enregistré. Vérifiez à nouveau les positions des repères dans le texte inchangé. Confirmez les calculs et les unités. Assurez-vous que chaque position acceptée appartient à la bonne vidéo.

Gardez ces échecs visibles :

8. Vérifier l’export et conserver les états d’échec
SituationDécision requise
Texte manquantLaisser l’extraction non résolue ; ne pas inventer de mots
Identité manquanteGarder l’enregistrement non résolu ; ne pas inventer d’identifiant
Repère invalideLe conserver avec l’échec de validation
Durée inconnueLaisser la vérification de durée non résolue
Lecture indisponibleLaisser la vérification de la scène non résolue
Commentaire parent ou réponses manquantsNoter le manque de contexte
Échec de la collecteNoter l’échec ; ne pas le traiter comme une collecte réussie avec un échantillon vide
Aucune correspondance vérifiéeSignaler l’absence de correspondances vérifiées dans cet ensemble collecté

Un nombre nul ne s’applique qu’à l’ensemble réellement vérifié. Il ne prouve pas qu’aucun commentaire pertinent n’existe. Présentez séparément le nombre d’identifiants uniques de commentaires et le nombre de mentions de repères temporels. Conservez avec ces nombres l’ordre de la source, les plafonds, les dates de collecte et les enregistrements non résolus.

Sources et lectures complémentaires

Par Chronometrica · Mis à jour

Retour en haut ↑