<ResourceList>
包含主要資源 (錄音內容或影片) 的詳細資料,以及構成交付內容的次要資源 (相關圖片)。舉例來說,在一張有 10 首曲目的 Audio Album (音訊專輯) 中,A1 到 A10 的資源參考檔案均為錄音內容,A11 則是專輯圖片。針對專輯中的錄音內容,在產生的 Art Track 中,YouTube 會以專輯圖片做為重要的視覺元素。根據 DDEX 的設定檔規定,Single Resource Release (單曲資源發行內容) 動態饋給不得含有任何圖片。
<ResourceList>
中,YouTube 不支援因地區而異的中繼資料。如果訊息中的某首曲目含有多個版本的中繼資料,YouTube 只會使用訊息中最先出現的版本。YouTube 專屬元素
展開下方的專區,即可快速查看 YouTube 的專屬元素。請在本頁參閱相應專區的內容,瞭解更多詳細資訊與範例。
YouTube 專屬元素
以下元素是 YouTube 專屬命名空間的一部分:
錄音內容
<SoundRecordingId>
[...]
<!--- 為錄音資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- 依資產 ID 找到要更新的錄音資產 -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- 為錄音資產加上一項資產標籤 -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Art Track
<SoundRecordingId>
[...]
<!--- 為 Art Track 資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- 為 Art Track 資產加上一項資產標籤 -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
音樂影片
<VideoId>
[...]
<!--- 為 MV 資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- 依資產 ID 找到要更新的 MV 資產 -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- 為 MV 資產加上一項資產標籤 -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- 更新特定的 MV 資產 -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- 指定要上傳影片的目的地頻道 -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
網路影片
<VideoId>
[...]
<!--- 為網路影片資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- 依資產 ID 找到要更新的網路資產 -->
<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>
錄音資源
錄音內容 ID
根據 YouTube 的規定,所有 <SoundRecording>
元素都必須包含有效的 ISRC 代碼。如果同時使用專屬 ID 代碼來追蹤錄音內容,可在 <SoundRecordingId>
內加入 <ProprietaryId>
元素,做為 <ISRC>
元素的同類項目。<ProprietaryId>
元素的格式如下所示:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
請一併提供 DDEX Party ID (命名空間) 和曲目的專屬 ID。YouTube 會將專屬 ID 值儲存在錄音資產 (適用於 Content ID 交付內容) 和 Art Track 資產 (適用於 YouTube Premium 交付內容) 的「custom_id」欄位中。舉例來說,上述 XML 會產生 ISRC 為「USRE10400888」且 custom_id 值為「custom_id_1234」的資產。
如要在錄音資產和 Art Track 資產中加入不同的「custom_id」值,可以使用專屬的「YOUTUBE:SR_CUSTOM_ID」和「YOUTUBE:AT_CUSTOM_ID」命名空間:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- 為錄音資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- 為 Art Track 資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
如要傳送更新至現有的錄音資產,可以使用專屬的「YOUTUBE:SR_ASSET_ID」命名空間,依資產 ID 找到該資產:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- 依資產 ID 找到要更新的錄音資產 -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
如要為錄音資產和 Art Track 資產新增資產標籤,請使用專屬的「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>
<!--- 為 Art Track 資產加上一項資產標籤 -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
錄音內容中繼資料
如要瞭解填入錄音內容中繼資料的相關規範,請參閱 Music Business Association 提供的 Music Metadata Style Guide (音樂中繼資料樣式指南)。<SoundRecording>
標記的中繼資料用於以下兩者:
- Content ID 交付內容:儲存在錄音資產中的中繼資料。
- YouTube Premium 交付內容:儲存在 Art Track 資產中的 Art Track 建立資訊和中繼資料。
錄音內容擁有權
<SoundRecording>
元素中使用 <RightsController>
標記即可取得錄音內容擁有權。根據 DDEX 標準,使用 <RightsController>
標記可指示你擁有錄音內容專屬權利的位置。這與提供的 Deal 標記並不相同,不過你只應針對擁有專屬權利的地區提供 Content ID 交易。在 <SoundRecording>
元素中使用 <RightsController>
標記即可套用錄音內容擁有權,而且 <PartyId>
必須與 <MessageSender>
標記相符 (如果提供的是 <SentOnBehalfOf>
標記,則必須與此標記相符)。
以下提供 XML 範例,說明如何標明「ABC 唱片公司」在南非具備錄音內容的擁有權:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!-- 指定要套用擁有權的一或多個地區。
-->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- 在這個部分設定錄音內容的擁有權。 -->
<RightsController>
<PartyName>
<FullName>ABC 唱片公司</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Art Track 擁有權
<RightsController>
元素。音樂影片資源
影片類型
你可以使用 <VideoType>
指定影片類型。允許的音樂影片類型如下所示:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
音樂影片 ID
根據 YouTube 的規定,每部音樂影片的 <Video>
元素都必須包含有效的 ISRC 代碼。根據 IFPI 的規定,這組 ISRC 代碼不得與錄音內容使用的 ISRC 代碼相同。如果同時使用專屬 ID 代碼來追蹤影片資源,可在 <VideoId>
內加入 <ProprietaryId>
元素,做為 <ISRC>
元素的同類項目。<ProprietaryId> 元素的格式如下所示:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube 會將專屬 ID 值儲存在音樂影片資產 (適用於 Content ID 交付內容) 的「custom_id」欄位中。舉例來說,上述 XML 會產生 ISRC 為「USRE10400889」,且 custom_id 值為「custom_id_1234」的 MV 資產。
如要為 MV 資產加入「custom_id」值,可以使用專屬的「YOUTUBE:MV_CUSTOM_ID」命名空間:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- 為 MV 資產設定自訂 ID -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
如要傳送更新至現有的 MV 資產,可以使用專屬的「YOUTUBE:MV_ASSET_ID」命名空間,依資產 ID 找到該資產:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- 依資產 ID 找到要更新的 MV 資產 -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
如要為 MV 資產加上資產標籤,可以使用專屬的「YOUTUBE:MV_ASSET_LABEL」命名空間:
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- 為 MV 資產加上兩項資產標籤 →
<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 提供的「Music Metadata Style Guide」(音樂中繼資料樣式指南)。<Video>
標記中的下列元素會用於填入 YouTube 上的影片和中繼資料:
影片:標題 | <VideoDetailsByTerritory> |
影片:標記/關鍵字 | <VideoDetailsByTerritory> |
資產:歌曲 | <Video> |
資產:唱片公司名稱 | <VideoDetailsByTerritory> |
資產:藝人 |
|
資產:音樂類型 | <VideoDetailsByTerritory> |
系統會根據 <Release>
(而非 <Video>
) 中的資訊填入影片說明。詳情請參閱發布內容清單一節。
音樂影片擁有權
<Video>
元素中使用 <RightsController>
標記,即可取得 MV 資產擁有權。根據 DDEX 標準,使用 <RightsController>
標記可指示你擁有影片內容專屬權利的位置。這與提供的 Deal 標記並不相同,不過你只應針對擁有專屬權利的地區提供 Content ID 交易。系統會使用 <Video>
元素下的 <RightsController>
標記,套用 MV 資產擁有權,而且 <PartyId>
必須與 <MessageSender>
標記相符 (如果提供的是 <SentOnBehalfOf>
標記,則必須與此標記相符)。
以下 XML 示範如何標明「ABC 唱片公司」在南非具備 MV 資產的擁有權:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--指定要套用擁有權的一/多個地域。-->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- 在這個部分設定 MV 資產的擁有權。-->
<RightsController>
<PartyName>
<FullName>ABC 唱片公司</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
網路影片資源
影片類型
你可以使用 <VideoType>
指定影片類型。允許的網路影片類型如下所示:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
網路影片 ID
如果使用專屬 ID 代碼追蹤影片資源,可以在 <VideoId>
內加入 <ProprietaryId>
元素,做為 <ISRC>
元素的同層項目。<ProprietaryId> 元素的格式如下:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube 會將專屬 ID 值儲存在網路影片資產 (適用於 Content ID 交付內容) 的「custom_id」欄位。舉例來說,上述 XML 會產生 custom_id 值為「custom_id_1234」的網路資產。
如要為網路資產新增「custom_id」值,可以使用專屬的「YOUTUBE:WEB_CUSTOM_ID」命名空間:
<VideoId>
<!--- 為網路資產設定自訂 ID -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
如要傳送更新至現有的網路資產,可以使用專屬的「YOUTUBE:WEB_ASSET_ID」命名空間,依資產 ID 找到該資產:
<VideoId>
<!--- 依資產 ID 找到要更新的網路資產 -->
<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>
) 中的資訊填入影片說明。詳情請參閱發布內容清單一節。
網路影片擁有權
<Video>
元素中使用 <RightsController>
標記即可取得網路資產擁有權。根據 DDEX 標準,使用 <RightsController>
標記可指示你擁有影片內容專屬權利的位置。這與提供的 Deal 標記並不相同,不過你只應針對擁有專屬權利的地區提供 Content ID 交易。系統會使用 <Video>
元素下的 <RightsController>
標記來套用網路資產擁有權,而且 <PartyId>
必須與 <MessageSender>
標記相符 (如果提供的是 <SentOnBehalfOf>
標記,則必須與此標記相符)。
以下提供 XML 範例,說明如何標明「ABC 唱片公司」在南非具備網路資產的擁有權:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--指定要套用擁有權的一/多個地域。-->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- 在這個部分設定網路資產的擁有權。-->
<RightsController>
<PartyName>
<FullName>ABC 唱片公司</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
設定影片的目標觀眾
設定影片的目標觀眾
將影片設為「兒童專屬」或「不是兒童專屬」
如要上傳「兒童專屬」或「不是兒童專屬」的非 Art Track 影片 (例如音樂影片或網路影片),請使用 <AvRating>
元素搭配 MadeForKids
或 NotMadeForKids
,格式如下:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
這個欄位是否必填,視上傳影片頻道的預設選項而定。
自行選擇是否加上「兒童專屬」標記
- 「是,將這個頻道設成『兒童專屬』;我上傳的影片全是為兒童打造的內容。]
- [否,將這個頻道設成「不是為兒童打造」;我不會上傳兒童專屬的內容。」
如果您已為影片設定目標觀眾,而 YouTube 偵測到錯誤或騷擾/濫用行為,則您會看到您的影片被 YouTube 設定為「為兒童打造」。您無法於此時覆寫 YouTube 的決定。您若不認同這項審查結果,請利用 [提供意見] 按鈕回報問題。
必須加上「兒童專屬」標記
- 「我想查看每部影片的這項設定。」
如果您已為影片設定目標觀眾,而 YouTube 偵測到錯誤或騷擾/濫用行為,則您會看到您的影片被 YouTube 設定為「為兒童打造」。您無法於此時覆寫 YouTube 的決定。您若不認同這項審查結果,請利用 [提供意見] 按鈕回報問題。