Metadata

Métadonnées d'un élément. Certains champs de métadonnées ne sont valides que pour certains types de composants.

Représentation JSON 
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
Champs
customId

string

Valeur unique que vous, le fournisseur de métadonnées, utilisez pour identifier un élément. La valeur peut correspondre à un identifiant unique que vous avez créé pour l'élément ou à un identifiant standard, tel qu'un code ISRC. La valeur ne peut pas comporter plus de 64 octets. Elle peut contenir des caractères alphanumériques, des tirets (-), des traits de soulignement (_), des points (.), des symboles @ (@) ou des barres obliques (/).
title

string

Titre ou nom du composant. La valeur ne doit pas dépasser 255 octets. Cette valeur est obligatoire pour les composants listés ci-dessous et facultative pour tous les autres :

  • Afficher les composants
  • Éléments d'épisode associés à une série
  • Éléments de film qui apparaissent dans la catégorie Films de YouTube
  • Enregistrements sonores inclus dans le programme AudioSwap
notes

string

Informations supplémentaires qui ne correspondent pas directement à l'un des autres champs de métadonnées. Ce champ ne doit pas dépasser 255 octets.
description

string

Description de l'élément. La description peut s'afficher sur YouTube ou dans le CMS. Elle ne doit pas dépasser 5 000 octets.
genre[]

string

Ce champ spécifie un genre pouvant être utilisé pour classer un élément dans une catégorie. Les éléments peuvent être classés dans plusieurs genres. YouTube utilise différents ensembles de genres pour classer différents types d'éléments. Par exemple, Soaps peut être un genre valide pour une série, mais pas pour un film ou un enregistrement audio.

  • Afficher les composants
  • Éléments de film qui apparaissent dans la catégorie Films de YouTube
  • Enregistrements sonores inclus dans le programme AudioSwap
isrc

string

Code ISRC (International Standard Recording Code) d'un élément Clip musical ou Enregistrement audio. La valeur de cette balise doit se composer exactement de 12 caractères alphanumériques.
grid

string

GRID (Global Release Identifier) d'un clip musical ou d'un enregistrement audio. La valeur de cette balise doit se composer exactement de 18 caractères alphanumériques.
artist[]

string

Artiste associé à un élément Clip musical ou Enregistrement audio. Ce champ n'est valide que pour les éléments Clip musical et Enregistrement audio. Il est obligatoire pour les enregistrements sonores inclus dans le programme AudioSwap.
label

string

Maison de disques qui a distribué un élément Enregistrement audio. Ce champ n'est valide que pour les éléments Enregistrement audio et ne doit pas dépasser 255 octets.
upc

string

Code UPC (Universal Product Code) associé à l'élément.
album

string

Album dans lequel un élément Enregistrement audio est inclus. Ce champ n'est valide que pour les éléments Enregistrement audio et ne doit pas dépasser 255 octets.
infoUrl

string

URL officielle associée à l'élément. Le champ ne doit pas dépasser 1 536 octets. Veuillez ne pas envoyer d'URL de 1 537 octets. Vos efforts seraient vains.
iswc

string

Code ISWC (International Standard Musical Work Code) d'un élément Composition. La valeur de cette balise doit se composer exactement de 11 caractères correspondant à la lettre "T" suivie de 10 chiffres.
category

string

Catégorie de cet élément.
copyrightDate

object (Date)

Date à laquelle les droits d'auteur de cet élément ont été établis. *
startYear

integer (uint32 format)

Année de la première diffusion d'une émission télévisée. Cette valeur est requise pour les assets de série et n'est utilisée que pour eux.
endYear

integer (uint32 format)

Année de la dernière diffusion d'une émission télévisée. Cette valeur n'est utilisée que pour les assets de série, pour lesquels elle est facultative. Ne spécifiez pas de valeur si de nouveaux épisodes de la série sont encore en cours de création.
episodesAreUntitled

boolean

Cette valeur indique que les épisodes associés à un élément d'émission ou de saison spécifique n'ont pas de titre. Les épisodes d'une série (ou d'une saison) sans titre sont identifiés par leur numéro ou leur date. Si ce champ est défini sur true, YouTube optimisera le titre affiché pour les épisodes associés.
keyword[]

string

Liste de 100 mots clés maximum associés à un élément de série. Ce champ est obligatoire et n'est utilisé que pour les éléments de série.
tmsId

string

ID TMS (Tribune Media Systems) de l'élément.
showCustomId

string

customId de l'élément de série auquel un élément de saison ou d'épisode est associé. Elle est obligatoire pour les actifs de saison et d'épisode qui apparaissent dans la catégorie Séries sur YouTube, et n'est pas valable pour les autres types d'actifs. Ce champ comporte 64 octets au maximum et peut contenir des caractères alphanumériques, des traits d'union (-), des traits de soulignement (_), des points (.), des symboles @ (@) ou des barres obliques (/).
showTitle

string

Nom de l'émission à laquelle un élément de type épisode est associé. Remarque : Cette balise n'est utilisée et valide que pour les épisodes qui ne sont pas associés à des éléments de type émission. Elle permet à ces éléments d'afficher un titre d'émission dans la section des métadonnées des éléments du CMS. Ce champ ne doit pas dépasser 120 octets.
seasonNumber

string

Numéro de saison qui identifie un élément de saison ou numéro de saison associé à un élément d'épisode. Ce champ ne doit pas dépasser cinq octets.
episodeNumber

string

Numéro de l'épisode associé à un élément d'épisode. Ce champ est obligatoire et n'est utilisé que pour les composants d'épisodes associés à des composants de séries. Elle ne doit pas dépasser 5 octets.
writer[]

string

Liste qui identifie les auteurs associés à l'élément. Vous pouvez spécifier jusqu'à 50 auteurs pour un élément.
actor[]

string

Liste qui identifie les acteurs associés à l'élément. Vous pouvez spécifier jusqu'à 50 acteurs pour un élément.
director[]

string

Liste des réalisateurs associés à l'élément. Vous pouvez spécifier jusqu'à 50 réalisateurs pour un élément.
producer[]

string

Liste qui identifie les producteurs de l'asset. Vous pouvez spécifier jusqu'à 50 producteurs pour un élément.
releaseDate

object (Date)

Date de sortie publique d'un asset. Pour les composants de saison, cette valeur spécifie la première date de diffusion de la saison. Vous ne pouvez pas définir des dates antérieures à 1902. Cette valeur est valide pour les éléments de type épisode, saison, film, clip musical et enregistrement audio. Il est obligatoire pour les composants listés ci-dessous et facultatif dans les autres cas :

  • Éléments d'épisode associés à une série
  • Éléments de film qui apparaissent dans la catégorie Films de YouTube
spokenLanguage

string

Langue principale de la vidéo. La valeur peut être un code de langue à deux lettres de la norme ISO 639-1. Cette valeur n'est utilisée que pour les actifs d'épisode et de film, et n'est pas valide pour les autres types d'actifs.
subtitledLanguage[]

string

Liste des langues pour lesquelles la vidéo comporte une piste de sous-titres distincte ou des sous-titres intégrés qui font partie de la vidéo. Chaque valeur de la liste doit être un code de langue à deux lettres ISO 639-1. Cette valeur n'est utilisée que pour les actifs d'épisode et de film, et n'est pas valide pour les autres types d'actifs.
isan

string

Code ISAN (International Standard Audiovisual Number) de l'élément. Cette valeur n'est utilisée que pour les éléments d'épisodes et de films. Elle est facultative dans les deux cas. La valeur se compose de 26 caractères, dont 24 caractères hexadécimaux correspondant au numéro ISAN et deux caractères de contrôle, au format suivant :

  • Les 16 premiers caractères de la valeur de la balise sont des caractères hexadécimaux spécifiant les composants "root" et "episode" du numéro ISAN.
  • Le dix-septième caractère est un caractère de contrôle (une lettre de A à Z).
  • Les caractères 18 à 25 correspondent aux huit caractères restants du numéro ISAN, qui définissent le composant "version" de l'ISAN.
  • Le vingt-sixième caractère est un autre caractère de contrôle (A-Z).
eidr

string

Identifiant EIDR (Entertainment Identifier Registry) attribué à un élément. Cette valeur n'est utilisée que pour les éléments d'épisodes et de films. Elle est facultative dans les deux cas. La valeur est composée d'un préfixe standard pour le registre EIDR, suivi d'une barre oblique, d'une chaîne de 20 caractères hexadécimaux, et d'un caractère alphanumérique de contrôle (0-9 A-Z).
hfa

string

Code HFA (Harry Fox Agency) à six caractères attribué pour identifier de façon unique une composition. Cette valeur n'est valide que pour les éléments de composition.
ratings[]

object (Rating)

Liste des notes attribuées à un composant. La classification doit être valide dans le système de classification spécifié.
broadcaster[]

string

Identifie le réseau ou la chaîne qui a initialement diffusé une émission ou une saison d'émission. Ce champ ne doit être inclus pour un asset que si la chaîne associée à l'asset est différente du partenaire qui l'importe sur YouTube. Notez qu'une série peut avoir plusieurs diffuseurs (par exemple, elle peut changer de chaîne entre les saisons).
totalEpisodesExpected

integer (uint32 format)

Indique le nombre total d'épisodes complets de la saison. Cette valeur n'est utilisée que pour les éléments de saison.
contentType

string

Type de contenu vidéo représenté par l'asset. Ce champ n'est valide que pour les éléments de type film et épisode. Il est obligatoire pour les types d'éléments suivants :

  • Éléments d'épisode associés à une série
  • Éléments de film qui apparaissent dans la catégorie Films de YouTube

Les valeurs acceptées sont les suivantes :

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Méthode par laquelle les utilisateurs ont eu la possibilité de voir un composant Vidéo pour la première fois. Cette valeur n'est utilisée que pour les éléments d'épisodes et de films. Il est obligatoire pour les composants suivants, mais facultatif pour les autres :

  • Éléments d'épisode associés à une série
  • Éléments de film qui apparaissent dans la catégorie Films de YouTube

Les valeurs acceptées sont les suivantes :

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

Date

Cette ressource identifie une date, qui est représentée par ses éléments constitutifs (année, mois, jour).

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer (uint32 format)

Année de la date dans le calendrier grégorien. Supposé être après J.-C.
month

integer (uint32 format)

Mois de la date. La valeur doit être un entier compris entre 1 et 12.
day

integer (uint32 format)

Jour de la date. La valeur doit être un entier compris entre 1 et 31. Notez que certaines combinaisons jour/mois ne sont pas valides.

Notes

Cet objet contient une classification du contenu pour un élément.

Représentation JSON 
{
  "ratingSystem": string,
  "rating": string
}
Champs
ratingSystem

string

Système de classification associé à la classification.

Les valeurs acceptées sont les suivantes :

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

Note attribuée au composant.