Comment citer une vidéo YouTube avec exactitude

Ce que vous apportent les sous-titres horodatés

Un Actor est un programme hébergé de collecte de données. L’Actor YouTube Transcript lit une piste de sous-titres publique à partir d’une URL de vidéo que vous connaissez déjà. Une piste de sous-titres est un texte horodaté enregistré avec la vidéo. L’Actor copie ce texte enregistré. Il ne produit pas de nouveau texte à partir de la parole. Il n’identifie pas les personnes qui parlent. Il ne vérifie pas les faits. Il ne peut pas prouver qu’une citation est exacte.

Une Task est un ensemble de paramètres d’entrée enregistrés. La Task YouTube timestamped transcript JSON fournit les paramètres d’entrée publiés pour démarrer. Elle demande des segments horodatés au format JSON. JSON est un format qui permet d’écrire des noms de champs et des valeurs sous forme de texte. Une Task publiée fournit seulement des paramètres d’entrée de départ. Elle ne vérifie pas les citations à votre place.

La version publique 0.1.43 de YouTube Transcript accepte 4 champs d’entrée.

• `startUrls` contient des URL ou des identifiants de vidéos connus.
• `preferredLanguages` contient les codes des langues que vous préférez. Une liste vide n’impose aucune langue.
• `outputFormats` permet de demander le format du résultat. Utilisez JSON.
• Lorsque `includeFailedInputDetails` est défini sur true, une ligne de détails est demandée en cas d’échec d’une entrée.

La Task publiée contient 3 URL de vidéos d’exemple. Ces exemples ne sont pas votre source. Remplacez toute la liste par une vidéo publique connue. Si vous laissez les exemples, vous risquez de lire une ligne provenant d’une autre vidéo. Conservez JSON comme format de sortie. Laissez `includeFailedInputDetails` sur true. Une ligne d’échec peut expliquer le problème. Une ligne d’échec n’est pas une citation vérifiée. L’Actor ne recherche pas les vidéos d’une chaîne. Il ne recherche pas les vidéos d’une playlist.

{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_VIDEO_ID"],
  "preferredLanguages": [],
  "outputFormats": ["json"],
  "includeFailedInputDetails": true
}

Placez l’URL de votre véritable vidéo publique dans `startUrls`. Supprimez toutes les URL d’exemple. Les accolades extérieures délimitent le début et la fin des paramètres d’entrée. Les crochets délimitent le début et la fin d’une liste. Si vous connaissez la langue parlée, placez son code dans `preferredLanguages`. Sinon, conservez la liste vide. Une liste de langues vide ne signifie pas que les sous-titres sont en anglais.

Un contrôle compatible a renvoyé 1 ligne à l’état succeeded. Cette ligne contenait une piste de sous-titres manuels en anglais, non vide. « Manuels » signifie qu’une personne a préparé la piste et qu’il ne s’agit pas d’une piste automatique. Les segments horodatés appartenaient à la vidéo prévue. Vous pouvez reprendre ce constat sur l’état du résultat. Ne reprenez pas les mots d’une vidéo d’exemple. Ces mots ne font pas partie de cette méthode.

Une ligne correspond à un résultat pour une vidéo. Conservez chaque champ renvoyé tel qu’il a été reçu. Voici les champs utiles :

• `videoId` est l’identifiant public de la vidéo.
• `videoUrl` est l’adresse publique de la vidéo.
• `transcriptLanguageCode` est le code de langue des sous-titres.
• `isAutoGenerated` indique si YouTube a créé la piste automatiquement. Le contrôle compatible a utilisé une piste manuelle en anglais : cette piste n’était donc pas automatique. Si ce champ vaut null, vous ne savez pas comment la piste a été créée.
• `text` est le texte des sous-titres de la ligne. Chaque segment possède aussi son propre champ `text`. Conservez les 2.
• `segments` est la liste des portions horodatées. Un segment est une portion horodatée de la piste de sous-titres.
• `status` indique ce qui s’est passé pour cette entrée. Le contrôle compatible a utilisé succeeded. Si l’état n’est pas succeeded, ne citez pas le contenu de cette ligne.
• `scrapedAt` indique quand la ligne a été collectée. Il ne s’agit pas du moment où les paroles ont été prononcées.

Chaque segment conserve `startSeconds`, `endSeconds`, `durationSeconds` et `text`. `startSeconds` indique le début de la portion, mesuré depuis le début de cette vidéo. `endSeconds` indique sa fin. `durationSeconds` est la durée envoyée par l’Actor. Si une valeur est null, laissez-la à null. Null signifie que la valeur est absente. Une valeur absente n’est pas égale à 0.

Vous pouvez vérifier une durée par une simple soustraction. Durée du passage = fin en secondes - début en secondes. Si le résultat ne correspond pas à `durationSeconds`, conservez la valeur de l’Actor. Notez l’écart dans votre fiche de citation. Ne remplacez pas la valeur de l’Actor.

Un sous-titre peut encore être erroné après un état succeeded. Des segments peuvent se chevaucher. Conservez les 2 segments qui se chevauchent. Ne les réunissez pas pour créer une nouvelle phrase. La piste peut omettre un changement de personne qui parle. Elle peut omettre un élément à l’écran qui modifie le sens. Conservez le texte et les repères temporels d’origine. N’inventez pas d’étiquette pour la personne qui parle. Ne remplacez pas un repère temporel de la source par une estimation.

Si une vidéo est privée, vous n’obtenez aucune citation vérifiée. Si elle a été supprimée, vous n’obtenez aucune citation vérifiée. Si elle n’a pas de sous-titres, vous n’obtenez aucune citation vérifiée. Vous pouvez l’écouter et rédiger une transcription humaine. Une transcription est le texte que vous écrivez après avoir écouté. Précisez qu’il s’agit de votre propre transcription. Ne dites pas que l’Actor l’a créée.

`transcriptLanguageCode` ne prouve pas quels mots ont été prononcés. Si vous traduisez, indiquez qu’il s’agit d’une traduction. Ne présentez pas une traduction comme une citation exacte dans la langue d’origine.

Le dispositif conserve un récapitulatif d’exécution avant la vérification des mots. inputsReceived est le nombre d’entrées reçues par l’exécution. uniqueVideosPlanned est le nombre de vidéos différentes que l’exécution prévoyait d’ouvrir. rowsWritten est le nombre de lignes de transcription réussies. successfulTranscriptRows est le nombre de lignes de transcription réussies. Une transcription est le texte écrit des sous-titres accompagné de ses repères temporels. rowsWritten et successfulTranscriptRows ne comptent pas les lignes de détails d’échec enregistrées. failedInputs est le nombre d’entrées pour lesquelles la récupération des sous-titres a échoué. failedInputs ne compte pas le travail inachevé. duplicateVideosSkipped est le nombre de vidéos répétées que l’exécution n’a pas ouvertes à nouveau. statusCounts est le nombre de résultats des entrées traitées pour chaque état de piste. Ces résultats incluent les échecs. L’état de piste est l’étiquette du résultat pour une piste de sous-titres. errorCodeCounts est le nombre d’échecs pour chaque code d’erreur. Un code d’erreur est le nom court d’un type d’échec. failedInputDetails est la liste de chaque entrée en échec et de son erreur. includeFailedInputDetails: true peut enregistrer des lignes de détails d’échec. Ces lignes sont distinctes des décomptes de transcriptions réussies. Vérifiez la concordance de ces enregistrements avant d’examiner les mots. Cela consiste à les comparer jusqu’à ce qu’ils concordent. La vidéo prévue, la langue de la piste, l’état de la piste, les lignes à l’état succeeded, les nombres d’échecs et la liste des échecs doivent tous concorder. La vidéo prévue est celle que l’exécution devait ouvrir. La langue de la piste est la langue indiquée sur cette piste de sous-titres. Une extraction réussie montre seulement que l’exécution a trouvé les sous-titres et leurs repères temporels. Elle ne prouve pas que les mots cités, l’identité de la personne qui parle ou l’affirmation sont corrects.

Vérifiez les mots en 8 étapes

Suivez ces étapes pour chaque court passage que vous envisagez de citer.

1. Écrivez l’affirmation que la citation doit étayer.

Écrivez l’affirmation en une phrase avant de choisir les mots. Choisissez ensuite une vidéo publique connue. Choisissez un court passage à examiner. Vous devez vérifier vous-même les mots prononcés. Un fragment de texte récupéré n’est qu’un repère. Une note indiquant où vous avez cliqué n’est qu’un repère. Ni l’un ni l’autre n’est la citation. Si vous n’écrivez pas d’abord l’affirmation, il est facile de supprimer des mots jusqu’à faire apparaître une autre affirmation.

1. Récupérez le JSON horodaté actuel ou examinez la vidéo manuellement.

Enregistrez l’identifiant de la source, son URL, le code de langue, l’état ainsi que le texte et les repères temporels d’origine des segments. Si les sous-titres sont absents, écoutez et rédigez une transcription humaine. Précisez qu’il s’agit d’une transcription humaine. Ne dites pas que l’Actor l’a créée. Laissez la piste de sous-titres brute inchangée après avoir trouvé une erreur. La piste brute montre ce que l’Actor a envoyé. Votre correction doit figurer dans la fiche de citation, pas dans cette piste.

1. Ouvrez le passage aux repères temporels retenus.

Lisez une portion suffisante de la vidéo avant et après la phrase. Les mots et les images qui l’entourent constituent le contexte. Le contexte montre qui parle. Il montre à quoi renvoie un mot comme « cela » ou « ils ». Il montre une condition, une unité et une négation. Une négation est un mot comme « pas ». Une condition est une exigence qui doit être satisfaite avant l’action. Une unité est une mesure, comme les tasses ou les minutes. Regardez l’image lorsqu’elle peut modifier le sens. Un signe de ponctuation dans les sous-titres ne prouve pas la manière dont la personne a parlé. Le nom d’une personne dans les sous-titres ne prouve pas qui a parlé. Un court segment peut omettre une négation prononcée juste avant. Incluez le segment voisin lorsque la condition s’y trouve.

1. Écoutez à nouveau et écrivez les mots dont vous avez besoin.

Écoutez une fois sans regarder les sous-titres. Transcrivez uniquement les mots exacts dont vous avez besoin. Réécoutez chaque mot dont vous n’êtes pas sûr. Si un mot erroné risque de produire une affirmation fausse aux conséquences graves, demandez à un autre lecteur d’écouter. Si le son manque de clarté, écrivez « peu clair ». Ne comblez pas le manque par un mot probable. Nommez la personne qui parle uniquement à partir d’une présentation ou d’une autre indication explicite dans la source. Une voix qui semble familière ne suffit pas à établir une identité. Une supposition dans les sous-titres ne suffit pas à établir une identité. Si la source ne nomme pas la personne qui parle, écrivez « inconnu ». Ce qui est inconnu reste inconnu. N’écrivez pas de nom et n’écrivez pas 0.

1. Comparez les mots des sous-titres aux mots que vous avez vérifiés.

Écrivez le motif de la correction dans la fiche de citation. Notez l’intervalle temporel de la source que vous avez écouté. Ne modifiez pas le texte brut des sous-titres. Ne modifiez pas les repères temporels bruts. Les mots que vous avez vérifiés constituent votre transcription. Il ne s’agit pas d’un nouveau champ fourni par l’Actor. Ne retouchez pas une phrase tout en conservant les guillemets. Une phrase retouchée peut être plus facile à lire sans être fidèle à la source. Les guillemets garantissent que les mots ont été vérifiés.

1. Choisissez une citation directe ou une reformulation.

Une citation directe reprend les mots vérifiés entre guillemets. Une reformulation exprime le même sens avec vos propres mots. Une reformulation ne prend pas de guillemets, mais conserve un lien vers la source. Vous pouvez omettre des mots uniquement si le sens reste le même. N’omettez pas une condition. N’omettez pas une négation. Si vous supprimez un mot comme « pas », vous pouvez inverser le sens. Respectez les limites de citation du support sur lequel vous publiez. Cette méthode ne vous indique pas ce que le droit d’auteur autorise. Ne copiez pas un long extrait d’une véritable vidéo.

1. Enregistrez la fiche de citation.

Incluez l’affirmation, l’URL de la source et son identifiant. Incluez le début et la fin du passage en secondes. Incluez la langue, les éléments qui identifient la personne qui parle et l’extrait brut des sous-titres. Incluez les mots vérifiés, la méthode de vérification et le moment de la vérification. Incluez une note de contexte, la correction et l’état de vérification. Citez un moment que le lecteur peut ouvrir. Sur ordinateur, YouTube permet de partager un lien qui démarre à un moment choisi. YouTube appelle cette option « Démarrer à ». La page d’aide est Aide au partage YouTube : Démarrer à. Testez un véritable lien horodaté avant de le citer. Confirmez qu’il ouvre la vidéo prévue au moment prévu. Conservez `videoUrl` dans la ligne brute. Un lien vers un moment précis est destiné au lecteur. Il ne prouve pas la citation. Il ne prouve pas l’affirmation. Une personne chargée de la vérification qui ne peut pas ouvrir ce moment ne peut pas vérifier vos mots. Un lien qui ouvre ce moment reste un simple moyen de navigation.

1. Faites ouvrir le passage par une personne chargée de la vérification avant de publier.

La personne chargée de la vérification compare la citation finale à l’audio. Elle la compare aussi à l’affirmation qui l’accompagne. Si un mot nécessaire reste incertain, conservez l’état de vérification `needs_review`. Si la source ne permet pas d’identifier la personne qui parle, conservez `needs_review`. Ne publiez pas une citation à l’état `needs_review` comme si elle avait été vérifiée. `verified_wording` signifie que les mots et les éléments qui identifient la personne qui parle ont été vérifiés. Cela ne signifie pas que l’affirmation a été prouvée. Une transcription exacte peut encore exprimer une affirmation non étayée. Distinguez la vérification des mots de celle de l’affirmation. Une autre personne écoute à nouveau : le contrôle ne repose donc pas sur une seule personne. Cette vérification ne rend pas vraie une affirmation fausse.

Exemple détaillé : fiction originale

La leçon de jardinage de cette section est une fiction originale. Ce n’est pas un résultat de l’Actor. Il ne s’agit ni d’une véritable vidéo ni d’une véritable personne qui parle. Aucun fait tiré de l’image n’est fourni ici. N’en ajoutez pas.

L’identifiant de la source fictive est la valeur de remplacement VIDEO_ID. Un segment brut de sous-titres allant de 42 secondes à 48 secondes indique : « ajoutez de l’eau quand le bac est à niveau. » La personne qui écoute lit ensuite le passage de 38 secondes à 51 secondes. Dans cet intervalle plus large, la personne qui parle dit : « N’ajoutez pas d’eau avant que le bac soit à niveau. »

Le sous-titre omet la négation « pas ». Il omet aussi « avant que », qui porte la condition temporelle. Un lecteur qui cite uniquement le sous-titre brut enseignera l’action contraire. La courte citation vérifiée est : « N’ajoutez pas d’eau avant que le bac soit à niveau. »

Durée du passage = fin en secondes - début en secondes. L’intervalle du sous-titre est de 48 - 42 = 6 secondes. L’intervalle d’écoute est de 51 - 38 = 13 secondes. Enregistrez les 2 intervalles. L’intervalle court correspond au segment brut. L’intervalle plus long correspond au contexte que vous avez entendu.

La présentation fictive nomme l’intervenant A. Conservez cette présentation comme élément d’identification de la personne qui parle. Laissez le sous-titre brut exactement tel qu’il a été reçu. Le motif de la correction est l’absence de la négation et de la condition. L’état de vérification est `verified_wording`. Le moment de la vérification est inconnu dans cette fiction. Une valeur inconnue n’est pas égale à 0.

Voici une reformulation : attendez que le bac soit à niveau avant d’ajouter de l’eau. Ne mettez pas cette reformulation entre guillemets. C’est une autre manière d’exprimer le sens, pas une seconde citation vérifiée. Une citation proposée qui se limiterait à « Ajoutez de l’eau » inverse l’instruction. Elle supprime la négation et la condition. Rejetez-la.

Le passage candidat 2 est lui aussi une fiction originale. Sa ligne de sous-titres est à l’état succeeded. Cette fiction ne fournit pas de phrase brute que l’on puisse reprendre de manière fiable : l’extrait brut reste donc inconnu. N’inventez pas d’unité pour combler le manque. Le mot qui indique l’unité dans l’audio manque de clarté. La source ne confirme pas de changement de personne qui parle. Les mots vérifiés sont inconnus. La personne qui parle est inconnue. Les repères temporels du passage sont inconnus. L’état de vérification est `needs_review`. Ce passage n’est pas vérifié.

2 lignes de sous-titres à l’état succeeded ne deviennent pas 2 citations vérifiées. La réussite de l’extraction des sous-titres montre seulement qu’une ligne a été renvoyée. Seul le passage candidat 1 possède des mots vérifiés, des éléments d’identification de la personne qui parle et un motif de correction.

La décision de publication a une portée limitée. Publiez la citation directe vérifiée du passage candidat 1 uniquement après qu’une personne chargée de la vérification a écouté le passage de 38 secondes à 51 secondes et a donné son accord. Ne publiez pas les mots « Ajoutez de l’eau » comme citation. Ne publiez pas le passage candidat 2. Conservez le passage candidat 2 à l’état `needs_review` jusqu’à ce que l’unité et la personne qui parle soient identifiées.

Pour cette fiction, un lien vers un moment précis suit uniquement ce modèle :

https://www.youtube.com/watch?v=VIDEO_ID&t=42s

Ce modèle ne fournit pas de preuve vidéo que le lecteur puisse visionner. Ce n’est pas une source accessible en ligne. Ne publiez pas VIDEO_ID comme référence factuelle. Lorsque vous appliquez la méthode à une véritable vidéo, citez cette véritable vidéo. Testez d’abord le véritable lien horodaté. Conservez une citation courte. Gardez le contexte de la source à un endroit où le lecteur peut le consulter.

Record 1 (original fiction)
claim: The speaker tells the viewer not to add water until the tray is level.
source id: VIDEO_ID (placeholder, not a real video)
moment link: template only, not playable evidence
passage in seconds: 42
passage out seconds: 48
passage length: 48 - 42 = 6 seconds
wider checked interval: 38 to 51 seconds
wider length: 51 - 38 = 13 seconds
language heard: English
speaker evidence: The fictional introduction names Speaker A.
raw caption excerpt: add water when the tray is level.
checked wording: Do not add water until the tray is level.
check method: Listen from 38 seconds to 51 seconds. Compare with the raw caption. Leave the raw caption unchanged.
check time: unknown
context note: The wider window contains the negation and the condition. No picture fact is supplied.
correction: The caption omitted the negation and the timing condition.
review state: verified_wording

Record 2 (original fiction)
claim: unknown
source id: VIDEO_ID (same fictional placeholder)
passage in seconds: unknown
passage out seconds: unknown
language heard: unknown
speaker evidence: none. No speaker change is confirmed.
raw caption excerpt: unknown. A caption row succeeded, but its words are not supplied here.
checked wording: unknown. The unit word is unclear in the audio.
check method: Listen. Do not guess the unit. Do not guess the speaker.
check time: unknown
context note: Caption success does not verify the words.
correction: none yet
review state: needs_review

Distinguez l’exactitude des mots de la véracité de l’affirmation

Une citation vérifiée peut encore contenir une affirmation peu solide ou fausse. L’exactitude des mots signifie seulement que vous avez entendu ces mots. Elle ne signifie pas que l’affirmation est vraie. Vérifiez l’affirmation à l’aide de preuves adaptées à cette affirmation. Cette vérification est distincte de la fiche de citation. `verified_wording` ne prouve pas la validité de l’instruction de jardinage, même dans la fiction. Cet état signifie seulement que les mots fictifs ont été vérifiés tels qu’ils ont été prononcés.