Елемент <ResourceList>
містить інформацію про основні та другорядні ресурси для завантаження контенту (як-от звукозаписи або відео та зв’язану обкладинку). Наприклад, у фіді профілю Audio Album (Аудіоальбом), що містить 10 композицій, звукозаписи будуть цифровими відбитками від A1 до A10, а обкладинка альбому – відбитком A11. YouTube використовує обкладинку як основний візуальний елемент об’єкта "Музика з обкладинкою альбому". Зверніть увагу: відповідно до вимог DDEX фіди профілю Single Resource Release (Випуск одного ресурсу) не мають містити обкладинок альбому.
<ResourceList>
не підтримує метадані за територіями. Якщо повідомлення містить кілька версій метаданих для композиції, YouTube використовує лише версію, яку вказано першою.Елементи, що належать 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>
Ресурси звукозапису
Ідентифікатори звукозапису
Згідно з вимогами YouTube кожен елемент <SoundRecording>
має містити дійсний код ISRC. Якщо ви відстежуєте звукозаписи за допомогою власного коду ідентифікатора, додайте тег <ProprietaryId>
разом із тегом <ISRC>
в елемент <SoundRecordingId>
. Формат елемента <ProprietaryId>
виглядає так:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
Для композиції потрібно вказати як ідентифікатор DDEX Party (простір імен), так і власний ідентифікатор. YouTube зберігає значення власного ідентифікатора в полі custom_id об’єкта "Звукозапис" (для надсилання контенту в систему Content ID) і об’єкта "Музика з обкладинкою альбому" (для завантаження в YouTube Premium). Наприклад, наведений вище фід XML створює об'єкт, для якого код ISRC має значення USRE10400888, а поле custom_id – custom_id_1234.
Щоб додати різні значення поля custom_id для об’єктів "Звукозапис" і "Музика з обкладинкою альбому", використовуйте спеціальні простори імен "YOUTUBE:SR_CUSTOM_ID" та "YOUTUBE:AT_CUSTOM_ID".
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Указує значення користувацького ідентифікатора для об'єкта "Звукозапис" -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Указує значення користувацького ідентифікатора для об'єкта "Музика з обкладинкою альбому" -->
<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: метадані зберігатимуться в об’єкті Музика з обкладинкою альбому.
Право власності на звукозапис
<RightsController>
в елементі <SoundRecording>
. Відповідно до стандарту DDEX тег <RightsController>
указує території, де ви володієте виключними правами на звукозапис. Ці дані надаються окремо від угод у системі Content ID, однак у ній потрібно вказувати угоди лише для територій, де у вас є виключні права на контент.Щоб застосувати право власності на звукозапис, додайте тег <RightsController>
в елемент <SoundRecording>
. Ідентифікатор <PartyId>
має збігатися зі значенням тегу <MessageSender>
або <SentOnBehalfOf>
.
У наведеному нижче фіді XML указано, що компанія 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>
ігноруватиметься.Ресурси музичного відео
Тип відео
Tип відео можна вказати за допомогою елемента <VideoType>
. Нижче наведено дозволені типи музичних відео.
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
Ідентифікатори музичних відео
Згідно з вимогами YouTube кожний елемент музичного відео <Video>
має містити відповідний код ISRC. Відповідно до правил IFPI код ISRC має відрізнятися від того, що використовується для об’єкта "Звукозапис". Якщо ви також відстежуєте відеоресурси за допомогою власного ідентифікатора, додайте тег <ProprietaryId>
разом із кодом <ISRC>
в елемент <VideoId>
. Формат елемента <ProprietaryId> виглядає так:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube зберігає значення власного ідентифікатора в полі custom_id об’єкта "Музичне відео" (для надсилання контенту в систему Content ID). Наприклад, наведений вище фід XML створює об'єкт "Музичне відео", для якого код ISRC має значення USRE10400889, а поле custom_id – custom_id_1234.
Щоб додати значення поля custom_id для об’єкта "Музичне відео", використовуйте простір імен "YOUTUBE:MV_CUSTOM_ID".
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Указує значення користувацького ідентифікатора для об’єкта "Музичне відео" -->
<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 Metadata Style Guide ("Оформлення метаданих музики"), створений організацією Music Business Association. Нижче наведено елементи тегу <Video>
, що використовуються для додавання відео й метаданих на YouTube.
Відео: назва | <VideoDetailsByTerritory> |
Відео: теги й ключові слова | <VideoDetailsByTerritory> |
Об’єкт: композиція | <Video> |
Об’єкт: назва мітки | <VideoDetailsByTerritory> |
Об’єкт: виконавці |
|
Об’єкт: жанр | <VideoDetailsByTerritory> |
Опис відео вказується в елементі <Release>
, а не <Video>
. Докладніше про список випусків.
Право власності на музичне відео
<RightsController>
в елементі <Video>
. Відповідно до стандарту DDEX тег <RightsController>
указує території, де ви володієте виключними правами на відео. Ці дані надаються окремо від угод у системі Content ID, однак у ній потрібно вказувати угоди лише для територій, де у вас є виключні права на контент.Щоб застосувати право власності на об’єкт "Музичне відео", додайте тег <RightsController>
в елемент <Video>
. Ідентифікатор <PartyId>
має збігатися зі значенням тегу <MessageSender>
або <SentOnBehalfOf>
.
У наведеному нижче фіді XML указано, що компанія 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>
Ресурси веб-відео
Тип відео
Tип відео можна вказати за допомогою елемента <VideoType>
. Нижче наведено дозволені типи веб-відео.
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
Ідентифікатори веб-відео
Якщо ви також відстежуєте відеоресурси за допомогою власного ідентифікатора, додайте тег <ProprietaryId>
разом із кодом <ISRC>
в елемент <VideoId>
. Формат елемента <ProprietaryId> виглядає так:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube зберігає значення власного ідентифікатора в полі custom_id об’єкта "Вебвідео" (для надсилання контенту в систему Content ID). Наприклад, наведений вище фід XML створює об'єкт "Веб-відео", для якого поле 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>
.
У наведеному нижче фіді XML указано, що компанія 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>
Це поле може бути обов’язковим або ні, залежно від налаштувань за умовчанням для каналу, у який ви завантажуєте відео.
Коли необов’язково вказувати, чи призначений контент для дітей
- "Так, позначити цей канал як призначений для дітей. Я завантажую контент лише для дітей."
- "Ні, позначити цей канал як не призначений для дітей. Я не завантажую контент для дітей".
Якщо ви вказали цільову аудиторію для відео, але наша система виявила помилку чи порушення, ви можете спробувати оскаржити це рішення, натиснувши кнопку "Надіслати відгук".
Коли обов’язково вказувати, чи призначений контент для дітей
- "Я хочу перевіряти це налаштування для кожного відео".
Якщо ви вказали цільову аудиторію для відео, але наша система виявила помилку чи порушення, ви можете спробувати оскаржити це рішення, натиснувши кнопку "Надіслати відгук".