Элемент <ResourceList>
содержит сведения о звукозаписях или видео и связанных с ними обложках альбома. Например, в аудиоальбоме из десяти треков дорожки будут представлены отпечатками от A1 до A10, а обложка – отпечатком А11. Это изображение нужно системе YouTube, чтобы создать объект "музыка с обложкой альбома". Помните, что по правилам DDEX в фиды Single Resource Release не нужно включать обложки альбомов.
<ResourceList>
несколько версий метаданных для разных стран. Если так сделать, пользователям будет виден только вариант, указанный первым.Элементы, принадлежащие YouTube
В разделе ниже представлена краткая информация об элементах, принадлежащих YouTube. Более подробные сведения о каждом из них, а также примеры приведены далее в статье.
Элементы, принадлежащие YouTube
Ниже перечислены элементы, которые являются частью пространства имен YouTube.
Звукозаписи
<SoundRecordingId>
[...]
<!--- Определяет значение поля custom_id для объекта типа "звукозапись" -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Определяет по идентификатору, какой объект типа "звукозапись" будет обновлен -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Добавляет ярлык к объекту типа "звукозапись" -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Музыка с обложкой альбома
<SoundRecordingId>
[...]
<!--- Определяет значение поля custom_id для объекта типа "трек с обложкой" -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Добавляет один ярлык к объекту типа "трек с обложкой" (используйте
YOUTUBE:CLEAR_AT_ASSET_LABELS для удаления всех ярлыков объекта) -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Музыкальные видео
<VideoId>
[...]
<!--- Задает значение поля custom_id для объекта типа "музыкальное видео" -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Определяет по идентификатору, какой объект типа "музыкальное видео" будет обновлен -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Добавляет один ярлык к объекту типа "музыкальное видео" -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Обновляет выбранный объект типа "музыкальное видео" -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Определяет канал, на который будет добавлено видео -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Интернет-видео
<VideoId>
[...]
<!--- Определяет значение поля custom_id для объекта типа "интернет-видео" -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Определяет по идентификатору, какой объект типа "интернет-видео" будет обновлен -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222
</ProprietaryId>
<!--- Добавляет один ярлык к объекту типа "интернет-видео" -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Обновляет выбранный объект типа "интернет-видео" -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Определяет канал, на который будет добавлено видео -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Плейлисты
<CollectionId>
[...]
<ProprietaryId Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-
SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Ресурсы звукозаписи
Идентификаторы звукозаписи
Каждый элемент <SoundRecording>
должен включать действительный код ISRC. Если вы также отслеживаете записи с помощью отдельного идентификатора, добавьте тег <ProprietaryId>
вместе с кодом <ISRC>
в элемент <SoundRecordingId>
. Вот как выглядит фрагмент XML-фида с элементом <ProprietaryId>
:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:ваш идентификатор DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
Необходимо указать и ваш идентификатор DPID (DDEX Party ID), и отдельный идентификатор, значение которого сохраняется в поле custom_id. В приведенном выше примере у объекта будет код ISRC USRE10400888, а идентификатор примет значение custom_id_1234.
Для объектов типа "звукозапись" и "трек с обложкой" можно указать разные значения поля custom_id. Нужно только добавить специальные элементы YOUTUBE:SR_CUSTOM_ID и YOUTUBE:AT_CUSTOM_ID.
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Определяет значение поля custom_id для объекта типа "звукозапись" -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Определяет значение поля custom_id для объекта типа "трек с обложкой" -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Если вы хотите обновить данные существующего объекта типа "звукозапись", укажите для него идентификатор с помощью пространства имен YOUTUBE:SR_ASSET_ID:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Определяет по идентификатору, какой объект типа "звукозапись" будет обновлен -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Чтобы добавить ярлыки объектов, используйте пространства имен YOUTUBE:SR_ASSET_LABEL и YOUTUBE:AT_ASSET_LABEL:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Добавляет два ярлыка к объекту типа "звукозапись" -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Добавляет один ярлык к объекту типа "трек с обложкой" -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Чтобы удалить все ярлыки для объекта типа "звукозапись", используйте следующее пространство имен:
YOUTUBE:CLEAR_SR_ASSET_LABELS.
<SoundRecordingId>
[...]
<!--- Удаляет все ярлыки для объекта типа "звукозапись" -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_SR_ASSET_LABELS">True</ProprietaryId>
[...]
</SoundRecordingId>
Метаданные звукозаписи
Чтобы узнать о том, как добавлять метаданные звукозаписи, ознакомьтесь с правилами в этом документе. Метаданные из тега <SoundRecording>
используются в следующих случаях:
- При загрузке контента в систему Content ID. Тогда метаданные будут содержаться в объекте типа "звукозапись".
- При загрузке контента в коллекцию YouTube Premium. В этом случае они будут храниться в объекте типа трек с обложкой.
Право собственности на звукозапись
<RightsController>
, входящем в состав элемента <SoundRecording>
. В соответствии со стандартом DDEX, по тегу <RightsController>
определяется, в каких странах вы обладаете исключительными правами на звукозапись. Эти сведения предоставляются отдельно от предложений в системе Content ID, однако в ней также следует указывать только регионы, где у вас действуют эксклюзивные права на контент. Обратите внимание, что элементы <StartDate>
и <EndDate>
не поддерживаются для тега <RightsController>
.Чтобы добавить в XML-фид информацию о правах на звукозапись, вставьте тег <RightsController>
в элемент <SoundRecording>
. Убедитесь, что идентификатор <PartyId>
совпадает с указанным в теге <MessageSender>
или <SentOnBehalfOf>
.
В приведенном ниже примере содержатся сведения о том, что компания ABC Label владеет правами на звукозапись в ЮАР:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Определяет регионы, в которых действует право собственности
на звукозапись -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- В этом разделе устанавливаются права собственности на звукозапись -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Право собственности на трек с обложкой
<RightsController>
учитываться не будет.Ресурсы музыкальных видео
Тип видео
Тип музыкального видео указывается с помощью тега <VideoType>
. Допускаются следующие типы:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
Идентификаторы музыкальных видео
Каждый элемент <Video>
должен включать действительный код ISRC. В соответствии с правилами стандарта IFPI, этот код ISRC должен отличаться от того, который используется для объекта звукозаписи. Если вы также отслеживаете видеоресурсы с помощью отдельного идентификатора, добавьте тег <ProprietaryId>
вместе с кодом <ISRC>
в элемент <VideoId>
. Вот как выглядит фрагмент XML-фида с тегом <ProprietaryId>:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
Значение отдельного идентификатора сохраняется в поле custom_id объекта типа "музыкальное видео". В приведенном выше примере у объекта будет код ISRC USRE10400889, а идентификатор примет значение custom_id_1234.
Добавить значение custom_id для объекта типа "музыкальное видео" можно с помощью пространства имен YOUTUBE:MV_CUSTOM_ID:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Задает значение поля custom_id для объекта типа "музыкальное видео" -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Если вы хотите обновить данные существующего объекта типа "музыкальное видео", укажите для него идентификатор с помощью пространства имен YOUTUBE:MV_ASSET_ID:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Определяет по идентификатору, какой объект типа "музыкальное видео" будет обновлен -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Добавить ярлыки для объекта типа "музыкальное видео" можно с помощью пространства имен YOUTUBE:MV_ASSET_LABEL:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Добавляет два ярлыка к объекту типа "музыкальное видео" →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Чтобы удалить все ярлыки для объекта типа "музыкальное видео", используйте следующее пространство имен:
YOUTUBE:CLEAR_MV_ASSET_LABELS
<VideoId>
[...]
<!--- Удаляет все ярлыки объекта типа "музыкальное видео" -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_MV_ASSET_LABELS">True</ProprietaryId>
[...]
</VideoId>
Указать канал, на который должно быть загружено видео, можно с помощью пространства имен YOUTUBE:CHANNEL_ID:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Определяет канал, на который будет добавлено видео -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Для всех видео должен быть указан идентификатор канала. Сообщения без него не будут обработаны.
Обновить данные уже загруженного видео можно с помощью пространства имен YOUTUBE:VIDEO_ID:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Чтобы загрузить музыкальное видео с доступом по ссылке, используйте пространство имен “YouTube: IS_DISCOVERBALE”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Метаданные музыкального видео
О том, как добавлять в фид метаданные музыкального видео в соответствии со стандартом DDEX, написано в руководстве, составленном организацией Music Business Association. Ниже приведены элементы тега <Video>
, с помощью которых метаданные видео добавляются на YouTube.
Видео: название | <VideoDetailsByTerritory> |
Видео: теги и ключевые слова | <VideoDetailsByTerritory> |
Объект: композиция | <Video> |
Объект: название звукозаписывающей компании | <VideoDetailsByTerritory> |
Объект: исполнители |
|
Объект: жанр | <VideoDetailsByTerritory> |
Описание видео указывается в элементе <Release>
, а не <Video>
. О списке выпусков рассказывается в этой статье.
Право собственности на музыкальное видео
<RightsController>
, входящем в состав элемента <Video>
. В соответствии со стандартом DDEX, по тегу <RightsController>
определяется, в каких странах вы обладаете исключительными правами на видео. Эти сведения предоставляются отдельно от предложений в системе Content ID, однако в ней также следует указывать только регионы, где у вас действуют эксклюзивные права на контент.Чтобы добавить информацию о правах на музыкальное видео, вставьте тег <RightsController>
в элемент <Video>
. Убедитесь, что идентификатор <PartyId>
совпадает с указанным в теге <MessageSender>
или <SentOnBehalfOf>
.
В приведенном ниже примере содержатся сведения о том, что компания ABC Label владеет правами на объект типа "музыкальное видео" в ЮАР:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Определяет регионы, в которых действует право собственности. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- В этом разделе устанавливается право собственности на объект типа "музыкальное видео" -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Ресурсы интернет-видео
Тип видео
Тип видео указывается с помощью тега <VideoType>
. Допускаются следующие типы:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
Идентификаторы интернет-видео
Если вы отслеживаете видеоресурсы с помощью отдельного идентификатора, добавьте тег <ProprietaryId>
вместе с кодом <ISRC>
в тег <VideoId>
. Вот как выглядит фрагмент XML-фида с тегом <ProprietaryId>:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
Значение отдельного идентификатора сохраняется в поле custom_id объекта типа "интернет-видео". В приведенном выше примере идентификатор примет значение custom_id_1234.
Добавить значение custom_id для объекта типа "интернет-видео" можно с помощью пространства имен YOUTUBE:WEB_CUSTOM_ID:
<VideoId>
<!--- Задает идентификатор объекта типа "интернет-видео" -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
Если вы хотите обновить данные существующего объекта типа "интернет-видео", укажите для него идентификатор с помощью пространства имен YOUTUBE:WEB_ASSET_ID:
<VideoId>
<!--- Определяет по идентификатору, какой типа "интернет-видео" будет обновлен -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Добавить ярлыки для объекта типа "интернет-видео" можно с помощью пространства имен YOUTUBE:WEB_ASSET_LABEL:
<VideoId>
<!--- Добавляет два ярлыка к объекту типа "интернет-видео" →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Указать канал, на который должно быть загружено видео, можно с помощью пространства имен YOUTUBE:CHANNEL_ID:
<VideoId>
<!-- Определяет канал, на который будет добавлено видео -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Для всех видео должен быть указан идентификатор канала. Сообщения без него не будут обработаны.
Обновить данные уже загруженного видео можно с помощью пространства имен YOUTUBE:VIDEO_ID:
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Метаданные интернет-видео
Ниже приведены элементы тега <Video>
, с помощью которых метаданные видео добавляются на YouTube.
Видео: название | <VideoDetailsByTerritory> |
Видео: теги и ключевые слова | <VideoDetailsByTerritory> |
Описание видео указывается в элементе <Release>
, а не <Video>
. О списке выпусков рассказывается в этой статье.
Право собственности на интернет-видео
<RightsController>
, входящем в состав элемента <Video>
. В соответствии со стандартом DDEX, по тегу <RightsController>
определяется, в каких странах вы обладаете исключительными правами на видео. Эти сведения предоставляются отдельно от предложений в системе Content ID, однако в ней также следует указывать только регионы, где у вас действуют эксклюзивные права на контент.Информация о праве собственности на объект типа "интернет-видео" указывается в теге <RightsController>
, входящем в состав элемента <Video>
. Убедитесь, что идентификатор <PartyId>
совпадает с указанным в теге <MessageSender>
или <SentOnBehalfOf>
.
В приведенном ниже примере содержатся сведения о том, что компания ABC Label владеет правами на веб-объект в ЮАР:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Определяет регионы, в которых действует право собственности -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- В этом разделе устанавливается право собственности на объект типа "интернет-видео" -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Как указать аудиторию видео
Как указать аудиторию видео
Как указать, подходит ли видео для детей, при загрузке
Укажите для элемента <AvRating>
значение MadeForKids
или NotMadeForKids
в следующем формате:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
Это поле может быть как обязательным, так и необязательным в зависимости от того, какие настройки по умолчанию заданы на вашем канале.
В каких случаях необязательно указывать, подходит ли контент для детей
- Да, все видео на моем канале предназначены для детей.
- Нет, на моем канале нет контента для детей.
Если вы задали категорию, но система классифицировала ваш контент иначе и вы не согласны с решением, сообщите нам об этом.
Когда нужно указывать, подходит ли ролик для детей
- "Я хочу указать аудиторию каждого ролика отдельно".
Если вы задали категорию, но система классифицировала ваш контент иначе и вы не согласны с решением, сообщите нам об этом.