Список ресурсов

Функции, описанные в этой статье, доступны только партнерам YouTube, которые пользуются системой управления контентом для работы с материалами, защищенными авторским правом.

Элемент <ResourceList> содержит сведения о звукозаписях или видео и связанных с ними обложках альбома. Например, в аудиоальбоме из десяти треков дорожки будут представлены отпечатками от A1 до A10, а обложка – отпечатком А11. Это изображение нужно системе YouTube, чтобы создать объект "музыка с обложкой альбома". Помните, что по правилам DDEX в фиды Single Resource Release не нужно включать обложки альбомов.

Не добавляйте в элемент <ResourceList> несколько версий метаданных для разных стран. Если так сделать, пользователям будет виден только вариант, указанный первым.

Элементы, принадлежащие YouTube

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

Элементы, принадлежащие YouTube

Ниже перечислены элементы, которые являются частью пространства имен YouTube.

Звукозаписи

<SoundRecordingId> [...]  <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> [...]  <ProprietaryId Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>

 <ProprietaryId Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId> [...] </SoundRecordingId>

Видеоклипы

<VideoId> [...]  <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> [...]  <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>

Метаданные звукозаписи

Чтобы узнать о том, как добавлять метаданные звукозаписи, ознакомьтесь с правилами в этом документе. Метаданные из тега <SoundRecording> используются в следующих случаях:

При загрузке контента в систему Content ID. Тогда метаданные будут содержаться в объекте типа "звукозапись".
При загрузке контента в коллекцию YouTube Premium. В этом случае они будут храниться в объекте типа трек с обложкой.

Право собственности на звукозапись

По стандарту DDEX информация о том, в каких странах вы обладаете исключительными правами на звукозапись, указываются с помощью тега <RightsController>. Он добавляется в элемент <SoundRecording>. Эти сведения предоставляются отдельно от предложений в системе Content ID, однако в ней также следует указывать только регионы, где у вас действуют эксклюзивные права на контент.

Заявить права собственности на звукозапись можно двумя способами. Необходимо отправить либо фид Single Resource Release, либо фид Audio Album. При этом элемент MessageRecipient должен иметь значение YouTube_ContentID.

Чтобы добавить в 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>

Право собственности на трек с обложкой

На музыку с обложкой альбома заявляются права, передаваемые по лицензии, поэтому объекты такого типа не используются в системе Content ID, а сведения о них получаются из предложений. Если загрузить фид только с данными о музыке с обложкой альбома, элемент <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: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> [...] <Title TitleType="DisplayTitle"> <TitleText>A little bit of Foo</TitleText> </Title> [...] </VideoDetailsByTerritory>`
Видео: теги и ключевые слова	`<VideoDetailsByTerritory> [...] <Keywords>Keyword1</Keywords> <Keywords>Keyword2</Keywords> [...] </VideoDetailsByTerritory>`
Объект: композиция	`<Video> [...] <ReferenceTitle> <TitleText>A little bit of Foo</TitleText> </ReferenceTitle> [...] </Video>`
Объект: название звукозаписывающей компании	`<VideoDetailsByTerritory> [...] <LabelName>Test Label</LabelName> [...] </VideoDetailsByTerritory>`
Объект: исполнители	`<VideoDetailsByTerritory> [...] <DisplayArtist SequenceNumber="1"> <PartyName> <FullName>Jonny and the Føøbars</FullName> </PartyName> <ArtistRole>MainArtist</ArtistRole> </DisplayArtist>` `<DisplayArtist SequenceNumber="2"> <PartyName> <FullName>Some Other Artist</FullName> </PartyName> <ArtistRole>MainArtist</ArtistRole> </DisplayArtist> [...] </VideoDetailsByTerritory>`
Объект: жанр	`<VideoDetailsByTerritory> [...] <Genre> <GenreText>Hip Hop</GenreText> </Genre> [...] </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> [...] <Title TitleType="DisplayTitle"> <TitleText>A little bit of Foo</TitleText> </Title> [...] </VideoDetailsByTerritory>`
Видео: теги и ключевые слова	`<VideoDetailsByTerritory> [...] <Keywords>Keyword1</Keywords> <Keywords>Keyword2</Keywords> [...] </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>

Как указать аудиторию видео

В соответствии с Законом США о защите личных сведений детей в Интернете (COPPA) и другими законодательными актами, вы должны указывать, предназначены ли ваши ролики для детей. Это требование распространяется на всех авторов вне зависимости от страны проживания.

Как указать, подходит ли видео для детей, при загрузке

Укажите для элемента <AvRating> значение MadeForKids или NotMadeForKids в следующем формате:

<VideoDetailsByTerritory> <TerritoryCode>Worldwide</TerritoryCode> [...] <AvRating> <RatingText>MadeForKids</RatingText> <RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency> </AvRating> [...] </VideoDetailsByTerritory>

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

В каких случаях необязательно указывать, подходит ли контент для детей

Автор может не указывать, подходит ли его видео для детей, если для его канала по умолчанию применен один из этих параметров:

Да, все видео на моем канале предназначены для детей.
Нет, на моем канале нет контента для детей.

Примечание. Мы также будем использовать машинное обучение, чтобы находить ролики, явно предназначенные для детей. Мы рассчитываем, что вы сможете самостоятельно оценивать свои видео и отмечать те из них, что нацелены на детскую аудиторию. Имейте в виду, что делать это нужно без ошибок и намеренных искажений информации. В противном случае указанная вами аудитория может быть изменена, а мы можем принять меры в отношении вашего аккаунта. Однако не полагайтесь на результаты работы наших автоматических систем – они могут не выявить контент, который Федеральная торговая комиссия США и иные органы считают предназначенным для детей. Кроме того, возможны другие юридические последствия. Если вы не знаете, к какой категории относится ваш контент, изучите эту статью или обратитесь к юристу.

Если вы задали категорию, но система классифицировала ваш контент иначе и вы не согласны с решением, сообщите нам об этом.

Когда нужно указывать, подходит ли ролик для детей

Выбирать аудиторию видео требуется, если на уровне канала установлена следующая настройка:

"Я хочу указать аудиторию каждого ролика отдельно".

Эта информация оказалась полезной?

Как можно улучшить эту статью?