Metadata

Метаданные актива. Некоторые поля метаданных действительны только для определенных типов активов.

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
}
Поля
customId

string

Уникальное значение, которое вы, как поставщик метаданных, используете для идентификации актива. Это может быть уникальный идентификатор, созданный вами для актива, или стандартный идентификатор, например, ISRC. Значение имеет максимальную длину 64 байта и может содержать буквенно-цифровые символы, дефисы ( - ), подчеркивания ( _ ), точки ( . ), символы " @ " или косые черты ( / ).

title

string

Название или наименование актива. Максимальная длина значения — 255 байт. Это значение обязательно для перечисленных ниже активов и необязательно для всех остальных:

  • Показать активы
  • Материалы эпизода, связанные с сериалом.
  • Видеоматериалы, которые отображаются в категории «Фильмы» на YouTube.
  • Звукозаписи, включенные в программу AudioSwap.
notes

string

Дополнительная информация, которая не связана напрямую с другими полями метаданных. Максимальная длина этого поля составляет 255 байт.

description

string

Описание ресурса. Описание может отображаться на YouTube или в CMS. Максимальная длина этого поля — 5000 байт.

genre[]

string

В этом поле указывается жанр, который можно использовать для классификации контента. Контент может быть отнесен к нескольким жанрам, и YouTube использует разные наборы жанров для классификации разных типов контента. Например, жанр Soaps может быть допустимым для сериала, но не для фильма или звукозаписи.

  • Показать активы
  • Видеоматериалы, которые отображаются в категории «Фильмы» на YouTube.
  • Звукозаписи, включенные в программу AudioSwap.
isrc

string

Код ISRC (Международный стандартный код записи) музыкального видео или звукозаписи. Значение этого поля должно содержать ровно 12 буквенно-цифровых символов.

grid

string

Идентификатор глобального релиза (GRID) музыкального видео или звукозаписи. Значение этого поля должно содержать ровно 18 буквенно-цифровых символов.

artist[]

string

Исполнитель, связанный с музыкальным видео или звукозаписью. Это поле действительно только для музыкальных видео и звукозаписей. Оно обязательно для звукозаписей, включенных в программу AudioSwap.

label

string

Звукозаписывающая компания, выпустившая звуковую запись. Это поле действительно только для звуковых записей и имеет максимальную длину 255 байт.

upc

string

Универсальный код продукта (UPC), связанный с активом.

album

string

Альбом, в который включена звуковая запись. Это поле действительно только для звуковых записей и имеет максимальную длину 255 байт.

infoUrl

string

Официальный URL-адрес, связанный с ресурсом. Максимальная длина этого поля — 1536 байт. Пожалуйста, не отправляйте URL-адреса длиной 1537 байт. Ваши усилия будут тщетны.

iswc

string

Международный стандартный код музыкального произведения (ISWC) для музыкального произведения. Значение поля должно содержать ровно 11 символов в формате буква (T), за которой следуют 10 цифр.

category

string

Категория данного актива.

copyrightDate

object ( Date )

Дата установления авторских прав на данный объект. *

startYear

integer ( uint32 format)

Первый год показа телешоу. Это значение необходимо и используется исключительно для хранения материалов шоу.

endYear

integer ( uint32 format)

Последний год показа телешоу. Это значение используется только для ресурсов шоу, для которых оно необязательно. Не указывайте значение, если новые эпизоды шоу еще находятся в процессе создания.

episodesAreUntitled

boolean

Это значение указывает на то, что эпизоды, связанные с конкретным сериалом или сезоном, не имеют названия. Сериал (или сезон) без названия имеет эпизоды, которые идентифицируются по номеру эпизода или дате. Если это поле установлено в true , YouTube оптимизирует отображаемое название для соответствующих эпизодов.

keyword[]

string

Список до 100 ключевых слов, связанных с элементом оформления шоу. Это поле обязательно для всех элементов оформления шоу и используется только для них.

tmsId

string

Идентификатор TMS (Tribune Media Systems) для данного актива.

showCustomId

string

Идентификатор пользовательского ресурса customId ) ресурса, с которым связан ресурс сезона или эпизода. Он обязателен для ресурсов сезонов и эпизодов, которые отображаются в категории «Шоу» на YouTube, и недействителен для других типов ресурсов. Максимальная длина этого поля составляет 64 байта, и оно может содержать буквенно-цифровые символы, дефисы ( - ), подчеркивания ( _ ), точки ( . ), символы « @ » или косые черты ( / ).

showTitle

string

Название сериала, с которым связан данный эпизод. Примечание: Этот тег используется и действителен только для эпизодов, не связанных с другими сериалами, и позволяет этим сериалам по-прежнему отображать название сериала в разделе метаданных CMS. Максимальная длина этого поля — 120 байт.

seasonNumber

string

Номер сезона, идентифицирующий ресурс сезона, или номер сезона, связанный с ресурсом эпизода. Максимальная длина этого поля — 5 байт.

episodeNumber

string

Номер эпизода, связанный с ресурсом эпизода. Это поле обязательно для ресурсов эпизодов, связанных с ресурсами сериала, и используется только для них. Максимальная длина поля — 5 байт.

writer[]

string

Список, содержащий имена авторов, связанных с данным ресурсом. Для одного ресурса можно указать до 50 авторов.

actor[]

string

Список, идентифицирующий участников, связанных с ресурсом. Для ресурса можно указать до 50 участников.

director[]

string

Список, содержащий информацию о директорах, связанных с активом. Для актива можно указать до 50 директоров.

producer[]

string

Список, содержащий информацию о производителях актива. Для одного актива можно указать до 50 производителей.

releaseDate

object ( Date )

Дата публичного выпуска ресурса. Для ресурсов, относящихся к сезонам, это значение указывает дату первого показа сезона. Даты до 1902 года не поддерживаются. Это значение действительно для ресурсов, относящихся к эпизодам, сезонам, фильмам, музыкальным клипам и звукозаписям. Оно обязательно для ресурсов, перечисленных ниже, в остальных случаях является необязательным:

  • Материалы эпизода, связанные с сериалом.
  • Видеоматериалы, которые отображаются в категории «Фильмы» на YouTube.
spokenLanguage

string

Основной язык озвучки видео. Значение может быть любым двухбуквенным кодом языка ISO 639-1 . Это значение используется только для ресурсов эпизодов и фильмов и недействительно для других типов ресурсов.

subtitledLanguage[]

string

Список языков, для которых видео имеет либо отдельную дорожку субтитров, либо встроенные субтитры. Каждое значение в списке должно представлять собой двухбуквенный код языка ISO 639-1 . Это значение используется только для ресурсов эпизодов и фильмов и недействительно для других типов ресурсов.

isan

string

Международный стандартный аудиовизуальный номер (ISAN) для данного ресурса. Это значение используется только для ресурсов, относящихся к эпизодам и фильмам, и является необязательным в обоих случаях. Значение содержит 26 символов, включая 24 шестнадцатеричных символа ISAN, а также два контрольных символа, в следующем формате:

  • Первые 16 символов в значении тега содержат шестнадцатеричные символы, указывающие на «корневой» и «эпизодный» компоненты ISAN.
  • Семнадцатый символ — это галочка (буква из аббревиатуры AZ).
  • Символы с 18 по 25 — это оставшиеся восемь символов ISAN, которые определяют компонент «версия» ISAN.
  • Двадцать шестой символ — это еще один контрольный символ (AZ).
eidr

string

Идентификатор развлекательного контента (EIDR), присвоенный ресурсу. Это значение используется только для эпизодов и фильмов и является необязательным в обоих случаях. Значение содержит стандартный префикс для реестра EIDR, за которым следует косая черта, 20-символьная шестнадцатеричная строка и буквенно-цифровой (0-9A-Z) контрольный символ.

hfa

string

Шестисимвольный код песни агентства Harry Fox Agency (HFA), присваиваемый для уникальной идентификации композиции. Это значение действительно только для активов композиции.

ratings[]

object ( Rating )

Список оценок, полученных активом. Оценка должна соответствовать указанной рейтинговой системе.

broadcaster[]

string

Указывает сеть или канал, который первоначально транслировал шоу или сезон шоу. Это поле следует включать в описание ресурса только в том случае, если вещатель, связанный с ресурсом, отличается от партнера, загружающего ресурс на YouTube. Обратите внимание, что у шоу может быть несколько вещателей; например, шоу может менять каналы между сезонами.

totalEpisodesExpected

integer ( uint32 format)

Указывает общее количество полных эпизодов в сезоне. Это значение используется только для материалов сезона.

contentType

string

Тип видеоконтента, который представляет собой данный ресурс. Это поле действительно только для ресурсов, относящихся к фильмам и эпизодам, и является обязательным для следующих типов таких ресурсов:

  • Материалы эпизода, связанные с сериалом.
  • Видеоматериалы, которые отображаются в категории «Фильмы» на YouTube.

Допустимые значения:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Способ, с помощью которого люди впервые получили возможность увидеть видеоматериал. Это значение используется только для эпизодов и фильмов. Оно обязательно для следующих типов материалов, в остальных случаях необязательно:

  • Материалы эпизода, связанные с сериалом.
  • Видеоматериалы, которые отображаются в категории «Фильмы» на YouTube.

Допустимые значения:

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

Дата

Этот ресурс отображает дату в виде ее составных частей (год, месяц, день).

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer ( uint32 format)

Год, указанный в этом дате по григорианскому календарю. Предполагается, что это год нашей эры.

month

integer ( uint32 format)

Месяц даты. Значение должно быть целым числом от 1 до 12 .

day

integer ( uint32 format)

День недели. Значение должно быть целым числом от 1 до 31 Обратите внимание, что некоторые комбинации день-месяц недопустимы.

Рейтинг

Этот объект содержит рейтинг контента для ресурса .

JSON-представление 
{
  "ratingSystem": string,
  "rating": string
}
Поля
ratingSystem

string

Система рейтингов, связанная с данным рейтингом.

Допустимые значения:

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

string

Рейтинг, полученный активом.