Videos

Une ressource video représente une vidéo YouTube.

Méthodes

L'API accepte les méthodes suivantes pour les ressources videos :

getRating
Récupère les notes attribuées par l'utilisateur autorisé à une liste de vidéos spécifiées. Essayer
liste
Renvoie une liste de vidéos correspondant aux paramètres de la requête API. Essayer
batchGetStats
Récupère une liste de statistiques vidéo correspondant aux paramètres de la requête API. Essayer
insérer
Met en ligne une vidéo sur YouTube et définit éventuellement ses métadonnées.
update
Met à jour les métadonnées d'une vidéo. Essayer
supprimer
Supprime une vidéo YouTube. Essayer
rate
Ajoutez une mention "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimez-en une. Essayer
reportAbuse
Signaler une vidéo contenant du contenu abusif. Essayer

Représentation de la ressource

La structure JSON suivante montre le format d'une ressource videos :

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource :

Propriétés
kind string
Identifie le type de ressource d'API. La valeur sera youtube#video.
etag etag
Etag de cette ressource.
id string
ID utilisé par YouTube pour identifier la vidéo de manière unique.
snippet object
L'objet snippet contient des informations de base sur la vidéo, telles que son titre, sa description et sa catégorie.
snippet.publishedAt datetime
Date et heure de publication de la vidéo. Cette heure peut être différente de celle à laquelle la vidéo a été mise en ligne. Par exemple, si une vidéo est mise en ligne en tant que vidéo privée, puis rendue publique ultérieurement, cette propriété spécifie l'heure à laquelle la vidéo a été rendue publique.

Il existe quelques cas particuliers :
  • Si une vidéo est mise en ligne en tant que vidéo privée et que ses métadonnées sont récupérées par le propriétaire de la chaîne, la valeur de la propriété indique la date et l'heure de mise en ligne de la vidéo.
  • Si une vidéo est mise en ligne en tant que vidéo non répertoriée, la valeur de la propriété spécifie également la date et l'heure de mise en ligne de la vidéo. Dans ce cas, toute personne connaissant l'ID unique de la vidéo peut récupérer ses métadonnées.
  • Si une vidéo est mise en ligne en tant que vidéo réservée aux membres, la valeur de la propriété indique la date et l'heure de mise en ligne de la vidéo.
La valeur est spécifiée au format ISO 8601.
snippet.channelId string
ID utilisé par YouTube pour identifier de manière unique la chaîne sur laquelle la vidéo a été mise en ligne. Cette valeur peut changer au fil du temps, par exemple lorsqu'une vidéo est réattribuée à une autre chaîne (une chaîne thématique ou une chaîne d'artiste, par exemple).
snippet.title string
Titre de la vidéo. La valeur de la propriété ne doit pas dépasser 100 caractères et peut contenir tous les caractères UTF-8 valides, à l'exception de < et >. Vous devez définir une valeur pour cette propriété si vous appelez la méthode videos.update et que vous mettez à jour la partie snippet d'une ressource video.
snippet.description string
Description de la vidéo. La valeur de la propriété peut comporter jusqu'à 5 000 octets et contenir tous les caractères UTF-8 valides, à l'exception de < et >.

Vous pouvez créer des chapitres vidéo en incluant des codes temporels formatés (par exemple, 00:00) dans le texte de la description.
snippet.thumbnails object
Carte des miniatures associées à la vidéo. Pour chaque objet de la carte, la clé correspond au nom de la miniature et la valeur est un objet contenant d'autres informations sur la miniature.
snippet.thumbnails.(key) object
Les valeurs de clé valides sont les suivantes :
  • default : image miniature par défaut. La vignette par défaut d'une vidéo (ou d'une ressource qui fait référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large et 90 pixels de haut. La miniature par défaut d'une chaîne mesure 88 px de large et 88 px de haut.
  • medium : version de la miniature en plus haute résolution. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 320 px de large et 180 px de haut. Pour une chaîne, cette image doit avoir une largeur et une hauteur de 240 px.
  • high : version haute résolution de la miniature. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 480 px de large et 360 px de haut. Pour une chaîne, cette image fait 800 px de large et 800 px de haut.
  • standard : version de la miniature avec une résolution encore plus élevée que celle de l'image high. Cette image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 640 px de large et 480 px de haut.
  • maxres : version haute résolution de la miniature. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 1 280 px de large et 720 px de haut.
  • fhd : version Full HD (1080p) de la miniature. Cette taille d'image est disponible pour certaines vidéos. Cette image mesure 1 920 px de large et 1 080 px de haut.
  • qhd : version quad haute définition (1440p / 2K) de la miniature. Cette taille d'image est disponible pour certaines vidéos. Cette image mesure 2 560 px de large sur 1 440 px de haut.
  • uhd : version ultra-haute résolution (4K) de la miniature. Cette taille d'image est disponible pour certaines vidéos. Cette image mesure 3 840 px de large et 2 160 px de haut.
snippet.thumbnails.(key).url string
URL de l'image.
snippet.thumbnails.(key).width unsigned integer
Largeur de l'image.
snippet.thumbnails.(key).height unsigned integer
Hauteur de l'image.
snippet.channelTitle string
Titre de la chaîne à laquelle appartient la vidéo.
snippet.tags[] list
Liste des tags de mots clés associés à la vidéo. Les tags peuvent contenir des espaces. La valeur de la propriété ne doit pas dépasser 500 caractères. Notez les règles suivantes concernant le calcul du nombre maximal de caractères :
  • La valeur de la propriété est une liste, et les virgules entre les éléments de la liste sont comptabilisées dans la limite.
  • Si un tag contient un espace, le serveur d'API traite la valeur du tag comme si elle était entourée de guillemets, et les guillemets sont comptabilisés dans le nombre maximal de caractères. Ainsi, pour le nombre maximal de caractères, le tag Foo-Baz contient sept caractères, mais le tag Foo Baz en contient neuf.
snippet.categoryId string
La catégorie de vidéo YouTube associée à la vidéo. Vous devez définir une valeur pour cette propriété si vous appelez la méthode videos.update et que vous mettez à jour la partie snippet d'une ressource video.
snippet.liveBroadcastContent string

Indique si la vidéo est une diffusion en direct à venir ou en cours. Sa valeur est none si la vidéo n'est pas une diffusion en direct à venir ou en cours.



Les valeurs valides pour cette propriété sont les suivantes :
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Langue du texte dans les propriétés snippet.title et snippet.description de la ressource video.
snippet.localized object
L'objet snippet.localized contient un titre et une description localisés pour la vidéo, ou le titre dans la langue par défaut pour les métadonnées de la vidéo.
  • Le texte localisé est renvoyé dans l'extrait de ressource si la requête videos.list a utilisé le paramètre hl pour spécifier une langue pour laquelle du texte localisé doit être renvoyé et si du texte localisé est disponible dans cette langue.
  • Les métadonnées de la langue par défaut sont renvoyées si aucune valeur de paramètre hl n'est spécifiée ou si une valeur est spécifiée, mais qu'aucune métadonnée localisée n'est disponible pour la langue spécifiée.
La propriété contient une valeur en lecture seule. Utilisez l'objet localizations pour ajouter, modifier ou supprimer des titres localisés.
snippet.localized.title string
Titre localisé de la vidéo.
snippet.localized.description string
Description localisée de la vidéo.
snippet.defaultAudioLanguage string
La propriété default_audio_language spécifie la langue parlée dans la piste audio par défaut de la vidéo.
contentDetails object
L'objet contentDetails contient des informations sur le contenu vidéo, y compris la durée de la vidéo et une indication précisant si des sous-titres sont disponibles.
contentDetails.duration string
Durée de la vidéo. La valeur de la propriété est une durée ISO 8601. Par exemple, pour une vidéo d'une durée comprise entre une minute et une heure, la durée est au format PT#M#S, où les lettres PT indiquent que la valeur spécifie une période, et les lettres M et S font référence à la durée en minutes et en secondes, respectivement. Les caractères # précédant les lettres M et S sont des entiers qui spécifient le nombre de minutes (ou de secondes) de la vidéo. Par exemple, la valeur PT15M33S indique que la vidéo dure 15 minutes et 33 secondes.

Si la vidéo dure au moins une heure, la durée est au format PT#H#M#S, où # précédant la lettre H spécifie la durée de la vidéo en heures, et tous les autres détails sont identiques à ceux décrits ci-dessus. Si la vidéo dure au moins un jour, les lettres P et T sont séparées, et le format de la valeur est P#DT#H#M#S. Pour en savoir plus, veuillez consulter la spécification ISO 8601.
contentDetails.dimension string
Indique si la vidéo est disponible en 3D ou en 2D.
contentDetails.definition string
Indique si la vidéo est disponible en haute définition (HD) ou uniquement en définition standard.

Les valeurs valides pour cette propriété sont les suivantes :
  • hd
  • sd
contentDetails.caption string
Indique si des sous-titres sont disponibles pour la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • false
  • true
contentDetails.licensedContent boolean
Indique si la vidéo représente un contenu sous licence, ce qui signifie que le contenu a été mis en ligne sur une chaîne associée à un partenaire de contenu YouTube, puis revendiqué par ce partenaire.
contentDetails.regionRestriction object
L'objet regionRestriction contient des informations sur les pays dans lesquels une vidéo est visible (ou non). L'objet contient la propriété contentDetails.regionRestriction.allowed ou la propriété contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Liste des codes de région identifiant les pays dans lesquels la vidéo peut être visionnée. Si cette propriété est présente et qu'un pays n'est pas indiqué dans sa valeur, la vidéo ne peut pas être diffusée dans ce pays. Si cette propriété est présente et contient une liste vide, la vidéo est bloquée dans tous les pays.
contentDetails.regionRestriction.blocked[] list
Liste des codes régionaux qui identifient les pays où la vidéo est bloquée. Si cette propriété est présente et qu'un pays n'est pas listé dans sa valeur, la vidéo est visible dans ce pays. Si cette propriété est présente et contient une liste vide, la vidéo peut être visionnée dans tous les pays.
contentDetails.contentRating object
Indique les notes attribuées à la vidéo dans différents systèmes de classification.
contentDetails.contentRating.acbRating string
Classification de la vidéo par l'ACB (Australian Classification Board) ou l'ACMA (Australian Communications and Media Authority). Les classifications ACMA sont utilisées pour classer les programmes télévisés pour enfants.

Les valeurs valides pour cette propriété sont les suivantes :
  • acbC : programmes ayant reçu la classification C de l'Australian Communications and Media Authority. Ces programmes sont destinés aux enfants de moins de 14 ans (sauf tout-petits).
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP : programmes ayant reçu la classification P de l'Australian Communications and Media Authority. Ces programmes sont destinés aux tout-petits.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Classification de la vidéo par l'Autorità per le Garanzie nelle Comunicazioni (AGCOM) en Italie.

Les valeurs valides pour cette propriété sont les suivantes :
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Classification Anatel (Asociación Nacional de Televisión) de la vidéo pour la télévision chilienne.

Les valeurs valides pour cette propriété sont les suivantes :
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Classification BBFC (British Board of Film Classification) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Classification de la vidéo par le Board of Film and Video Censors de Thaïlande.

Les valeurs valides pour cette propriété sont :
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Classification de la vidéo par l'organisme autrichien de classification des contenus multimédias (Bundesministerium für Unterricht, Kunst und Kultur).

Les valeurs valides pour cette propriété sont les suivantes :
  • bmukk10 : 10 ans et plus
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16 ans et plus
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Non limitée
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Système de classification des émissions de télévision canadiennes : classification des émissions de télévision canadiennes. Classification de la vidéo attribuée par le Conseil de la radiodiffusion et des télécommunications canadiennes (CRTC) pour les émissions canadiennes en langue anglaise. Pour en savoir plus, consultez le site Web du Conseil canadien des normes de la radiodiffusion.

Les valeurs valides pour cette propriété sont les suivantes :
  • catv14plus – 14 ans et plus
  • catv18plus – 18 ans et plus
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Classification de la vidéo par le Conseil de la radiodiffusion et des télécommunications canadiennes (CRTC) pour les diffusions en français au Canada. Pour en savoir plus, consultez le site Web du Conseil canadien des normes de la radiodiffusion.

Les valeurs valides pour cette propriété sont les suivantes :
  • catvfr13plus – 13 ans et plus
  • catvfr16plus – 16 ans et plus
  • catvfr18plus – 18 ans et plus
  • catvfr8plus – 8 ans et plus
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Classification de la vidéo par le Central Board of Film Certification (CBFC - Inde).

Les valeurs valides pour cette propriété sont les suivantes :
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Classification de la vidéo par le Consejo de Calificación Cinematográfica (Chili).

Les valeurs valides pour cette propriété sont les suivantes :
  • ccc14 – 14 ans et plus
  • ccc18 – 18 ans et plus
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18 ans et plus : contenu excessivement violent
  • ccc6 – 6+ : inconvénient pour les enfants de moins de 7 ans
  • cccTe – Tout public
  • cccUnrated
contentDetails.contentRating.cceRating string
Classification de la vidéo attribuée par la Comissão de Classificação de Espect´culos du Portugal.

Les valeurs valides pour cette propriété sont les suivantes :
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Classification de la vidéo en Suisse.

Les valeurs valides pour cette propriété sont les suivantes :
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Classification CHVRS (Canadian Home Video Rating System) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Classification de la vidéo attribuée par la Commission de Contrôle des Films (Belgique).

Les valeurs valides pour cette propriété sont les suivantes :
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Classification de la vidéo par le CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) de Roumanie.

Les valeurs valides pour cette propriété sont les suivantes :
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18 ans et plus
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Système de classification en France - Commission de classification cinematographique

Les valeurs valides pour cette propriété sont les suivantes :
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Classification de la vidéo par le Conseil supérieur de l'audiovisuel (CSA), qui évalue les contenus diffusés.

Les valeurs valides pour cette propriété sont les suivantes :
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Classification de la vidéo attribuée par la Commission de surveillance de la classification des films (CSCF) du Luxembourg.

Les valeurs valides pour cette propriété sont les suivantes :
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Classification de la vidéo en République tchèque.

Les valeurs valides pour cette propriété sont les suivantes :
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Classification de la vidéo par le Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brésil).

Les valeurs valides pour cette propriété sont les suivantes :
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Motifs expliquant pourquoi la vidéo a reçu sa classification DJCQT (Brésil).
contentDetails.contentRating.ecbmctRating string
Système de classification en Turquie : Evaluation and Classification Board du ministère de la Culture et du Tourisme

Les valeurs valides pour cette propriété sont les suivantes :
  • ecbmct13a – 13A
  • ecbmct13plus – 13 ans et plus
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18 ans et plus
  • ecbmct7a – 7A
  • ecbmct7plus – 7 ans et plus
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6 ans et plus
  • ecbmct10a – 10A
  • ecbmct10plus : 10 ans et plus
  • ecbmct16plus – 16 ans et plus
contentDetails.contentRating.eefilmRating string
Classification de la vidéo en Estonie.

Les valeurs valides pour cette propriété sont les suivantes :
  • eefilmK12 – Enseignement primaire et secondaire
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Classification de la vidéo en Égypte.

Les valeurs valides pour cette propriété sont les suivantes :
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Classification Eirin (映倫) de la vidéo. Eirin est le système de classification japonais.

Les valeurs valides pour cette propriété sont les suivantes :
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Classification du film par le Film Censorship Board de Malaisie.

Les valeurs valides pour cette propriété sont les suivantes :
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Classification de la vidéo par l'Office for Film, Newspaper and Article Administration de Hong Kong.

Les valeurs valides pour cette propriété sont les suivantes :
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Cette propriété est obsolète depuis le 2 novembre 2015. Utilisez plutôt la propriété contentDetails.contentRating.cncRating.

Classification du Centre national du cinéma et de l'image animée (ministère français de la Culture) pour la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Classification de la vidéo par le Film and Publication Board d'Afrique du Sud.

Les valeurs valides pour cette propriété sont les suivantes :
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Motifs expliquant pourquoi la vidéo a reçu sa classification FPB (Afrique du Sud).
contentDetails.contentRating.fskRating string
Classification FSK (Freiwillige Selbstkontrolle der Filmwirtschaft, Allemagne) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Classification de la vidéo en Grèce.

Les valeurs valides pour cette propriété sont les suivantes :
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – Enseignement primaire et secondaire
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Classification de la vidéo par l'Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA, Espagne).

Les valeurs valides pour cette propriété sont les suivantes :
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Classification de la vidéo par l'Irish Film Classification Office (IFCO, Irlande). Pour en savoir plus, consultez le site Web de l'IFCO.

Les valeurs valides pour cette propriété sont les suivantes :
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15 A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Classification de la vidéo en Israël.

Les valeurs valides pour cette propriété sont les suivantes :
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Classification INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentine) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (réservé aux adultes, diffusion soumise à conditions)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Réservé aux personnes de 16 ans et plus)
  • incaaSam18 – 18 (Réservé aux personnes de 18 ans et plus)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Classification de la vidéo par le Kenya Film Classification Board.

Les valeurs valides pour cette propriété sont les suivantes :
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Pays-Bas).

Les valeurs valides pour cette propriété sont les suivantes :
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Classification de la vidéo par le Korea Media Rating Board (영상물등급위원회). Le KMRB évalue les vidéos en Corée du Sud.

Les valeurs valides pour cette propriété sont les suivantes :
  • kmrb12plus : 12세 이상 관람가
  • kmrb15plus : interdit aux moins de 15 ans
  • kmrbAll – Tout public
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Classification de la vidéo par le Lembaga Sensor Film indonésien.

Les valeurs valides pour cette propriété sont les suivantes :
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Classification de la vidéo par le Film Age-Classification Board de Malte.

Les valeurs valides pour cette propriété sont les suivantes :
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 : cette classification a été supprimée de la nouvelle structure de classification introduite en 2013.
  • mccaa15 – 15
  • mccaa16 – 16 : cette classification a été supprimée de la nouvelle structure de classification introduite en 2013.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Classification de la vidéo par le Media Council for Children and Young People du Danish Film Institute (Det Danske Filminstitut).

Les valeurs valides pour cette propriété sont les suivantes :
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Système de classification de la vidéo pour le Vietnam (MCST)

Les valeurs valides pour cette propriété sont les suivantes :
  • mcst0 – 0
  • mcst16plus – 16 ans et plus
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Classification de la vidéo par la Media Development Authority (MDA) de Singapour et, plus précisément, par le Board of Film Censors (BFC).

Les valeurs valides pour cette propriété sont les suivantes :
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Classification de la vidéo par Medietilsynet, l'autorité norvégienne des médias.

Les valeurs valides pour cette propriété sont les suivantes :
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Classification de la vidéo par le Kansallinen Audiovisuaalinen Instituutti (Institut national de l'audiovisuel) de Finlande.

Les valeurs valides pour cette propriété sont les suivantes :
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Classification de la vidéo par le Ministero dei Beni e delle Attività Culturali e del Turismo (Italie).

Les valeurs valides pour cette propriété sont les suivantes :
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Classification de la vidéo par le Ministerio de Cultura (Colombie).

Les valeurs valides pour cette propriété sont les suivantes :
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – Exclu
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Classification de la vidéo par le ministère de la Culture de Taïwan (文化部).

Les valeurs valides pour cette propriété sont les suivantes :
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Classification MPAA (Motion Picture Association of America) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Classification de la Motion Picture Association of America pour les bandes-annonces et les extraits de films.

Les valeurs valides pour cette propriété sont les suivantes :
  • mpaatGb – GB (Green Band – Approved for all audiences)
  • mpaatRb – RB (Red Band : recommandé pour les spectateurs de 17 ans et plus)
contentDetails.contentRating.mtrcbRating string
Classification de la vidéo par le Movie and Television Review and Classification Board (Philippines).

Les valeurs valides pour cette propriété sont les suivantes :
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Classification de la vidéo par le Maldives National Bureau of Classification.

Les valeurs valides pour cette propriété sont les suivantes :
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18 ans et plus
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Classification de la vidéo par le Bulgarian National Film Center.

Les valeurs valides pour cette propriété sont les suivantes :
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Classification de la vidéo par le National Film and Video Censors Board du Nigeria.

Les valeurs valides pour cette propriété sont les suivantes :
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Classification de la vidéo attribuée par le Nacionãlais Kino centrs (Centre national du cinéma de Lettonie).

Les valeurs valides pour cette propriété sont les suivantes :
  • nkclv12plus – 12+
  • nkclv18plus – 18 ans et plus
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Classification de la vidéo par l'Office of Film and Literature Classification (OFLC - Nouvelle-Zélande).

Les valeurs valides pour cette propriété sont les suivantes :
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Classification de la vidéo au Pérou.

Les valeurs valides pour cette propriété sont les suivantes :
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Classification de la vidéo au Venezuela.

Les valeurs valides pour cette propriété sont les suivantes :
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Classification de la vidéo par la Direction générale de la radio, de la télévision et de la cinématographie (Mexique).

Les valeurs valides pour cette propriété sont les suivantes :
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Classification de la vidéo par la Raidió Teilifís Éireann (Irlande).

Les valeurs valides pour cette propriété sont les suivantes :
  • rteCh – CH
  • rteGa – DG
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Classification du Registre national des films de la Fédération de Russie (MKRF - Russie) pour la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16 ans et plus
  • russia18 – 18 ans et plus
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Classification de la vidéo en Slovaquie.

Les valeurs valides pour cette propriété sont les suivantes :
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Classification de la vidéo en Islande.

Les valeurs valides pour cette propriété sont les suivantes :
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Classification de la vidéo par le Statens medieråd (Conseil national des médias suédois).

Les valeurs valides pour cette propriété sont les suivantes :
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA : tous âges
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Classification TVPG (TV Parental Guidelines) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Classification utilisée par YouTube pour identifier les contenus soumis à une limite d'âge.

Les valeurs valides pour cette propriété sont les suivantes :
  • ytAgeRestricted
contentDetails.projection string
Spécifie le format de projection de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Indique si l'utilisateur ayant mis en ligne la vidéo a fourni une miniature personnalisée pour la vidéo. Cette propriété n'est visible que par l'utilisateur qui a mis en ligne la vidéo.
status object
L'objet status contient des informations sur l'état d'importation, de traitement et de confidentialité de la vidéo.
status.uploadStatus string
État de la vidéo mise en ligne.

Les valeurs valides pour cette propriété sont les suivantes :
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Cette valeur explique pourquoi une vidéo n'a pas pu être importée. Cette propriété n'est présente que si la propriété uploadStatus indique que l'importation a échoué.

Les valeurs valides pour cette propriété sont les suivantes :
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Cette valeur explique pourquoi YouTube a refusé une vidéo mise en ligne. Cette propriété n'est présente que si la propriété uploadStatus indique que l'importation a été refusée.

Les valeurs valides pour cette propriété sont les suivantes :
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
État de confidentialité de la vidéo. Dans une requête videos.insert, si vous ne spécifiez pas de valeur pour cette propriété, l'état de confidentialité de la vidéo mise en ligne est défini par défaut sur public. Certaines mises en ligne peuvent être définies par défaut sur private en fonction des paramètres du compte du créateur, comme expliqué dans le Centre d'aide YouTube. Les vidéos mises en ligne à partir de projets d'API non validés ne sont pas limitées au mode de visionnage privé.

Les valeurs valides pour cette propriété sont les suivantes :
  • private
  • public
  • unlisted
status.publishAt datetime
Date et heure auxquelles la vidéo doit être publiée. Il ne peut être défini que si l'état de confidentialité de la vidéo est défini sur "Privée". La valeur est spécifiée au format ISO 8601. Notez les deux points supplémentaires suivants concernant le comportement de cette propriété :
  • Si vous définissez la valeur de cette propriété lors de l'appel de la méthode videos.update, vous devez également définir la valeur de la propriété status.privacyStatus sur private, même si la vidéo est déjà privée.
  • Cette propriété ne peut être définie que si l'état de confidentialité de la vidéo est private et que la vidéo n'a jamais été publiée.
  • Si votre demande programme la publication d'une vidéo à une heure passée, elle sera publiée immédiatement. Par conséquent, définir la propriété status.publishAt sur une date et une heure passées revient à modifier la valeur de privacyStatus de private à public.
status.license string
Licence de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • creativeCommon
  • youtube
status.embeddable boolean
Cette valeur indique si la vidéo peut être intégrée à un autre site Web.
status.publicStatsViewable boolean
Cette valeur indique si les statistiques étendues de la vidéo sur sa page de lecture sont visibles publiquement. Par défaut, ces statistiques sont visibles, et les statistiques telles que le nombre de vues et les notes d'une vidéo restent visibles publiquement même si la valeur de cette propriété est définie sur false.
status.madeForKids boolean
Cette valeur indique si la vidéo est désignée comme destinée aux enfants et contient l'état actuel "conçue pour les enfants" de la vidéo. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube.
status.selfDeclaredMadeForKids boolean
Dans une requête videos.insert ou videos.update, cette propriété permet au propriétaire de la chaîne de désigner la vidéo comme étant destinée aux enfants. Dans une requête videos.list, la valeur de la propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API.
status.containsSyntheticMedia boolean
Dans une requête videos.insert ou videos.update, cette propriété permet au propriétaire de la chaîne d'indiquer qu'une vidéo contient du contenu modifié ou synthétique (M/S) réaliste. En savoir plus sur les Règles YouTube concernant les contenus A/S

Voici quelques exemples de contenus ASMR :
  • Faire dire ou faire à une personne réelle quelque chose qu'elle n'a pas dit ni fait
  • Modifier les images d'un événement ou d'un lieu réel
  • Générer une scène d'apparence réaliste qui n'a pas eu lieu
statistics object
L'objet statistics contient des statistiques sur la vidéo.
statistics.viewCount unsigned long

Nombre de fois où la vidéo a été regardée.

À partir du 24 août 2026, pour tous les formats vidéo (vidéos longues, diffusions en direct et Shorts) d'une chaîne, viewCount sera mis à jour pour comptabiliser les vues dès qu'une vidéo commencera à être lue (y compris la lecture automatique, le pointeur sur la vidéo et le clic/appuyer pour lire).
statistics.likeCount unsigned long
Nombre d'utilisateurs ayant indiqué qu'ils aimaient la vidéo.
statistics.dislikeCount unsigned long
Remarque : La propriété statistics.dislikeCount est devenue privée le 13 décembre 2021. Cela signifie que la propriété n'est incluse dans une réponse de l'API que si la requête API a été authentifiée par le propriétaire de la vidéo. Pour en savoir plus, consultez l'historique des révisions.

Nombre d'utilisateurs ayant indiqué qu'ils n'aimaient pas la vidéo.
statistics.favoriteCount unsigned long
Remarque : Cette propriété est obsolète. Cette suppression est effective depuis le 28 août 2015. La valeur de la propriété est désormais toujours définie sur 0.
statistics.commentCount unsigned long
Nombre de commentaires sur la vidéo.
paidProductPlacementDetails object
L'objet paidProductPlacementDetails contient des informations sur le placement de produit rémunéré dans la vidéo.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Définissez sur true si le contenu utilise un placement de produit rémunéré. La valeur par défaut est false.
player object
L'objet player contient les informations dont vous avez besoin pour lire la vidéo dans un lecteur intégré.
player.embedHtml string
Balise <iframe> qui intègre un lecteur permettant de lire la vidéo.
  • Si la requête API permettant de récupérer la ressource spécifie une valeur pour les paramètres maxHeight et/ou maxWidth, la taille du lecteur intégré est mise à l'échelle pour répondre aux exigences maxHeight et/ou maxWidth.
  • Si le format de la vidéo est inconnu, le lecteur intégré utilise par défaut le format 4:3.
player.embedHeight long
 Hauteur du lecteur intégré renvoyée dans la propriété player.embedHtml. Cette propriété n'est renvoyée que si la requête spécifie une valeur pour les paramètres maxHeight et/ou maxWidth, et si le format de la vidéo est connu.
player.embedWidth long
Largeur du lecteur intégré renvoyé dans la propriété player.embedHtml. Cette propriété n'est renvoyée que si la requête a spécifié une valeur pour les paramètres maxHeight et/ou maxWidth et que le format de la vidéo est connu.
topicDetails object
L'objet topicDetails encapsule des informations sur les thèmes associés à la vidéo.

Important : Consultez les définitions des propriétés topicDetails.relevantTopicIds[] et topicDetails.topicIds[], ainsi que l'historique des révisions pour en savoir plus sur les modifications à venir concernant les ID de thèmes.
topicDetails.topicIds[] list
Important : Cette propriété est obsolète depuis le 10 novembre 2016. L'API ne renvoie plus de valeurs pour cette propriété. Les thèmes associés à une vidéo sont désormais renvoyés par la valeur de la propriété topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Liste des ID de thèmes pertinents pour la vidéo.

Cette propriété a été abandonnée le 10 novembre 2016. Elle sera compatible jusqu'au 10 novembre 2017.

Important : En raison de l'abandon de Freebase et de l'API Freebase, les ID de sujet fonctionnent différemment depuis le 27 février 2017. À cette époque, YouTube a commencé à renvoyer un petit ensemble d'ID de thèmes sélectionnés.
topicDetails.topicCategories[] list
Liste d'URL Wikipédia fournissant une description générale du contenu de la vidéo.
recordingDetails object
L'objet recordingDetails encapsule des informations sur le lieu, la date et l'adresse où la vidéo a été enregistrée.
recordingDetails.locationDescription string
Cette propriété est obsolète depuis le 1er juin 2017. Pour en savoir plus, veuillez consulter l'annonce de l'abandon.

Description textuelle du lieu où la vidéo a été enregistrée.
recordingDetails.location object
Cette propriété est obsolète. Toutes ses propriétés enfants (latitude, longitude, altitude) sont obsolètes.

Informations de géolocalisation associées à la vidéo. Les valeurs des propriétés enfants identifient le lieu que le propriétaire de la vidéo souhaite associer à la vidéo. La valeur est modifiable, incluse dans l'index de recherche des vidéos publiques et peut être affichée aux utilisateurs pour les vidéos publiques.
recordingDetails.location.latitude double
Cette propriété est obsolète depuis le 1er juin 2017. Pour en savoir plus, consultez l'annonce de l'abandon.

Latitude en degrés.
recordingDetails.location.longitude double
Cette propriété est obsolète depuis le 1er juin 2017. Pour en savoir plus, consultez l'annonce de l'abandon.

Longitude en degrés.
recordingDetails.location.altitude double
Cette propriété est obsolète depuis le 9 juillet 2018. Pour en savoir plus, consultez l'annonce de l'abandon.

Altitude au-dessus de l'ellipsoïde de référence, en mètres.
recordingDetails.recordingDate datetime
Date et heure d'enregistrement de la vidéo. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
L'objet fileDetails contient des informations sur le fichier vidéo mis en ligne sur YouTube, y compris sa résolution, sa durée, ses codecs audio et vidéo, les débits des flux, etc. Seul le propriétaire de la vidéo peut récupérer ces données.

L'objet fileDetails ne sera renvoyé que si la propriété processingDetails.fileAvailability a la valeur available.
fileDetails.fileName string
Nom du fichier importé. Ce champ est présent, qu'un fichier vidéo ou un autre type de fichier ait été importé.
fileDetails.fileSize unsigned long
Taille du fichier importé, en octets. Ce champ est présent, qu'un fichier vidéo ou un autre type de fichier ait été importé.
fileDetails.fileType string
Type du fichier importé tel qu'il a été détecté par le moteur de traitement vidéo de YouTube. Actuellement, YouTube ne traite que les fichiers vidéo, mais ce champ est présent, qu'un fichier vidéo ou un autre type de fichier ait été importé.

Les valeurs valides pour cette propriété sont les suivantes :
  • archive : le fichier est un fichier d'archive, tel qu'une archive .zip.
  • audio : le fichier est un type de fichier audio connu, tel qu'un fichier .mp3.
  • document : le fichier est un document ou un fichier texte, tel qu'un document MS Word.
  • image : le fichier est un fichier image, par exemple une image .jpeg.
  • other : le fichier est d'un autre type que vidéo.
  • project : le fichier est un fichier de projet vidéo, tel qu'un projet Microsoft Windows Movie Maker, qui ne contient pas de données vidéo réelles.
  • video : le fichier est un type de fichier vidéo connu, tel qu'un fichier .mp4.
fileDetails.container string
Format de conteneur du fichier vidéo importé.
fileDetails.videoStreams[] list
Liste des flux vidéo contenus dans le fichier vidéo importé. Chaque élément de la liste contient des métadonnées détaillées sur un flux vidéo.
fileDetails.videoStreams[].widthPixels unsigned integer
Largeur du contenu vidéo encodé, en pixels. Vous pouvez calculer le format d'encodage de la vidéo comme suit : width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Hauteur du contenu vidéo encodé, en pixels.
fileDetails.videoStreams[].frameRateFps double
Fréquence d'images du flux vidéo, en images par seconde.
fileDetails.videoStreams[].aspectRatio double
Format d'affichage du contenu vidéo, qui spécifie le format dans lequel la vidéo doit être affichée.
fileDetails.videoStreams[].codec string
Codec vidéo utilisé par le flux.
fileDetails.videoStreams[].bitrateBps unsigned long
Débit du flux vidéo, en bits par seconde.
fileDetails.videoStreams[].rotation string
Quantité de rotation que YouTube doit appliquer au contenu source d'origine pour afficher correctement la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • clockwise : la vidéo doit être pivotée de 90 degrés dans le sens des aiguilles d'une montre.
  • counterClockwise : la vidéo doit être pivotée de 90 degrés dans le sens inverse des aiguilles d'une montre.
  • none : la vidéo n'a pas besoin d'être pivotée.
  • other : la vidéo doit être pivotée d'une autre manière, non triviale.
  • upsideDown : la vidéo doit être inversée.
fileDetails.videoStreams[].vendor string
Valeur qui identifie de manière unique un fournisseur de vidéos. En règle générale, la valeur est un code de fournisseur à quatre lettres.
fileDetails.audioStreams[] list
Liste des flux audio contenus dans le fichier vidéo importé. Chaque élément de la liste contient des métadonnées détaillées sur un flux audio.
fileDetails.audioStreams[].channelCount unsigned integer
Nombre de canaux audio contenus dans le flux.
fileDetails.audioStreams[].codec string
Codec audio utilisé par le flux.
fileDetails.audioStreams[].bitrateBps unsigned long
Débit du flux audio, en bits par seconde.
fileDetails.audioStreams[].vendor string
Valeur qui identifie de manière unique un fournisseur de vidéos. En règle générale, la valeur est un code de fournisseur à quatre lettres.
fileDetails.durationMs unsigned long
Durée de la vidéo importée en millisecondes.
fileDetails.bitrateBps unsigned long
Débit combiné (vidéo et audio) du fichier vidéo importé, en bits par seconde.
fileDetails.creationTime string
Date et heure de création du fichier vidéo importé. La valeur est spécifiée au format ISO 8601. Les formats ISO 8601 suivants sont actuellement acceptés :
  • Date uniquement : YYYY-MM-DD
  • Heure naïve : YYYY-MM-DDTHH:MM:SS
  • Heure avec fuseau horaire : YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
L'objet processingDetails contient des informations sur la progression de YouTube dans le traitement du fichier vidéo importé. Les propriétés de l'objet identifient l'état de traitement actuel et une estimation du temps restant avant que YouTube ne termine le traitement de la vidéo. Cette partie indique également si différents types de données ou de contenus, tels que les détails du fichier ou les images miniatures, sont disponibles pour la vidéo.

L'objet processingProgress est conçu pour être interrogé afin que l'utilisateur qui a mis en ligne la vidéo puisse suivre la progression du traitement du fichier vidéo par YouTube. Seul le propriétaire de la vidéo peut récupérer ces données.
processingDetails.processingStatus string
État de traitement de la vidéo. Cette valeur indique si YouTube a pu traiter la vidéo ou si elle est toujours en cours de traitement.

Les valeurs valides pour cette propriété sont les suivantes :
  • failed : échec du traitement de la vidéo. Consultez ProcessingFailureReason.
  • processing : la vidéo est en cours de traitement. Voir ProcessingProgress.
  • succeeded : la vidéo a bien été traitée.
  • terminated : les informations de traitement ne sont plus disponibles.
processingDetails.processingProgress object
L'objet processingProgress contient des informations sur la progression du traitement de la vidéo par YouTube. Les valeurs ne sont pertinentes que si l'état de traitement de la vidéo est processing.
processingDetails.processingProgress.partsTotal unsigned long
Estimation du nombre total de parties à traiter pour la vidéo. Ce nombre peut être mis à jour avec des estimations plus précises pendant le traitement de la vidéo par YouTube.
processingDetails.processingProgress.partsProcessed unsigned long
Nombre de parties de la vidéo que YouTube a déjà traitées. Vous pouvez estimer le pourcentage de la vidéo que YouTube a déjà traité en calculant :
100 * parts_processed / parts_total

Notez que, comme le nombre estimé de parties peut augmenter sans que le nombre de parties déjà traitées n'augmente, il est possible que la progression calculée diminue périodiquement pendant que YouTube traite une vidéo.
processingDetails.processingProgress.timeLeftMs unsigned long
Estimation du temps (en millisecondes) nécessaire à YouTube pour terminer le traitement de la vidéo.
processingDetails.processingFailureReason string
Raison pour laquelle YouTube n'a pas pu traiter la vidéo. Cette propriété n'aura de valeur que si la valeur de la propriété processingStatus est failed.

Les valeurs valides pour cette propriété sont les suivantes :
  • other : un autre composant de traitement a échoué.
  • streamingFailed – Impossible d'envoyer la vidéo aux streamers.
  • transcodeFailed : échec du transcodage du contenu.
  • uploadFailed : échec de la distribution du fichier.
processingDetails.fileDetailsAvailability string
Cette valeur indique si les détails du fichier sont disponibles pour la vidéo importée. Vous pouvez récupérer les informations détaillées sur le fichier d'une vidéo en demandant la partie fileDetails dans votre requête videos.list().
processingDetails.processingIssuesAvailability string
Cette valeur indique si le moteur de traitement vidéo a généré des suggestions susceptibles d'améliorer la capacité de YouTube à traiter la vidéo, des avertissements expliquant les problèmes de traitement vidéo ou des erreurs à l'origine de ces problèmes. Vous pouvez récupérer ces suggestions en demandant la partie suggestions dans votre requête videos.list().
processingDetails.tagSuggestionsAvailability string
Cette valeur indique si des suggestions de mots clés (tags) sont disponibles pour la vidéo. Vous pouvez ajouter des tags aux métadonnées d'une vidéo pour aider les autres utilisateurs à la trouver plus facilement. Vous pouvez récupérer ces suggestions en demandant la partie suggestions dans votre requête videos.list().
processingDetails.editorSuggestionsAvailability string
Cette valeur indique si des suggestions de montage vidéo, qui peuvent améliorer la qualité vidéo ou l'expérience de lecture, sont disponibles pour la vidéo. Vous pouvez récupérer ces suggestions en demandant la partie suggestions dans votre requête videos.list().
processingDetails.thumbnailsAvailability string
Cette valeur indique si des miniatures ont été générées pour la vidéo.
suggestions object
L'objet suggestions encapsule les suggestions qui identifient les opportunités d'amélioration de la qualité vidéo ou des métadonnées de la vidéo mise en ligne. Seul le propriétaire de la vidéo peut récupérer ces données.

L'objet suggestions ne sera renvoyé que si la propriété processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability a la valeur available.
suggestions.processingErrors[] list
Liste des erreurs qui empêcheront YouTube de traiter correctement la vidéo mise en ligne. Ces erreurs indiquent que, quel que soit l'état de traitement actuel de la vidéo, cet état sera presque certainement failed.

Les valeurs valides pour cette propriété sont les suivantes :
  • archiveFile : fichier d'archive (par exemple, une archive ZIP).
  • audioFile : le fichier ne contient que du contenu audio (par exemple, un fichier MP3).
  • docFile : document ou fichier texte (par exemple, un document MS Word).
  • imageFile : fichier image (par exemple, une image JPEG).
  • notAVideoFile : autre fichier non vidéo.
  • projectFile : fichier de projet vidéo (par exemple, projet Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Liste des raisons pour lesquelles YouTube peut rencontrer des difficultés à transcoder la vidéo mise en ligne ou qui peuvent entraîner un transcodage erroné. Ces avertissements sont générés avant que YouTube ne traite le fichier vidéo importé. En outre, ils identifient les problèmes qui n'indiquent pas nécessairement que le traitement de la vidéo échouera, mais qui peuvent tout de même entraîner des problèmes tels que des problèmes de synchronisation, des artefacts vidéo ou une piste audio manquante.

Les valeurs valides pour cette propriété sont les suivantes :
  • hasEditlist : les listes de modification ne sont pas acceptées pour le moment.
  • inconsistentResolution : résolutions de conteneur et de flux en conflit.
  • problematicAudioCodec : un codec audio connu pour causer des problèmes a été utilisé.
  • problematicVideoCodec : un codec vidéo connu pour causer des problèmes a été utilisé.
  • unknownAudioCodec – Codec audio non reconnu. Le transcodage risque d'échouer.
  • unknownContainer : format de fichier non reconnu. Le transcodage risque d'échouer.
  • unknownVideoCodec : codec vidéo non reconnu, le transcodage risque d'échouer.
suggestions.processingHints[] list
Liste de suggestions qui peuvent améliorer la capacité de YouTube à traiter la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :
  • nonStreamableMov : le fichier MP4 n'est pas diffusable en streaming, ce qui ralentit le traitement.
  • sendBestQualityVideo : il existe probablement une version de meilleure qualité de la vidéo.
suggestions.tagSuggestions[] list
Liste de tags de mots clés qui pourraient être ajoutés aux métadonnées de la vidéo pour augmenter la probabilité que les utilisateurs trouvent votre vidéo lorsqu'ils effectuent une recherche ou parcourent YouTube.
suggestions.tagSuggestions[].tag string
Balise de mot clé suggérée pour la vidéo.
suggestions.tagSuggestions[].categoryRestricts[] list
Ensemble de catégories de vidéos pour lesquelles le tag est pertinent. Vous pouvez utiliser ces informations pour afficher des suggestions de tags appropriées en fonction de la catégorie de vidéo que l'utilisateur associe à la vidéo. Par défaut, les suggestions de tags sont pertinentes pour toutes les catégories si aucune restriction n'est définie pour le mot clé.
suggestions.editorSuggestions[] list
Liste des opérations de montage vidéo susceptibles d'améliorer la qualité vidéo ou l'expérience de lecture de la vidéo mise en ligne.

Les valeurs valides pour cette propriété sont les suivantes :
  • audioQuietAudioSwap : la piste audio semble silencieuse et pourrait être remplacée par une piste de meilleure qualité.
  • videoAutoLevels : les niveaux de luminosité de l'image semblent incorrects et pourraient être corrigés.
  • videoCrop : les marges (caches) détectées autour de l'image peuvent être recadrées.
  • videoStabilize : la vidéo semble trembler et pourrait être stabilisée.
liveStreamingDetails object
L'objet liveStreamingDetails contient des métadonnées sur une diffusion vidéo en direct. L'objet n'est présent dans une ressource video que si la vidéo est une diffusion en direct à venir, en cours ou terminée.
liveStreamingDetails.actualStartTime datetime
Heure à laquelle la diffusion a réellement commencé. La valeur est spécifiée au format ISO 8601. Cette valeur ne sera disponible qu'une fois la diffusion commencée.
liveStreamingDetails.actualEndTime datetime
Heure à laquelle la diffusion s'est réellement terminée. La valeur est spécifiée au format ISO 8601. Cette valeur ne sera disponible qu'à la fin de la diffusion.
liveStreamingDetails.scheduledStartTime datetime
Heure à laquelle la diffusion doit commencer. La valeur est spécifiée au format ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Heure à laquelle la diffusion doit se terminer. La valeur est spécifiée au format ISO 8601. Si la valeur est vide ou si la propriété n'est pas présente, la diffusion est programmée pour se poursuivre indéfiniment.
liveStreamingDetails.concurrentViewers unsigned long
Nombre de spectateurs qui regardent actuellement la diffusion. La propriété et sa valeur sont présentes si la diffusion a des spectateurs actuels et que le propriétaire de la diffusion n'a pas masqué le nombre de vues de la vidéo. Notez que YouTube cesse de suivre le nombre de spectateurs simultanés pour une diffusion une fois celle-ci terminée. Cette propriété n'identifierait donc pas le nombre de spectateurs qui regardent une vidéo archivée d'une diffusion en direct déjà terminée.
Le nombre de spectateurs simultanés renvoyé par l'API YouTube Data peut différer du nombre de spectateurs simultanés traité et sans spam disponible via YouTube Analytics. En savoir plus sur les métriques des diffusions en direct dans le Centre d'aide YouTube
liveStreamingDetails.activeLiveChatId string
ID du chat en direct actuellement actif associé à cette vidéo. Ce champ n'est renseigné que si la vidéo est une diffusion en direct en cours avec un chat en direct. Une fois la diffusion terminée, ce champ sera supprimé et le chat en direct sera fermé. Pour les diffusions persistantes, cet ID de chat en direct ne sera plus associé à cette vidéo, mais à la nouvelle vidéo affichée sur la page persistante.
brandPartner object
L'objet brandPartner contient des informations sur la marque partenaire associée à la vidéo pour l'accès des marques partenaires à l'initiative des créateurs (CI BPA).
brandPartner.channelId string
ID externe de la chaîne du partenaire de la marque. Ce champ doit commencer par "UC". Vous devez définir channelId ou channelHandle lors de l'établissement de l'accès, mais seul channelId est renvoyé dans la réponse.
brandPartner.channelHandle string
Identifiant de la chaîne de la marque partenaire. Ce champ doit commencer par "@". channelId ou channelHandle doit être défini lors de l'établissement de l'accès, mais seul channelId est renvoyé dans la réponse.
localizations object
L'objet localizations contient les traductions des métadonnées de la vidéo.
localizations.(key) object
Langue du texte localisé associé à la valeur de la clé. La valeur est une chaîne contenant un code de langue BCP-47.
localizations.(key).title string
Titre localisé de la vidéo.
localizations.(key).description string
Description localisée de la vidéo.