Cette page a été traduite par l'API Cloud Translation.

Videos

Toutes les vidéos mises en ligne via le point de terminaison videos.insert à partir de projets 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 pour vérifier sa conformité avec 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 prend en charge les méthodes suivantes pour les ressources videos :

getRating: Récupère les notes attribuées par l'utilisateur autorisé à une liste de vidéos spécifiées. Essayer
liste: Renvoie la liste des vidéos correspondant aux paramètres de requête de l'API. Essayer
insérer: met en ligne une vidéo sur YouTube et en définit éventuellement ses métadonnées.
update: Modifie les métadonnées d'une vidéo. Essayer
supprimer: Supprime une vidéo YouTube. Essayer
rate [taux]: Ajouter une mention "J'aime" ou "Je n'aime pas" à une vidéo ou supprimer une mention Essayer
reportAbuse: Signalez une vidéo dont le contenu est abusif. Essayer

Représentation de la ressource

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

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

etag etag
Etag de cette ressource.

id string
ID utilisé par YouTube pour identifier de manière unique la vidéo.

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 cette heure peut être différente de celle à laquelle la vidéo a été mise en ligne. Par exemple, si une vidéo est mise en ligne en tant que vidéo privée, puis rendue publique ultérieurement, cette propriété indiquera l'heure à laquelle la vidéo a été rendue publique.

Voici quelques cas particuliers:

Si une vidéo est mise en ligne en tant que vidéo privée et que les métadonnées de la vidéo 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 mise en ligne de la vidéo. Dans ce cas, toute personne qui connaît 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 manière 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 images miniatures associées à la vidéo. Pour chaque objet de la carte, la clé correspond au nom de l'image miniature, et la valeur à un objet contenant d'autres informations sur la miniature.

snippet.thumbnails.(key)

object
Les valeurs de clé valides sont les suivantes:

default : image miniature par défaut. La vignette par défaut d'une vidéo (ou d'une ressource qui y fait référence, comme un élément de playlist ou un résultat de recherche) mesure 120 x 90 pixels. La miniature par défaut d'une chaîne mesure 88 pixels de large et 88 pixels de haut.
medium : version de la vignette en haute résolution. 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, cette image mesure 240 x 240 pixels.
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, cette image mesure 800 x 800 pixels.
standard : version de l'image miniature encore plus haute que celle de l'image avec une résolution high. Cette image est disponible pour certaines vidéos et autres ressources qui y font référence, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 640 x 480 pixels.
maxres : version avec la plus haute résolution de la vignette. Cette taille d'image est disponible pour certaines vidéos et autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 1 280 x 720 pixels.

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 la vidéo appartient.

snippet.tags[]

list
Liste des balises de mots clés associées à la vidéo. Les tags peuvent contenir des espaces. La valeur de la propriété ne doit pas comporter plus de 500 caractères. Notez les 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 prises en compte dans la limite.
Si une balise contient un espace, le serveur de l'API gère la valeur de la balise comme si elle était placée entre guillemets, et les guillemets sont pris en compte dans la limite de caractères. Par conséquent, pour les limites de caractères, la balise Foo-Baz contient sept caractères, mais la balise Foo Baz en contient neuf.

snippet.categoryId string
La catégorie de vidéo YouTube associée à la vidéo. Vous devez définir une valeur pour cette propriété si vous appelez la méthode videos.update et que vous mettez à jour la partie snippet d'une ressource video.

snippet.liveBroadcastContent

string
Indique si la vidéo est une diffusion en direct à venir/active. La valeur définie est "none" si la vidéo n'est pas une diffusion en direct à venir/active.

Les valeurs valides pour cette propriété sont les suivantes :

live
none
upcoming

snippet.defaultLanguage string
Langue du texte dans les propriétés snippet.title et snippet.description de la ressource video.

snippet.localized

object
L'objet snippet.localized contient un titre et une description localisés pour la vidéo, ou le titre dans la langue par défaut 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 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, modifier ou supprimer des titres localisés.

snippet.localized.title string
Titre de la vidéo localisé.

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 l'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 au format ISO 8601. Par exemple, pour une vidéo d'une durée d'au moins une minute et de moins d'une heure, la durée est au format PT#M#S, dans lequel les lettres PT indiquent que la valeur spécifie une période de temps, et les lettres M et S font référence à la durée en minutes et en secondes, respectivement. Les caractères # qui précèdent les lettres M et S sont tous deux des entiers qui spécifient le nombre de minutes (ou de secondes) de la vidéo. Par exemple, une valeur de 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, dans lequel la lettre # précédant la lettre H indique la durée de la vidéo en heures. Tous les autres détails sont identiques à ceux décrits ci-dessus. Si la vidéo dure au moins un jour, les lettres P et T sont séparées, et le format de la valeur est P#DT#H#M#S. Pour en savoir plus, consultez 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.

Valeurs valides pour cette propriété :

hd
sd

contentDetails.caption

string
Indique si des sous-titres sont disponibles pour la vidéo.

Les valeurs acceptées 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 n'est pas) disponible. L'objet contiendra la propriété contentDetails.regionRestriction.allowed ou la propriété contentDetails.regionRestriction.blocked.

contentDetails.regionRestriction.allowed[] list
Liste des codes de région identifiant les pays dans lesquels la vidéo est visible. Si cette propriété est présente et qu'un pays n'est pas listé dans sa valeur, la vidéo ne peut pas être diffusée dans ce pays. Si cette propriété est présente et contient une liste vide, la vidéo est bloquée dans tous les pays.

contentDetails.regionRestriction.blocked[] list
Liste des codes des régions qui identifient les pays dans lesquels la vidéo est bloquée. Si cette propriété est présente et qu'un pays n'est pas listé dans sa valeur, la vidéo peut être visionnée dans ce pays. Si cette propriété est présente et contient une liste vide, la vidéo peut être visionnée dans tous les pays.

contentDetails.contentRating object
Indique les classifications attribuées à la vidéo selon différents systèmes de classification.

contentDetails.contentRating.acbRating

string
Classification attribuée par l'Australian Classification Board (ACB) ou l'Australian Communications and Media Authority (ACMA) à la vidéo. Les classifications de l'ACMA sont utilisées pour classer les programmes télévisés pour enfants.

Les valeurs acceptées pour cette propriété sont les suivantes :

acbC : programmes classés C par l'Australian Communications and Media Authority. Ces programmes s'adressent aux enfants (autres que les tout-petits) âgés de moins de 14 ans.
acbE - E
acbG - G
acbM - M
acbMa15plus – MA15+
acbP : programmes classés P par l'Australian Communications and Media Authority. Ces programmes sont destinés aux enfants d'âge préscolaire.
acbPg : PG
acbR18plus : R18+
acbUnrated

contentDetails.contentRating.agcomRating

string
Classification de la vidéo par l'organisme italien Autorità per le Garanzie Nelle Comunicazioni (AGCOM).

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.

Valeurs valides pour cette propriété :

anatelA : A
anatelF - F
anatelI : I
anatelI10 : I-10
anatelI12 – I-12
anatelI7 : I-7
anatelR – D
anatelUnrated

contentDetails.contentRating.bbfcRating

string
Classification de la vidéo par le British Board of Film Classification (BBFC).

Les valeurs valides pour cette propriété sont les suivantes :

bbfc12 - 12
bbfc12a - 12A
bbfc15 - 15
bbfc18 - 18
bbfcPg – PG
bbfcR18 – R18
bbfcU - U
bbfcUnrated

contentDetails.contentRating.bfvcRating

string
Classification de la vidéo par le Conseil de censure des films et des vidéos de Thaïlande.

Les valeurs valides pour cette propriété sont les suivantes :

bfvc13 - 13
bfvc15 - 15
bfvc18 - 18
bfvc20 - 20
bfvcB – B
bfvcE - E
bfvcG – G
bfvcUnrated

contentDetails.contentRating.bmukkRating

string
Classification de la vidéo par le Conseil autrichien des médias (Bundesministerium für Unterricht, Kunst und Kultur).

Les valeurs acceptées pour cette propriété sont les suivantes :

bmukk10 – 10 ou plus
bmukk12 – 12 ans et plus
bmukk14 – 14 ans et plus
bmukk16 : 16 ans et plus
bmukk6 : 6 ans et plus
bmukk8 – 8 ans et plus
bmukkAa : pas de restriction
bmukkUnrated

contentDetails.contentRating.catvRating

string
Système de classification pour la télévision canadienne - Système de classification de la télévision canadienne Classification de la vidéo par la Commission canadienne de la télévision et des télécommunications (CRTC) pour les diffusions en anglais canadien Pour en savoir plus, consultez le site Web du Conseil canadien des normes de diffusion.

Les valeurs valides pour cette propriété sont les suivantes :

catv14plus : 14 ans et plus
catv18plus : 18 ans et plus
catvC - C
catvC8 – C8
catvG - G
catvPg : PG
catvUnrated

contentDetails.contentRating.catvfrRating

string
Classification de la vidéo par le Conseil de la radiodiffusion et des télécommunications canadiennes (CRTC) pour les diffusions en français au Canada. Pour en savoir plus, consultez le site Web du Conseil canadien des normes de diffusion.

Les valeurs valides pour cette propriété sont les suivantes :

catvfr13plus : 13 ans et plus
catvfr16plus – 16 ans et plus
catvfr18plus – 18 ans et plus
catvfr8plus : 8 et plus
catvfrG - G
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
Classification de la vidéo par le Central Board of Film Certification (CBFC, Inde).

Les valeurs valides pour cette propriété sont les suivantes :

cbfcA : A
cbfcS - S
cbfcU - U
cbfcUnrated
cbfcUA – U/A
cbfcUA7plus – U/A
cbfcUA13plus – U/A
cbfcUA16plus – U/A

contentDetails.contentRating.cccRating

string
Classification du Conseil de Calificación Cinematográfica (Chili) pour la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

ccc14 – 14 ans et plus
ccc18 : 18 ans et plus
ccc18s – 18+ - contenido pornográfico
ccc18v – 18+ - contenido excesivamente violento
ccc6 – 6+ - Inconveniente para menores de 7 años
cccTe – Todo espectador
cccUnrated

contentDetails.contentRating.cceRating

string
Classification de la vidéo par la Comissão de Classificação de Espect´culos au Portugal.

Les valeurs valides pour cette propriété sont les suivantes :

Entre cceM12 et 12 ans
cceM14 - 14
cceM16 - 16
Entre cceM18 et 18 ans
Entre cceM4 et 4 ans
Entre cceM6 et 6 ans
cceUnrated

contentDetails.contentRating.chfilmRating

string
Classification de la vidéo en Suisse.

Valeurs valides pour cette propriété :

chfilm0 – 0
Entre chfilm12 et 12 ans
Entre chfilm16 et 16 ans
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.

Valeurs valides pour cette propriété :

chvrs14a - 14A
chvrs18a-18:00
chvrsE - E
chvrsG - G
chvrsPg : PG
chvrsR : R
chvrsUnrated

contentDetails.contentRating.cicfRating

string
Classification de la vidéo par la Commission de contrôle des films (Belgique).

Les valeurs acceptées 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.

Valeurs valides pour cette propriété :

cna12 - 12
cna15 - 15
cna18 - 18
cna18plus : 18 ans et plus
cnaAp : PA
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 :

cnc10 - 10
cnc12 - 12
cnc16 - 16
cnc18 - 18
cncE - E
cncT - T
cncUnrated

contentDetails.contentRating.csaRating

string
Classification de la vidéo par le Conseil supérieur de l'audiovisuel, qui évalue le contenu diffusé.

Les valeurs valides pour cette propriété sont les suivantes :

csa10 - 10
csa12 - 12
csa16 - 16
Entre csa18 et 18 ans
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) au Luxembourg.

Valeurs valides pour cette propriété :

cscf12 - 12
cscf16 - 16
cscf18 - 18
Entre cscf6 et 6 ans
cscf9 - 9
cscfA – A
cscfAl : AL
cscfUnrated

contentDetails.contentRating.czfilmRating

string
Classification de la vidéo en République tchèque.

Valeurs valides pour cette propriété :

czfilm12 - 12
czfilm14 - 14
czfilm18 - 18
czfilmU - U
czfilmUnrated

contentDetails.contentRating.djctqRating

string
Classification du Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT, Brésil) pour la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

djctq10 - 10
Entre djctq12 et 12 ans
djctq14 - 14
djctq16 - 16
djctq18 - 18
djctqL – L
djctqUnrated

contentDetails.contentRating.djctqRatingReasons[] list
Raisons pour lesquelles la vidéo a été classée DJCQT (Brésil).

contentDetails.contentRating.ecbmctRating

string
Système de classification en Turquie – Commission d'évaluation et de classification du ministère de la Culture et du Tourisme

Valeurs valides pour cette propriété :

ecbmct13a - 13A
ecbmct13plus : 13 ans et plus
ecbmct15a - 15A
ecbmct15plus : 15 ans et plus
ecbmct18plus : 18 ans et plus
ecbmct7a - 7A
ecbmct7plus : 7 et plus
ecbmctG - G
ecbmctUnrated
ecbmct6a - 6A
ecbmct6plus – 6 ans et plus
ecbmct10a - 10A
ecbmct10plus – 10 ou plus
ecbmct16plus – 16 ans et plus

contentDetails.contentRating.eefilmRating

string
Classification de la vidéo en Estonie.

Valeurs valides pour cette propriété :

eefilmK12 – enseignement primaire et secondaire
eefilmK14 – enseignement primaire et secondaire
eefilmK16 – enseignement primaire et collège
eefilmK6 : K-6
eefilmL – L
eefilmMs12 : MS-12
eefilmMs6 : MS-6
eefilmPere – Pere
eefilmUnrated

contentDetails.contentRating.egfilmRating

string
Classification de la vidéo en Égypte.

Valeurs valides pour cette propriété :

egfilm18 - 18
egfilmBn – BN
egfilmGn – GN
egfilmUnrated

contentDetails.contentRating.eirinRating

string
Évaluation Eirin (映倫) de la vidéo Eirin est le système de classification japonais.

Les valeurs valides pour cette propriété sont les suivantes :

eirinG - G
eirinPg12 – PG-12
eirinR15plus – R15 et plus
eirinR18plus : R18+
eirinUnrated

contentDetails.contentRating.fcbmRating

string
Classification de la vidéo par le Film Censorship Board de Malaisie.

Les valeurs acceptées pour cette propriété sont les suivantes :

fcbm13 - 13
fcbm16 - 16
Entre fcbm18 et 18 ans
fcbm18pa – 18PA
fcbm18pl – 18PL
fcbm18sg – 18SG
fcbm18sx – 18SX
fcbmP12 – P12
fcbmP13 : P13
fcbmPg13 : PG-13
fcbmU - U
fcbmUnrated

contentDetails.contentRating.fcoRating

string
Classification de la vidéo par l'Office for Film, Newspaper and Article Administration de Hong Kong.

Valeurs valides pour cette propriété :

fcoI : I
fcoIi – II
fcoIia : IIA
fcoIib : IIB
fcoIii – III
fcoUnrated

contentDetails.contentRating.fmocRating

string
Cette propriété a été abandonnée le 2 novembre 2015. Utilisez plutôt la propriété contentDetails.contentRating.cncRating.

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

Les valeurs valides pour cette propriété sont les suivantes :

fmoc10 - 10
fmoc12 - 12
fmoc16 - 16
fmoc18 - 18
fmocE - E
fmocU – U
fmocUnrated

contentDetails.contentRating.fpbRating

string
Classification de la vidéo par le Film and Publication Board d'Afrique du Sud.

Les valeurs valides pour cette propriété sont les suivantes :

fpb10 - 10
fpb1012Pg – 10-12PG
fpb13 - 13
fpb16 - 16
fpb18 - 18
fpb79Pg – 7-9PG
fpbA – A
fpbPg : PG
fpbUnrated
fpbX18 – X18
fpbXx : XX

contentDetails.contentRating.fpbRatingReasons[] list
Motifs expliquant pourquoi la vidéo a reçu la classification FPB (Afrique du Sud).

contentDetails.contentRating.fskRating

string
Classification Freiwillige Selbstkontrolle der Filmwirtschaft (FSK, Allemagne) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

fsk0 – FSK 0
fsk12 : FSK 12
fsk16 – FSK 16
fsk18 – FSK 18
fsk6 – FSK 6
fskUnrated

contentDetails.contentRating.grfilmRating

string
Classification de la vidéo en Grèce.

Les valeurs acceptées pour cet établissement sont les suivantes :

grfilmE - E
grfilmK - K
grfilmK12 : enseignement primaire et secondaire
grfilmK13 : K-13
grfilmK15 : K-15
grfilmK17 : K-17
grfilmK18 – K-18
grfilmUnrated

contentDetails.contentRating.icaaRating

string
Classification de la vidéo par l'Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Espagne).

Les valeurs valides pour cet établissement sont les suivantes :

icaa12 - 12
icaa13 - 13
icaa16 - 16
icaa18 - 18
icaa7 - 7
icaaApta : APTA
icaaUnrated
icaaX – X

contentDetails.contentRating.ifcoRating

string
Classification de la vidéo par l'Irish Film Classification Office (IFCO, Irlande). Pour en savoir plus, consultez le site Web IFCO.

Les valeurs acceptées pour cette propriété sont les suivantes :

ifco12 - 12
ifco12a - 12A
Entre ifco15 et 15 ans
ifco15a - 15A
ifco16 - 16
ifco18 - 18
ifcoG - G
ifcoPg : PG
ifcoUnrated

contentDetails.contentRating.ilfilmRating

string
Classification de la vidéo en Israël.

Les valeurs valides pour cette propriété sont les suivantes :

ilfilm12 - 12
ilfilm16 - 16
Entre ilfilm18 et 18 ans
ilfilmAa : AA
ilfilmUnrated

contentDetails.contentRating.incaaRating

string
Classification INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentina) de la vidéo.

Les valeurs valides 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 años)
incaaSam18 – 18 (Solo apta para mayores de 18 años)
incaaUnrated

contentDetails.contentRating.kfcbRating

string
Classification de la vidéo par le Kenya Film Classification Board.

Valeurs valides pour cette propriété :

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 :

kijkwijzer12 - 12
kijkwijzer14 - 14
Entre kijkwijzer16 et 16 ans
kijkwijzer18-18 ans
Entre kijkwijzer6 et 6 ans
kijkwijzer9 - 9
kijkwijzerAl – Alabama
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

string
Classification de la vidéo par le Korea Media Rating Board (영상물등급위원회). Le KMRB classe les vidéos en Corée du Sud.

Les valeurs valides pour cette propriété sont les suivantes :

kmrb12plus – 12 이상 に람수
kmrb15plus – 15세 이상 관람가
kmrbAll – 전체관람가
kmrbR – 청소년 は람불수
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

string
Classification de la vidéo par le film indonésien Lembaga Sensor.

Les valeurs acceptées pour cette propriété sont les suivantes :

lsf13 - 13
lsf17-17 ans
Entre lsf21 et 21 ans
lsfA : A
lsfBo : BO
lsfD - D
lsfR : R
lsfSu - SU
lsfUnrated

contentDetails.contentRating.mccaaRating

string
Classification de la vidéo par la Malta's Film Age-Classification Board.

Valeurs valides pour cette propriété :

mccaa12 - 12
mccaa12a-12:00
mccaa14 – 14 : cette note a été supprimée de la nouvelle structure de classification introduite en 2013.
Entre mccaa15 et 15 ans
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 Conseil des médias pour les enfants et les jeunes du Danish Film Institute (Det Danske Filminstitut).

Valeurs valides pour cette propriété :

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 :

mcst0 - 0
mcst16plus – 16 ans et plus
mcstC13 : C13
mcstC16 - C16
mcstC18 : C18
mcstP - P
mcstUnrated
mcstT13 – T13
mcstT16 : T16
mcstT18 - T18
mcstK - K

contentDetails.contentRating.mdaRating

string
Classification de la vidéo par l'Autorité de développement des médias (MDA) de Singapour et, plus précisément, par son Conseil de censure des films (BFC).

Valeurs valides pour cette propriété :

mdaG - G
mdaM18 - M18
mdaNc16 – NC16
mdaPg – PG
mdaPg13 : PG-13
mdaR21 - R21
mdaUnrated

contentDetails.contentRating.medietilsynetRating

string
Classification de la vidéo par Medietilsynet, l'autorité norvégienne des médias.

Les valeurs valides pour cette propriété sont les suivantes :

medietilsynet11 - 11
medietilsynet12 - 12
medietilsynet15 - 15
medietilsynet18 - 18
medietilsynet6 - 6
Entre medietilsynet7 et 7 ans
Entre medietilsynet9 et 9 ans
medietilsynetA : A
medietilsynetUnrated

contentDetails.contentRating.mekuRating

string
Classification de la vidéo par le Kansallinen Audiovisuaalinen Instituutti (Institut national de l'audiovisuel) de Finlande.

Valeurs valides pour cette propriété :

Entre meku12 et 12 ans
meku16 - 16
meku18 - 18
meku7 - 7
mekuS - S
mekuUnrated

contentDetails.contentRating.mibacRating

string
Classification de la vidéo par le Ministero dei Beni e delle Attività Culturali e del Turismo (Italie).

Les valeurs valides pour cette propriété sont les suivantes :

mibacT
mibacUnrated
mibacVap
mibacVm6
mibacVm12
mibacVm14
mibacVm18

contentDetails.contentRating.mocRating

string
Classification du Ministère de la Culture (Colombie) pour la vidéo.

Valeurs valides pour cette propriété :

moc12 - 12
Entre moc15 et 15 ans
moc18 - 18
moc7 - 7
mocBanned : interdit
mocE - E
mocT – T
mocUnrated
mocX – X

contentDetails.contentRating.moctwRating

string
Classification de la vidéo par le ministère de la Culture de Taïwan (文化部).

Les valeurs valides pour cette propriété sont les suivantes :

moctwG - G
moctwP - P
moctwPg : PG
moctwR : R
moctwR12 : R-12
moctwR15 : R-15
moctwUnrated

contentDetails.contentRating.mpaaRating

string
Classification MPAA (Motion Picture Association of America) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

mpaaG - G
mpaaNc17 – Interdit aux moins de 17 ans
mpaaPg : PG
mpaaPg13 : PG-13
mpaaR : R
mpaaUnrated

contentDetails.contentRating.mpaatRating

string
Classification de la Motion Picture Association of America pour les bandes-annonces et les extraits de films.

Les valeurs valides pour cette propriété sont les suivantes :

mpaatGb : GB (bande verte, approuvé pour tous les publics)
mpaatRb : RB (Red Band, tranche d'âge recommandée : 17 ans et plus)

contentDetails.contentRating.mtrcbRating

string
Classification de la vidéo par le Movie and Television Review and Classification Board (Philippines).

Valeurs valides pour cette propriété :

mtrcbG – G
mtrcbPg : PG
mtrcbR13 : R-13
mtrcbR16 : R-16
mtrcbR18 – R-18
mtrcbUnrated
mtrcbX – X

contentDetails.contentRating.nbcRating

string
Classification de la vidéo par le Bureau national de classification des Maldives.

Les valeurs valides pour cette propriété sont les suivantes :

nbc12plus : 12 ans et plus
nbc15plus : 15 ans et plus
nbc18plus : 18 ans et plus
nbc18plusr : 18 ans et plus
nbcG - G
nbcPg : PG
nbcPu – PU
nbcUnrated

contentDetails.contentRating.nfrcRating

string
Classification de la vidéo par le Bulgarie National Film Center.

Les valeurs acceptées pour cet établissement sont les suivantes :

nfrcA : A
nfrcB – B
nfrcC - C
nfrcD - D
nfrcUnrated
nfrcX – X

contentDetails.contentRating.nfvcbRating

string
Classification de la vidéo par le National Film and Video Censors Board du Nigeria.

Les valeurs valides pour cet établissement sont les suivantes :

nfvcb12 - 12
nfvcb12a - 12A
Entre nfvcb15 et 15 ans
nfvcb18 - 18
nfvcbG – G
nfvcbPg : PG
nfvcbRe : RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
Classification de la vidéo par le Nacionãlais Kino centrs (Centre national du cinéma de Lettonie).

Valeurs valides pour cette propriété :

nkclv12plus : 12 ans et plus
nkclv18plus – 18 ans et plus
nkclv7plus : 7 et plus
nkclvU - U
nkclvUnrated

contentDetails.contentRating.oflcRating

string
Classification de la vidéo par l'Office of Film and Literature Classification (OFLC, Nouvelle-Zélande).

Valeurs valides pour cette propriété :

oflcG - G
oflcM – M
oflcPg : PG
oflcR13 - R13
oflcR15 - R15
oflcR16 : R16
oflcR18 – R18
oflcRp13 – RP13
oflcRp16 : RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

string
Note de la vidéo au Pérou.

Les valeurs acceptées pour cet établissement 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 acceptées pour cet établissement sont les suivantes :

resorteviolenciaA – A
resorteviolenciaB – B
resorteviolenciaC - C
resorteviolenciaD - D
resorteviolenciaE - E
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

string
Classification de la vidéo par la Dirección General de Radio, Televisión y Cinematografía (Mexique).

Valeurs valides pour cette propriété :

rtcA – A
rtcAa : AA
rtcB - B
rtcB15 : B15
rtcC – C
rtcD - D
rtcUnrated

contentDetails.contentRating.rteRating

string
Classification de la vidéo par Raidió Teilifís Éireann (Irlande).

Valeurs valides pour cette propriété :

rteCh – CH
rteGa – DG
rteMa – MA
rtePs : PS
rteUnrated

contentDetails.contentRating.russiaRating

string
Classification du film par le National Film Registry of the Russian Federation (MKRF, Russie).

Les valeurs valides pour cette propriété sont les suivantes :

russia0 – 0 et plus
russia12 : 12 ans et plus
russia16 – 16 ans et plus
russia18 : 18 ans et plus
russia6 : 6 ans et plus
russiaUnrated

contentDetails.contentRating.skfilmRating

string
Classification de la vidéo en Slovaquie.

Valeurs valides pour cette propriété :

skfilmG – G
skfilmP2 : P2
skfilmP5 : P5
skfilmP8 : P8
skfilmUnrated

contentDetails.contentRating.smaisRating

string
Classification de la vidéo en Islande.

Valeurs valides pour cette propriété :

smais12 - 12
smais14 - 14
smais16 - 16
smais18 - 18
smais7 - 7
smaisL – L
smaisUnrated

contentDetails.contentRating.smsaRating

string
Classification de la vidéo par Statens medieråd (Conseil national des médias de Suède).

Valeurs valides pour cette propriété :

smsa11 - 11
smsa15 - 15
smsa7 - 7
smsaA – Tous les âges
smsaUnrated

contentDetails.contentRating.tvpgRating

string
Classification TV-PG (surveillance parentale suggérée) de la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

tvpgG : TV-G
tvpgMa : TV-MA
tvpgPg : TV-PG
tvpgUnrated
tvpgY – TV-Y
tvpgY7 – TV-Y7
tvpgY7Fv – TV-Y7-FV
pg14 : TV-14

contentDetails.contentRating.ytRating

string
Classification utilisée par YouTube pour identifier les contenus soumis à une limite d'âge.

Valeurs valides pour cette propriété :

ytAgeRestricted

contentDetails.projection

string
Spécifie le format de projection de la vidéo.

Les valeurs acceptées pour cette propriété sont les suivantes :

360
rectangular

contentDetails.hasCustomThumbnail boolean
Indique si l'utilisateur qui a mis en ligne la vidéo a fourni une image de miniature personnalisée pour celle-ci. Cette propriété n'est visible que par l'utilisateur qui met la vidéo en ligne.

status object
L'objet status contient des informations sur l'état de mise en ligne, de traitement et de confidentialité de la vidéo.

status.uploadStatus

string
État de la vidéo mise en ligne.

Valeurs valides pour cette propriété :

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 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é". La valeur est spécifiée au format ISO 8601. Notez les deux points supplémentaires suivants concernant le comportement de cette propriété:

Si vous définissez la valeur de cette propriété 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 à un moment précis, la vidéo sera publiée immédiatement. Par conséquent, l'effet de la définition de la propriété status.publishAt sur une date et une heure passées est le même que celui de la modification de la valeur 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 à un autre site Web.

status.publicStatsViewable boolean
Cette valeur indique si les statistiques vidéo étendues sur la page de lecture de la vidéo sont visibles par tous les utilisateurs. Par défaut, ces statistiques sont visibles, et des statistiques telles que le nombre de vues et les notes d'une vidéo restent publiques, 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 destinée aux enfants et indique si elle est actuellement définie comme "conçue pour les enfants". Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube.

status.selfDeclaredMadeForKids boolean
Dans une requête videos.insert ou videos.update, cette propriété permet au propriétaire de la chaîne de désigner la vidéo comme étant destinée aux enfants. Dans une requête videos.list, la valeur de la propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête d'API.

status.containsSyntheticMedia

boolean
Dans une requête videos.insert ou videos.update, cette propriété permet au propriétaire de la chaîne d'indiquer qu'une vidéo contient du contenu modifié ou synthétique (A/S) réaliste. Consultez les Règles YouTube concernant le contenu A/S.

Exemples de contenus A/S : les vidéos qui :

Faire dire ou faire à une personne réelle quelque chose qu'elle n'a pas dit ni fait
Modifier les images d'un événement ou d'un lieu réel
Générer une scène d'apparence réaliste alors qu'elle n'a jamais eu lieu

statistics object
L'objet statistics contient des statistiques sur la vidéo.

statistics.viewCount unsigned long
Nombre de fois où la vidéo a été regardée.

statistics.likeCount unsigned long
Nombre d'utilisateurs ayant indiqué avoir aimé la vidéo.

statistics.dislikeCount

unsigned long

Remarque : La propriété statistics.dislikeCount a été rendue privée à partir du 13 décembre 2021. Cela signifie que la propriété n'est incluse dans une réponse d'API que si la requête d'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 qui ont indiqué ne pas aimer la vidéo.

statistics.favoriteCount unsigned long
Remarque:Cette propriété est obsolète. Cette suppression sera effective à compter du 28 août 2015. La valeur de la propriété est désormais toujours définie sur 0.

statistics.commentCount unsigned long
Nombre de commentaires sur la vidéo.

paidProductPlacementDetails object
L'objet paidProductPlacementDetails contient des informations sur le placement de produit rémunéré dans la vidéo.

paidProductPlacementDetails.hasPaidProductPlacement boolean
Définissez ce paramètre sur true si le contenu utilise un placement de produit rémunéré. La valeur par défaut est false.

player object
L'objet player contient les informations que vous pouvez utiliser pour lire la vidéo dans un lecteur intégré.

player.embedHtml

string
Balise <iframe> qui intègre un lecteur qui lit la vidéo.

Si la requête API permettant de récupérer la ressource spécifie une valeur pour les paramètres maxHeight et/ou maxWidth, la taille du lecteur intégré est redimensionnée pour répondre aux exigences maxHeight et/ou maxWidth.
Si le format de la vidéo n'est pas connu, le lecteur intégré est au format 4:3 par défaut.

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 demande a spécifié 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 demande a spécifié 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 thèmes associés à la vidéo.

Important : Consultez les définitions des propriétés topicDetails.relevantTopicIds[] et topicDetails.topicIds[], ainsi que l'historique des révisions pour en savoir plus sur les modifications à venir concernant les ID de sujet.

topicDetails.topicIds[] list
Important:Cette propriété a été abandonnée le 10 novembre 2016. L'API ne renvoie plus de valeurs pour cette propriété. Tous les sujets 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 sujet pertinents pour la vidéo.

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

Important : Depuis l'abandon de Freebase et de l'API Freebase, les ID de sujet fonctionnent différemment depuis le 27 février 2017. À l'époque, YouTube a commencé à renvoyer un petit ensemble d'ID de sujets sélectionnés.

Afficher les ID de thèmes acceptés depuis le 15 février 2017

Thèmes
Sujets liés à la musique
/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
Sujets 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	Jeu vidéo de simulation
/m/022dc6	Jeu de sport
/m/03hf_rm	Jeu vidéo de stratégie
Sujets sportifs
/m/06ntj	Sports (sujet parent)
/m/0jm_	Football américain
/m/018jz	Baseball
/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 liés au divertissement
/m/02jjt	Divertissement (sujet parent)
/m/09kqc	Humour
/m/02vxn	Films
/m/05qjc	Arts du spectacle
/m/066wd	Catch professionnel
/m/0f2f9	Séries TV
Thèmes de style de vie
/m/019_rr	Style de vie (sujet parent)
/m/032tl	Mode
/m/027x7n	Fitness
/m/02wbm	Restauration
/m/03glg	Loisirs
/m/068hy	Animaux de compagnie
/m/041xxh	Attrait physique [Beauté]
/m/07c1v	Technologie
/m/07bxq	Tourisme
/m/07yv9	Véhicules
Sujets de société
/m/098wr	Société (thème parent)
/m/09s1f	Entreprise
/m/0kt51	Santé
/m/01h6rj	Armée
/m/05qt0	Politique
/m/06bvp	Religion
Autres sujets
/m/01k8wb	Connaissances

topicDetails.topicCategories[] list
Liste d'URL Wikipédia fournissant une description générale du contenu de la vidéo.

recordingDetails object
L'objet recordingDetails encapsule des informations sur le lieu, la date et l'adresse où la vidéo a été enregistrée.

recordingDetails.locationDescription string
Cette propriété est obsolète depuis le 1er juin 2017. Pour en savoir plus, 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 des propriétés enfants identifient l'emplacement que le propriétaire de la vidéo souhaite associer à la vidéo. Cette valeur est modifiable, incluse dans l'index de recherche des vidéos publiques et peut être visible par les utilisateurs pour les vidéos publiques.

recordingDetails.location.latitude double
Cette propriété a été abandonnée 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 de l'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 regroupe des informations sur le fichier vidéo mis en ligne sur YouTube, y compris sa résolution, sa durée, ses codecs audio et vidéo, ses 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 présent que vous ayez importé un fichier vidéo ou un autre type de fichier.

fileDetails.fileSize unsigned long
Taille du fichier importé, en octets. Ce champ est présent que vous ayez importé un fichier vidéo ou un autre type de fichier.

fileDetails.fileType

string
Type du fichier importé 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 que vous ayez mis en ligne un fichier vidéo ou un autre type de fichier.

Les valeurs valides pour cette propriété sont les suivantes :

archive : le fichier est un fichier d'archive, tel qu'une archive ZIP.
audio : type de fichier audio connu, par exemple un fichier .mp3.
document : le fichier est un document ou un fichier texte, tel qu'un document MS Word.
image : le fichier est un fichier image, tel qu'une image au format .jpeg.
other : le fichier est un autre type de fichier non vidéo.
project : le fichier est un fichier de projet vidéo, tel qu'un projet Microsoft Windows Movie Maker, qui ne contient pas de données vidéo réelles.
video : le fichier est un type de fichier vidéo connu, tel qu'un fichier .mp4.

fileDetails.container string
Format du conteneur du fichier vidéo importé.

fileDetails.videoStreams[] list
Liste des flux vidéo contenus dans le fichier vidéo importé. Chaque élément de la liste contient des métadonnées détaillées sur un flux vidéo.

fileDetails.videoStreams[].widthPixels unsigned integer
Largeur du contenu vidéo encodé, en pixels. Vous pouvez calculer le format d'encodage de la vidéo comme suit : width_pixels / height_pixels.

fileDetails.videoStreams[].heightPixels unsigned integer
Hauteur du contenu vidéo encodé, en pixels.

fileDetails.videoStreams[].frameRateFps double
Fréquence d'images du flux vidéo, en images par seconde.

fileDetails.videoStreams[].aspectRatio double
Format d'affichage du contenu vidéo, qui spécifie le format dans lequel la vidéo doit être affichée.

fileDetails.videoStreams[].codec string
Le 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
Durée nécessaire à YouTube pour effectuer une rotation du contenu source d'origine afin d'afficher correctement la vidéo.

Les valeurs valides pour cette propriété sont les suivantes :

clockwise : la vidéo doit être pivotée de 90 degrés dans le sens des aiguilles d'une montre.
counterClockwise : vous devez faire pivoter la vidéo de 90 degrés dans le sens inverse des aiguilles d'une montre.
none : la vidéo n'a pas besoin d'être pivotée.
other : la vidéo doit être pivotée d'une autre manière.
upsideDown : la vidéo doit être retournée.

fileDetails.videoStreams[].vendor string
Valeur qui identifie de manière unique un fournisseur de vidéos. Il s'agit généralement d'un code fournisseur de 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
Le 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. Il s'agit généralement d'un code fournisseur de quatre lettres.

fileDetails.durationMs unsigned long
Durée de la vidéo importée en millisecondes.

fileDetails.bitrateBps unsigned long
Débit combiné (vidéo et audio) du fichier vidéo mis en ligne, 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 fuseau horaire : YYYY-MM-DDTHH:MM:SS+HH:MM

processingDetails object
L'objet processingDetails regroupe des informations sur la progression du traitement du fichier vidéo importé par YouTube. Les propriétés de l'objet indiquent l'état actuel du traitement et une estimation du temps restant avant que YouTube ait terminé de traiter la vidéo. Cette partie indique également si différents types de données ou de contenus, tels que les détails du fichier ou les images miniatures, sont disponibles pour la vidéo.

L'objet processingProgress est conçu pour être interrogé afin que la vidéo mise en ligne puisse suivre la progression du traitement du fichier vidéo mis en ligne par YouTube. Ces données ne peuvent être récupérées que par le propriétaire de la vidéo.

processingDetails.processingStatus

string
État du traitement de la vidéo. Cette valeur indique si YouTube a pu traiter la vidéo ou si elle est toujours en cours de traitement.

Les valeurs valides pour cette propriété sont les suivantes :

failed : le traitement de la vidéo a échoué. Voir ProcessingFailureReason.
processing : la vidéo est en cours de traitement. Voir ProcessingProgress.
succeeded : la vidéo a bien été traitée.
terminated : les informations de traitement ne sont plus disponibles.

processingDetails.processingProgress object
L'objet processingProgress contient des informations sur la progression du traitement de la vidéo par YouTube. Les valeurs ne sont vraiment pertinentes que si l'état de traitement de la vidéo est processing.

processingDetails.processingProgress.partsTotal unsigned long
Estimation du nombre total d'éléments à 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 que YouTube a déjà traité en calculant :
100 * parts_processed / parts_total

Notez que, comme le nombre estimé de parties peut augmenter sans que le nombre de parties déjà traitées augmente en conséquence, il est possible que la progression calculée diminue régulièrement pendant que YouTube traite une vidéo.

processingDetails.processingProgress.timeLeftMs unsigned long
Estimation du temps (en millisecondes) nécessaire à YouTube pour terminer le traitement de la vidéo.

processingDetails.processingFailureReason

string
Motif pour lequel YouTube n'a pas pu traiter la vidéo. Cette propriété n'a de valeur que si la valeur de la propriété processingStatus est failed.

Les valeurs valides pour cette propriété sont les suivantes :

other : un autre composant de traitement a échoué.
streamingFailed : impossible d'envoyer la vidéo aux streamers.
transcodeFailed : échec du transcodage du contenu.
uploadFailed : l'envoi du fichier a échoué.

processingDetails.fileDetailsAvailability string
Cette valeur indique si des informations sur le fichier sont disponibles pour la vidéo mise en ligne. Vous pouvez récupérer les détails du fichier d'une vidéo en demandant la partie fileDetails dans votre requête videos.list().

processingDetails.processingIssuesAvailability string
Cette valeur indique si le moteur de traitement vidéo a généré des suggestions susceptibles d'améliorer la capacité de YouTube à traiter la vidéo, des avertissements ou des erreurs entraînant des problèmes de traitement de la vidéo. Pour récupérer ces suggestions, demandez la partie suggestions dans votre requête videos.list().

processingDetails.tagSuggestionsAvailability string
Cette valeur indique si des suggestions de mots clés (balises) sont disponibles pour la vidéo. Vous pouvez ajouter des tags aux métadonnées d'une vidéo pour permettre aux autres utilisateurs de la trouver plus facilement. Pour récupérer ces suggestions, demandez la partie suggestions dans votre requête videos.list().

processingDetails.editorSuggestionsAvailability string
Cette valeur indique si des suggestions de montage vidéo, qui peuvent améliorer la qualité de la vidéo ou l'expérience de lecture, sont disponibles pour la vidéo. Pour récupérer ces suggestions, demandez la partie suggestions dans votre requête videos.list().

processingDetails.thumbnailsAvailability string
Cette valeur indique si des miniatures ont été générées pour la vidéo.

suggestions object
L'objet suggestions encapsule des suggestions qui identifient des possibilités d'améliorer la qualité de la vidéo ou les métadonnées de la vidéo mise en ligne. Ces données ne peuvent être récupérées que par le propriétaire de la vidéo.

L'objet suggestions n'est renvoyé que si la propriété processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability a la valeur available.

suggestions.processingErrors[]

list
Liste des erreurs qui empêchent YouTube de traiter correctement la vidéo importée. Ces erreurs indiquent que, quel que soit l'état de traitement actuel de la vidéo, il 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 contient uniquement 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 non 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 qui peut entraîner une erreur de transcodage. Ces avertissements sont générés avant que YouTube ne traite le fichier vidéo mis en ligne. En outre, ils identifient les problèmes qui n'indiquent pas nécessairement que le traitement vidéo échouera, mais qui peuvent néanmoins causer des problèmes tels que des problèmes de synchronisation, des artefacts vidéo ou une piste audio manquante.

Les valeurs valides pour cette propriété sont les suivantes :

hasEditlist : il n'est pas possible de modifier les listes pour le moment.
inconsistentResolution : résolutions de conteneur et de flux en conflit.
problematicAudioCodec : un codec audio connu pour causer des problèmes a été utilisé.
problematicVideoCodec : un codec vidéo connu pour causer des problèmes a été utilisé.
unknownAudioCodec : codec audio non reconnu. Le transcodage risque d'échouer.
unknownContainer : format de fichier non reconnu, le transcodage risque d'échouer.
unknownVideoCodec : codec vidéo non reconnu. Le transcodage risque d'échouer.

suggestions.processingHints[]

list
Liste de suggestions susceptibles d'améliorer la capacité de YouTube à traiter la vidéo.

Valeurs valides pour cette propriété :

nonStreamableMov : le fichier MP4 ne peut pas être lu en streaming, ce qui ralentira le traitement.
sendBestQualityVideo : il existe probablement une version de meilleure qualité de la vidéo.

suggestions.tagSuggestions[] list
Liste des balises de mots clés pouvant être ajoutées aux métadonnées de la vidéo pour augmenter la probabilité que les utilisateurs la trouvent lorsqu'ils effectuent une recherche ou parcourent 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 la balise est pertinente. Vous pouvez utiliser ces informations pour afficher des suggestions de tags appropriées en fonction de la catégorie de la vidéo que l'utilisateur qui l'a mise en ligne lui a attribuée. Par défaut, les suggestions de balises 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é ou l'expérience de lecture de la vidéo mise en ligne.

Valeurs valides pour cette propriété :

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 (bordures) détectées autour de l'image peuvent être rognées.
videoStabilize : la vidéo semble floue 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 si la vidéo est une diffusion en direct à venir, en cours ou terminée.

liveStreamingDetails.actualStartTime datetime
Heure à laquelle la diffusion a réellement commencé. La valeur est spécifiée au format ISO 8601. Cette valeur ne sera pas disponible tant que la diffusion n'aura pas commencé.

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 pas disponible tant que la diffusion n'est pas terminée.

liveStreamingDetails.scheduledStartTime datetime
Heure de début de la diffusion. La valeur est spécifiée au format ISO 8601.

liveStreamingDetails.scheduledEndTime datetime
Heure de fin de la diffusion. La valeur est spécifiée au format ISO 8601. Si la valeur est vide ou que la propriété n'est pas présente, la diffusion est planifié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 compte des spectateurs actuels et que le propriétaire de la diffusion n'a pas masqué le nombre de vues de la vidéo. Notez que YouTube cesse de suivre le nombre de spectateurs simultanés d'une diffusion lorsqu'elle se termine. Par conséquent, 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 différer du nombre de spectateurs simultanés traités et déspammés disponibles dans YouTube Analytics. En savoir plus sur les métriques des diffusions en direct dans le Centre d'aide YouTube

liveStreamingDetails.activeLiveChatId string
ID du chat en direct actuellement actif associé à cette vidéo. Ce champ n'est renseigné que si la vidéo est une diffusion en direct avec un chat en direct. Une fois la diffusion terminée, ce champ sera supprimé et le chat en direct fermé. Pour les diffusions persistantes, cet ID de chat en direct ne sera plus associé à cette vidéo, mais à la nouvelle vidéo affichée sur la page persistante.

localizations object
L'objet localizations contient les traductions des métadonnées de la vidéo.

localizations.(key) object
Langue du texte localisé associé à la valeur de clé. La valeur est une chaîne contenant un code de langue BCP-47.

localizations.(key).title string
Titre de la vidéo localisé.

localizations.(key).description string
Description de la vidéo localisée.