Create references

The YouTube XML format is being replaced by DDEX (music only) and CSV templates (all industries). YouTube strongly discourages any new implementations of the YouTube XML format. This page should be used solely as reference material for existing implementations. Visit Using the YouTube DDEX feed for more information about the new format.
The features described in this article are available only to partners who use YouTube's Content Manager to manage their copyrighted content.

You don’t create a reference for an asset directly using the <reference> tag. You create the reference indirectly by defining a relationship between the asset and a file that contains the audio or video content you want Content ID to use for matching, or a fingerprint of that content (that is, a <file> whose type attribute is video, audio or x-gfp).

<file type="video">

    <item path="/feed/file[1]"/>
    <related_item path="/external/asset[@id='ASSET_ID_1_']"/>

You can also create a reference by defining a relationship between the asset and an existing YouTube video, as long as the video was uploaded to a YouTube user account that is linked to your content owner.

    <item path="/external/video[@id='VIDEO_ID_1_']"/>
    <related_item path="/external/asset[@id='ASSET_ID_1_']"/>

When you create a reference, YouTube returns a unique reference ID in the status report that details the actions taken while processing the feed. You use the reference ID (and the <reference> tag) to delete, deactivate, or reactivate the reference.

When you create a reference for an asset, you must also specify a match policy for the asset.

A reference must include only content that you own. When a reference includes content that you don't own, you need to exclude that content from consideration when determining matches.
Was this helpful?
How can we improve it?