<ResourceList>
mengandungi butiran tentang sumber utama (rakaman bunyi atau video) dan sumber kedua (kerja seni yang berkaitan) yang membentuk penghantaran. Pada Album Audio 10 runut sebagai contoh, sumber rujukan A1 hingga A10 merupakan rakaman bunyi dan A11 merupakan album kerja seni. YouTube menggunakan album kerja seni sebagai elemen visual utama dalam Runut Seni yang dijana untuk rakaman daripada album ini. Suapan Keluaran Sumber Tunggal tidak seharusnya mengandungi sebarang kerja seni, menurut profil DDEX.
<ResourceList>
. Jika mesej menyertakan berbilang versi metadata untuk suatu runut, YouTube hanya menggunakan versi yang dipaparkan dahulu dalam mesej.Elemen proprietari YouTube
Kembangkan bahagian di bawah untuk mendapatkan gambaran ringkas tentang elemen proprietari YouTube. Gunakan bahagian yang sepadan pada seluruh halaman ini untuk mendapatkan maklumat dan contoh yang lebih terperinci.
Elemen proprietari YouTube
Elemen yang berikut adalah sebahagian daripada ruang nama proprietari YouTube:
Rakaman bunyi
<SoundRecordingId>
[...]
<!--- Sets the custom ID on the Sound Recording asset -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Identifies the Sound Recording asset to be updated by Asset ID -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Adds an asset label to the Sound Recording asset -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Runut seni
<SoundRecordingId>
[...]
<!--- Sets the custom ID on the Art Track asset -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Adds one asset label to the Art Track asset (use
YOUTUBE:CLEAR_AT_ASSET_LABELS to remove all asset labels) -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Video muzik
<VideoId>
[...]
<!--- Sets the custom ID on the Music Video asset -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Identifies the Music Video asset to be updated by Asset ID -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Adds one asset label to the Music Video asset -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Updates a specific Music Video asset -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Specifies the channel to upload the video in -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Video web
<VideoId>
[...]
<!--- Sets the custom ID on the Web Video asset -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Identifies the Web asset to be updated by Asset ID -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222
</ProprietaryId>
<!--- Adds one asset label to the Web Video asset -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Updates a specific Web Video asset -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Specifies the channel to upload the video in -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Senarai main
<CollectionId>
[...]
<ProprietaryId Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-
SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Sumber rakaman bunyi
ID rakaman bunyi
YouTube menghendaki setiap elemen <SoundRecording>
menyertakan kod ISRC yang sah. Jika anda turut menjejaki rakaman menggunakan kod ID proprietari, anda boleh menyertakan elemen <ProprietaryId>
sebagai saudara kepada elemen <ISRC>
dalam <SoundRecordingId>
. Format elemen <ProprietaryId>
ialah:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
DDEX Party ID (Ruang nama) anda dan juga ID proprietari untuk runut diperlukan. YouTube menyimpan nilai ID proprietari dalam medan custom_id aset rakaman bunyi (untuk penghantaran Content ID) dan aset Runut Seni (untuk penghantaran YouTube Premium). Sebagai contoh, XML di atas menghasilkan aset dengan ISRC USRE10400888 dan nilai custom_id custom_id_1234.
Untuk menambahkan nilai custom_id yang berbeza pada aset Rakaman Bunyi dan Runut Seni, anda boleh menggunakan ruang nama khusus "YOUTUBE:SR_CUSTOM_ID" dan "YOUTUBE:AT_CUSTOM_ID" :
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Sets the custom ID on the Sound Recording asset -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Sets the custom ID on the Art Track asset -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Jika anda menghantar kemaskinian kepada aset Rakaman Bunyi yang sedia ada, anda boleh mengenal pasti aset tersebut mengikut ID aset dengan menggunakan ruang nama khusus “YOUTUBE:SR_ASSET_ID”:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Identifies the Sound Recording asset to be updated by Asset ID -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Untuk menambahkan label aset pada aset Rakaman Bunyi dan Runut Seni, anda boleh menggunakan ruang nama khusus ”YOUTUBE:SR_ASSET_LABEL” dan ”YOUTUBE:AT_ASSET_LABEL”:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Adds two asset labels to the Sound Recording asset -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Adds one asset label to the Art Track asset -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Untuk mengalih keluar semua label aset daripada Rakaman Bunyi, anda boleh menggunakan ruang nama khusus
”YOUTUBE:CLEAR_SR_ASSET_LABELS”:
<SoundRecordingId>
[...]
<!--- Removes all asset labels from the Sound Recording asset -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_SR_ASSET_LABELS">True</ProprietaryId>
[...]
</SoundRecordingId>
Metadata rakaman bunyi
Untuk mendapatkan garis panduan tentang cara mengisi metadata Rakaman Bunyi, sila rujuk Panduan Gaya Metadata Muzik daripada Persatuan Perniagaan Muzik. Metadata daripada tag <SoundRecording>
digunakan untuk:
- Penghantaran Content ID: metadata disimpan pada aset Rakaman Bunyi.
- Penghantaran YouTube Premium: Ciptaan dan metadata Runut Seni disimpan pada aset Runut Seni.
Pemilikan rakaman bunyi
<RightsController>
dalam elemen <SoundRecording>
. Menurut standard DDEX, tag <RightsController>
menunjukkan tempat anda memiliki hak eksklusif untuk rakaman. Hal ini bukan sebahagian daripada Tawaran yang disediakan tetapi anda hanya perlu menyediakan tawaran Content ID bagi wilayah yang anda miliki hak eksklusif. Harap maklum bahawa kami tidak menyokong <StartDate>
atau <EndDate>
untuk komposit pengawal <RightsController>
.Pemilikan Rakaman Bunyi digunakan melalui penggunaan tag <RightsController>
dalam elemen <SoundRecording>
. <PartyId>
mestilah sepadan dengan tag<MessageSender>
(atau tag <SentOnBehalfOf>
, jika disediakan).
Contoh XML di bawah menyatakan Label ABC memiliki Rakaman Bunyi di Afrika Selatan:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Specifies the territory/territories in which ownership should
be applied. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- This section sets the ownership of the Sound Recording. -->
<RightsController>
<PartyName>
<FullName>Label ABC</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Pemilikan Runut Seni
<RightsController>
diabaikan dalam suapan yang hanya mencipta Runut Seni.Sumber video muzik
Jenis video
Jenis video boleh ditentukan dengan menggunakan <VideoType>
. Jenis Video Muzik yang dibenarkan ialah:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
ID video muzik
YouTube memerlukan setiap element Video Muzik <Video>
menyertakan kod ISRC yang sah. Kod ISRC ini mestilah berbeza daripada kod yang digunakan untuk rakaman bunyi menurut garis panduan IFPI. Jika anda turut menjejaki sumber video menggunakan kod ID proprietari, anda boleh menyertakan elemen <ProprietaryId>
sebagai saudara kepada elemen <ISRC>
dalam <VideoId>
. Format elemen <ProprietaryId> ialah:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube menyimpan nilai ID proprietari dalam medan custom_id aset video muzik (untuk penghantaran Content ID). Sebagai contoh, XML di atas menghasilkan aset Video Muzik dengan ISRC USRE10400889 dan nilai custom_id custom_id_1234.
Untuk menambahkan nilai custom_id pada aset Video Muzik, anda boleh menggunakan ruang nama khusus "YOUTUBE:MV_CUSTOM_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Sets the custom ID on the Music Video asset -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Jika anda menghantar kemaskinian kepada aset Video Muzik yang sedia ada, anda boleh mengenal pasti aset tersebut mengikut ID aset dengan menggunakan ruang nama khusus “YOUTUBE:MV_ASSET_ID”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Identifies the Music Video asset to be updated by Asset ID -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Untuk menambahkan label aset pada aset Video Muzik, anda boleh menggunakan ruang nama khusus "YOUTUBE:MV_ASSET_LABEL":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Adds two asset labels to the Music Video asset →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Untuk mengalih keluar semua label aset daripada Video Muzik, anda boleh menggunakan ruang nama khusus
”YOUTUBE:CLEAR_MV_ASSET_LABELS”:
<VideoId>
[...]
<!--- Removes all asset labels from the Music Video asset -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_MV_ASSET_LABELS">True</ProprietaryId>
[...]
</VideoId>
Untuk menentukan saluran bagi video yang perlu dimuat naik, anda boleh menggunakan ruang nama khusus "YOUTUBE:CHANNEL_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Specifies the channel to upload the video in -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
ID saluran mestilah dinyatakan untuk semua muat naik video, sebarang mesej tanpa ID saluran tidak akan dapat diproses.
Untuk mengemaskinikan video yang dimuat naik sebelum ini, anda boleh menggunakan ruang nama khusus "YOUTUBE:VIDEO_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Untuk memuat naik Video Muzik sebagai tidak tersenarai, anda boleh menggunakan ruang nama khusus “YouTube: IS_DISCOVERBALE”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Metadata video muzik
Untuk mendapatkan garis panduan tentang cara mengisi metadata Video Muzik dalam DDEX, sila rujuk Panduan Gaya Metadata Muzik daripada Persatuan Perniagaan Muzik. Elemen daripada tag <Video>
yang berikut digunakan untuk mengisi video dan metadata pada YouTube:
Video: Tajuk | <VideoDetailsByTerritory> |
Video: Tag/Kata kunci | <VideoDetailsByTerritory> |
Aset: Runut | <Video> |
Aset: Nama Label | <VideoDetailsByTerritory> |
Aset: Artis |
|
Aset: Genre | <VideoDetailsByTerritory> |
Perihalan video diisi daripada <Release>
, bukan daripada <Video>
. Lihat bahagian Senarai Keluaran untuk mendapatkan maklumat lanjut.
Pemilikan video muzik
<RightsController>
dalam elemen <Video>
. Menurut standard DDEX, tag <RightsController>
menunjukkan tempat anda memiliki hak eksklusif untuk video. Hal ini bukan sebahagian daripada Tawaran yang disediakan tetapi anda hanya perlu menyediakan tawaran Content ID bagi wilayah yang anda miliki hak eksklusif.Pemilikan aset Video Muzik digunakan dengan tag <RightsController>
dalam elemen <Video>
. <PartyId>
mestilah sepadan dengan tag<MessageSender>
(atau tag <SentOnBehalfOf>
, jika disediakan).
Contoh XML di bawah menyatakan bahawa Label ABC memiliki aset Video Muzik di Afrika Selatan:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Specifies the territory/territories in which ownership should be applied. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- This section sets the ownership of the Music Video asset. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Sumber video web
Jenis video
Jenis video boleh ditentukan dengan menggunakan <VideoType>
. Jenis video web yang dibenarkan ialah:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
ID video web
Jika anda menjejaki sumber video menggunakan kod ID proprietari, anda boleh menyertakan elemen <ProprietaryId>
sebagai saudara kepada elemen <ISRC>
dalam <VideoId>
. Format elemen <ProprietaryId> ialah:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube menyimpan nilai ID proprietari dalam medan custom_id aset video web (untuk penghantaran Content ID). Sebagai contoh, XML di atas menghasilkan aset Web dengan nilai custom_id custom_id_1234.
Untuk menambahkan nilai custom_id pada aset Web, anda boleh menggunakan ruang nama khusus "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>
Jika anda menghantar kemaskinian kepada aset Web yang sedia ada, anda boleh mengenal pasti aset tersebut mengikut ID aset dengan menggunakan ruang nama khusus “YOUTUBE:WEB_ASSET_ID”:
<VideoId>
<!--- Identifies the Web asset to be updated by Asset ID -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Untuk menambahkan label aset pada aset Web, anda boleh menggunakan ruang nama khusus "YOUTUBE:WEB_ASSET_LABEL":
<VideoId>
<!--- Adds two asset labels to the Web asset →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Untuk menentukan saluran bagi video yang perlu dimuat naik, anda boleh menggunakan ruang nama khusus "YOUTUBE:CHANNEL_ID":
<VideoId>
<!-- Specifies the channel to upload the video in -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
ID saluran mestilah dinyatakan untuk semua muat naik video, sebarang mesej tanpa ID saluran tidak akan dapat diproses.
Untuk mengemaskinikan video yang dimuat naik sebelum ini, anda boleh menggunakan ruang nama khusus "YOUTUBE:VIDEO_ID":
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Metadata video web
Elemen daripada tag <Video>
yang berikut digunakan untuk mengisi video dan metadata pada YouTube:
Video: Tajuk | <VideoDetailsByTerritory> |
Video: Tag/Kata kunci | <VideoDetailsByTerritory> |
Perihalan video diisi daripada <Release>
, bukan daripada <Video>
. Lihat bahagian Senarai Keluaran untuk mendapatkan maklumat lanjut.
Pemilikan video Web
<RightsController>
dalam elemen <Video>
. Menurut standard DDEX, tag <RightsController>
menunjukkan tempat anda memiliki hak eksklusif untuk video. Hal ini bukan sebahagian daripada Tawaran yang disediakan tetapi anda hanya perlu menyediakan tawaran Content ID bagi wilayah yang anda miliki hak eksklusif.Pemilikan aset Web digunakan melalui penggunaan tag <RightsController>
dalam elemen <Video>
. <PartyId>
mestilah sepadan dengan tag<MessageSender>
(atau tag <SentOnBehalfOf>
, jika disediakan).
Contoh XML di bawah menyatakan Label ABC memiliki aset Web di Afrika Selatan:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Specifies the territory/territories in which ownership should be applied. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- This section sets the ownership of the Web asset. -->
<RightsController>
<PartyName>
<FullName>Label ABC</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Tetapkan khalayak video anda
Tetapkan khalayak video anda
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.
Tetapkan video sebagai dihasilkan untuk kanak-kanak atau tidak dihasilkan untuk kanak-kanak
Untuk memuat naik video bukan Runut Seni (iaitu Video Muzik atau Video Web) sebagai dihasilkan untuk kanak-kanak atau bukan dihasilkan untuk kanak-kanak, gunakan elemen <AvRating>
dengan sama ada MadeForKids
atau NotMadeForKids
mengikut format yang berikut:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
Pengisian medan ini adalah pilihan atau diperlukan, bergantung pada tetapan lalai saluran yang telah anda pilih bagi saluran yang akan digunakan untuk memuat naik video.
Bendera pilihan dihasilkan untuk kanak-kanak
- “Ya, tetapkan saluran ini sebagai dihasilkan untuk kanak-kanak. Saya selalu memuat naik kandungan yang dihasilkan untuk kanak-kanak”.
- “Tidak, tetapkan saluran ini sebagai tidak dihasilkan untuk kanak-kanak. Saya tidak pernah memuat naik kandungan yang dihasilkan untuk kanak-kanak”.
If you've already set your audience for your video and YouTube detects error or abuse, you will see your video marked as “Made for kids - Set by YouTube". You won't be able to change your audience setting. If you disagree, you can use the “Send Feedback” button.
Bendera dihasilkan untuk kanak-kanak diperlukan
- “Saya mahu menyemak tetapan ini bagi setiap video”.
If you've already set your audience for your video and YouTube detects error or abuse, you will see your video marked as “Made for kids - Set by YouTube". You won't be able to change your audience setting. If you disagree, you can use the “Send Feedback” button.