De <ResourceList>
bevat gegevens over de primaire bronnen (geluidsopnamen of video's) en de secundaire bronnen (bijbehorende afbeeldingen) die samen de levering vormen. Op een Audio Album met tien tracks zijn bronvermeldingen A1 tot en met A10 bijvoorbeeld de geluidsopnamen en is A11 de albumhoes. YouTube gebruikt de albumhoes als een belangrijk visueel element in de gegenereerde art-tracks voor de opnamen in dit album. Single Resource Release-feeds mogen geen afbeeldingen bevatten, in overeenstemming met het DDEX-profiel.
<ResourceList>
. Als het bericht meerdere versies van de metadata voor een track bevat, wordt alleen de eerste versie in het bericht gebruikt.De eigendomselementen van YouTube
Vouw het onderstaande gedeelte uit voor een kort overzicht van de eigendomselementen van YouTube. Gebruik de bijhorende gedeelten van deze pagina voor meer gedetailleerde informatie en voorbeelden.
De eigendomselementen van YouTube
De volgende elementen zijn deel van de naamruimte voor eigendomselementen van YouTube:
Geluidsopnamen
<SoundRecordingId>
[...]
<!--- Stelt de aangepaste ID in voor het geluidsopname-item -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Identificeert het te updaten geluidsopname-item via item-ID -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Voegt een itemlabel toe aan het geluidsopname-item -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Art-tracks
<SoundRecordingId>
[...]
<!--- Stelt de aangepaste ID in voor het art-track-item -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Voegt een itemlabel toe aan het art-track-item (gebruik
YOUTUBE:CLEAR_AT_ASSET_LABELS om alle itemlabels te verwijderen) -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Muziekvideo's
<VideoId>
[...]
<!--- Stelt de aangepaste ID in voor het muziekvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Identificeert het te updaten muziekvideo-item via item-ID -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Voegt een itemlabel toe aan een muziekvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Updatet een specifiek muziekvideo-item -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Geeft aan naar welk kanaal de video moet worden geüpload -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Webvideo's
<VideoId>
[...]
<!--- Stelt de aangepaste ID in voor het webvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Identificeert het te updaten webitem via item-ID -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A22222222222222
</ProprietaryId>
<!--- Voegt een itemlabel toe aan een webvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Updatet een specifiek webvideo-item -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Geeft aan naar welk kanaal de video moet worden geüpload -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Playlists
<CollectionId>
[...]
<ProprietaryId
Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Geluidsopnamebronnen
Geluidsopname-ID's
Op YouTube moet elk <SoundRecording>
-element een geldige ISRC-code hebben. Als je daarnaast opnamen monitort met een eigendoms-ID-code, kun je het element <ProprietaryId>
toevoegen op gelijk niveau als het element <ISRC>
in <SoundRecordingId>
. De structuur van het element <ProprietaryId>
is:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
Zowel je partij-ID van DDEX (naamruimte) als de eigendoms-ID van de track is vereist. YouTube slaat de waarde van de eigendoms-ID op in het veld custom_id van het geluidsopname-item (voor Content ID-leveringen) en het art-track-item (voor YouTube Premium-leveringen). De XML hierboven resulteert bijvoorbeeld in een item met ISRC USRE10400888 en custom_id custom_id_1234.
Gebruik de speciale naamruimten 'YOUTUBE:SR_CUSTOM_ID' en 'YOUTUBE:AT_CUSTOM_ID' als je andere waarden voor custom_id aan de geluidsopname en art-track wilt toevoegen:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Stelt de aangepaste ID in voor het geluidsopname-item -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Stelt de aangepaste ID in voor het art-track-item -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Als je een bestaand geluidsopname-item updatet, kun je het item herkennen aan item-ID door de speciale naamruimte 'YOUTUBE:SR_ASSET_ID' te gebruiken:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Geeft aan wat het te updaten geluidsopname-item via de item-ID is -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Als je itemlabels wilt toevoegen aan de items geluidsopname en art-track, kun je de speciale naamruimten 'YOUTUBE:SR_ASSET_LABEL' en 'YOUTUBE:AT_ASSET_LABEL' gebruiken:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Voegt 2 itemlabels toe aan het geluidsopname-item -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Voegt 1 itemlabel toe aan het art-track-item -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Als je alle itemlabels uit de geluidsopname wilt verwijderen, gebruik je de speciale naamruimte
'YOUTUBE:CLEAR_SR_ASSET_LABELS':
<SoundRecordingId>
[...]
<!--- Verwijdert alle itemlabels uit het geluidsopname-item -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_SR_ASSET_LABELS">True</ProprietaryId>
[...]
</SoundRecordingId>
Metadata voor geluidsopnamen
Check de Music Metadata Style Guide (Stijlgids voor muziekmetadata) van de Music Business Association voor richtlijnen voor het invullen van de metadata voor geluidsopnamen. De metadata van de tag <SoundRecording>
worden gebruikt voor:
- Content ID-leveringen: metadata worden opgeslagen op het geluidsopname-item.
- YouTube Premium-leveringen: art-tracks worden gemaakt en metadata worden opgeslagen op het art-track-item.
Eigendom van geluidsopnamen
<RightsController>
onder het element <SoundRecording>
. In overeenstemming met de DDEX-standaard geeft de tag <RightsController>
aan waar je de exclusieve rechten voor de opname bezit. Dit staat los van de geboden deals, maar je moet alleen Content ID-deals aanbieden voor territoriums waar je de exclusieve rechten bezit. We ondersteunen geen <StartDate>
of <EndDate>
voor de controllersamenstelling <RightsController>
.Het eigendom van geluidsopnamen wordt toegepast met de tag <RightsController>
onder het element <SoundRecording>
. De <PartyId>
moet overeenkomen met de tag <MessageSender>
(of de tag <SentOnBehalfOf>
, als deze is opgegeven).
In het voorbeeld hieronder wordt in de XML opgegeven dat ABC Label eigenaar is van de geluidsopname in Zuid-Afrika:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Geeft aan op welk territorium of welke territoriums het eigendom moet
worden toegepast. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Dit gedeelte stelt het eigendom van de geluidsopname in. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Eigendom van art-tracks
<RightsController>
wordt genegeerd in feeds die alleen art-tracks maken.Muziekvideobronnen
Videotype
Het videotype kan gespecificeerd worden met <VideoType>
. De ondersteunde typen zijn:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
Muziekvideo-ID's
Op YouTube moet elk <Video>
-element van muziekvideo's een geldige ISRC-code hebben. Deze ISRC-code mag niet overeenkomen met de code die voor de geluidsopname is gebruikt, in overeenstemming met de IFPI-richtlijnen. Als je daarnaast videobronnen monitort met een eigendoms-ID-code, kun je het element <ProprietaryId>
toevoegen op gelijk niveau als het element <ISRC>
in <VideoId>
. De structuur van het element <ProprietaryId> is:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube slaat de waarde van de eigendoms-ID op in het veld custom_id van het muziekvideo-item (voor Content ID-leveringen). De XML hierboven resulteert bijvoorbeeld in een muziekvideo-item met ISRC USRE10400889 en custom_id custom_id_1234.
Gebruik de speciale naamruimte 'YOUTUBE:MV_CUSTOM_ID' om een waarde voor custom_id toe te voegen aan het muziekvideo-item:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Stelt de aangepaste ID in voor een muziekvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Als je een bestaand muziekvideo-item updatet, kun je het item identificeren via item-ID door de speciale naamruimte 'YOUTUBE:MV_ASSET_ID' te gebruiken:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Geeft aan wat het te updaten muziekvideo-item via item-ID is -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Gebruik de speciale naamruimte 'YOUTUBE:MV_ASSET_LABEL' als je itemlabels aan het muziekvideo-item wilt toevoegen:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Voegt 2 itemlabels toe aan het muziekvideo-item →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Als je alle itemlabels uit de muziekvideo wilt verwijderen, gebruik je de speciale naamruimte
'YOUTUBE:CLEAR_MV_ASSET_LABELS':
<VideoId>
[...]
<!--- Verwijdert alle itemlabels van het muziekvideo-item -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_MV_ASSET_LABELS">True</ProprietaryId>
[...]
</VideoId>
Gebruik de speciale naamruimte 'YOUTUBE:CHANNEL_ID' om aan te geven naar welk kanaal je de video wilt uploaden:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Geeft aan naar welk kanaal de video moet worden geüpload -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Geef voor alle video-uploads een kanaal-ID op. Berichten zonder kanaal-ID worden niet verwerkt.
Gebruik de speciale naamruimte 'YOUTUBE:VIDEO_ID' als je een eerder geüploade video wilt updaten:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Als je een muziekvideo als verborgen wilt uploaden, kun je de speciale naamruimte YOUTUBE: IS_DISCOVERABLE gebruiken:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Metadata voor muziekvideo's
Check de Music Metadata Style Guide (Stijlgids voor muziekmetadata) van de Music Business Association voor richtlijnen voor het invullen van de metadata voor muziekvideo's in DDEX. De volgende elementen uit de tag <Video>
worden gebruikt om videogegevens en metadata in te vullen op YouTube:
Video: titel | <VideoDetailsByTerritory> |
Video: tags/zoekwoorden | <VideoDetailsByTerritory> |
Item: nummer | <Video> |
Item: labelnaam | <VideoDetailsByTerritory> |
Item: artiesten |
|
Item: genre | <VideoDetailsByTerritory> |
De videobeschrijving wordt opgehaald uit <Release>
en niet uit <Video>
. Zie het gedeelte Releaselijst voor meer informatie.
Eigendom van muziekvideo
<RightsController>
onder het element <Video>
. In overeenstemming met de DDEX-standaard geeft de tag <RightsController>
aan waar je de exclusieve rechten voor de video bezit. Dit staat los van de geboden deals, maar je moet alleen Content ID-deals aanbieden voor territoriums waar je de exclusieve rechten bezit.Het eigendom van muziekvideo-items wordt toegekend met de tag <RightsController>
onder het element <Video>
. De <PartyId>
moet overeenkomen met de tag <MessageSender>
(of de tag <SentOnBehalfOf>
, als deze is opgegeven).
In het voorbeeld hieronder wordt in de XML opgegeven dat ABC Label eigenaar is van het muziekvideo-item in Zuid-Afrika:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Geeft aan voor welk gebied/welke gebieden het eigendom geldt. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Met dit gedeelte stel je het eigendom van het muziekvideo-item in. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Webvideobronnen
Videotype
Het videotype kan gespecificeerd worden met <VideoType>
. De ondersteunde typen zijn:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
Webvideo-ID's
Als je videobronnen monitort met een eigendoms-ID-code, kun je het element <ProprietaryId>
toevoegen op hetzelfde niveau als het element <ISRC>
in <VideoId>
. De structuur van het element <ProprietaryId> is:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube slaat de waarde van de eigendoms-ID op in het veld custom_id van het webvideo-item (voor Content ID-leveringen). De XML hierboven resulteert bijvoorbeeld in een webitem met custom_id custom_id_1234.
Gebruik de speciale naamruimte 'YOUTUBE:WEB_CUSTOM_ID' om een waarde voor het veld custom_id toe te voegen aan het webitem:
<VideoId>
<!--- Hiermee stel je een aangepaste ID in voor het webitem -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
Als je een bestaand webitem updatet, kun je het item via item-ID identificeren door de speciale naamruimte 'YOUTUBE:WEB_ASSET_ID' te gebruiken:
<VideoId>
<!--- Hiermee geef je aan welk webitem moet worden geüpdatet via de item-ID -->
<ProprietaryId Namespace="YOUTUBE:WEB_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Gebruik de speciale naamruimte 'YOUTUBE:WEB_ASSET_LABEL' om itemlabels toe te voegen aan het webitem:
<VideoId>
<!--- Hiermee voeg je 2 itemlabels toe aan het webitem →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Gebruik de speciale naamruimte 'YOUTUBE:CHANNEL_ID' om aan te geven naar welk kanaal je de video wilt uploaden:
<VideoId>
<!-- Hiermee geef je aan naar welk kanaal de video moet worden geüpload -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Geef voor alle video-uploads een kanaal-ID op. Berichten zonder kanaal-ID worden niet verwerkt.
Gebruik de speciale naamruimte 'YOUTUBE:VIDEO_ID' als je een eerder geüploade video wilt updaten:
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Metadata voor webvideo's
De volgende elementen uit de tag <Video>
worden gebruikt om videogegevens en metadata in te vullen op YouTube:
Video: titel | <VideoDetailsByTerritory> |
Video: tags/zoekwoorden | <VideoDetailsByTerritory> |
De videobeschrijving wordt opgehaald uit <Release>
en niet uit <Video>
. Zie het gedeelte Releaselijst voor meer informatie.
Eigendom van webvideo's
<RightsController>
onder het element <Video>
. In overeenstemming met de DDEX-standaard geeft de tag <RightsController>
aan waar je de exclusieve rechten voor de video bezit. Dit staat los van de geboden deals, maar je moet alleen Content ID-deals aanbieden voor territoriums waar je de exclusieve rechten bezit.Het eigendom van webitems wordt toegepast met de tag <RightsController>
onder het element <Video>
. De <PartyId>
moet overeenkomen met de tag <MessageSender>
(of de tag <SentOnBehalfOf>
, als deze is opgegeven).
In het voorbeeld hieronder wordt in de XML opgegeven dat ABC Label eigenaar is van het webitem in Zuid-Afrika:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Geeft aan voor welk gebied/welke gebieden het eigendom geldt. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- In dit gedeelte stel je het eigendom van het webitem in. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Heb publiek van je video instellen
Het publiek van je video instellen
Regardless of your location, you’re legally required to comply with the Children’s Online Privacy Protection Act and/or other laws. You’re required to tell us that your videos are made for kids if you make kids content.
Een video instellen als wel of niet gemaakt voor kinderen
Als je een video zonder art-track (zoals een muziekvideo of webvideo) wilt uploaden als wel of niet gemaakt voor kinderen, gebruik je het element <AvRating>
met MadeForKids
of NotMadeForKids
, met deze indeling:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
Het veld kan optioneel of verplicht zijn, afhankelijk van de gekozen standaardinstelling voor het kanaal waarnaar je de video uploadt.
Optionele markering 'gemaakt voor kinderen'
- Ja, stel dit kanaal in als 'gemaakt voor kinderen'. Ik upload altijd content die is gemaakt voor kinderen.
- Nee, stel dit kanaal niet in als 'gemaakt voor kinderen'. Ik upload nooit content die is gemaakt voor kinderen.
Vereiste markering 'gemaakt voor kinderen'
- Ik wil deze instelling per video beoordelen.