# Comment retrouver les vidéos indisponibles ou manquantes de votre playlist YouTube enregistrée

Pour retrouver les vidéos indisponibles ou manquantes dans votre playlist YouTube, comparez votre propre inventaire enregistré aux résultats des vérifications des identifiants vidéo connus. Un inventaire est une liste enregistrée des entrées d’une playlist. Examinez d’abord les entrées peu claires dans votre compte propriétaire et sur la page de la vidéo. Conservez chaque position enregistrée, y compris les vidéos répétées. L’échec d’une recherche publique ne prouve pas qu’une vidéo est privée ou supprimée. Sans inventaire antérieur, la vue actuelle ne permet pas de déterminer quelles anciennes entrées ont disparu.

Le résultat utile est un audit : une comparaison enregistrée qui garde visibles les entrées vérifiées, les avis explicites d’indisponibilité et les entrées non résolues. Cet audit ne récupère pas le contenu des vidéos supprimées ou privées. Il ne vous impose pas non plus de supprimer ou de remplacer des entrées.

## Partez du document de playlist que vous possédez déjà

La première question n’est pas de savoir quel outil peut trouver le plus de vidéos. Il faut d’abord déterminer quel document enregistré contient les entrées de playlist à vérifier.

Utilisez votre propre export ou inventaire existant. Un export est une copie enregistrée des données d’une source. Gardez le fichier original intact. Travaillez dans une copie distincte pour que les vérifications ultérieures ne remplacent pas les preuves antérieures.

Consignez ces informations dans un document privé :

1. Le compte propriétaire associé au document.
2. Le nom et l’identifiant de la playlist, s’ils sont présents.
3. La date du document enregistré.
4. Le format du fichier et le nom du fichier source.
5. Le périmètre du document, y compris les lacunes connues.
6. La conservation ou non des positions et des entrées répétées dans la source.

Un ID est un identifiant qui distingue un enregistrement d’un autre. L’identifiant de playlist désigne la playlist. L’identifiant vidéo désigne la vidéo. Ils sont différents de l’identifiant d’une entrée au sein d’une playlist.

Si vous n’avez aucun inventaire enregistré, notez cette limite avant de continuer. Vous pouvez examiner les entrées actuelles et enregistrer les preuves visibles. Cette vue actuelle ne suffit pas à nommer toutes les vidéos disparues avant la vérification.

Le problème du lecteur concerne les entrées masquées correspondant à des vidéos supprimées ou privées. Cette méthode ne dépend pas de la présence d’une commande d’affichage particulière dans votre compte. Examinez ce que votre vue propriétaire montre. Consignez toute lacune restante au lieu de supposer que la liste visible contient toutes les anciennes entrées.

## Distinguez les entrées de playlist des vidéos

Une entrée de playlist relie une vidéo à une playlist. Une même vidéo peut occuper plusieurs positions enregistrées. Ces positions doivent rester distinctes dans votre audit.

La ressource officielle `playlistItem` de YouTube décrit cette distinction. Elle possède son propre identifiant, un identifiant de playlist, une position et un identifiant vidéo. Sa date `snippet.publishedAt` indique quand l’élément a été ajouté à la playlist. Il ne s’agit pas de la date de publication de la vidéo. Cette référence décrit un schéma. Elle ne prouve pas qu’une playlist privée appartenant à un utilisateur a été exportée dans le cadre de cette recherche. [Référence YouTube PlaylistItems — vérifiée le 25 octobre 2026 ; structure de la ressource uniquement](https://developers.google.com/youtube/data/reference/rest/v3/playlistItems).

Un schéma définit les champs d’un enregistrement. Utilisez le schéma officiel pour comprendre les champs réellement présents dans votre source. Ne supposez pas que votre fichier enregistré contient tous les champs de ce schéma.

Créez un tableau des entrées avec une ligne pour chaque entrée d’origine :

| Champ enregistré | Élément à conserver |
| --- | --- |
| Fichier et ligne sources | Une référence à l’entrée d’origine |
| Identifiant de playlist | L’identifiant enregistré de la playlist, s’il est présent |
| Identifiant d’entrée | L’identifiant enregistré de l’entrée, s’il est présent |
| Position enregistrée | La position exacte consignée dans la source |
| Identifiant vidéo | L’identifiant connu de la vidéo, s’il est présent |
| Titre enregistré | La preuve du titre antérieur, si elle est présente |
| Date d’ajout à la playlist | La date d’ajout enregistrée, si elle est présente |
| Notes sur la source | Les lacunes connues et le sens des champs |

Ces colonnes sont proposées pour votre audit. Elles ne décrivent pas les champs renvoyés par l’Actor de métriques.

Si la source ne contient aucun identifiant d’entrée, conservez la référence au fichier et à la ligne sources. Si l’identifiant vidéo manque, gardez la ligne et marquez-la comme non résolue. Ne supprimez pas une entrée parce qu’elle ne peut pas faire l’objet d’une recherche publique.

Gardez les titres enregistrés séparés des titres actuels. Distinguez les dates d’ajout à la playlist des dates de publication des vidéos. Laissez les dates inconnues comme telles. La date de la vérification du jour ne peut pas remplacer une date inconnue dans le document antérieur.

Conservez la position enregistrée, même si vous triez ensuite une vue de travail. Un tri par titre actuel ou par date de publication de la vidéo ne doit pas remplacer l’ordre d’origine.

## Suivez la méthode d’audit en huit étapes

### 1. Définissez l’inventaire à vérifier

Précisez quel document de playlist enregistré couvre l’audit. Comptez ses lignes d’entrées avant de collecter les données actuelles. Ce total est le nombre d’entrées attendu pour ce document.

Si le document ne couvre qu’une partie de la playlist, indiquez-le. Même correcte, la comparaison d’un document partiel reste un audit partiel. Elle ne permet pas d’établir tout le contenu antérieur de la playlist.

### 2. Conservez chaque ligne d’entrée

Copiez les champs sources dans votre tableau de travail des entrées. Vérifiez que le nombre de lignes correspond toujours à celui du document source.

Conservez les identifiants vidéo répétés. Un identifiant répété ne représente pas une vidéo unique supplémentaire. Chaque occurrence reste toutefois une entrée de playlist distincte. Gardez aussi les lignes dont l’identifiant, le titre ou la date manque.

### 3. Créez une liste distincte des identifiants vidéo uniques

Créez un second tableau avec une ligne par identifiant vidéo connu distinct. Cette liste sert aux vérifications des métadonnées publiques. Les métadonnées sont des données descriptives, comme un titre ou une date de publication.

Gardez les entrées d’origine dans le premier tableau. Supprimez les identifiants répétés uniquement dans le second tableau. Notez quelles lignes d’entrées sont liées à chaque identifiant unique.

Utilisez des vidéos connues comme données d’entrée pour ce travail. La découverte de chaînes publiques a un autre périmètre. Elle ne permet pas d’établir la présence d’une vidéo dans votre playlist enregistrée. Le [guide des jeux de données de chaînes YouTube](/fr/articles/chronometrica-ou-streamers-shorts-choisir-les-donnees-de-chaines-youtube/) explique les limites de cette collecte distincte.

### 4. Testez une vidéo connue en entrée

Commencez par une vidéo pertinente de votre liste d’identifiants uniques. Utilisez les données d’entrée limitées présentées ci-dessous pour l’Actor. Un Actor est un programme hébergé qui collecte des données. Une Task est un ensemble de paramètres d’entrée enregistré pour ce programme.

Examinez le résultat avant d’ajouter d’autres identifiants. Vérifiez l’identifiant et le statut renvoyés. Une exécution terminée ne prouve pas, à elle seule, que des données utiles ont été obtenues pour la vidéo visée.

### 5. Associez les résultats aux entrées d’origine

Associez chaque résultat accepté à son identifiant vidéo exact. Rattachez-le ensuite à chaque entrée portant cet identifiant. Cette opération s’appelle une jointure : elle relie des lignes au moyen d’un identifiant commun.

Conservez les lignes d’entrées d’origine, même sans résultat correspondant. Le tableau des résultats ne doit pas remplacer le document de playlist enregistré.

### 6. Examinez directement les entrées non résolues

Ouvrez la playlist concernée dans votre compte propriétaire. Examinez la page de la vidéo connue et le lecteur de la source lorsque c’est possible. Si un motif explicite apparaît, consignez-le.

Conservez le libellé du motif, sa source, la date et l’heure de vérification ainsi que le contexte du compte. Si la source ne donne aucun motif clair, laissez l’entrée non résolue. Ne déduisez pas une cause précise d’un échec de recherche générique.

### 7. Vérifiez la concordance des totaux

Cette vérification consiste à confirmer que le total des résultats d’audit correspond au total des entrées enregistrées. Comptez séparément les entrées et les identifiants vidéo uniques.

Chaque entrée d’origine doit avoir un état d’audit. Les vidéos répétées doivent toujours occuper leurs lignes d’entrées d’origine. Les contrôles des totaux ci-dessous montrent comment le confirmer.

### 8. Enregistrez l’audit et déterminez les points à revoir

Enregistrez ensemble l’inventaire d’origine, le tableau de travail des entrées, le tableau de vérification des identifiants uniques et les notes sur les preuves. Après révision, conservez l’audit en lecture seule.

Ne supprimez pas et ne remplacez pas automatiquement les entrées de playlist. Décidez séparément s’il faut réexaminer une entrée non résolue ou modifier manuellement la playlist.

## Utilisez l’Actor de métriques pour vérifier des vidéos publiques connues

La documentation du [Chronometrica YouTube Metrics Scraper](https://apify.com/chronometrica/youtube-metrics-scraper) décrit la collecte de métadonnées et de métriques publiques à partir de vidéos connues fournies en entrée. Une métrique est une mesure numérique, comme un nombre de vues. Ce périmètre documenté convient à l’étape de vérification publique de l’audit. Il ne fait pas de l’Actor un outil d’export complet de playlists.

Le contrat public prévoit aussi une découverte de chaînes dans des limites définies. Cette fonction ne prouve pas la présence d’une vidéo dans votre playlist enregistrée. Pour cette méthode, utilisez vos identifiants vidéo connus ou les URL directes des vidéos. Une URL est une adresse Web.

Les données d’entrée limitées ci-dessous ont passé une validation statique du schéma. Cette validation portait uniquement sur leur structure. Aucune exécution de collecte n’a été effectuée :

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

Utilisez l’Actor de métriques pour vérifier des vidéos publiques connues

Remplacez l’URL d’exemple par celle d’une vidéo connue que vous souhaitez vérifier. L’adresse fournie sert d’exemple pour le schéma. Elle ne prouve pas qu’un résultat utile a été obtenu pour votre playlist.

Le champ `startUrls` contient les données d’entrée fournies. Le champ `maxItems` limite le nombre total de lignes de métriques pour l’ensemble de l’exécution. Ici, une limite de un convient à une première vérification portant sur une seule vidéo. Elle ne permet pas de vérifier un inventaire comportant plusieurs identifiants uniques. Avant un traitement par lot ultérieur, fixez une limite adaptée et vérifiez le traitement de chaque identifiant prévu.

Ne collez pas une URL de playlist en supposant que toutes ses entrées seront exportées. Le contrat figé ne permet pas de l’affirmer.

Vous pouvez aussi ouvrir la [Task youtube-engagement-metrics-tracker](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker) publique. Remplacez ses données d’entrée d’exemple avant de l’utiliser. La page et l’identifiant de la Task ont été trouvés le 25 octobre 2026. Les données d’entrée enregistrées accessibles après authentification et l’exécution n’ont pas été vérifiées.

L’Actor lit des données publiques. Il ne lit ni le document de playlist réservé à votre compte propriétaire ni les vidéos privées. Il ne récupère pas les contenus privés ou supprimés. Ses champs de métriques publiques documentés comprennent un nombre de commentaires. Cela ne signifie pas qu’il collecte les commentaires eux-mêmes. Ces limites proviennent du contrat vérifié, et non d’un test en conditions réelles. [Contrat de l’Actor Chronometrica — vérifié le 25 octobre 2026 ; schéma public et README de la version par défaut, aucune exécution payante](https://apify.com/chronometrica/youtube-metrics-scraper).

## Enregistrez les résultats sans masquer les lacunes

Gardez un tableau de vérification distinct pour les identifiants vidéo uniques. Conservez chaque donnée d’entrée utilisée lors d’une tentative, même si le résultat est peu clair.

| Champ enregistré | Objectif |
| --- | --- |
| Identifiant de la vidéo visée | Relier la tentative à l’inventaire enregistré |
| `inputUrl` | Conserver la source soumise |
| `postId` | Vérifier l’identifiant de la vidéo renvoyée |
| `postUrl` | Conserver l’adresse de la vidéo renvoyée |
| `title` | Conserver séparément la preuve du titre actuel |
| `publishedAt` | Conserver la date et l’heure de publication de la vidéo |
| `status` | Conserver le statut du résultat renvoyé |
| `scrapedAt` | Conserver la date et l’heure de collecte |
| `postMetricStatus` | Conserver les détails sur la disponibilité et la précision des métriques |
| État d’audit et notes | Consigner votre décision fondée sur les preuves |

La dernière ligne décrit vos propres colonnes d’audit. Ne les présentez pas comme des données renvoyées par l’Actor.

Vérifiez `postId` avant d’accepter une correspondance. N’utilisez pas la ressemblance des titres comme règle de jointure. Si l’identifiant du résultat ne correspond pas clairement à celui attendu, conservez la tentative et examinez-la.

Laissez les valeurs manquantes comme telles. Un titre manquant ne prouve pas que la vidéo a été supprimée. Un nombre de vues indisponible ne signifie pas zéro vue. Un zéro renvoyé et une valeur manquante ont des sens différents.

Un résultat de métadonnées résolu peut comporter des métriques indisponibles. Ne marquez pas une entrée de playlist comme non résolue au seul motif qu’un décompte facultatif manque. Examinez ensemble l’identifiant, le statut renvoyé et les preuves disponibles.

De même, un résultat de métadonnées ne prouve pas que vous avez lu la vidéo. Si la lecture compte, consignez une vérification distincte dans le lecteur, avec sa date, son heure et son contexte. Cet audit ne transforme pas une recherche de métadonnées en test de disponibilité.

## Utilisez des états clairs pour les échecs et les preuves directes

Utilisez ces états dans votre propre audit. Ce sont des libellés de travail, pas des valeurs de statut documentées de l’Actor.

| État d’audit | Preuve requise | Traitement dans les totaux |
| --- | --- | --- |
| Vérifiée à ce jour | Métadonnées publiques correspondantes acceptées pour l’identifiant connu | Entrée vérifiée |
| Explicitement indisponible | Une source directe affiche un motif clair d’indisponibilité | Entrée vérifiée, motif conservé |
| Non résolue | Identifiant manquant, résultat peu clair ou absence d’explication directe | Entrée non résolue |

Pour les totaux, les entrées vérifiées comprennent les entrées vérifiées à ce jour et celles dont l’indisponibilité est explicitement prouvée. Présentez aussi ces deux groupes séparément.

Un motif explicite s’applique au contexte de vérification consigné. Conservez ce contexte. Ne généralisez pas une observation liée à un compte ou à un moment précis à tous les spectateurs ou à toutes les vérifications futures.

L’échec d’une recherche publique ne permet pas, à lui seul, de distinguer une vidéo privée, une suppression, une restriction régionale ou une limite temporaire. Le contrat de l’Actor précise cette limite. Conservez le statut renvoyé comme preuve, sans le reformuler en une cause plus précise. [Contrat de l’Actor Chronometrica — vérifié le 25 octobre 2026 ; limites documentées concernant les échecs, aucun test d’exécution](https://apify.com/chronometrica/youtube-metrics-scraper).

Si une vérification ultérieure apporte de meilleures preuves, ajoutez un résultat daté. Conservez l’observation antérieure. Une recherche ultérieure réussie peut résoudre une lacune actuelle sans expliquer l’échec de la première tentative.

Retrouver un titre ne permet pas non plus de récupérer le contenu d’origine. Si votre prochain travail nécessite les sous-titres d’une vidéo connue, utilisez le [guide des transcriptions YouTube et des sous-titres manquants](/fr/articles/transcription-youtube-sous-titres-manquants/). Gardez les preuves relatives aux sous-titres distinctes de la décision concernant l’entrée de playlist.

## Suivez un exemple fictif original

Cet exemple est une fiction originale. Les identifiants, les entrées et les résultats sont inventés. Il ne décrit ni un test d’export ni un test de disponibilité vidéo.

Un inventaire enregistré contient trois entrées :

| Position enregistrée | Identifiant vidéo | Vérification des métadonnées publiques | État d’audit |
| --- | --- | --- | --- |
| 1 | A | Résultat correspondant renvoyé pour A | Vérifiée à ce jour |
| 2 | B | Aucun résultat accepté ni aucune explication directe | Non résolue |
| 3 | A | Même résultat correspondant rattaché à cette entrée | Vérifiée à ce jour |

La liste des identifiants uniques contient A et B. La recherche fictive renvoie un résultat correspondant pour A. Elle ne résout pas B. Rattachez le résultat de A aux positions 1 et 3. Ne regroupez pas ces positions en une seule ligne.

Le calcul des entrées est le suivant :

3 entrées attendues = 2 entrées vérifiées + 1 entrée non résolue.

Le décompte distinct des identifiants est le suivant :

2 identifiants vidéo uniques = 1 identifiant vidéo unique résolu + 1 identifiant vidéo unique non résolu.

Il y a trois entrées, et non trois vidéos uniques. Il y a deux entrées vérifiées, et non deux identifiants vidéo résolus séparément. Ces totaux décrivent des enregistrements, pas des personnes.

Dans cet exemple, aucun motif explicite d’indisponibilité n’existe pour B. Le nombre d’entrées explicitement indisponibles est donc de zéro. Ce zéro décrit cette catégorie de preuves. Il ne signifie pas que B est disponible, supprimée ou privée.

L’étape suivante consiste à examiner B dans la playlist du compte propriétaire et dans le lecteur de la source. Tant qu’aucune preuve directe n’explique le résultat, son entrée reste non résolue. Les positions 1, 2 et 3 restent toutes dans l’audit.

## Vérifiez l’audit terminé

Avant d’accepter le rapport, effectuez ces vérifications :

1. Confirmez que chaque ligne d’entrée d’origine est toujours présente.
2. Confirmez que les positions enregistrées et les entrées répétées restent intactes.
3. Confirmez que les lignes sans identifiant vidéo restent non résolues.
4. Confirmez que les jointures utilisent les identifiants vidéo et conservent les entrées sans correspondance.
5. Confirmez que les dates d’ajout à la playlist, les dates de publication et les dates et heures de vérification restent distinctes.
6. Confirmez que chaque motif précis d’indisponibilité repose sur une preuve directe.
7. Confirmez que les valeurs de métriques manquantes n’ont pas été remplacées par zéro.
8. Confirmez que le nombre d’entrées attendu est égal au nombre d’entrées vérifiées plus le nombre d’entrées non résolues.
9. Présentez les identifiants vidéo uniques séparément des entrées.
10. Précisez le périmètre de l’inventaire et toutes les lacunes restantes.

Le rapport doit permettre à un autre lecteur de relier chaque décision à une entrée enregistrée et à ses preuves. La concordance des totaux vérifie le décompte. Elle ne prouve pas que l’inventaire d’origine couvrait toute la playlist.

## Passez à l’étape suivante

Commencez par un inventaire de playlist enregistré et un identifiant vidéo connu. Conservez d’abord le tableau des entrées. Examinez les entrées peu claires dans votre compte propriétaire. Utilisez ensuite le [Chronometrica YouTube Metrics Scraper](https://apify.com/chronometrica/youtube-metrics-scraper) pour une vérification limitée des métadonnées publiques.

Élargissez la vérification seulement après avoir confirmé la correspondance des identifiants, les champs conservés et la méthode de comptage. Gardez les entrées non résolues visibles. Appuyez-vous sur des preuves explicites provenant de la source pour expliquer les éléments indisponibles. Toute suppression ou tout remplacement ultérieur doit faire l’objet d’une décision manuelle distincte.

## Sources et lectures complémentaires

- [YouTube Data API : PlaylistItems — vérifié le 25 octobre 2026 ; champs des entrées et sens des dates, aucune preuve d’export d’une playlist privée](https://developers.google.com/youtube/data/reference/rest/v3/playlistItems)
- [Chronometrica YouTube Metrics Scraper — vérifié le 25 octobre 2026 ; schéma public et README de la version par défaut, aucune exécution payante ni aucun test du bon fonctionnement à l’exécution](https://apify.com/chronometrica/youtube-metrics-scraper)
- [Task youtube-engagement-metrics-tracker — vérifiée le 25 octobre 2026 ; page publique et identifiant de Task présents, données d’entrée enregistrées et exécution non testées](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker)
- [Question Reddit sur les playlists — publiée le 26 mai 2026, consultée le 25 octobre 2026 ; problème d’un lecteur, aucune preuve de demande ou de performance d’un outil](https://www.reddit.com/r/youtube/comments/1toj1zs/option_to_show_unavailable_videos_in_playlists/)