Parametr <ResourceList>
zawiera informacje dotyczące zasobów podstawowych (nagrań dźwiękowych lub filmów) i zasobów dodatkowych (powiązanych grafik), z których składa się dostarczana treść. Na przykład w przypadku albumu zawierającego 10 utworów zasoby referencyjne od A1 do A10 odpowiadają nagraniom dźwiękowym, a zasób A11 to grafika albumu. YouTube wykorzystuje grafikę albumu jako kluczowy element wizualny w wygenerowanych utworach audio dla nagrań z tego albumu. Zgodnie z profilem DDEX pliki danych wydania pojedynczego zasobu nie powinny zawierać żadnych grafik.
<ReleaseList>
YouTube nie obsługuje metadanych dotyczących określonych regionów. Jeśli w wiadomości znajdują się różne wersje metadanych utworu, YouTube użyje tylko wersji, która pojawia się jako pierwsza.Zastrzeżone elementy YouTube
Aby przejrzeć zastrzeżone elementy YouTube, rozwiń poniższą sekcję. W poszczególnych sekcjach na tej stronie znajdziesz bardziej szczegółowe informacje i przykłady.
Zastrzeżone elementy YouTube
Poniższe elementy należą do zastrzeżonej przestrzeni nazw YouTube:
Nagrania dźwiękowe
<SoundRecordingId>
[...]
<!--- Ustawia identyfikator niestandardowy dla zasobu nagrania dźwiękowego -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Rozpoznaje zasób nagrania dźwiękowego, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Dodaje etykietę zasobu do zasobu nagrania dźwiękowego -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Utwory audio
<SoundRecordingId>
[...]
<!--- Ustawia identyfikator niestandardowy dla zasobu utworu audio -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Dodaje 1 etykietę zasobu do zasobu utworu audio (użyj
YOUTUBE:CLEAR_AT_ASSET_LABELS, aby usunąć wszystkie etykiety zasobów) -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Teledyski
<VideoId>
[...]
<!--- Ustawia identyfikator niestandardowy dla zasobu teledysku -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Rozpoznaje zasób teledysku, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Dodaje 1 etykietę zasobu do zasobu teledysku -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Aktualizuje konkretny zasób teledysku -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Określa kanał, na który ma zostać przesłany film -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Filmy internetowe
<VideoId>
[...]
<!--- Ustawia identyfikator niestandardowy dla zasobu wideo -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Rozpoznaje zasób internetowy, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222
</ProprietaryId>
<!--- Dodaje 1 etykietę zasobu do zasobu filmu internetowego -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Aktualizuje konkretny zasób filmu internetowego -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Określa kanał, na który ma zostać przesłany film -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Playlisty
<CollectionId>
[...]
<ProprietaryId Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-
SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Zasoby nagrania dźwiękowego
Identyfikatory nagrania dźwiękowego
YouTube wymaga, aby każdy element <SoundRecording>
zawierał prawidłowy kod ISRC. Jeśli Ty również monitorujesz nagrania, używając zastrzeżonego kodu identyfikacyjnego, możesz uwzględnić element <ProprietaryId>
razem z elementem <ISRC>
w <SoundRecordingId>
. Format elementu <ProprietaryID>
to:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
Zarówno Twój identyfikator DDEX Party (przestrzeń nazw), jak i zastrzeżony identyfikator utworu są wymagane. YouTube przechowuje wartość zastrzeżonego identyfikatora w polu custom_id zasobu nagrania dźwiękowego (dla treści dostarczanych do systemu Content ID) i zasobu utworu audio (dla treści dostarczanych do YouTube Premium). Na przykład powyższy fragment kodu XML tworzy zasób o identyfikatorze ISRC USRE10400888 i o wartości custom_id_1234 w polu custom_id.
Aby dodać różne wartości custom_id do zasobów nagrania dźwiękowego i utworu audio, możesz użyć dedykowanych przestrzeni nazw „YOUTUBE:SR_CUSTOM_ID” i „YOUTUBE:AT_CUSTOM_ID”:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Ustawia identyfikator niestandardowy dla zasobu nagrania dźwiękowego -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Ustawia identyfikator niestandardowy dla zasobu utworu audio -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Jeśli aktualizujesz istniejący zasób nagrania dźwiękowego, możesz wskazać ten zasób, podając jego identyfikator w dedykowanej przestrzeni nazw „YOUTUBE:SR_ASSET_ID”:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Rozpoznaje zasób nagrania dźwiękowego, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Aby dodać etykiety zasobów do zasobów nagrania dźwiękowego i utworu audio, możesz uzyć dedykowanych przestrzeni nazw „YOUTUBE:SR_ASSET_LABEL” i „YOUTUBE:AT_ASSET_LABEL”:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Dodaje 2 etykiety zasobów do zasobu nagrania dźwiękowego -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Dodaje 1 etykietę zasobu do zasobu utworu audio -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Aby usunąć wszystkie etykiety zasobów z nagrania dźwiękowego, możesz użyć dedykowanej
przestrzeni nazw „YOUTUBE:CLEAR_SR_ASSET_LABELS”:
<SoundRecordingId>
[...]
<!--- Usuwa wszystkie etykiety zasobów z zasobu nagrania dźwiękowego -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_SR_ASSET_LABELS">True</ProprietaryId>
[...]
</SoundRecordingId>
Metadane nagrania dźwiękowego
Wytyczne dotyczące wprowadzania metadanych nagrania dźwiękowego znajdziesz w przewodniku Music Metadata Style Guide przygotowanym przez Music Business Association. Metadane z tagu <SoundRecording>
są używane do:
- dostarczania treści do systemu Content ID: metadane są zapisane w zasobie nagrania dźwiękowego;
- dostarczania treści do YouTube Premium: tworzy się utwór audio i metadane są zapisane w zasobie utworu audio.
Własność nagrania dźwiękowego
<RightsController>
w elemencie <SoundRecording>
. Zgodnie ze standardem DDEX tag <RightsController>
informuje o tym, gdzie masz wyłączne prawa do nagrania. Jest to oddzielny element od ofert. Oferty Content ID należy podać tylko w przypadku tych regionów, w których masz wyłączne prawa. Pamiętaj, że w przypadku elementu złożonego <RightsController>
nie obsługujemy właściwości <StartDate>
ani <EndDate>
.Własność nagrania dźwiękowego jest dodawana za pomocą tagu <RightsController>
w elemencie <SoundRecording>
. Parametr <PartyId>
musi odpowiadać temu w tagu <MessageSender>
(lub tagu <SentOnBehalfOf>
, jeśli jest podany).
Poniższy przykładowy fragment kodu XML określa, że ABC Label jest właścicielem nagrania dźwiękowego w Republice Południowej Afryki:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Określa regiony, w których mają zostać zastosowane
prawa własności. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Ta sekcja ustawia własność nagrania dźwiękowego. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Własność utworu audio
<RightsController>
jest ignorowany w plikach danych, które są używane do tworzenia utworu audio.Zasoby teledysków
Typ filmu
Typ filmu można określić za pomocą elementu <VideoType>
. Dozwolone typy teledysków to:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
Identyfikatory teledysków
YouTube wymaga, aby element <Video>
każdego teledysku zawierał prawidłowy kod ISRC. Zgodnie z wytycznymi IFPI ten kod ISRC musi różnić się od kodu używanego w przypadku nagrania dźwiękowego. Jeśli Ty również monitorujesz zasoby wideo, używając zastrzeżonego kodu identyfikacyjnego, możesz uwzględnić element <ProprietaryId>
razem z elementem <ISRC>
w <VideoId>
. Format elementu <ProprietaryID> to:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube przechowuje wartość zastrzeżonego identyfikatora w polu custom_id zasobu teledysku (w przypadku treści dostarczanych do systemu Content ID). Na przykład powyższy fragment kodu XML tworzy zasób teledysku o identyfikatorze ISRC USRE10400889 i o wartości custom_id_1234 w polu custom_id.
Aby dodać wartość custom_id do zasobu teledysku, możesz użyć dedykowanej przestrzeni nazw „YOUTUBE:MV_CUSTOM_ID”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Ustawia identyfikator niestandardowy dla zasobu teledysku -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Jeśli aktualizujesz istniejący zasób teledysku, możesz wskazać ten zasób, podając jego identyfikator w dedykowanej przestrzeni nazw „YOUTUBE:MV_ASSET_ID”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Rozpoznaje zasób teledysku, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Aby dodać etykiety zasobu do zasobu teledysku, możesz użyć przestrzeni nazw „YOUTUBE:MV_ASSET_LABEL”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Dodaje 2 etykiety zasobu do zasobu teledysku →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Aby usunąć wszystkie etykiety zasobów z teledysku, możesz użyć dedykowanej
przestrzeni nazw „YOUTUBE:CLEAR_MV_ASSET_LABELS”:
<VideoId>
[...]
<!--- Usuwa wszystkie etykiety zasobu z zasosobu teledysku -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_MV_ASSET_LABELS">True</ProprietaryId>
[...]
</VideoId>
Aby określić kanał, na który film powinien zostać przesłany, możesz użyć przestrzeni nazw „YOUTUBE:CHANNEL_ID”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Określa kanał, na który ma zostać przesłany film -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
W przypadku wszystkich przesyłanych filmów należy podać identyfikator kanału. Wiadomości bez identyfikatora kanału nie będą przetwarzane.
Aby zaktualizować wcześniej przesłany film, możesz użyć przestrzeni nazw „YOUTUBE:VIDEO_ID”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Aby przesłać teledysk jako niepubliczny, możesz użyć przestrzeni nazw „YouTube: IS_DISCOVERBALE”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Metadane teledysku
Wytyczne dotyczące wprowadzania metadanych teledysku w DDEX znajdziesz w przewodniku Music Metadata Style Guide przygotowanym przez Music Business Association. Metadane filmu w YouTube są wprowadzane przy użyciu tych elementów z tagu <Video>
:
Film: tytuł | <VideoDetailsByTerritory> |
Film: tagi / słowa kluczowe | <VideoDetailsByTerritory> |
Zasób: utwór | <Video> |
Zasób: nazwa wytwórni | <VideoDetailsByTerritory> |
Zasób: wykonawcy |
|
Zasób: gatunek | <VideoDetailsByTerritory> |
Opis filmu jest pobierany z elementu <Release>
, a nie <Video>
. Więcej informacji znajdziesz w sekcji Lista wydań.
Własność teledysku
<RightsController>
umieszczonego w elemencie <Video>
. Zgodnie ze standardem DDEX tag <RightsController>
informuje o tym, gdzie masz wyłączne prawa do filmu. Jest to oddzielny element od ofert. Oferty Content ID należy podać tylko w przypadku tych regionów, w których masz wyłączne prawa.Własność teledysku jest dodawana za pomocą tagu <RightsController>
w elemencie <Video>
. Parametr <PartyId>
musi odpowiadać temu w tagu <MessageSender>
(lub tagu <SentOnBehalfOf>
, jeśli jest podany).
Poniższy przykładowy fragment kodu XML określa, że ABC Label jest właścicielem teledysku w Republice Południowej Afryki:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Określa regiony, w których mają zostać zastosowane prawa własności. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Ta sekcja ustawia własność zasobu teledysku. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Zasoby filmów internetowych
Typ filmu
Typ filmu można określić za pomocą elementu <VideoType>
. Dozwolone typy filmów internetowych to:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
Identyfikatory filmów internetowych
Jeśli monitorujesz zasoby wideo, używając zastrzeżonego kodu identyfikacyjnego, możesz uwzględnić element <ProprietaryId>
razem z elementem <ISRC>
w <VideoId>
. Format elementu <ProprietaryID> to:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube przechowuje wartość zastrzeżonego identyfikatora w polu custom_id zasobu filmu internetowego (w przypadku treści dostarczanych do systemu Content ID). Na przykład powyższy fragment kodu XML przedstawia zasób internetowy o wartości custom_id_1234 w polu custom_id.
Aby dodać wartość custom_id do zasobu internetowego, możesz użyć dedykowanej przestrzeni nazw „YOUTUBE:WEB_CUSTOM_ID”:
<VideoId>
<!--- Sets the custom ID on the Web asset -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
Jeśli aktualizujesz istniejący zasób internetowy, możesz wskazać ten zasób, podając jego identyfikator w dedykowanej przestrzeni nazw „YOUTUBE:WEB_ASSET_ID”:
<VideoId>
<!--- Rozpoznaje zasób internetowy, który ma zostać zaktualizowany, po identyfikatorze zasobu -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Aby dodać etykiety zasobu do zasobu internetowego, możesz użyć przestrzeni nazw „YOUTUBE:WEB_ASSET_LABEL”:
<VideoId>
<!--- Dodaje 2 etykiety zasobów do zasobu internetowego →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Aby określić kanał, na który film powinien zostać przesłany, możesz użyć przestrzeni nazw „YOUTUBE:CHANNEL_ID”:
<VideoId>
<!-- Określa kanał, na który ma zostać przesłany film -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
W przypadku wszystkich przesyłanych filmów należy podać identyfikator kanału. Wiadomości bez identyfikatora kanału nie będą przetwarzane.
Aby zaktualizować wcześniej przesłany film, możesz użyć przestrzeni nazw „YOUTUBE:VIDEO_ID”:
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Metadane filmu internetowego
Metadane filmu w YouTube są wprowadzane przy użyciu tych elementów z tagu <Video>
:
Film: tytuł | <VideoDetailsByTerritory> |
Film: tagi / słowa kluczowe | <VideoDetailsByTerritory> |
Opis filmu jest pobierany z elementu <Release>
, a nie <Video>
. Więcej informacji znajdziesz w sekcji Lista wydań.
Własność filmu internetowego
<RightsController>
umieszczonego w elemencie <Video>
. Zgodnie ze standardem DDEX tag <RightsController>
informuje o tym, gdzie masz wyłączne prawa do filmu. Jest to oddzielny element od ofert. Oferty Content ID należy podać tylko w przypadku tych regionów, w których masz wyłączne prawa.Własność zasobu internetowego jest dodawana za pomocą tagu <RightsController>
w elemencie <Video>
. Parametr <PartyId>
musi odpowiadać temu w tagu <MessageSender>
(lub tagu <SentOnBehalfOf>
, jeśli jest podany).
Poniższy przykładowy fragment kodu XML określa, że ABC Label jest właścicielem zasobu internetowego w Republice Południowej Afryki:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Określa regiony, w których mają zostać zastosowane prawa własności. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Ta sekcja okreśła własność zasobu internetowego. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Określanie odbiorców filmu
Określanie odbiorców filmu
Jak oznaczyć film jako przeznaczony lub nieprzeznaczony dla dzieci
Aby przesłać film bez utworu audio (np. teledysk lub film internetowy) jako przeznaczony lub nieprzeznaczony dla dzieci, użyj elementu <AvRating>
razem z oznaczeniem MadeForKids
lub NotMadeForKids
w tym formacie:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
To pole jest opcjonalne lub wymagane w zależności od domyślnego ustawienia kanału, na który film zostanie przesłany.
Opcjonalna flaga „Przeznaczone dla dzieci”
- „Tak, oznacz ten kanał jako przeznaczony dla dzieci. Zawsze przesyłam treści przeznaczone dla dzieci”.
- „Nie, oznacz ten kanał jako nieprzeznaczony dla dzieci. Nigdy nie przesyłam treści przeznaczonych dla dzieci”.
Jeśli masz już ustawionych odbiorców swojego filmu, a YouTube wykryje jakiś błąd lub naruszenie, z którym się nie zgadzasz, możesz użyć przycisku „Prześlij opinię”.
Wymagana flaga „Przeznaczone dla dzieci”
- „Chcę sprawdzać to ustawienie dla każdego filmu”.
Jeśli masz już ustawionych odbiorców swojego filmu, a YouTube wykryje jakiś błąd lub naruszenie, z którym się nie zgadzasz, możesz użyć przycisku „Prześlij opinię”.