DDEX reference resources

These features are only available to partners using YouTube's Content Manager to manage their copyrighted content.

The message samples demonstrate how to communicate new releases and takedowns for streaming with ads, YouTube Premium and Content ID. All samples are based on DDEX ERN version 3.8.

Sound Recordings - Album deliveries

These sample files follow the Audio Album profile and should be used for delivering on a per-release basis. Learn how to choose a release profile.

  New Release Sample Takedown Sample
YouTube Premium  721620118165_yt_premium.xml 721620118165_yt_premium_takedown.xml
Content ID 721620118165_content_id.xml​ 721620118165_content_id_takedown.xml
Combined Feed
(YouTube Premium & Content ID)
721620118165_combined.xml 721620118165_combined_takedown.xml
Creator Music

Album_creatormusic_only.xml

Album_creatormusic_only_takedown.xml
YouTube Premium, Content ID, & Creator Music Combined Feed Album_contentid_creatormusic_combined.xml Album_contentid_creatormusic_combined_takedown.xml

Sound Recordings - Track deliveries

These sample files follow the Single Resource Release profile and should be used for delivering on a per-track basis. Learn how to choose a release profile.

  New Release Sample Takedown Sample
Content ID USGCV1172318_content_id.xml USGCV1172318_content_id_takedown.xml
Creator Music SRR_CreatorMusic_only.xml SRR_CreatorMusic_only_takedown.xml
Content ID & Creator Music Combined Feed SRR_CID_CreatorMusic_Combined.xml SRR_CID_CreatorMusic_Combined_takedown.xml

 

Music Videos

These sample files follow the Video Single profile and should be used to deliver on a per-video basis.

  New Release Sample Update Sample
Music Video Upload music_video_only.xml music_video_only_update.xml
Content ID QZ6RS1700001_music_video_content_id_only.xml QZ6RS1700001_music_video_content_id_only_update.xml
Combined Feed
(Music Video Upload & Content ID)
QZ6RS1700001_music_video_content_id_combined.xml QZ6RS1700001_music_video_content_id_combined_update.xml

 

Web Videos

These sample files follow the Video Single profile and should be used to deliver on a per-video basis.

  New Release Sample Update Sample
Web Video Upload web_video_only.xml web_video_only_update.xml
Content ID web_video_content_id_only.xml web_video_content_id_only_update.xml
Combined Feed
(Web Video Upload & Content ID)
web_video_content_id_combined.xml web_video_content_id_combined_update.xml

 

In accordance with the DDEX convention, the filename of the DDEX file needs to include the unique Release ID for the album. The Release ID is the UPC, EAN, GRid, or ISRC provided by the <ReleaseId> element.

The below table indicates when the respective <ProprietaryId> elements should be communicated.
 

  Video ID Channel ID Asset ID
Delivering new video Not allowed Required Optional
Claiming existing video Required Optional Optional
Creating fingerprint from existing video Required Optional Optional
Reference/Fingerprint only upload Not allowed Not allowed Optional
Asset-only update Not allowed Not allowed Optional

Status reports for DDEX deliveries

Starting 2018, YouTube will transition to using the DDEX standard FtpAcknowledgementMessage for all DDEX status reports. See the ERN Choreography Standard documentation for more information on this message.

  Successful Package Report Failed Package Report
YouTube Premium ACK_721620118178.xml ACK_721620118178_failed.xml

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu