Metadata

Metadane zasobu. Niektóre pola metadanych są prawidłowe tylko w przypadku określonych typów komponentów.

Zapis 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
}
Pola
customId

string

Unikalna wartość, której używasz do identyfikowania zasobu. Wartością może być unikalny identyfikator utworzony przez Ciebie dla zasobu lub standardowy identyfikator, np. ISRC. Wartość może mieć maksymalnie 64 bajty i może zawierać znaki alfanumeryczne, łączniki (-), podkreślenia (_), kropki (.), symbole „@” (@) lub ukośniki (/).
title

string

Tytuł lub nazwa komponentu. Wartość może mieć maksymalnie 255 bajtów. Ta wartość jest wymagana w przypadku tych komponentów:

  • Pokaż zasoby
  • komponenty odcinka powiązane z programem;
  • Zasoby filmowe, które wyświetlają się w kategorii Filmy w YouTube
  • Nagrania dźwiękowe objęte programem Podmień dźwięk
notes

string

Dodatkowe informacje, które nie są mapowane bezpośrednio na żadne z pozostałych pól metadanych. Maksymalna długość tego pola to 255 bajtów.
description

string

Opis komponentu. Opis może być wyświetlany w YouTube lub w systemie CMS. Maksymalna długość pola to 5000 bajtów
genre[]

string

To pole określa gatunek, który może służyć do kategoryzowania zasobu. Zasoby mogą być przypisane do więcej niż 1 gatunku, a YouTube używa różnych zestawów gatunków do kategoryzowania różnych typów zasobów. Na przykład Soaps może być prawidłowym gatunkiem w przypadku programu, ale nie w przypadku filmu lub nagrania dźwiękowego.

  • Pokaż zasoby
  • Zasoby filmowe, które wyświetlają się w kategorii Filmy w YouTube
  • Nagrania dźwiękowe objęte programem Podmień dźwięk
isrc

string

Kod ISRC (International Standard Recording Code) zasobu teledysku lub nagrania dźwiękowego. Wartość tego pola musi składać się z dokładnie 12 znaków alfanumerycznych.
grid

string

GRid (globalny identyfikator wydania) teledysku lub nagrania dźwiękowego. Wartość tego pola musi składać się z dokładnie 18 znaków alfanumerycznych.
artist[]

string

Wykonawca powiązany z zasobem teledysku lub nagrania dźwiękowego. To pole jest prawidłowe tylko w przypadku zasobów teledysku i nagrania dźwiękowego. Jest wymagany w przypadku nagrań dźwiękowych objętych programem Podmień dźwięk.
label

string

Wytwórnia, która wydała zasób nagrania dźwiękowego. To pole jest prawidłowe tylko w przypadku zasobów nagrania dźwiękowego i ma maksymalną długość 255 bajtów.
upc

string

Kod UPC (Universal Product Code) powiązany z zasobem.
album

string

Album, na którym znajduje się zasób nagrania dźwiękowego. To pole jest prawidłowe tylko w przypadku zasobów nagrania dźwiękowego i ma maksymalną długość 255 bajtów.
infoUrl

string

Oficjalny adres URL powiązany z zasobem. Maksymalna długość tego pola to 1536 bajtów. Nie przesyłaj adresu URL o długości 1537 bajtów. Twoje wysiłki byłyby bezcelowe.
iswc

string

Kod ISWC (International Standard Musical Work Code) zasobu kompozycji. Wartość pola musi składać się z dokładnie 11 znaków i mieć format litery (T), po której następuje 10 cyfr.
category

string

Kategoria tego komponentu.
copyrightDate

object (Date)

Data ustanowienia praw autorskich do tego komponentu. *
startYear

integer (uint32 format)

Pierwszy rok emisji programu telewizyjnego. Ta wartość jest wymagana i używana tylko w przypadku zasobów dotyczących programów.
endYear

integer (uint32 format)

Ostatni rok emisji programu telewizyjnego. Ta wartość jest używana tylko w przypadku komponentów do wyświetlania, w których jest opcjonalna. Nie podawaj wartości, jeśli nadal tworzone są nowe odcinki programu.
episodesAreUntitled

boolean

Ta wartość oznacza, że odcinki powiązane z danym zasobem programu lub danym zasobem sezonu nie mają tytułu. Niezatytułowany program (lub sezon) zawiera odcinki, które są identyfikowane na podstawie numeru odcinka lub daty. Jeśli to pole ma wartość true, YouTube będzie optymalizować wyświetlany tytuł powiązanych odcinków.
keyword[]

string

Lista maksymalnie 100 słów kluczowych powiązanych z zasobem programu. To pole jest wymagane i używane tylko w przypadku zasobów dotyczących programów.
tmsId

string

Identyfikator TMS (Tribune Media Systems) zasobu.
showCustomId

string

customId zasobu programu, z którym jest powiązany dany sezon lub odcinek. Jest wymagany w przypadku zasobów sezonowych i odcinków, które pojawiają się w kategorii Programy w YouTube, i nie jest ważny w przypadku innych typów zasobów. To pole ma maksymalną długość 64 bajtów i może zawierać znaki alfanumeryczne, łączniki (-), podkreślenia (_), kropki (.), symbole „@” (@) lub ukośniki (/).
showTitle

string

Nazwa programu, z którym jest powiązany zasób odcinka. Uwaga: ten tag jest używany tylko w przypadku odcinków, które nie są powiązane z zasobami programu, i umożliwia wyświetlanie tytułu programu w sekcji metadanych zasobu w systemie CMS. Maksymalna długość tego pola wynosi 120 bajtów.
seasonNumber

string

Numer sezonu, który identyfikuje zasób sezonu lub jest powiązany z zasobem odcinka. Maksymalna długość tego pola to 5 bajtów.
episodeNumber

string

Numer odcinka powiązany z zasobem odcinka. To pole jest wymagane i używane tylko w przypadku komponentów odcinka, które są połączone z komponentami programu. Maksymalna długość to 5 bajtów.
writer[]

string

Lista identyfikująca autorów powiązanych z zasobem. Możesz określić maksymalnie 50 scenarzystów zasobu.
actor[]

string

Lista identyfikująca aktorów powiązanych z zasobem. Możesz określić maksymalnie 50 aktorów dla zasobu.
director[]

string

Lista identyfikująca reżyserów powiązanych z zasobem. Do jednego zasobu możesz przypisać maksymalnie 50 reżyserów.
producer[]

string

Lista identyfikująca producentów zasobu. Możesz określić maksymalnie 50 producentów zasobu.
releaseDate

object (Date)

Data publicznej publikacji zasobu. W przypadku komponentów sezonu ta wartość określa pierwszą datę emisji sezonu. Nie są obsługiwane daty sprzed 1902 r. Ta wartość jest prawidłowa w przypadku odcinków, sezonów, filmów, teledysków i nagrań dźwiękowych. Jest wymagany w przypadku wymienionych poniżej komponentów, a w pozostałych przypadkach jest opcjonalny:

  • komponenty odcinka powiązane z programem;
  • Zasoby filmowe, które wyświetlają się w kategorii Filmy w YouTube
spokenLanguage

string

Główny język mówiony w filmie. Wartością może być dowolny dwuliterowy kod języka w standardzie ISO 639-1. Ta wartość jest używana tylko w przypadku zasobów odcinków i filmów i nie jest prawidłowa w przypadku innych typów zasobów.
subtitledLanguage[]

string

Lista języków, dla których film ma osobną ścieżkę z napisami lub napisy wbudowane w film. Każda wartość na liście powinna być dwuliterowym kodem języka w standardzie ISO 639-1. Ta wartość jest używana tylko w przypadku zasobów odcinków i filmów i nie jest prawidłowa w przypadku innych typów zasobów.
isan

string

Kod ISAN (International Standard Audiovisual Number) zasobu. Ta wartość jest używana tylko w przypadku odcinków i filmów i jest opcjonalna w obu przypadkach. Wartość składa się z 26 znaków, z czego 24 stanowią szesnastkowy numer ISAN, a dwa są znakami kontrolnymi. Format jest następujący:

  • Pierwsze 16 znaków wartości tagu to liczby szesnastkowe, które określają składniki „root” i „episode” numeru ISAN.
  • Siedemnasty znak to znak kontrolny (litera od A do Z).
  • Znaki od 18 do 25 to pozostałe osiem znaków ISAN. Określają one składnik „version” numeru ISAN.
  • Dwudziestym szóstym znakiem jest kolejny znak kontrolny (litera z zakresu A-Z).
eidr

string

Identyfikator rejestru EIDR (Entertainment Identifier Registry) przypisany do zasobu. Ta wartość jest używana tylko w przypadku odcinków i filmów i jest opcjonalna w obu przypadkach. Wartość składa się ze standardowego przedrostka kodu EIDR, po którym następuje prawy ukośnik, 20-znakowa liczba szesnastkowa oraz alfanumeryczny znak kontrolny (0–9, A–Z).
hfa

string

Sześcioznakowy kod utworu Harry Fox Agency (HFA) nadany w celu jednoznacznego identyfikowania kompozycji. Ta wartość jest prawidłowa tylko w przypadku zasobów kompozycji.
ratings[]

object (Rating)

Lista ocen otrzymanych przez komponent. Ocena musi być prawidłowa w ramach określonego systemu ocen.
broadcaster[]

string

Określa sieć lub kanał, który pierwotnie wyemitował program lub sezon programu. To pole powinno być uwzględnione w przypadku pliku tylko wtedy, gdy nadawca powiązany z plikiem jest inny niż partner przesyłający plik do YouTube. Pamiętaj, że program może mieć wielu nadawców. Na przykład może zmieniać sieć między sezonami.
totalEpisodesExpected

integer (uint32 format)

Określa łączną liczbę pełnych odcinków w sezonie. Ta wartość jest używana tylko w przypadku zasobów sezonowych.
contentType

string

Typ treści wideo, które reprezentuje zasób. To pole jest prawidłowe tylko w przypadku zasobów filmów i odcinków. Jest wymagane w przypadku tych typów zasobów:

  • komponenty odcinka powiązane z programem;
  • Zasoby filmowe, które wyświetlają się w kategorii Filmy w YouTube

Akceptowane wartości:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Sposób, w jaki użytkownicy po raz pierwszy mieli możliwość obejrzenia zasobu wideo. Ta wartość jest używana tylko w przypadku zasobów odcinków i filmów. Jest wymagany w przypadku tych komponentów, a w innych przypadkach jest opcjonalny:

  • komponenty odcinka powiązane z programem;
  • Zasoby filmowe, które wyświetlają się w kategorii Filmy w YouTube

Akceptowane wartości:

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

Data

Ten zasób określa datę, która jest reprezentowana przez jej części składowe (rok, miesiąc, dzień).

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer (uint32 format)

Rok daty w kalendarzu gregoriańskim. Przyjęto, że jest to era nowożytna.
month

integer (uint32 format)

Miesiąc daty. Wartość powinna być liczbą całkowitą z zakresu od 1 do 12.
day

integer (uint32 format)

Dzień daty. Wartość powinna być liczbą całkowitą z zakresu od 1 do 31. Pamiętaj, że niektóre kombinacje dnia i miesiąca są nieprawidłowe.

Ocena

Ten obiekt zawiera ocenę treści zasobu.

Zapis JSON 
{
  "ratingSystem": string,
  "rating": string
}
Pola
ratingSystem

string

System ocen powiązany z oceną.

Akceptowane wartości:

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

string

Ocena, jaką otrzymał komponent.