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 d'affichage privé. Pour lever cette restriction, chaque projet d'API doit faire l'objet d'un audit afin de vérifier qu'il respecte les 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 est compatible avec 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
liste
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 des métadonnées de la vidéo.
mise à jour
Modifie les métadonnées d'une vidéo. Essayer
supprimer
Supprime une vidéo YouTube. Essayer
rate [taux]
Vous pouvez attribuer une note "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimer une note. Essayer
reportAbuse
Signaler une vidéo pour son contenu abusif Essayer

Représentation des ressources

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
  },
  "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 d'API. La valeur est 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. Notez que cette heure 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, 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 la mise en ligne.
  • 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 les métadonnées de la vidéo.
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é est limitée à 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 miniatures associées à la vidéo. Pour chaque objet de la carte, la clé est le nom de la vignette et 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 et 90 pixels de haut. La miniature par défaut d'une chaîne fait 88 pixels de large et 88 pixels de haut.
  • medium : version de la miniature dans une résolution plus élevée. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large et 180 pixels de haut. Pour une chaîne, elle mesure 240 pixels de large et 240 pixels de haut.
  • high : version haute résolution de l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large et 360 pixels de haut. Pour une chaîne, elle mesure 800 pixels de large et 800 pixels de haut.
  • standard : version de l'image miniature dans une résolution encore supérieure à celle de l'image avec une résolution high. Cette image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 640 pixels de large et 480 pixels de haut.
  • maxres : version de la miniature avec la résolution la plus élevée. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 1 280 pixels de large et 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 tags peuvent contenir des espaces. La valeur de la propriété ne doit pas comporter plus de 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 placée entre guillemets. Ces derniers sont alors comptabilisés dans le nombre maximal de caractères. Ainsi, dans le cadre de la définition du nombre maximal de caractères, le tag Foo-Baz contient sept caractères, tandis que le tag 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. La valeur est "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 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 la langue pour laquelle le texte localisé doit être renvoyé et si 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 de la vidéo localisée.
snippet.localized.description string
Description de la vidéo localisée
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 si des sous-titres sont disponibles pour la vidéo.
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, dans laquelle 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 tous deux des entiers indiquant 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, elle est au format PT#H#M#S. L'élément # précédant 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 un jour, 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 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 du contenu sous licence, c'est-à-dire 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 (ou non) visible. L'objet contiendra la propriété contentDetails.regionRestriction.allowed ou la propriété contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Liste de codes régionaux qui identifient les pays dans lesquels la vidéo est visible. Si cette propriété est présente et que la valeur d'un pays ne figure pas dans sa valeur, la vidéo ne peut pas être diffusé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 que la valeur d'un pays ne figure pas dans la liste, 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 peut être regardée dans tous les pays.
contentDetails.contentRating object
Spécifie les classifications que la vidéo a reçues selon différents systèmes de classification.
contentDetails.contentRating.acbRating string
La classification de la vidéo selon l'ACB (Australian Classification Board) ou l'ACMA (Australian Communications and Media Authority). La classification de l'ACMA permet de classer les programmes télévisés pour enfants.

Les valeurs valides pour cette propriété sont les suivantes :
  • acbC : programmes classés C par l'Australian Communications and Media Authority. Ces programmes sont destinés aux enfants de moins de 14 ans (autres que les tout-petits).
  • acbE – E
  • acbG – V
  • acbM – M
  • acbMa15plus – MA15 ans et plus
  • acbP : programmes classés 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
Note de l'autorité italienne "Autorità per le Garanzie nelle Comunicazioni" (AGCOM) de la vidéo

Les valeurs acceptées pour cette propriété sont les suivantes :
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
La 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 de la vidéo selon le British Board of Film Classification (BBFC).

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 valides 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 – Plus de 10
  • bmukk12 – Plus de 12
  • bmukk14 – 14 ans et plus
  • bmukk16 – 16 ans et plus
  • Entre bmukk6 et 6
  • bmukk8 – Plus de 8 ans
  • bmukkAa – Illimité
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Système de classification de la télévision canadienne – Système de classification de la télévision canadienne (Critique de la Télévision canadienne, organisme de classification de la télévision canadienne, équivalent à la classification de la vidéo, émise par la Commission canadienne des radiotélévisions et télécommunications (CRTC)) pour les émissions diffusées en langue anglaise canadienne. Pour en savoir plus, consultez le site Web du Conseil canadien des normes de 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 – V
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Classification de la vidéo par la Commission canadienne des radiocommunications et des télécommunications (CRTC) pour les émissions canadiennes en français. Pour en savoir plus, consultez le site Web du Conseil canadien des normes de 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 – Plus de 8 ans
  • catvfrG – V
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Classification de la vidéo (Central Board of Film Certification (CBFC - Inde)).

Les valeurs acceptées pour cette propriété sont les suivantes :
  • cbfcA – A
  • cbfcS – D
  • 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 cette propriété sont les suivantes :
  • ccc14 – 14 ans 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 – Inconveniente para menores de 7 ans
  • cccTe – Espectador de tâches
  • cccUnrated
contentDetails.contentRating.cceRating string
Classification de la vidéo fournie par la Comissão de Classificação de Espect 'culos (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 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 du système canadien de classification des vidéos à domicile (CHVRS) de la vidéo.

Les valeurs acceptées pour cette propriété sont les suivantes :
  • chvrs14a-14h
  • chvrs18a-18:00
  • chvrsE – E
  • chvrsG – V
  • chvrsPg – PG
  • chvrsR – D
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Note de la vidéo fournie 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 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 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
La classification de la vidéo attribuée 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 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
Classification 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 – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Raisons pour lesquelles la vidéo a reçu sa classification DJCQT (Brésil).
contentDetails.contentRating.ecbmctRating string
Système de classification en Turquie - Conseil d'évaluation et de classification du ministère de la Culture et du Tourisme

Les valeurs valides pour cet établissement sont les suivantes :
  • ecbmct13a-13h
  • ecbmct13plus – 13 ans et plus
  • ecbmct15a-15h
  • ecbmct15plus – 15 ans et plus
  • ecbmct18plus – 18 ans et plus
  • ecbmct7a-7h
  • ecbmct7plus – Plus de 7 ans
  • ecbmctG – V
  • ecbmctUnrated
  • ecbmct6a-6h
  • Entre ecbmct6plus et 6
  • ecbmct10a-10 h
  • ecbmct10plus – Plus de 10
  • 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 – Enseignement primaire et secondaire
  • eefilmK16 – Enseignement primaire et secondaire
  • eefilmK6 – Enseignement primaire et secondaire
  • 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
Note Eirin (映倫) de la vidéo Eirin est le système de classification japonais.

Les valeurs acceptées pour cet établissement 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 l'Autorité malaisienne de censure des films.

Les valeurs acceptées pour cette propriété sont les suivantes :
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa-18 PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18 Go
  • 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.

La vidéo est classée sous la catégorie "Centre national du cinéma et de l'image animée" (ministère français de la Culture).

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
La 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 valides 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 de la vidéo : Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Espagne).

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
La classification de la vidéo selon l'IFCO (Irish Film Classification Office) Consultez le site Web d'IFCO pour en savoir plus.

Les valeurs valides pour cette propriété sont les suivantes :
  • ifco12 – 12
  • ifco12a-12:00
  • ifco15 – 15
  • ifco15a-15h
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – V
  • 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
Notation de l'INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentine) de 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 classification de la vidéo selon le Korea Media Rating Board (영상물등로원회) 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 indonésien 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 note a été supprimée de la nouvelle structure de classification introduite en 2013.
  • mccaa15 – 15
  • mccaa16 – 16 : cette note 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 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 établie par la Media Development Authority (MDA) de Singapour et plus particulièrement 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 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 fournie par l'Institut national audiovisuel de Kansallinen Instituutti en Finlande.

Les valeurs valides pour cet établissement sont les suivantes :
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – D
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Note de la vidéo fournie 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
Avis du Ministerio de Cultura (Colombie) associé à la vidéo

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 (parce du ministère taïwanais de la Culture).

Les valeurs valides pour cette propriété sont les suivantes :
  • moctwG – V
  • moctwP – P
  • moctwPg – PG
  • moctwR – D
  • moctwR12 – Interdit aux moins de 12 ans
  • moctwR15 – Interdit aux moins de 15 ans
  • 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 – Interdit aux moins de 17 ans
  • 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 extraits de films.

Les valeurs acceptées pour cette propriété sont les suivantes :
  • mpaatGb – GB (bande verte – Approuvée pour tous les publics)
  • mpaatRb – RB (bande rouge – Adapté à un public de 17 ans et plus)
contentDetails.contentRating.mtrcbRating string
Classification de la vidéo fournie 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 – Interdit aux moins de 18 ans
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Classification de la vidéo par le Bureau national de classification des Maldives.

Les valeurs valides pour cette propriété sont les suivantes :
  • nbc12plus – Plus de 12
  • nbc15plus – 15 ans 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 fournie par le Bulgare 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 valides 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 fournie par le Nacionãlais Kino centrs (Centre national du film de Lettonie).

Les valeurs acceptées pour cet établissement sont les suivantes :
  • nkclv12plus – Plus de 12
  • nkclv18plus – 18 ans et plus
  • nkclv7plus – Plus de 7 ans
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Classification de la vidéo (Office of Film and Literature Classification (OFLC, Nouvelle-Zélande)).

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 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 – o
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Classification de la vidéo auprès de la Direction générale de la radio, de la télévision et de la cinématographie (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
Classification de la vidéo par l'Irlandais Raidió Teilifís Éireann.

Les valeurs acceptées pour cette propriété sont les suivantes :
  • rteCh – CH
  • rteGa – DG
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Classification de la vidéo selon la classification du MKRF (National Film Registry of Russie) (MKRF).

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

Les valeurs valides 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 valides pour cet établissement sont les suivantes :
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Note de la vidéo fournie par les 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 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. Seul l'utilisateur qui a mis en ligne la vidéo peut voir cette propriété.
status object
L'objet status contient des informations sur l'état de la mise en ligne, du traitement et de la 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 la mise en ligne d'une vidéo a échoué. 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 valides 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 le paramètre 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 planifie 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 dans le passé 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, et 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. Elle indique également que la 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 découvrir 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 la propriété n'est renvoyée que si le propriétaire du canal 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 la 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é ne pas aimer 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 les informations dont vous avez besoin pour lire la vidéo dans un lecteur intégré.
player.embedHtml string
Une balise <iframe> qui intègre un lecteur qui lit la vidéo.
  • Si la requête API pour récupérer 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 utilisé par défaut par 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 si 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 si le format de la vidéo est connu.
topicDetails object
L'objet topicDetails encapsule les informations sur les sujets 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é, 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 en rapport avec la vidéo.

Cette propriété est obsolète depuis le 10 novembre 2016. Ils seront pris en charge jusqu'au 10 novembre 2017.

Important:En raison de l'abandon de Freebase et de l'API Freebase, les ID de thèmes ont commencé à fonctionner différemment depuis le 27 février 2017. À cette date, YouTube a commencé à renvoyer un petit ensemble d'ID de thèmes sélectionnés.

topicDetails.topicCategories[] list
Liste d'URL Wikipédia qui fournissent une description détaillée 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, consultez l'annonce de l'abandon.

Description textuelle 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 présenté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 encapsule les informations sur le fichier vidéo importé sur YouTube, y compris la résolution du fichier, la durée, les codecs audio et vidéo, le débit du 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 présent si un fichier vidéo ou un autre type de fichier a été importé.
fileDetails.fileSize unsigned long
Taille du fichier importé, en octets. Ce champ est présent si un fichier vidéo ou un autre type de fichier a été importé.
fileDetails.fileType string
Type du fichier importé, tel que détecté par le moteur de traitement des vidéos 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, par exemple une archive .zip.
  • audio : le fichier est un type de fichier audio connu, comme les fichiers .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 du 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 : type de fichier vidéo connu, comme les fichiers .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 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, exprimée en frames par seconde.
fileDetails.videoStreams[].aspectRatio double
Format d'affichage du contenu vidéo.
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é dont YouTube doit effectuer la rotation du 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 faire l'objet d'une rotation 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 : il n'est pas nécessaire de faire pivoter la vidéo.
  • other : la rotation de la vidéo doit être effectuée de manière complexe.
  • upsideDown : la vidéo doit être retournée vers le bas.
fileDetails.videoStreams[].vendor string
Valeur identifiant 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 mis en ligne. 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 identifiant 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 importé, exprimé 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. 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. Cette partie indique également si différents types de données ou de contenu, 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 du traitement de la vidéo. Cette valeur indique si YouTube a pu traiter la vidéo ou si la vidéo 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. Consultez "ProcessingProgress".
  • succeeded : la vidéo a bien été traitée.
  • terminated : les informations relatives au 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. 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 que YouTube a déjà traitées. Vous pouvez estimer le pourcentage de la vidéo déjà traité par YouTube en calculant:
100 * parts_processed / parts_total

Notez que, comme l'estimation du nombre de parties peut augmenter sans augmentation correspondante du nombre de parties déjà traitées, il est possible que la progression calculée diminue régulièrement pendant le traitement d'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 une 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 élément de traitement a échoué.
  • streamingFailed : la vidéo n'a pas pu être envoyée aux streamers.
  • transcodeFailed : échec du transcodage du contenu.
  • uploadFailed : échec de l'envoi du fichier.
processingDetails.fileDetailsAvailability string
Cette valeur indique si des informations sur le fichier sont disponibles pour la vidéo mise en ligne. Pour récupérer les détails d'un fichier vidéo, demandez la partie fileDetails de 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 de la vidéo ou des erreurs qui provoquent des problèmes de traitement de la vidéo. Vous pouvez récupérer ces suggestions en demandant la partie suggestions de votre requête videos.list().
processingDetails.tagSuggestionsAvailability string
Cette valeur indique si des suggestions de mots clés (de tags) sont disponibles pour la vidéo. Vous pouvez ajouter des tags aux métadonnées d'une vidéo pour que les autres utilisateurs la trouvent plus facilement. Vous pouvez récupérer ces suggestions en demandant la partie suggestions de votre requête videos.list().
processingDetails.editorSuggestionsAvailability string
Cette valeur indique si des suggestions de modification de la vidéo, susceptibles d'améliorer la qualité ou la lecture, sont disponibles. Vous pouvez récupérer ces suggestions en demandant la partie suggestions de 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 des possibilités d'amélioration de la qualité 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êchent 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 (par exemple, une archive ZIP).
  • audioFile : le fichier ne contient que de l'audio (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 du film (par exemple, projet Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Liste des raisons pour lesquelles YouTube peut avoir des difficultés à convertir la vidéo importée ou à générer une erreur 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 les problèmes qui n'indiquent pas nécessairement que le traitement de la vidéo va échouer, mais qui peuvent tout de même entraîner des problèmes de synchronisation, d'artefacts vidéo ou de piste audio manquante.

Les valeurs acceptées pour cette propriété sont les suivantes :
  • hasEditlist : les listes de modifications ne sont actuellement pas compatibles.
  • inconsistentResolution : résolutions du conteneur et du flux en conflit.
  • problematicAudioCodec : un 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 lu en streaming, ce qui ralentit le traitement.
  • sendBestQualityVideo : il existe probablement une version de la vidéo de meilleure qualité.
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 naviguent sur YouTube.
suggestions.tagSuggestions[].tag string
Tag de mot clé suggéré 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 en fonction de la catégorie que l'utilisateur ayant mis en ligne la vidéo 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 peut ê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 (mates) détectées autour de l'image risquent d'ê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 ne sera présent dans une ressource video que s'il s'agit d'une vidéo à 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 disponible qu'au début de la diffusion.
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'une fois la diffusion terminée.
liveStreamingDetails.scheduledStartTime datetime
Heure à laquelle la diffusion doit commencer. 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 que 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 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 être différent du nombre de spectateurs simultanés traités et supprimés des spams disponibles dans YouTube Analytics. Pour en savoir plus sur les métriques liées aux 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 s'il s'agit d'une diffusion en direct avec un chat en direct. Une fois la diffusion terminée, ce champ sera supprimé et le chat en direct fermé. Pour les diffusions permanentes, 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 la traduction des métadonnées de la vidéo.
localizations.(key) object
Langue du texte localisé associé à la clé-valeur. La valeur est une chaîne contenant un code de langue BCP-47.
localizations.(key).title string
Titre de la vidéo localisée.
localizations.(key).description string
Description de la vidéo localisée