Videos

Toutes les vidéos importées via le point de terminaison videos.insert à partir de projets d'API non validés créés après le 28 juillet 2020 seront limitées au mode de visionnage privé. Pour lever cette restriction, chaque projet d'API doit faire l'objet d'un audit afin de vérifier qu'il est conforme aux Conditions d'utilisation. Pour en savoir plus, consultez l'historique des révisions de l'API.

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 que l'utilisateur autorisé a attribuées à une liste de vidéos spécifiées. Essayer

list

Renvoie une liste de vidéos correspondant aux paramètres de requête API. Essayer

insérer

Mise en ligne d'une vidéo sur YouTube et définition facultative de ses métadonnées

mettre à jour

Modifie les métadonnées d'une vidéo. Essayer

supprimer

Supprime une vidéo YouTube. Essayer

tarif

Ajoutez une note sur "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimez la note qui lui est attribuée. Essayer

signaler un abus

Signaler une vidéo pour son contenu abusif Essayer

Représentation des ressources

La structure JSON suivante illustre 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
  },
  "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 API. La valeur est youtube#video.
etag	etag Etag de cette ressource.
id	string ID utilisé par YouTube pour identifier la vidéo de façon unique.
snippet	object L'objet snippet contient des informations de base sur la vidéo, comme son titre, sa description et sa catégorie.
snippet.publishedAt	datetime Date et heure de publication de la vidéo. Notez que l'heure de la mise en ligne peut être différente de celle de la mise en ligne de la vidéo. 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é indique l'heure à laquelle elle 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é indique également la date et l'heure de la mise en ligne. Dans ce cas, toute personne connaissant l'ID vidéo unique de la vidéo peut récupérer ses métadonnées. La valeur est spécifiée au format ISO 8601.
snippet.channelId	string ID utilisé par YouTube pour identifier de façon unique la chaîne sur laquelle la vidéo a été mise en ligne.
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 mettez à jour la partie snippet d'une ressource video.
snippet.description	string Description de la vidéo La valeur de la propriété ne doit pas dépasser 5 000 octets et peut contenir tous les caractères UTF-8 valides, à l'exception de < et >.
snippet.thumbnails	object Carte des vignettes associées à la vidéo. Pour chaque objet de la carte, la clé correspond au nom de la vignette, tandis que la valeur est un objet contenant d'autres informations sur la vignette.
snippet.thumbnails.(key)	object Les clés-valeurs valides sont les suivantes: default : vignette par défaut. La miniature par défaut d'une vidéo (ou d'une ressource faisant référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large sur 90 pixels de haut. Par défaut, la miniature d'une chaîne mesure 88 pixels de large sur 88 pixels de haut. medium : version haute résolution de l'image de la miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large sur 180 pixels de haut. Pour une chaîne, cette image mesure 240 pixels de large sur 240 pixels de haut. high : version haute résolution de l'image de la miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large sur 360 pixels de haut. Pour une chaîne, cette image mesure 800 pixels de large sur 800 pixels de haut. standard : version encore plus élevée de l'image miniature que celle de la résolution high. Cette image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image mesure 640 pixels de large sur 480 pixels de haut. maxres : version avec la résolution la plus élevée de l'image de la miniature. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources qui se rapportent à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image mesure 1 280 pixels de large sur 720 pixels 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 de tags de mots clés associés à la vidéo. Les balises peuvent contenir des espaces. La valeur de la propriété ne doit pas dépasser 500 caractères. Tenez compte des règles suivantes concernant le calcul de la limite 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 entre guillemets. Ces derniers sont alors comptabilisés dans le nombre maximal de caractères. Ainsi, dans le cadre du nombre maximal de caractères, la balise Foo-Baz contient sept caractères, tandis que la balise Foo Baz en contient neuf.
snippet.categoryId	string Catégorie de la 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 mettez à jour la partie snippet d'une ressource video.
snippet.liveBroadcastContent	string Indique si la vidéo est une diffusion en direct à venir/active. Il prend également la valeur "none " si la vidéo n'est pas une diffusion en direct à venir/active. Les valeurs acceptées 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 soit un titre et une description localisés pour la vidéo, soit le titre dans la langue par défaut des 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 le texte localisé doit être renvoyé et que le texte localisé est disponible dans cette langue. Les métadonnées pour 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 que les métadonnées localisées ne sont pas disponibles pour la langue spécifiée. La propriété contient une valeur en lecture seule. Utilisez l'objet localizations pour ajouter, mettre à jour 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 sa durée et une indication si des sous-titres sont disponibles pour celle-ci.
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'au moins une minute et de moins d'une heure, la durée est au format PT#M#S. Les lettres PT indiquent que la valeur spécifie une période, et les lettres M et S désignent la durée en minutes et en secondes, respectivement. Les caractères # précédant les lettres M et S sont des entiers qui indiquent 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. L'élément # qui précède la lettre H indique 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 une journée, les lettres P et T sont séparées, et le format de la valeur est P#DT#H#M#S. Pour plus d'informations, 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 acceptées 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 du contenu sous licence, c'est-à-dire si 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 (ou non) visible. L'objet contiendra la propriété contentDetails.regionRestriction.allowed ou contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list Liste de codes régionaux qui identifient les pays dans lesquels la vidéo est disponible. Si cette propriété est présente et qu'un pays ne figure pas dans sa valeur, la diffusion de la vidéo est bloquée dans ce pays. Si cette propriété est présente et qu'elle contient une liste vide, la vidéo est bloquée dans tous les pays.
contentDetails.regionRestriction.blocked[]	list Liste de codes régionaux qui identifient les pays dans lesquels la vidéo est bloquée. Si cette propriété est présente et qu'un pays ne figure pas dans sa valeur, cela signifie que la vidéo est disponible dans ce pays. Si cette propriété est présente et qu'elle contient une liste vide, la vidéo est visible dans tous les pays.
contentDetails.contentRating	object Spécifie les notes que la vidéo a reçues selon différents systèmes de classification.
contentDetails.contentRating.acbRating	string Classification de la vidéo : 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 classés dans la catégorie C par l'Australian Communications and Media Authority. Ces programmes sont destinés aux moins de 14 ans (sauf tout-petits). acbE – E acbG – V acbM – M acbMa15plus – MA15+ acbP : programmes classés dans la catégorie P par l'Australian Communications and Media Authority. Ces programmes sont destinés aux tout-petits. acbPg – PG acbR18plus – Interdit aux moins de 18 ans acbUnrated
contentDetails.contentRating.agcomRating	string Classification de la vidéo par l'Autorità per le Garanzie nelle Comunicazioni (AGCOM) en Italie. Les valeurs acceptées 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 acceptées pour cette propriété sont les suivantes : anatelA – A anatelF – V anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – D anatelUnrated
contentDetails.contentRating.bbfcRating	string Classification du British Board of Film Classification (BBFC) de la vidéo. Les valeurs acceptées pour cette propriété sont les suivantes : bbfc12 – 12 bbfc12a – 12:00 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 acceptées pour cette propriété sont les suivantes : bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – o bfvcE – E bfvcG – V bfvcUnrated
contentDetails.contentRating.bmukkRating	string Classification de la vidéo par le Conseil autrichien de classification des médias (Bundesministerium für Unterricht, Kunst und Kultur). Les valeurs acceptées pour cette propriété sont les suivantes : bmukk10 – 10 et plus bmukk12 – 12 et plus bmukk14 – 14 et plus bmukk16 – 16 et plus bmukk6 – Plus de 6 bmukk8 – Plus de 8 ans bmukkAa – Pas de restriction bmukkUnrated
contentDetails.contentRating.catvRating	string Système de classification de la TV canadienne - Système de classification de la télévision canadienne Classification de la vidéo émise par la Commission canadienne de la radiotélévision et des télécommunications (CRTC) pour les émissions diffusées en langue canadienne anglophone. Pour en savoir plus, consultez le site Web du Canadian Broadcast Standards Council. Les valeurs valides pour cette propriété sont les suivantes : catv14plus – 14 et plus catv18plus – 18 ans et plus catvC – C catvC8 – C8 catvG – V catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Classification de la vidéo par la Commission canadienne de la radiotélévision et des télécommunications (CRTC) pour les émissions canadiennes francophones. Pour en savoir plus, consultez le site Web du Canadian Broadcast Standards Council. Les valeurs valides pour cette propriété sont les suivantes : catvfr13plus – 13 et plus catvfr16plus – 16 et plus catvfr18plus – 18 ans et plus catvfr8plus – Plus de 8 ans catvfrG – V catvfrUnrated
contentDetails.contentRating.cbfcRating	string Classification du Central Board of Film Certification (CBFC – Inde) de la vidéo. Les valeurs acceptées 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 Note de la vidéo Consejo de Calificación Cinematográfica (Chili). Les valeurs acceptées pour cet établissement sont les suivantes : ccc14 – 14 et plus ccc18 – 18 ans et plus ccc18s – 18 ans et plus (contenido pornográfico) ccc18v – 18+ – contenido excesivamente violento ccc6 – 6 ans et plus – Dérangement pour une pause de sept ans cccTe – Espectador de tâches cccUnrated
contentDetails.contentRating.cceRating	string Classification de la vidéo, émise par la Comissão de Classificação de Espect 'culos au Portugal. Les valeurs acceptées 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 acceptées pour cette propriété sont les suivantes : chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 - 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Classification CHVRS (Canada Home Video Rating System) de la vidéo. Les valeurs acceptées pour cette propriété sont les suivantes : chvrs14a – 14:00 chvrs18a – 18:00 chvrsE – E chvrsG – V chvrsPg – PG chvrsR – D chvrsUnrated
contentDetails.contentRating.cicfRating	string Classification de la vidéo par la Commission de Contrôle des Films (Belgique). Les valeurs acceptées 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 acceptées 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 cinématographique Les valeurs acceptées 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 fournie par le Conseil supérieur de l'audiovisuel français, qui évalue le contenu diffusé. Les valeurs acceptées 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, émise par la Commission de surveillance de la classification des films (CSCF) du Luxembourg. Les valeurs acceptées pour cette propriété sont les suivantes : cscf12 – 12 cscf16 – 16 cscf18 – 18 cscf6 - 6 cscf9 - 9 cscfA – A cscfAl – Alabama cscfUnrated
contentDetails.contentRating.czfilmRating	string Classification de la vidéo en République tchèque. Les valeurs acceptées pour cette propriété sont les suivantes : czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Note de la vidéo "Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brésil). Les valeurs acceptées pour cet établissement sont les suivantes : djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – G djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Raisons pour lesquelles la vidéo a été classée par le DJCQT (Brésil).
contentDetails.contentRating.ecbmctRating	string Système de classification en Turquie - Comité d'évaluation et de classification du ministère de la Culture et du Tourisme Les valeurs acceptées pour cet établissement sont les suivantes : ecbmct13a – 13:00 ecbmct13plus – 13 et plus ecbmct15a – 15 heures ecbmct15plus – 15 et plus ecbmct18plus – 18 ans et plus ecbmct7a – 7:00 ecbmct7plus – 7 et plus ecbmctG – V ecbmctUnrated ecbmct6a – 6 heures ecbmct6plus – Plus de 6 ecbmct10a-10 h ecbmct10plus – 10 et plus ecbmct16plus – 16 et plus
contentDetails.contentRating.eefilmRating	string Note de la vidéo en Estonie. Les valeurs valides pour cette propriété sont les suivantes : eefilmK12 – Enseignement primaire et secondaire eefilmK14 – Enseignement primaire et secondaire eefilmK16 – Enseignement primaire et secondaire eefilmK6 – Enseignement primaire et secondaire eefilmL – G 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 Note Eirin (映倫) de la vidéo Eirin est le système de classification japonais. Les valeurs acceptées pour cette propriété sont les suivantes : eirinG – V eirinPg12 – PG-12 eirinR15plus – Interdit aux moins de 15 ans eirinR18plus – Interdit aux moins de 18 ans eirinUnrated
contentDetails.contentRating.fcbmRating	string Classification de la vidéo par le Conseil malaisien de censure des films. Les valeurs acceptées 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 acceptées 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 de la vidéo (Centre national du cinéma et de l'image animée) du ministère de la Culture français. Les valeurs acceptées 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 acceptées 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 Raisons pour lesquelles la vidéo a été classée FPB (Afrique du Sud).
contentDetails.contentRating.fskRating	string Note "Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Allemagne)" de la vidéo. Les valeurs acceptées 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 acceptées pour cette propriété sont les suivantes : grfilmE – E grfilmK – K grfilmK12 – Enseignement primaire et secondaire grfilmK13 – Enseignement primaire et secondaire grfilmK15 – Enseignement primaire et secondaire grfilmK17 – Enseignement primaire et secondaire grfilmK18 – Enseignement primaire et secondaire grfilmUnrated
contentDetails.contentRating.icaaRating	string Classification ICAA – Espagne (Instituto de la Cinematografía y de las Artes Audiovisuales) de la vidéo. Les valeurs acceptées 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 irlandaise (IFCO) de la vidéo Pour en savoir plus, consultez le site Web IFCO. Les valeurs valides pour cette propriété sont les suivantes : ifco12 – 12 ifco12a – 12:00 ifco15 – 15 ifco15a – 15 heures ifco16 – 16 ifco18 – 18 ifcoG – V ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Classification de la vidéo en Israël. Les valeurs acceptées pour cette propriété sont les suivantes : ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Note INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentine) associée à la vidéo. Les valeurs acceptées pour cette propriété sont les suivantes : incaaAtp – ATP (Apta para todo publico) incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada) incaaSam13 – 13 (Solo apta para mayores de 13 años) incaaSam16 – 16 (Solo apta para mayores de 16 ans) incaaSam18 – 18 (Solo apta para mayores de 18 ans) incaaUnrated
contentDetails.contentRating.kfcbRating	string Classification de la vidéo par le Kenya Film Classification Board. Les valeurs acceptées 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 acceptées pour cette propriété sont les suivantes : kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 - 6 kijkwijzer9 - 9 kijkwijzerAl – Alabama kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string La note du Korea Media Rating Board (영상물등미플원회) de la vidéo. Le KMRB évalue les vidéos en Corée du Sud. Les valeurs acceptées pour cette propriété sont les suivantes : kmrb12plus – 12세 이상 관람사 kmrb15plus – 15세 이상 관람 kmrbAll - 에체관람型 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Note de la vidéo tirée du film indonesia Lembaga Sensor. Les valeurs acceptées pour cette propriété sont les suivantes : lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – D lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Classification de la vidéo par le Film Age-Classification Board de Malte. Les valeurs acceptées pour cette propriété sont les suivantes : mccaa12 – 12 mccaa12a – 12:00 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 de l'Institut danois du film (Det Danske Filminstitut). Les valeurs acceptées 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 acceptées pour cette propriété sont les suivantes : mcst0 – 0 mcst16plus – 16 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 établie par la Media Development Authority (MDA) de Singapour et plus précisément par le Board of Film Censors (BFC). Les valeurs acceptées pour cette propriété sont les suivantes : mdaG – V mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Note de la vidéo fournie par Medietilsynet, la Norwegian Media Authority. 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 l'organisme finlandais Kansallinen Audiovisuaalinen Instituutti (Institut national de l'audiovisuel). 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 acceptées pour cet établissement sont les suivantes : mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Classification de la vidéo par Ministerio de Cultura (Colombie). Les valeurs acceptées 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 Note de la vidéo fournie par le ministère taïwanais de la Culture (文化部). Les valeurs acceptées pour cette propriété sont les suivantes : moctwG – V moctwP – P moctwPg – PG moctwR – D moctwR12 – Interdit aux moins de 12 ans moctwR15 – R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Classification MPAA (Motion Picture Association of America) de la vidéo. Les valeurs acceptées pour cette propriété sont les suivantes : mpaaG – V mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – D mpaaUnrated
contentDetails.contentRating.mpaatRating	string Classification de la Motion Picture Association of America pour les bandes-annonces et les aperçus de films. Les valeurs acceptées pour cette propriété sont les suivantes : mpaatGb – Go (bande verte – Approuvé pour tous les publics) mpaatRb – RB (bande rouge – recommandé pour les utilisateurs âgés 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 acceptées pour cette propriété sont les suivantes : mtrcbG – V mtrcbPg – PG mtrcbR13 – Interdit aux moins de 13 ans mtrcbR16 – Interdit aux moins de 16 ans mtrcbR18 – R-18 mtrcbUnrated mtrcbX – X
contentDetails.contentRating.nbcRating	string Classification de la vidéo par le Bureau national de classification des Maldives. Les valeurs acceptées pour cette propriété sont les suivantes : nbc12plus – 12 et plus nbc15plus – 15 et plus nbc18plus – 18 ans et plus nbc18plusr – 18 ans et plus nbcG – V nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Classification de la vidéo provenant du Bulgarie National Film Center. Les valeurs acceptées pour cette propriété sont les suivantes : nfrcA – A nfrcB – o 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 acceptées pour cette propriété sont les suivantes : nfvcb12 – 12 nfvcb12a – 12:00 nfvcb15 – 15 nfvcb18 – 18 nfvcbG – V nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Classification de la vidéo par le Nacionãlais Kino centrs (Centre national du film de Lettonie). Les valeurs acceptées pour cet établissement sont les suivantes : nkclv12plus – 12 et plus nkclv18plus – 18 ans et plus nkclv7plus – 7 et plus nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Classification Office of Film and Literature Classification (OFLC, Nouvelle-Zélande) de la vidéo. Les valeurs acceptées pour cette propriété sont les suivantes : oflcG – V 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 acceptées 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 – o resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string Classification de la vidéo (General Directorate of Radio, Television and Cinematography (Mexique)). Les valeurs acceptées pour cette propriété sont les suivantes : rtcA – A rtcAa – AA rtcB – o rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Note de l'éditeur irlandais Raidió Teilifís Éireann. Les valeurs acceptées pour cet établissement sont les suivantes : rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Classification MKRF (Russie) de la vidéo au Registre national des films de la Fédération de Russie. Les valeurs acceptées pour cette propriété sont les suivantes : russia0 – 0 ou plus russia12 – 12 et plus russia16 – 16 et plus russia18 – 18 ans et plus russia6 – Plus de 6 russiaUnrated
contentDetails.contentRating.skfilmRating	string Classification de la vidéo en Slovaquie. Les valeurs acceptées pour cette propriété sont les suivantes : skfilmG – V skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Classification de la vidéo en Islande. Les valeurs acceptées pour cette propriété sont les suivantes : smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 smais7 – 7 smaisL – G smaisUnrated
contentDetails.contentRating.smsaRating	string Classification de la vidéo par Statens medieråd (Conseil national des médias de Suède). Les valeurs acceptées pour cette propriété sont les suivantes : smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Tous les âges smsaUnrated
contentDetails.contentRating.tvpgRating	string Classification de la vidéo selon le règlement parental (TVPG). Les valeurs acceptées 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 acceptées 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 indique pourquoi une vidéo n'a pas pu être mise en ligne. 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. Les valeurs acceptées pour cette propriété sont les suivantes : private public unlisted
status.publishAt	datetime Date et heure de publication prévue de la vidéo. 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 autres points suivants concernant le comportement de cette propriété: Si vous définissez la valeur de cette propriété lorsque vous appelez 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. Si votre demande programme la publication d'une vidéo par le passé, elle sera publiée immédiatement. Par conséquent, le fait de définir la propriété status.publishAt sur une date et une heure passées est le même que de faire passer l'privacyStatus de la vidéo 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 sur un autre site Web.
status.publicStatsViewable	boolean Cette valeur indique si les statistiques étendues de la vidéo sur la page de lecture de la vidéo sont visibles publiquement. Par défaut, ces statistiques sont visibles. Des 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 étant destinée aux enfants et indique si cette vidéo est actuellement "conçue pour les enfants". Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Consultez le Centre d'aide YouTube pour savoir comment définir l'audience de votre chaîne, de vos vidéos ou de vos diffusions.
status.selfDeclaredMadeForKids	boolean Dans une demande videos.insert ou videos.update, cette propriété permet au propriétaire de la chaîne d'indiquer que la vidéo est destinée aux enfants. Dans une requête videos.list, la valeur de propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API.
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.
statistics.likeCount	unsigned long Nombre d'utilisateurs ayant indiqué avoir aimé la vidéo.
statistics.dislikeCount	unsigned long Remarque:La propriété statistics.dislikeCount est désormais privée depuis 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'ont pas aimé la vidéo.
statistics.favoriteCount	unsigned long Remarque:Cette propriété est obsolète. Cet abandon prendra effet 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 de la vidéo.
player	object L'objet player contient des informations que vous pouvez utiliser pour lire la vidéo dans un lecteur intégré.
player.embedHtml	string Balise <iframe> intégrant un lecteur qui lit la vidéo. Si la requête API de récupération de la ressource spécifie une valeur pour les paramètres maxHeight et/ou maxWidth, la taille du lecteur intégré est ajustée pour répondre aux exigences maxHeight et/ou maxWidth. Si le format de la vidéo n'est pas connu, le format 4:3 est défini par défaut sur le lecteur intégré.
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 que le format de la vidéo est connu.
player.embedWidth	long Largeur 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 que le format de la vidéo est connu.
topicDetails	object L'objet topicDetails encapsule les 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 liées aux identifiants des 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é, et tous 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é est obsolète depuis le 10 novembre 2016. Elles seront disponibles jusqu'au 10 novembre 2017. Important:En raison de l'abandon de Freebase et de l'API Freebase, les ID de thèmes fonctionnent différemment depuis le 27 février 2017. À ce moment-là, YouTube a commencé à renvoyer un petit ensemble d'identifiants de thèmes sélectionnés. Découvrez les ID de thèmes acceptés à partir du 15 février 2017. Sujets Thèmes musicaux /m/04rlf Musique (sujet parent) /m/02mscn musique chrétienne /m/0ggq0m Musique classique /m/01lyv Pays /m/02lkt Électro /m/0glt670 Hip-hop /m/05rwpb Musique indépendante /m/03_d0 Jazz /m/028sqc Musique d'Asie /m/0g293 Musique d'Amérique latine /m/064t9 Pop /m/06cqb Reggae /m/06j6l Rhythm and blues /m/06by7 Rock /m/0gywn Soul Thèmes liés aux jeux vidéo /m/0bzvm2 Jeux vidéo (sujet parent) /m/025zzc Jeu d'action /m/02ntfj Jeu d'action et d'aventure /m/0b1vjn Jeu grand public /m/02hygl Jeu vidéo musical /m/04q1x3q Jeu vidéo de réflexion /m/01sjng Jeu vidéo de course /m/0403l3g Jeu vidéo de rôle /m/021bp2 Simulation de jeu vidéo /m/022dc6 Jeu de sport /m/03hf_rm Jeu vidéo stratégique Thèmes sportifs /m/06ntj Sports (sujet principal) /m/0jm_ Football américain /m/018jz Base-ball /m/018w8 Basket-ball /m/01cgz Boxe /m/09xp_ Cricket /m/02vx4 Football américain /m/037hz Golf /m/03tmr Hockey sur glace /m/01h7lh Arts martiaux mixtes /m/0410tth Sports motorisés /m/07bs0 Tennis /m/07_53 Volley-ball Thèmes du divertissement /m/02jjt Divertissement (sujet pour les parents) /m/09kqc Humour /m/02vxn Films /m/05qjc Arts du spectacle /m/066wd Catch /m/0f2f9 Séries TV Thèmes liés au mode de vie /m/019_rr Style de vie (sujet parent) /m/032tl Mode /m/027x7n Remise en forme /m/02wbm Nourriture /m/03glg Loisirs /m/068hy Animaux de compagnie /m/041xxh Attrait physique [Beauté] /m/07c1v Technologie /m/07bxq Tourisme /m/07yv9 Véhicules Sujets liés à la société /m/098wr Société (sujet parent) /m/09s1f Métier /m/0kt51 État /m/01h6rj Armée /m/05qt0 Politique /m/06bvp Religion Autres sujets /m/01k8wb Connaissances
topicDetails.topicCategories[]	list Liste d'URL de Wikipédia fournissant une description détaillée du contenu de la vidéo.
recordingDetails	object L'objet recordingDetails encapsule les 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, consultez l'annonce d'abandon. Description du lieu où la vidéo a été enregistrée.
recordingDetails.location	object Informations de géolocalisation associées à la vidéo. Notez que les valeurs de la propriété enfant indiquent le lieu que le propriétaire de la vidéo souhaite associer à celle-ci. Cette valeur peut être modifiée, incluse dans l'index de recherche pour les vidéos publiques, et peut être visible par les utilisateurs dans le cas de 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 d'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 d'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 d'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 encapsule les informations sur le fichier vidéo importé sur YouTube, y compris la résolution du fichier, sa durée, ses codecs audio et vidéo, les débits de flux, etc. Seul le propriétaire de la vidéo peut récupérer ces données. L'objet fileDetails n'est renvoyé que si la propriété processingDetails.fileAvailability a la valeur available.
fileDetails.fileName	string Nom du fichier importé. Ce champ est disponible, 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 disponible, qu'un fichier vidéo ou un autre type de fichier ait été importé.
fileDetails.fileType	string Type du fichier importé tel qu'il est 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 ait été importé. Les valeurs acceptées pour cette propriété sont les suivantes : archive : le fichier est un fichier d'archive, comme une archive .zip. audio : le fichier est un type de fichier audio connu, par exemple un fichier .mp3. document : le fichier est un document ou un fichier texte, par exemple un document MS Word. image : le fichier est un fichier image, par exemple une image .jpeg. other : le fichier n'est pas de type vidéo. project : fichier de projet vidéo (un projet Microsoft Windows Movie Maker, par exemple) qui ne contient pas de données vidéo réelles. video : le fichier est un type de fichier vidéo connu, comme un fichier .mp4.
fileDetails.container	string Format du conteneur du fichier vidéo importé.
fileDetails.videoStreams[]	list Liste des flux vidéo contenus dans le fichier vidéo mis en ligne. Chaque élément de la liste contient des métadonnées détaillées relatives à 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, exprimée en frames 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, exprimé en bits par seconde.
fileDetails.videoStreams[].rotation	string Quantité nécessaire à YouTube pour faire pivoter le contenu source d'origine afin d'afficher correctement la vidéo. Les valeurs acceptées 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 faire l'objet d'une rotation 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 rotation de la vidéo doit être effectuée d'une autre manière. upsideDown : la vidéo doit être retournée.
fileDetails.videoStreams[].vendor	string Valeur qui identifie de manière unique un fournisseur vidéo. Généralement, la valeur est un code 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 vidéo. Généralement, la valeur est un code fournisseur à quatre lettres.
fileDetails.durationMs	unsigned long Durée de la vidéo mise en ligne en millisecondes.
fileDetails.bitrateBps	unsigned long Débit combiné (vidéo et audio) du fichier vidéo mis en ligne, en bits par seconde.
fileDetails.creationTime	string Date et heure de création du fichier vidéo mis en ligne. La valeur est spécifiée au format ISO 8601. Actuellement, les formats ISO 8601 suivants sont acceptés: Date uniquement: YYYY-MM-DD Temps naïf: YYYY-MM-DDTHH:MM:SS Heure avec le fuseau horaire: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object L'objet processingDetails encapsule les informations sur la progression de YouTube dans le traitement du fichier vidéo importé. Les propriétés de l'objet indiquent l'état actuel du traitement et une estimation du temps restant avant que YouTube n'ait fini de traiter la vidéo. Elle indique également si différents types de données ou de contenus, tels que des détails de fichier ou des vignettes, sont disponibles pour la vidéo. L'objet processingProgress est conçu pour être interrogé afin que la vidéo mise en ligne puisse suivre la progression du traitement du fichier vidéo mis en ligne 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 acceptées pour cette propriété sont les suivantes : failed : échec du traitement de la vidéo. Consultez "ProcessFailureReason". processing : la vidéo est en cours de traitement. Consultez "ProcessProgress". succeeded : la vidéo a bien été traitée. terminated : les informations sur le traitement ne sont plus disponibles.
processingDetails.processingProgress	object L'objet processingProgress contient des informations sur la progression de YouTube dans le traitement de la vidéo. Ces 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 que YouTube traite la vidéo.
processingDetails.processingProgress.partsProcessed	unsigned long Nombre de parties de la vidéo déjà traitées par YouTube. Vous pouvez estimer le pourcentage de la vidéo déjà traité par YouTube en calculant ce qui suit: 100 * parts_processed / parts_total Notez que l'estimation du nombre de parties pouvant augmenter sans augmentation correspondante du nombre de parties déjà traitées, 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 au traitement de la vidéo par YouTube.
processingDetails.processingFailureReason	string Motif pour lequel YouTube n'a pas pu traiter la vidéo. Cette propriété n'aura une valeur que si celle de la propriété processingStatus est failed. Les valeurs valides pour cette propriété sont les suivantes : other : un autre élément de traitement a échoué. streamingFailed : impossible d'envoyer la vidéo aux streamers. transcodeFailed : échec du transcodage du contenu. uploadFailed : échec de l'envoi du fichier
processingDetails.fileDetailsAvailability	string Cette valeur indique si les détails du fichier sont disponibles pour la vidéo mise en ligne. Vous pouvez récupérer les détails d'un fichier 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 qui expliquent les problèmes de traitement des vidéos ou des erreurs qui entravent les problèmes de traitement des vidéos. 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 afin que les autres utilisateurs la trouvent 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 retouche 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 vignettes ont été générées pour la vidéo.
suggestions	object L'objet suggestions encapsule les suggestions qui identifient les possibilité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 n'est renvoyé que si la propriété processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability a la valeur available.
suggestions.processingErrors[]	list Liste d'erreurs qui empêcheront YouTube de traiter 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 (une archive ZIP, par exemple). audioFile : fichier ne contenant que du son (par exemple, un fichier MP3) docFile : document ou fichier texte (par exemple, document MS Word). imageFile : fichier image (par exemple, une image JPEG). notAVideoFile : autre fichier autre qu'une vidéo. projectFile : fichier de projet de film (par exemple, projet Microsoft Windows Movie Maker).
suggestions.processingWarnings[]	list Liste des raisons pour lesquelles YouTube peut avoir des difficultés à transcoder la vidéo mise en ligne ou générer des erreurs de transcodage. Ces avertissements sont générés avant que YouTube ne traite réellement le fichier vidéo mis en ligne. De plus, ils identifient des problèmes qui n'indiquent pas nécessairement que le traitement de la vidéo échouera, mais qui pourraient tout de même être à l'origine de problèmes de synchronisation, d'artefacts vidéo ou d'absence de piste audio. Les valeurs acceptées pour cette propriété sont les suivantes : hasEditlist : les listes de modifications ne sont pas acceptées pour l'instant. inconsistentResolution : résolutions de conteneur et de flux en conflit. problematicAudioCodec : codec audio connu pour causer des problèmes a été utilisé. problematicVideoCodec : 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 susceptibles d'améliorer la capacité de YouTube à traiter la vidéo. Les valeurs valides pour cette propriété sont les suivantes : nonStreamableMov : le fichier MP4 ne peut pas être diffusé 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 pouvant être ajoutés aux métadonnées de la vidéo pour augmenter la probabilité que les utilisateurs la trouvent lorsqu'ils effectuent une recherche ou naviguent sur 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 adaptées à la catégorie que l'utilisateur ayant mis en ligne la vidéo associe à celle-ci. Par défaut, les suggestions de tags sont pertinentes pour toutes les catégories si aucune restriction n'a été définie pour le mot clé.
suggestions.editorSuggestions[]	list Liste d'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 acceptées 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 peuvent être corrigés. videoCrop : les marges détectées autour de la photo peuvent être recadrées. videoStabilize : la vidéo semble tremblante et pourrait être stabilisée.
liveStreamingDetails	object L'objet liveStreamingDetails contient des métadonnées sur une diffusion vidéo en direct. L'objet ne sera présent dans une ressource video que s'il s'agit d'une diffusion en direct à venir, en direct 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 pas disponible avant le début de la diffusion.
liveStreamingDetails.actualEndTime	datetime Heure à laquelle la diffusion s'est terminée. La valeur est spécifiée au format ISO 8601. Cette valeur ne sera disponible qu'une fois la diffusion terminée.
liveStreamingDetails.scheduledStartTime	datetime Heure de début prévue de la diffusion. La valeur est spécifiée au format ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Heure de fin prévue de la diffusion. 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 si le propriétaire de la diffusion n'a pas masqué le nombre de vues de la vidéo. Sachez que YouTube arrête de suivre le nombre de spectateurs simultanés pour une diffusion à la fin de celle-ci. Ainsi, cette propriété n'identifie pas le nombre de spectateurs qui regardent la 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és et hors spams disponibles dans YouTube Analytics. Pour en savoir plus sur les métriques concernant les diffusions en direct, consultez le Centre d'aide YouTube.
liveStreamingDetails.activeLiveChatId	string ID du chat en direct actuellement actif joint à cette vidéo. Ce champ n'est renseigné que si la vidéo est une diffusion en direct qui inclut un chat en direct. Ce champ sera supprimé une fois la diffusion terminée et le chat en direct fermé. Pour les diffusions persistantes, l'ID du chat en direct ne sera plus associé à cette vidéo, mais à la nouvelle vidéo affichée sur la page persistante.
localizations	object L'objet localizations contient des traductions des métadonnées de la vidéo.
localizations.(key)	object Langue du texte localisé associé à la clé-valeur. Cette 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.