Comment exporter et vérifier votre historique des vidéos regardées sur YouTube

Définissez ce que vous devez vérifier

La question du lecteur porte sur un « historique YouTube complet ». Elle nécessite deux vérifications distinctes : votre tableau conserve-t-il les événements exportés, et l’archive couvre-t-elle l’historique attendu ?

Vous pouvez comparer le tableau à ses fichiers sources. Ces fichiers seuls ne permettent pas de prouver que l’archive couvre tout votre historique depuis l’origine. Une question publique d’un titulaire de compte signale un export Takeout incomplet. Il s’agit d’une seule lacune signalée. Ce témoignage ne permet pas d’établir un taux d’échec ni une méthode garantissant un historique complet.

Prévoyez de conserver trois éléments :

1. Une note privée sur l’archive demandée et son contenu.
2. Un tableau des événements de visionnage qui conserve les visionnages répétés et les dates et heures d’origine.
3. Un tableau facultatif des vidéos publiques, avec un résultat sélectionné par identifiant vidéo.

Un identifiant est une valeur qui permet d’identifier un élément. Un identifiant vidéo désigne une vidéo, pas un événement de visionnage. Maintenez cette distinction tout au long de la méthode.

Demandez votre archive et notez son périmètre

Utilisez uniquement votre propre compte Google. Accédez à la page Google Takeout avec votre compte connecté depuis le guide officiel de téléchargement.

Ne vous fiez pas à un chemin de menus ou à un nom de fichier fixe. Examinez les produits proposés et les options actuelles de données à inclure.

1. Sélectionnez les données YouTube ou d’activité du compte nécessaires à votre historique des vidéos regardées.
2. Notez le compte et les données sélectionnées dans un document privé.
3. Notez la date de la demande.
4. Demandez l’archive.
5. Téléchargez toutes les parties de l’archive fournies pour cette demande.
6. Notez la date de création de l’archive, le format des fichiers et le nom de chaque partie.
7. Conservez les fichiers d’origine sans les modifier.
8. Ouvrez une copie de travail et confirmez qu’elle contient des événements de visionnage.

L’activité de recherche et les abonnements ne permettent pas d’établir quelles vidéos vous avez regardées. Confirmez le type d’enregistrement à partir du contenu réel avant de compter les lignes.

Les données sélectionnées définissent le périmètre demandé : les données du compte que vous avez demandé à Google d’inclure. Notez séparément le contenu réellement reçu. La sélection d’une catégorie ne prouve pas, à elle seule, que les fichiers téléchargés contiennent tous les enregistrements attendus.

Gardez l’archive privée. La vérification facultative des données publiques nécessite seulement les identifiants ou les liens des vidéos publiques sélectionnées. Elle ne nécessite ni l’archive ni les identifiants de connexion de votre compte. Le téléchargement de vos données ne supprime pas leur copie dans le cloud. Périmètre et limites des exports Google

Créez un tableau qui conserve chaque événement de visionnage

Lisez les noms réels des champs avant d’importer les fichiers. Ne supposez pas que la structure des fichiers, le format des dates ou le champ vidéo sont fixes.

Créez une ligne de travail pour chaque événement de visionnage source. Conservez tous les champs d’origine. Ajoutez des références qui permettent de retrouver l’événement dans l’archive inchangée.

Les champs ci-dessous sont des champs de travail proposés. Google ne garantit pas que ses exports utilisent ces intitulés.

Un horodatage est une date et une heure enregistrées. Une date et heure normalisées constituent une seconde valeur, convertie dans un format commun. Aucune de ces valeurs ne doit remplacer la valeur brute de la source.

Une référence source permet de retrouver un événement dans votre archive sauvegardée. Elle ne constitue pas nécessairement un identifiant d’événement stable d’un export à l’autre. Deux numéros de ligne identiques dans deux fichiers ne prouvent pas qu’il s’agit du même événement.

L’absence de lien vidéo n’efface pas un événement de visionnage enregistré. Conservez l’événement et indiquez que l’identité de la vidéo reste indéterminée. De même, un champ vide indique une information manquante. Il ne signifie pas zéro visionnage.

Établissez les dates et heures sans changer leur sens

La date et l’heure du visionnage, de la publication de la vidéo et de la recherche publique décrivent des événements différents.

N’analysez une date que si vous connaissez son format. L’analyse consiste ici à interpréter un texte enregistré comme une date et une heure. Une date ambiguë doit rester indéterminée tant que vous ne pouvez pas établir son sens.

1. Conservez l’horodatage brut sans le modifier.
2. Identifiez le format de la date à partir de la source.
3. Identifiez le fuseau ou le décalage horaire, s’il est fourni.
4. Convertissez la valeur uniquement lorsque ces éléments sont connus.
5. Enregistrez la valeur convertie à côté de la valeur brute.
6. Notez tout problème de date ou d’heure non résolu.

UTC désigne le temps universel coordonné, une référence horaire commune. Vous pouvez enregistrer une valeur normalisée en UTC lorsque la date et l’heure de la source peuvent être établies. N’attribuez pas un fuseau horaire à une valeur simplement parce que votre ordinateur l’utilise.

N’utilisez pas la date et l’heure d’importation comme date et heure de visionnage. Ne remplacez pas la date et l’heure manquantes d’un événement par celles de la publication de la vidéo. Si vous regroupez ensuite les visionnages par jour, précisez le fuseau horaire utilisé pour les résultats. Résolvez les questions de date et d’heure avant de considérer les totaux quotidiens comme des résultats vérifiés.

Conservez les visionnages répétés et supprimez uniquement les copies d’importation prouvées

Deux événements peuvent avoir le même identifiant vidéo, le même titre ou la même date. Cela ne fait pas d’eux des doublons.

Par exemple, un visionnage le matin et un visionnage le soir d’une même vidéo restent deux lignes distinctes. Supprimer des lignes selon l’identifiant vidéo ferait perdre une partie de l’historique enregistré.

La déduplication consiste à supprimer les copies confirmées d’un même enregistrement. Appliquez-la uniquement si vous avez la preuve que votre importation a créé ces copies. Si vous avez importé deux fois la même archive inchangée, vous pouvez examiner ce cas à l’aide des références de l’archive, du fichier et de l’entrée source.

1. Comptez les lignes d’événements de visionnage importées.
2. Vérifiez si une partie de l’archive a été importée deux fois.
3. Identifiez les copies d’enregistrements sources à l’aide de leurs références sources.
4. Supprimez uniquement les copies supplémentaires dont l’existence est prouvée.
5. Notez le nombre de copies supprimées et la raison de leur suppression.
6. Enregistrez le nombre d’événements conservés avant d’ajouter les informations publiques.

Des identifiants vidéo ou des horodatages identiques ne prouvent pas, à eux seuls, que deux lignes sont des copies. Les archives dont les contenus se recoupent nécessitent une vérification distincte des enregistrements. Ne fusionnez pas des correspondances incertaines en un seul événement.

Déterminez si les informations publiques sur les vidéos vous sont utiles

Vous pouvez vous arrêter au tableau d’événements vérifié s’il répond à votre question.

Des métadonnées facultatives peuvent ajouter les titres actuels, les informations sur les chaînes et les décomptes publics. Les métadonnées sont des informations sur un élément. Elles décrivent la vidéo ; elles ne prouvent pas un événement de visionnage supplémentaire.

Le Chronometrica YouTube Metrics Scraper est un Actor, c’est-à-dire un programme hébergé de collecte de données. Les entrées documentées comprennent des identifiants vidéo connus et des liens vidéo. Il permet aussi de découvrir des chaînes publiques, ce qui n’est pas nécessaire pour vérifier cette archive.

L’Actor lit les métadonnées et les métriques publiques des vidéos. Les métriques sont des décomptes, comme le nombre public de vues ou de mentions J’aime. Il ne lit ni l’historique personnel des vidéos regardées ni les vidéos privées. Il ne collecte pas le texte des commentaires et ne fournit pas les impressions, le taux de clics ou la rétention de YouTube Studio.

Préparez une liste séparée d’identifiants connus de vidéos publiques, sans doublons. Cela réduit les recherches publiques répétées tout en conservant chaque événement de visionnage. Le guide sur les corpus de transcriptions distingue aussi les apparitions répétées dans les sources des identités de vidéos distinctes. Ici, la liste sans doublons sert uniquement à la recherche facultative. Votre tableau d’événements doit conserver les visionnages répétés.

Si vous avez ensuite besoin du texte parlé d’une vidéo, consultez le guide distinct sur l’extraction des sous-titres. Les sous-titres ne permettent pas d’établir si vous avez regardé une vidéo ni à quel moment.

Configurez la recherche publique facultative

La Task youtube-engagement-metrics-tracker fournit une configuration de départ. Une Task est une configuration d’entrée enregistrée pour un Actor.

Les éléments de preuve fournis font état d’une vérification de la page publique de la Task et de son identifiant le 25 octobre 2026. Ils ne comprennent ni l’examen des paramètres enregistrés accessibles après connexion ni l’exécution de la Task.

Le petit exemple d’entrée ci-dessous a passé une vérification de format selon les règles publiques d’entrée fournies. JSON est un format texte pour les données structurées.

{
  "maxItems": 1,
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ]
}

Le lien fourni est un exemple d’entrée. Ce n’est pas un résultat obtenu avec cette méthode.

1. Examinez les paramètres de la Task avant de l’utiliser.
2. Remplacez toute la liste d’exemple dans `startUrls` par les identifiants ou les liens des vidéos publiques souhaitées.
3. Utilisez des entrées qui désignent directement les vidéos pour cette vérification de l’archive.
4. Réglez `maxItems` pour permettre le nombre prévu de lignes de résultats publics.
5. N’envoyez aucun fichier d’archive privée ni aucune ligne d’événement de visionnage.
6. Lancez une recherche sur une courte liste que vous pouvez examiner en entier.
7. Enregistrez séparément les données d’entrée, les résultats et la date et l’heure de la recherche.

La valeur de `maxItems` affichée limite la sortie à une seule ligne de métriques. La laisser à un pour une liste plus longue peut empêcher les résultats de couvrir cette liste. Comparez les identifiants envoyés aux résultats ; ne supposez pas qu’une exécution terminée a couvert toutes les vidéos prévues.

Ces actions sont proposées au lecteur. Aucune archive privée n’a été consultée ni testée pour ce guide. Aucune exécution payante de l’Actor n’a été effectuée. Les fonctions documentées justifient son utilisation pour cette vérification publique facultative ; elles ne prouvent pas ses performances à l’exécution.

Rattachez les résultats publics sans perdre d’événements

Conservez les résultats publics dans un tableau séparé. Gardez les valeurs exactes renvoyées et les informations sur leur état.

Le champ `comments` contient un nombre, pas le texte des commentaires. Les décomptes manquants restent indisponibles. Conservez `null`, qui représente une valeur manquante, au lieu de le remplacer par zéro. Conservez aussi les informations de précision ; un décompte public arrondi ne doit pas devenir un décompte exact dans votre rapport. Contrat de sortie de l’Actor

Sélectionnez au plus une observation publique par identifiant vidéo vérifié pour cette version de votre tableau. Si vous effectuez d’autres vérifications plus tard, enregistrez-les séparément et précisez quelle observation vous utilisez.

Une jointure combine des tableaux à l’aide d’une valeur commune. Rattachez le résultat public sélectionné à chaque événement qui porte cet identifiant vidéo vérifié. Conservez les événements sans correspondance. Pour un résultat en échec sans identifiant renvoyé, conservez la référence de l’entrée envoyée et examinez la correspondance.

Vérifiez les deux types d’erreurs possibles :

1. Si le nombre d’événements diminue, vérifiez si des événements sans correspondance ont été supprimés.
2. Si le nombre d’événements augmente, vérifiez si plusieurs résultats publics ont été rattachés à un même événement.
3. Confirmez que chaque référence d’événement d’origine figure encore exactement une fois.
4. Confirmez que les visionnages répétés ont toujours des lignes distinctes.

L’échec d’une recherche publique ne prouve pas qu’une vidéo a été supprimée, rendue privée, soumise à une restriction géographique ou temporairement indisponible. Laissez la cause indéterminée sauf si des éléments distincts permettent de l’établir.

Exemple détaillé : trois événements et deux identifiants vidéo

Cet exemple est une fiction originale. Les libellés d’événements et les résultats de recherche sont inventés à des fins pédagogiques. Ce ne sont ni des enregistrements d’archive privée ni des résultats de test de l’Actor.

Une archive fictive enregistre la vidéo A à 09:00 et à 17:00, ainsi que la vidéo B à 18:00. Cet exemple simplifié ne fournit ni date ni fuseau horaire. Gardez ces limites visibles ; ne calculez pas d’heures UTC à partir de ces valeurs.

Le tableau d’événements contient trois lignes. La liste de recherche séparée contient deux identifiants vidéo : A et B. Dans cette vérification fictive, A renvoie des métadonnées et B n’en renvoie pas.

Les calculs utilisent des unités différentes :

• 2 événements de visionnage pour A + 1 événement de visionnage pour B = 3 événements de visionnage.
• 1 identifiant unique pour A + 1 identifiant unique pour B = 2 identifiants vidéo uniques.
• 1 résultat avec métadonnées disponibles + 1 résultat avec métadonnées indisponibles = 2 résultats de recherche.
• 3 lignes d’événements avant la jointure = 3 lignes d’événements après la jointure.

Les deux événements de A reçoivent les métadonnées sélectionnées pour A. L’événement de B à 18:00 reste présent, avec la mention « métadonnées indisponibles ». L’échec de la recherche n’efface pas le visionnage enregistré.

Indiquez trois événements de visionnage enregistrés et deux identifiants vidéo uniques. Ces décomptes ne mesurent pas le nombre de personnes distinctes. Ils ne prouvent pas non plus que l’archive contient tous les événements de visionnage de cette journée.

Si le nombre public de vues de B manque, laissez cette valeur manquante. Indiquer zéro vue publique serait une affirmation chiffrée que cette recherche fictive ne permet pas de justifier.

Vérifiez la couverture de l’archive et les états indéterminés

Comparez le périmètre demandé aux fichiers inclus. Lorsque c’est possible, comparez certains enregistrements de l’archive à l’historique que vous pouvez consulter dans Mon activité. Notez le compte, la période et la date de cette comparaison.

YouTube indique que les vidéos regardées lorsque l’historique est désactivé n’y apparaissent pas. Les titulaires de compte peuvent aussi supprimer leur historique manuellement ou utiliser la suppression automatique. Les informations publiques sur les vidéos ne permettent pas de reconstituer ces événements privés manquants. Commandes de l’historique YouTube

Traitez les différents problèmes séparément :

Une période vide ne prouve pas qu’il y a eu zéro visionnage. Une ligne la plus ancienne remontant loin dans le temps ne prouve pas que l’historique est complet. Une analyse réussie prouve que votre traitement a lu les fichiers ; elle ne prouve pas que Google a fourni tous les événements passés.

Avant de valider le tableau, confirmez que toutes les parties de l’archive ont été prises en compte. Vérifiez que les valeurs brutes restent inchangées et que les problèmes de date et d’heure restent visibles. Confirmez aussi que chaque événement source conservé reste présent après la jointure avec les données publiques. Signalez les lacunes de l’archive séparément des échecs de recherche.