Search
Clear search
Close search
Google apps
Main menu
true

Complete feed samples

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.

The sections below provide samples of complete feeds that upload different types of data. Several of the samples also show the status report you'd receive when YouTube processes the feed.

Create a web video asset and associated YouTube video

This feed creates a web asset. The feed creates a reference file and uploads a custom thumbnail image for the asset. It also creates a YouTube video from the reference content, assigns a YouTube content rating to the video, and claims the video. Finally, the feed sets a match policy that will be applied to user-uploaded videos that match the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <asset type="web">
    <custom_id>wv-webvideo-02</custom_id>
    <description>Dave becomes a web celebrity.</description>
    <notes>Syndicate</notes>
    <title>I am on the Internet!</title>
    <url>http://www.example.com/daves_web_life</url>
  </asset>

  <!-- define reference files -->
  <file type="video">
    <filename>wv-webvideo-02.mov</filename>
  </file>
  <file type="image">
    <filename>dave_on_the_web.jpg</filename>
  </file>

  <!-- define the video metadata -->
  <video>
    <allow_comments>Approve</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <artwork type="custom_thumbnail" path="/feed/file[2]" />
    <channel>channelName</channel>
    <description>Description of another test video.</description>
    <genre>People & Blogs</genre>
    <keyword>Dave</keyword>
    <keyword>Internet</keyword>
    <public>True</public>
    <title>I am on the Internet</title>
  </video>

  <content_rating system="youtube">L2 S0 N0 V0 D0</content_rating>
  <relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/content_rating[1]" />
  </relationship>
  <!-- connect all of the video files in the feed to the movie asset -->
  <relationship>
    <item path="/feed/asset[1]" />
    <related_item path="/feed/file[1]" />
  </relationship>

  <relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/file[1]" />
  </relationship>

  <!-- Worldwide ownership for the asset -->
  <ownership/>

  <relationship>
    <item path="/feed/asset[1]"/>
    <related_item path="/feed/ownership[1]"/>
  </relationship>

  <!-- Rights administration rules are the same as ownership -->
  <rights_admin type="usage" owner="True"/>
  <rights_admin type="match" owner="True"/>

  <!-- Claim the video and set a usage policy to a saved policy. -->
  <claim type="audiovisual"
         asset="/feed/asset[1]"
         video="/feed/video[1]"
         rights_admin="/feed/rights_admin[1]"
         rights_policy="/external/rights_policy[@name='Monetize in all countries']"/>

  <!-- Set match policy using a saved policy. -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']" />
    <item path="/external/rights_policy[@name='Monetize in all countries']" />
    <related_item path="/feed/asset[1]" />
  </relationship>
</feed>

Status report


<Feed version="2">
   <uploader_name>psomusictest</uploader_name>
   <timestamp>2011-08-22T22:39:31</timestamp>
   <upload_control_id>uQrWwakAAPU</upload_control_id>
   <filename>web_video_web_feed.xml</filename>
   <action name="Parse">
       <status>Success</status>
       <timestamp>2011-08-22T22:08:51</timestamp>
   </action>
   <action name="Process asset">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/asset[1]</in_file>
       <id type="Asset ID">A175587133494830</id>
       <timestamp>2011-08-22T22:08:59</timestamp>
       <action name="Set metadata">
           <status>Success</status>
           <timestamp>2011-08-22T22:09:10</timestamp>
       </action>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize in all countries</name>
           </policy>
           <timestamp>2011-08-22T22:22:06</timestamp>
       </action>
       <action name="Set ownership">
           <status>Success</status>
           <in_file>/feed/ownership[1]</in_file>
           <timestamp>2011-08-22T22:14:42</timestamp>
       </action>
   </action>
   <action name="Process claim">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/video[1]</in_file>
       <id type="Video ID">-LcLOAPCLEE</id>
       <timestamp>2011-08-22T22:15:02</timestamp>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize in all countries</name>
           </policy>
           <timestamp>2011-08-22T22:15:16</timestamp>
       </action>
       <action name="Claim video">
           <status>Success</status>
           <timestamp>2011-08-22T22:21:47</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[1]</in_file>
       <filename>test_video_5.mov</filename>
       <timestamp>2011-08-22T22:09:00</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">RkmHyd5xxzI</id>
           <id type="Video ID">-LcLOAPCLEE</id>
           <id type="Asset ID">A175587133494830</id>
           <timestamp>2011-08-22T22:39:13</timestamp>
       </action>
       <action name="Submit video">
           <command>Insert</command>
           <status>Success</status>
           <status_detail>Live!</status_detail>
           <id type="Video ID">-LcLOAPCLEE</id>
           <timestamp>2011-08-22T22:30:12</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[2]</in_file>
       <filename>andy_snap.jpg</filename>
       <timestamp>2011-08-22T22:09:00</timestamp>
       <action name="Submit image">
           <command>Insert</command>
           <status>Success</status>
           <timestamp>2011-08-22T22:13:45</timestamp>
       </action>
   </action>
</Feed>
Create a movie asset and associated YouTube video

This feed creates a movie asset. The feed specifies several reference files for the asset. It also uploads a custom thumbnail image for the movie. In addition, the feed creates and claims a YouTube video from the reference content and also sets a match policy that will be applied to user-uploaded videos that match the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <!-- Comprehensive movie example: Movie studio delivers references in
       multiple aspect ratios or with differing sound tracks. Includes
       metadata for the single movie asset, reference files, ownership data
       and relationships between the movie and songs on its sound track -->
  <!-- Elsewhere in this feed you could refer to this asset in several ways:
       - "/feed/asset[1]"
       "/feed/asset[title='Wiki Wiki Wiki']"
       "/external/asset[id='Zz9aa8dz9Zz']" -->

  <asset type="movie">
    <actor>Sarah Marshal</actor>
    <content_type>Feature Film</content_type>
    <custom_id>wv-movie1</custom_id>
    <description>I wear clothes that say Boston</description>
    <director>Will Harper</director>
    <genre>Drama</genre>
    <original_release_date>2010-01-01</original_release_date>
    <original_release_medium>Film</original_release_medium>
    <producer>Griffin Harding</producer>
    <producer>John Patterson</producer>
    <title>Boston, my clothes say</title>
    <url>http://www.example.co.uk/boston</url>
    <writer>Jack Boston</writer>
  </asset>

  <!-- define reference files -->
  <file type="video">
    <filename>wv-movie1a.mov</filename>
  </file>
  <file type="video">
    <filename>wv-movie1b.mov</filename>
  </file>
  <file type="image">
    <filename>movie_custom_thumbnail.jpg</filename>
  </file>

  <!-- connect all of the video files in the feed to the movie asset -->
  <relationship>
    <item path="/feed/asset[1]" />
    <related_item path="/feed/file[1]" />
    <related_item path="/feed/file[2]" />
  </relationship>

  <relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/file[filename='wv-movie1a.mov']" />
  </relationship>

  <!-- define the video metadata -->
  <video>
    <allow_comments>Approve</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <artwork type="custom_thumbnail" path="/feed/file[3]" />
    <description>Another description of another test video.</description>
    <genre>Education</genre>
    <keyword>keywords, xml testing</keyword>
    <public>True</public>
    <title>Boston, my clothes say</title>
  </video>

  <!-- The feed provider only owns the video in the United States. -->
  <ownership asset="/feed/asset[1]">
    <owner>
      <rule>
        <condition restriction="include" type="territory">US</condition>
      </rule>
    </owner>
  </ownership>

  <!-- rights administration for the movie itself: mirrors ownership -->
  <rights_admin owner="True" type="usage"/>
  <rights_admin owner="True" type="match"/>

  <!-- Claim the video and set a usage policy -->
  <claim type="audiovisual"
         asset="/feed/asset[1]"
         video="/feed/video[1]"
         rights_admin="/feed/rights_admin[1]"
         rights_policy="/external/rights_policy[@name='Monetize in all countries']"/>

  <!-- Set administrator's default match policy using a policy saved in CMS -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']" />
    <item path="/external/rights_policy[@name='Monetize matches less than 90s']" />
    <related_item path="/feed/asset[1]" />
  </relationship>
</feed>

Status report


<Feed version="2">
   <uploader_name>psomusictest</uploader_name>
   <timestamp>2011-08-22T22:26:57</timestamp>
   <upload_control_id>ik8qdwWV9KM</upload_control_id>
   <filename>web_video_movie_feed.xml</filename>
   <action name="Parse">
       <status>Success</status>
       <timestamp>2011-08-22T21:59:53</timestamp>
   </action>
   <action name="Process claim">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/video[1]</in_file>
       <id type="Video ID">cdyq1YYjitw</id>
       <timestamp>2011-08-22T22:06:10</timestamp>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize in all countries</name>
           </policy>
           <timestamp>2011-08-22T22:06:22</timestamp>
       </action>
       <action name="Claim video">
           <status>Success</status>
           <timestamp>2011-08-22T22:12:54</timestamp>
       </action>
   </action>
   <action name="Process asset">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/asset[1]</in_file>
       <id type="Asset ID">A531920758782835</id>
       <timestamp>2011-08-22T22:00:04</timestamp>
       <action name="Set metadata">
           <status>Success</status>
           <timestamp>2011-08-22T22:05:15</timestamp>
       </action>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize matches less than 90s</name>
           </policy>
           <timestamp>2011-08-22T22:12:45</timestamp>
       </action>
       <action name="Set ownership">
           <status>Success</status>
           <in_file>/feed/ownership[1]</in_file>
           <timestamp>2011-08-22T22:06:10</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[1]</in_file>
       <filename>test_video_3.mov</filename>
       <timestamp>2011-08-22T22:00:04</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">h2pVkpd-n2g</id>
           <id type="Video ID">cdyq1YYjitw</id>
           <id type="Asset ID">A531920758782835</id>
           <timestamp>2011-08-22T22:26:47</timestamp>
       </action>
       <action name="Submit video">
           <command>Insert</command>
           <status>Success</status>
           <status_detail>Live!</status_detail>
           <id type="Video ID">cdyq1YYjitw</id>
           <timestamp>2011-08-22T22:16:29</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[2]</in_file>
       <filename>test_video_4.mov</filename>
       <timestamp>2011-08-22T22:00:04</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">oCfcKHAz_Hc</id>
           <timestamp>2011-08-22T22:20:41</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[3]</in_file>
       <filename>andy_snap.jpg</filename>
       <timestamp>2011-08-22T22:00:04</timestamp>
       <action name="Submit image">
           <command>Insert</command>
           <status>Success</status>
           <timestamp>2011-08-22T22:05:32</timestamp>
       </action>
   </action>
</Feed>
Create a movie asset with multiple reference files

This feed uploads assets that will appear in YouTube's Movies category. The feed defines a movie asset and specifies several video reference files for the asset. It also uploads a custom thumbnail image for the movie. In addition, the feed creates and claims a YouTube video from the reference content and also sets a match policy that will be applied to user-uploaded videos that match the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <!-- Comprehensive movie example: Movie studio delivers references in
       multiple aspect ratios or with differing sound tracks. Includes
       metadata for the single movie asset, reference files, and
       ownership data. -->
  <asset type="movie">
    <actor>Sarah Marshal</actor>
    <content_type>Feature Film</content_type>
    <custom_id>BBEW-DW</custom_id>
    <description>The Wiki is getting larger!</description>
    <director>Will Harper</director>
    <genre>Drama</genre>
    <original_release_date>2010-01-01</original_release_date>
    <original_release_medium>Film</original_release_medium>
    <producer>Griffin Harding</producer>
    <producer>John Patterson</producer>
    <rating system="mpaa">PG</rating>
    <shows_and_movies_programming>True</shows_and_movies_programming>
    <spoken_language>en</spoken_language>
    <title>Wiki Wiki Wiki II</title>
    <url>http://www.example.co.uk/wikiwikiwiki</url>
    <writer>Jack Sprat</writer>
  </asset>

  <!-- define reference files -->
  <file type="video">
    <filename>movie_4x3_en.mov</filename>
  </file>
  <file type="video">
    <filename>movie_16x9_en.mov</filename>
  </file>
  <file type="video">
    <filename>movie_16x9_dubbed_es.mov</filename>
  </file>
  <file type="video">
    <filename>movie_16x9_dubbed_fr.mov</filename>
  </file>
  <file type="image">
    <filename>movie_custom_thumbnail.jpg</filename>
  </file>

  <!-- connect all of the video files in the feed to the movie asset -->
  <relationship>
    <item path="/feed/asset[1]" />
    <related_item path="/feed/file[1]" />
    <related_item path="/feed/file[2]" />
    <related_item path="/feed/file[3]" />
    <related_item path="/feed/file[4]" />
  </relationship>

  <relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/file[filename='movie_16x9_en.mov']" />
  </relationship>

  <!-- define the video metadata -->
  <video>
    <allow_comments>Approve</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <artwork type="custom_thumbnail" path="/feed/file[5]" />
    <description>A movie sequel about Wikis.</description>
    <genre>Education</genre>
    <keyword>Wiki</keyword>
    <public>True</public>
    <title>Wiki Wiki Wiki II</title>
  </video>

  <!-- ownership for movie asset: Foo in US, Baz everywhere else -->
  <ownership asset="/feed/asset[1]">
    <owner type="partner" name="FooPictures">
      <rule>
        <condition restriction="include" type="territory">US</condition>
      </rule>
    </owner>
    <owner type="partner" name="BazEntertainment">
      <rule>
        <condition restriction="exclude" type="territory">US</condition>
      </rule>
    </owner>
  </ownership>

  <!-- rights administration for the movie itself: mirrors ownership -->
  <rights_admin owner="True" type="usage"/>
  <rights_admin owner="True" type="match"/>

  <!-- Claim the video and set a usage policy -->
  <claim type="audiovisual"
         asset="/feed/asset[1]"
         video="/feed/video[1]"
         rights_admin="/feed/rights_admin[1]"
         rights_policy="/external/rights_policy[@name='Monetize US CA JP']"/>

  <!-- Set administrator's default match policy using a policy saved in CMS -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']" />
    <item path="/external/rights_policy[@name='Monetize everywhere']" />
    <related_item path="/feed/asset[1]" />
  </relationship>
</feed>
Create a television episode asset and associated YouTube video

This feed creates an episode asset. The feed creates a reference file and uploads a custom thumbnail image for the asset. It also creates a YouTube video from the reference content and claims it. Finally, the feed sets a match policy that will be applied to user-uploaded videos that match the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <asset type="episode">
    <actor>David Piper</actor>
    <actor>Camille Jones</actor>
    <content_type>Full Episode</content_type>
    <custom_id>BBEW-DW-2006-12</custom_id>
    <description>Medieval cold treatment was not fun.</description>
    <director>Will Harper</director>
    <episode>12</episode>
    <notes>Production code: NBBS096J; Length: 43'18"</notes>
    <original_release_date>2006-07-01</original_release_date>
    <original_release_medium>Terrestrial TV</original_release_medium>
    <producer>David Russell</producer>
    <producer>John Gardner</producer>
    <rating system="tvpg">TV-PG</rating>
    <season>2</season>
    <title>Treating a cold</title>
    <tms_id>EP099991780027</tms_id>
    <url>http://www.example.co.uk/doctorjill/2/12</url>
    <writer>David Russell</writer>
  </asset>

  <file type="video">
    <filename>dj_2006_12.avi</filename>
  </file>

  <file type="image">
    <filename>dj_2006_12_thumb.jpg</filename>
  </file>

  <video>
    <title>Dr. Jill - Treating a cold (season 2)</title>
    <description>Medieval cold treatments were not fun.</description>
    <genre>Entertainment</genre>
    <keyword>Jill</keyword>
    <keyword>medieval</keyword>
    <keyword>cold</keyword>
    <keyword>treatment</keyword>
    <genre>Comedy</genre>
    <artwork type="custom_thumbnail" path="/feed/file[2]" />
    <public>True</public>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <allow_comments>Approve</allow_comments>
  </video>

  <relationship>
    <item path="/feed/asset[@type='episode']" />
    <related_item path="/feed/file[1]" />
  </relationship>

  <relationship>
    <item path="/feed/file[1]" />
    <related_item path="/feed/video[1]" /> <!-- completes the video declaration -->
  </relationship>

  <!-- The asset owner also administers the asset -->
  <rights_admin type="usage" owner="true"/>
  <rights_admin type="match" owner="true"/>

  <!-- declare a one-off policy -->
  <rights_policy>
    <rule action="track">
      <condition restriction="include" type="territory">GB AU</condition>
    </rule>
    <rule action="block" subaction="review">
      <condition restriction="exclude" type="territory">GB AU</condition>
    </rule>
  </rights_policy>

  <!-- Claim our uploaded video with the one-off policy -->
  <claim type="audiovisual"
         asset="/feed/asset[@type='episode']"
         rights_admin="/feed/rights_admin[@type='match']"
         rights_policy="/feed/rights_policy[1]"
         video="/feed/video[1]"/>

  <relationship>
    <item path="/feed/rights_policy[1]"/>
    <related_item path="/feed/asset[@type='episode']"/>
  </relationship>

</feed>
Create a sound recording asset and set its Content ID match policy

This feed creates a sound recording asset, provides ownership data for the asset, and creates a reference file. Finally, the feed defines and sets a match policy for the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="someone@example.com">
  <!-- Set the tag value to the sound recording's ISRC to be able to refer
       to the sound recording by ISRC in the feed and to have the ISRC
       returned in the feed's status report. -->
  <asset type="sound_recording" tag="ISRC00112233">
    <custom_id>ISRC00112233</custom_id> <!-- Can be ISRC or any other value. -->
    <title>Song Title</title>
    <!-- Optional asset tags below this comment -->
    <album>All your song title are belong to us</album>
    <artist>The Foos</artist>          <!-- Required for AudioSwap -->
    <genre>Blues</genre>             <!-- Required for AudioSwap -->
    <isrc>ISRC00112233</isrc>
    <label>Foo label</label>
  </asset>

  <!-- Identify the file -->
  <file type="audio" tag="ISRC00112233">
    <filename>ISRC00112233.mp3</filename>
  </file>

  <!-- Asset is owned worldwide. -->
  <ownership tag="worldwide">
    <owner>
      <rule percentage="100">
        <condition restriction="exclude" type="territory"/>
      </rule>
    </owner>
  </ownership>

  <relationship>
    <item path="/feed/asset[@tag='ISRC00112233']"/>
    <related_item path="/feed/ownership[@tag='worldwide']"/>
  </relationship>

  <!-- Create a reference by associating the file with the asset. -->
  <!-- The XML that is commented out would add the file to AudioSwap. -->
  <relationship>
    <item path="/feed/file[@tag='ISRC00112233']"/>
    <related_item path="/feed/asset[@tag='ISRC00112233']"/>
    <!-- To include file in AudioSwap, remove comments around <related_item>
         tag below. The feed must also contain an <audioswap/> tag. -->
    <!--  <related_item path="/feed/audioswap"/>  -->
  </relationship>

  <!-- Define administration rule indicating that you administer the
       asset in the same territories where you own it. -->
  <rights_admin type="match" owner="True"/>

  <!-- Define a policy to block user-uploaded videos matching more than 90%
       of the asset and to monetize other matching user-uploaded videos. -->
  <rights_policy tag="Block 90% match">
    <rule action="block">
      <condition restriction="greater_equal" type="match_percent">90</condition>
    </rule>
    <rule action="monetize">
      <condition restriction="less_than" type="match_percent">90</condition>
    </rule>
  </rights_policy>

  <!-- Set a match policy for the asset -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']"/>
    <item path="/feed/rights_policy[@tag='Block 90% match']"/>
    <related_item path="feed/asset[@tag='ISRC00112233']"/>
  </relationship>
</feed>
Status report

 


<Feed version="2">
    <uploader_name>psomusictest</uploader_name>
    <timestamp>2011-08-23T18:49:54</timestamp>
    <upload_control_id>ZmTgAQONp0c</upload_control_id>
    <filename>sound_recording_feed.xml</filename>
    <action name="Parse">
        <status>Success</status>
        <timestamp>2011-08-23T17:29:49</timestamp>
    </action>
    <action name="Process asset">
        <command>Insert</command>
        <status>Success</status>
        <in_file>feed/asset[@tag='USNDY1000823']</in_file>
        <id type="Asset ID">A838770060555823</id>
        <timestamp>2011-08-23T17:29:58</timestamp>
        <action name="Set metadata">
            <status>Success</status>
            <timestamp>2011-08-23T17:30:12</timestamp>
        </action>
        <action name="Set rights policy">
            <status>Success</status>
            <policy>
                <in_file>/feed/rights_policy[@tag='Block 90% match']</in_file>
            </policy>
            <timestamp>2011-08-23T17:42:41</timestamp>
        </action>
        <action name="Set ownership">
            <status>Success</status>
            <in_file>/feed/ownership[@tag='worldwide']</in_file>
            <timestamp>2011-08-23T17:36:54</timestamp>
        </action>
    </action>
    <action name="Process file">
        <status>Success</status>
        <in_file>/feed/file[@tag='USNDY1000823']</in_file>
        <filename>sr_test1.mp3</filename>
        <timestamp>2011-08-23T17:29:58</timestamp>
        <action name="Submit reference">
            <command>Insert</command>
            <status>Success</status>
            <id type="Reference ID">fN5ZUoUYTk4</id>
            <id type="Asset ID">A838770060555823</id>
            <timestamp>2011-08-23T18:49:45</timestamp>
        </action>
    </action>
</Feed>
Create sound recording assets for all of the songs on an album

This feed shows how to add all of the songs on an album into the rights management system. It creates a sound recording asset for each song and identifies the file that contains each song's digital media content, thereby creating a reference file for each song. (The media files need to be uploaded with the feed.) The feed applies the same ownership settings and match policy to all of the songs on the album.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="someone@example.com">
  <!-- Create one sound recording asset for each song. For songs on the same
       album, all information is likely to be the same from one song to the
       next except for the title, the ISRC, and the value of the <asset>
       tag's <span class=code>tag</span> attribute. -->

  <!-- Song #1 -->
  <!-- Tip: Set the tag value to the sound recording's ISRC to be able to
       refer to the sound recording by ISRC in the feed and to have the ISRC
       returned in the feed's status report. -->
  <asset type="sound_recording" tag="ISRC00112233">
    <title>SONG TITLE 1</title>
    <custom_id>ISRC00112233</custom_id>
    <artist>ARTIST NAME</artist>
    <album>ALBUM TITLE</album>
    <genre>Blues</genre>
    <label>LABEL NAME</label>
    <isrc>ISRC00112233</isrc>
    <upc>012345678912</upc>
    <original_release_date>2010-08-17</original_release_date>
  </asset>

  <!-- Create the reference file for the sound recording asset (song #1) -->
  <file type="audio" tag="ISRC00112233">
    <filename>FILENAME1.mp3</filename>
  </file>

  <!-- Associate the reference file with the sound recording asset (song #1) -->
  <relationship type="associate">
    <item path="/feed/asset[@tag='ISRC00112233']"/>
    <related_item path="/feed/file[@tag='ISRC00112233']"/>
  </relationship>

  <!-- Song #2 -->
  <asset type="sound_recording" tag="ISRC99887766">
    <title>SONG TITLE 2</title>
    <custom_id>ISRC99887766</custom_id>
    <artist>ARTIST NAME</artist>
    <album>ALBUM TITLE</album>
    <genre>Blues</genre>
    <label>LABEL NAME</label>
    <isrc>ISRC99887766</isrc>
    <upc>012345678912</upc>
    <original_release_date>2010-08-17</original_release_date>
  </asset>

  <!-- Create the reference file for the sound recording asset (song #2) -->
  <file type="audio" tag="ISRC99887766">
    <filename>FILENAME2.mp3</filename>
  </file>

  <!-- Associates the reference file to the sound recording asset (song #2) -->
  <relationship type="associate">
    <item path="/feed/asset[@tag='ISRC99887766']"/>
    <related_item path="/feed/file[@tag='ISRC99887766']"/>
  </relationship>

  <!-- Set ownership for all of the assets (sound recordings) in the feed.
       In this example, the same ownership settings apply to all of the
       songs on the same album. (The ownership settings indicate that the
       assets are owned everywhere but Canada and the United States. -->
  <ownership tag="ownership">
    <owner>
      <rule percentage="100">
        <condition restriction="exclude" type="territory">CA US</condition>
      </rule>
    </owner>
  </ownership>

  <relationship type="associate">
    <item path="/feed/ownership[@tag='ownership']"/>
    <related_item path="/feed/asset"/>
  </relationship>

  <!-- Create admin rights for user-uploaded videos that contain your songs. -->
  <rights_admin owner="True" type="match" tag="rights_admin"/>

  <!-- Create a policy that monetizes the sound recordings worldwide. (YouTube
       only enforces the policy in the countries where you own the songs.) -->
  <rights_policy tag="rights_policy">
    <rule action="Monetize">
      <condition restriction="exclude" type="territory"/>
    </rule>
  </rights_policy>

  <!-- Associate all of the songs with the admin rights and match policy. -->
  <relationship type="associate">
    <item path="/external/rights_policy[@name='Monetize in all countries']"/>
    <item path="/feed/rights_admin[@tag='rights_admin']"/>
    <related_item path="/feed/asset"/>
  </relationship>
</feed>

Status report


<Feed version="2">
   <uploader_name>psomusictest</uploader_name>
   <timestamp>2011-08-23T20:51:47</timestamp>
   <upload_control_id>bLzoRilCYHc</upload_control_id>
   <filename>insert_album.xml</filename>
   <action name="Parse">
       <status>Success</status>
       <timestamp>2011-08-23T18:32:48</timestamp>
   </action>
   <action name="Process asset">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/asset[@tag='USNDY3000823']</in_file>
       <id type="Asset ID">A538859383693764</id>
       <timestamp>2011-08-23T18:32:56</timestamp>
       <action name="Set metadata">
           <status>Success</status>
           <timestamp>2011-08-23T18:33:05</timestamp>
       </action>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize in all countries</name>
           </policy>
           <timestamp>2011-08-23T18:40:07</timestamp>
       </action>
       <action name="Set ownership">
           <status>Success</status>
           <in_file>/feed/ownership[@tag='ownership']</in_file>
           <timestamp>2011-08-23T18:33:06</timestamp>
       </action>
   </action>
   <action name="Process asset">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/asset[@tag='USNDY4000823']</in_file>
       <id type="Asset ID">A306078208014179</id>
       <timestamp>2011-08-23T18:32:56</timestamp>
       <action name="Set metadata">
           <status>Success</status>
           <timestamp>2011-08-23T18:33:05</timestamp>
       </action>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <name>Monetize in all countries</name>
           </policy>
           <timestamp>2011-08-23T18:39:00</timestamp>
       </action>
       <action name="Set ownership">
           <status>Success</status>
           <in_file>/feed/ownership[@tag='ownership']</in_file>
           <timestamp>2011-08-23T18:33:06</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[@tag='USNDY3000823']</in_file>
       <filename>sr_test3.mp3</filename>
       <timestamp>2011-08-23T18:32:56</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">fpZs0yOktbg</id>
           <id type="Asset ID">A538859383693764</id>
           <timestamp>2011-08-23T20:51:36</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[@tag='USNDY4000823']</in_file>
       <filename>sr_test4.mp3</filename>
       <timestamp>2011-08-23T18:32:56</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">UAU6tsSQ-28</id>
           <id type="Asset ID">A306078208014179</id>
           <timestamp>2011-08-23T19:51:37</timestamp>
       </action>
   </action>
</Feed>
Create a composition asset and associate it with sound recordings

This feed creates a composition asset, provides ownership data for the composition, and sets a match policy for the composition. In this example, two owners share ownership of the asset. The example also uses a 'contained_by' relationship to associate the composition with sound recordings that contain it.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="someone@example.com">
  <asset type="composition" tag="T0913255414">
    <title>Full-size Pickup Line</title>
    <custom_id>764a8sx34</custom_id>
    <iswc>T0913255414</iswc>
    <writer>Bridges,Ashley</writer>
    <writer>House,Simon</writer>
    <writer>Trotts,Darren</writer>
  </asset>

  <!-- The composition has two owners who have 60% and 40% shares worldwide -->
  <ownership tag="T0913255414">
    <owner name="Foo Publishing" type="publisher"
           ipi_number="00061734438">
      <rule percentage="60"/>
    </owner>

    <owner name="Baz Publishing" type="publisher"
           ipi_number="00061734439">
      <rule percentage="40"/>
    </owner>
  </ownership>

  <relationship type="associate">
    <item path="/feed/asset[@tag='T0913255414']"/>
    <related_item path="/feed/ownership[@tag='T0913255414']"/>
  </relationship>

  <!-- Indicate that the owner is also the administrator -->
  <rights_admin type="match" owner="True"/>

  <!-- Set a match policy for the composition by associating the asset
       with the rights administrator and rights policy information -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']"/>
    <item path="/external/rights_policy[@name='Monetize US CA only']"/>
    <related_item path="/feed/asset[@tag='T0913255414']"/>
  </relationship>

  <!-- Associate the composition with sound recordings that embed it -->
  <relationship type="contained_by">
    <item path="/feed/asset[@tag='T0913255414']"/>
    <related_item path="/external/asset[id='ASSET_ID_1_']"/>
    <related_item path="/external/asset[id='ASSET_ID_2_']"/>
    <related_item path="/external/asset[isrc='ISRC00112233']" />
  </relationship>
</feed>

Status report


<Feed version="2">
    <uploader_name>psomusictest</uploader_name>
    <timestamp>2011-08-23T18:51:50</timestamp>
    <upload_control_id>2h8k7llMD8U</upload_control_id>
    <filename>composition_feed.xml</filename>
    <action name="Parse">
        <status>Success</status>
        <timestamp>2011-08-23T18:44:35</timestamp>
    </action>
    <action name="Process asset">
        <command>Insert</command>
        <status>Success</status>
        <in_file>/feed/asset[@tag='T0811300000']</in_file>
        <id type="Asset ID">A371988195838719</id>
        <timestamp>2011-08-23T18:44:44</timestamp>
        <action name="Set metadata">
            <status>Success</status>
            <timestamp>2011-08-23T18:44:53</timestamp>
        </action>
        <action name="Set rights policy">
            <status>Success</status>
            <policy>
                <name>Monetize in all countries</name>
            </policy>
            <timestamp>2011-08-23T18:51:39</timestamp>
        </action>
        <action name="Set ownership">
            <status>Success</status>
            <in_file>/feed/ownership[@tag='T0811300000']</in_file>
            <timestamp>2011-08-23T18:51:10</timestamp>
        </action>
    </action>
    <action name="Set rights owner">
        <status>Success</status>
        <timestamp>2011-08-23T18:44:44</timestamp>
    </action>
    <action name="Set rights owner">
        <status>Success</status>
        <timestamp>2011-08-23T18:44:44</timestamp>
    </action>
    <action name="Set asset relationship">
        <status>Success</status>
        <timestamp>2011-08-23T18:49:56</timestamp>
    </action>
</Feed>
Create a music video asset and an associated YouTube video

This feed creates a music video asset, a reference file for the asset, and a YouTube video. It claims the video and defines a match policy for user-uploaded videos that match the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <!-- Comprehensive music video example: Music label delivers a
       music video reference file, along with:
       - asset metadata for both the video and the composition
       - rights administration
       - one-off policy for the publisher's portion of the rights
       - instructions to show the video on YT -->

  <!-- Specify the location of the reference file -->
  <file type="video">
    <filename>70900486.mov</filename>
  </file>

  <!-- update an existing music video asset -->
  <asset type="music_video">
    <label>Windy Music</label>
    <title>Oboes are down on their luck</title>
    <genre>Blues</genre>
    <isrc>US8970900486</isrc>
    <artist>Hot Dog McCarthy</artist>
    <upc>00629217062280</upc>
  </asset>

  <!-- ownership for the music video asset -->
  <ownership>
    <owner type="partner" name="Foo Music Group">
      <rule>
        <condition restriction="include" type="territory">US CA MX</condition>
        <!-- 100% ownership implied -->
        <!-- More conditions. All conditions must be true for rule to apply -->
      </rule>
      <!-- More rules for this owner. All conditions of at least one rule
           must be true for owner to be recognized as the owner of any
           associated asset(s). -->
    </owner>
    <!-- More owners of the asset if there are different owners in
         different countries. For compositions, multiple owners can have
         partial ownership within the same country. -->
  </ownership>

  <!-- Associate the asset with its reference file and ownership-->
  <relationship type="associate">
    <item path="/feed/asset[1]" />
    <related_item path="/feed/file[1]" />
    <related_item path="/feed/ownership[1]" />
  </relationship>

  <!-- rights administration for the music video asset -->
  <rights_admin owner="True" type="match"/>
  <rights_admin owner="True" type="usage"/>
  <!-- Declare a one-off policy. -->
  <rights_policy tag="policy-ugc">
    <rule action="block" subaction="review">
      <condition restriction="include" type="territory">US CA</condition>
      <condition restriction="greater_than" type="match_percent">90</condition>
      <condition restriction="less_than" type="match_percent">97</condition>
    </rule>
    <rule action="monetize">
      <condition restriction="greater_equal" type="match_percent">97</condition>
    </rule>
    <rule action="block">
      <condition restriction="include" type="territory">CA ES</condition>
    </rule>
  </rights_policy>

  <!-- One-off policy to monetize partner-uploaded content everywhere. -->
  <rights_policy tag="policy-upload">
    <rule action="monetize" />
  </rights_policy>

  <!-- combine the policy with the administrator and asset to apply that
       policy to the asset for that administrator. The conditions are ANDed
       together so the resulting applied policy in this example would be:
       - monetize US
       - ignore GB (someone else administers GB, or policy already defined)
       - block everywhere else -->

  <!-- Set the default match policy for the asset -->
  <relationship type="associate">
    <item path="/feed/rights_admin[1]" />
    <item path="/feed/rights_policy[1]" />
    <related_item path="/feed/asset[1]" />
  </relationship>

  <!-- create a video from the file -->
  <video>
    <title>Oboes are down on their luck</title>
    <description>Oboes are down on their luck</description>
    <genre>Music</genre>
    <keyword>Hot Dog</keyword>
    <keyword>McCarthy</keyword>
    <keyword>Oboes</keyword>
    <public>True</public>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <allow_comments>Approve</allow_comments>
  </video>

  <!-- Associate the reference file with the video -->
  <relationship type="associate">
    <item path="/feed/file[1]"/>
    <related_item path="/feed/video[1]"/>
  </relationship>

  <!-- Define claim -->
  <claim type="audiovisual"/>

  <!-- Claim the audiovisual content in the video
       with the partner's upload rights designation-->
  <relationship type="associate">
    <item path="/feed/claim[1]"/>
    <item path="/feed/asset[1]"/>
    <item path="/feed/rights_admin[@type='usage']"/>
    <item path="/feed/rights_policy[2]"/>
    <related_item path="/feed/video[1]"/>
  </relationship>
</feed>

Status report


<Feed version="2">
   <uploader_name>psomusictest</uploader_name>
   <timestamp>2011-08-22T23:04:34</timestamp>
   <upload_control_id>mGRgiOrHhCk</upload_control_id>
   <filename>music_video_feed.xml</filename>
   <action name="Parse">
       <status>Success</status>
       <timestamp>2011-08-22T22:32:57</timestamp>
   </action>
   <action name="Process asset">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/asset[1]</in_file>
       <id type="Asset ID">A772833876361203</id>
       <timestamp>2011-08-22T22:33:06</timestamp>
       <action name="Set metadata">
           <status>Success</status>
           <timestamp>2011-08-22T22:33:17</timestamp>
       </action>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <in_file>/feed/rights_policy[1]</in_file>
           </policy>
           <timestamp>2011-08-22T22:38:53</timestamp>
       </action>
       <action name="Set ownership">
           <status>Success</status>
           <in_file>/feed/ownership[1]</in_file>
           <timestamp>2011-08-22T22:33:17</timestamp>
       </action>
   </action>
   <action name="Process claim">
       <command>Insert</command>
       <status>Success</status>
       <in_file>/feed/video[1]</in_file>
       <id type="Video ID">iLMnJ0KXGk4</id>
       <timestamp>2011-08-22T22:38:24</timestamp>
       <action name="Set rights policy">
           <status>Success</status>
           <policy>
               <in_file>/feed/rights_policy[2]</in_file>
           </policy>
           <timestamp>2011-08-22T22:38:34</timestamp>
       </action>
       <action name="Claim video">
           <status>Success</status>
           <timestamp>2011-08-22T22:45:16</timestamp>
       </action>
   </action>
   <action name="Process file">
       <status>Success</status>
       <in_file>/feed/file[1]</in_file>
       <filename>test_video_6.mov</filename>
       <timestamp>2011-08-22T22:33:06</timestamp>
       <action name="Submit reference">
           <command>Insert</command>
           <status>Success</status>
           <id type="Reference ID">jFqLylbmZFs</id>
           <id type="Video ID">iLMnJ0KXGk4</id>
           <id type="Asset ID">A772833876361203</id>
           <timestamp>2011-08-22T23:04:12</timestamp>
       </action>
       <action name="Submit video">
           <command>Insert</command>
           <status>Success</status>
           <status_detail>Live!</status_detail>
           <id type="Video ID">iLMnJ0KXGk4</id>
           <timestamp>2011-08-22T22:52:17</timestamp>
       </action>
   </action>
</Feed>
Upload and claim a video that you administer but do not own

This feed shows how to upload and claim a video that you administer but do not own. Since you are not the owner of the asset, the feed doesn't provide ownership data for the asset.

This feed also uploads a video, but does not create a reference or set a match policy since those are things that the video owner would likely do. If your administration rights include the ability to set policies for user-uploaded videos that match your video, however, you could create a reference and set a match policy.

A key portion of this feed is the <rights_admin> tag sets the owner attribute to False since the asset owner and asset administrator are different entities. In addition, the <rights_admin> tag defines a rule that identifies the territories where you administer the asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="someone@example.com" channel="TestChannel">
  <!-- define the asset -->
  <asset type="web">
    <custom_id>2011-11-11-claimworef1</custom_id>
    <description>Someone talks about something.</description>
    <title>Claim w/o reference test #1</title>
  </asset>

  <!-- define the video metadata -->
  <video>
    <allow_comments>Approve</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <description>Upload a video and claim it without creating a reference.</description>
    <genre>People & Blogs</genre>
    <keyword>test</keyword>
    <keyword>sample xml</keyword>
    <public>True</public>
    <title>Claim w/o reference test #1</title>
  </video>

  <!-- define video file -->
  <file type="video">
    <filename>test_clip1.mov</filename>
  </file>

  <!-- associate the video metadata with the video file -->
  <relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/file[1]" />
  </relationship>

  <!-- Set rights administration rules. The rights administrator, in this case,
       is not the owner. So, this file does not specify any ownership data. The
       rights_admin tag contains a rule identifying the countries where the
       administrator has the right to monetize the data. -->
  <rights_admin owner="False" type="usage">
    <rule>
      <condition restriction="include" type="territory">US CA</condition>
    </rule>
  </rights_admin>

  <!-- Claim the video and set a usage policy to a saved policy. -->
  <claim type="audiovisual"
         asset="/feed/asset[1]"
         video="/feed/video[1]"
         rights_admin="/feed/rights_admin[1]"
         rights_policy="/external/rights_policy[@name='Monetize in all countries']"/>
  <!-- Do not associate asset with file to create reference -->
  <!-- Do not set asset ownership -->
  <!-- Do not set a match policy -->
</feed>

Status report


<Feed version="2">
    <uploader_name>psomusictest</uploader_name>
    <timestamp>2011-11-12T00:11:40</timestamp>
    <upload_control_id>ajM5q9MifMo</upload_control_id>
    <filename>upload_claimed_video_without_reference.xml</filename>
    <action name="Parse">
        <status>Success</status>
        <timestamp>2011-11-11T23:56:29</timestamp>
    </action>
    <action name="Process asset">
        <command>Insert</command>
        <status>Success</status>
        <in_file>/feed/asset[1]</in_file>
        <id type="Asset ID">A963932478721363</id>
        <timestamp>2011-11-11T23:56:49</timestamp>
        <action name="Set metadata">
            <status>Success</status>
            <timestamp>2011-11-11T23:57:17</timestamp>
        </action>
    </action>
    <action name="Process claim">
        <command>Insert</command>
        <status>Success</status>
        <in_file>/feed/video[1]</in_file>
        <id type="Video ID">RHlXb2w8fM0</id>
        <timestamp>2011-11-12T00:03:52</timestamp>
        <action name="Set rights policy">
            <status>Success</status>
            <policy>
                <name>Monetize in all countries</name>
            </policy>
            <timestamp>2011-11-12T00:04:20</timestamp>
        </action>
        <action name="Claim video">
            <status>Success</status>
            <timestamp>2011-11-12T00:10:21</timestamp>
        </action>
    </action>
    <action name="Process file">
        <status>Success</status>
        <in_file>/feed/file[1]</in_file>
        <filename>test_clip1.mov</filename>
        <timestamp>2011-11-11T23:56:50</timestamp>
        <action name="Submit video">
            <command>Insert</command>
            <status>Success</status>
            <status_detail>Live!</status_detail>
            <id type="Video ID">RHlXb2w8fM0</id>
            <timestamp>2011-11-12T00:11:14</timestamp>
        </action>
    </action>
</Feed>
Update a movie asset

This example updates a movie asset. The <asset> tag uses the id attribute to identify an existing asset. The asset is then associated with a new reference file and ownership data.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com">
  <!-- Partial update of a movie example: Movie studio delivers additional
       references for an existing asset -->

  <!-- Fix a typo in the title of an existing external asset. -->
  <asset type="movie" id="ASSET_ID_1_">
    <title>Reservoir Puppies II: The Search For Spot</title>
  </asset>

  <!-- attach a new reference file -->
  <file type="video">
    <filename>puppies_final_hd.mov</filename>
  </file>

  <!-- associate the file with the movie asset -->
  <relationship>
    <item path="/feed/asset[1]" />
    <related_item path="/feed/file[1]" />
  </relationship>

  <!-- modify part of ownership for the movie asset -->
  <ownership>
    <owner type="partner" name="Sappy Pictures Inc">
      <rule>
        <condition restriction="include" type="territory">US</condition>
      </rule>
    </owner>
  </ownership>

  <!-- associate the ownership data with the movie asset -->
  <relationship>
    <item path="/external/asset[id='ASSET_ID_1_']" />
    <related_item path="/feed/ownership[1]" />
  </relationship>
</feed>
Create a trailer asset and associate it with an existing movie

This feed uploads a trailer asset (and video) and links the trailer to an existing movie asset.


<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  <!-- Create a trailer for an existing movie asset -->

  <asset type="trailer" tag="trailer1">
    <actor>Sarah Marshal</actor>
    <custom_id>BBEW-DW</custom_id>
    <description>Pet care is a difficult business!</description>
    <director>Will Harper</director>
    <genre>Action & Adventure</genre>
    <original_release_date>2010-01-01</original_release_date>
    <original_release_medium>Promotional</original_release_medium>
    <producer>Jake Harding</producer>
    <producer>Ladybird Patterson</producer>
    <rating system="mpaa">PG</rating>
    <shows_and_movies_programming>True</shows_and_movies_programming>
    <title>The Dogbather</title>
    <url>http://www.example.com/dogbather</url>
    <writer>Amelia Stickerbook</writer>
  </asset>

  <!-- Define ownership for the asset. Feed uploader owns asset worldwide -->
  <ownership tag="trailer1"/>

  <!-- Set ownership for the asset -->
  <relationship>
    <item path="/feed/asset[@tag='trailer1']" />
    <related_item path="/feed/ownership[@tag='trailer1']" />
  </relationship>

  <!-- define reference file -->
  <file type="video" tag="trailer1">
    <filename>dogbather_trailer.mov</filename>
  </file>

  <!-- define video metadata -->
  <video type="trailer" tag="trailer1">
    <allow_comments>Never</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>False</allow_ratings>
    <genre>Comedy</genre>
    <keyword>trailer</keyword>
    <public>True</public>
    <title>The Dogbather, now available on Blu-Ray</title>
    <description>You should totally buy this.</description>
  </video>

  <!-- Associate the video file with the asset and video elements -->
  <relationship>
    <item path="/feed/file[@tag='trailer1']" />
    <related_item path="/feed/asset[@tag='trailer1']" />
    <related_item path="/feed/video[@tag='trailer1']" />
  </relationship>

  <!-- rights administration for the movie itself: mirrors ownership -->
  <rights_admin owner="True" type="usage"/>
  <rights_admin owner="True" type="match"/>

  <!-- Claim the video and set a usage policy -->
  <claim type="audiovisual"
         asset="/feed/asset[@tag='trailer1']"
         video="/feed/video[@tag='trailer1']"
         rights_admin="/feed/rights_admin[@type='usage']"
         rights_policy="/external/rights_policy[@name='Monetize worldwide']"/>

  <!-- Associate the trailer asset with the movie it promotes -->
  <relationship>
    <item path="/feed/video[@tag='trailer1']" />
    <related_item path="/external/video[@type='movie'][@custom_id='w1234']" />
  </relationship>


  <!-- Set default match policy for the asset using a policy saved in CMS -->
  <relationship>
    <item path="/feed/rights_admin[@type='match']" />
    <item path="/external/rights_policy[@name='Monetize everywhere']" />
    <related_item path="/feed/asset[@tag='trailer1']" />
  </relationship>
</feed>
Add a caption file for an existing video

This feed uploads a caption file (in SubRip format) for an existing video.

<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0">
        
<file type="timed_text">
  <filename>caption.srt</filename>
</file>

<caption>
  <format>srt</format>
  <language>EN</language>
</caption>

<relationship>
  <item path="/feed/caption[1]" />
  <item path="/feed/file[1]" />
  <related_item path="/external/video[@id='VIDEO_ID_1']" />
</relationship>

</feed>
Blocking embedding at specific domains

This feed uploads a video and prevents users from embedding the video at particular domains. The domain blacklist applies to this video only; to block embedding for all videos, set the domains on the Settings Overview page.

When specifying a domain to block, include a wildcard before and after the domain name so that the block applies to subdomains and to URLs that include variables.

To block embedding generally with certain exceptions, use the <domain_whitelist> tag in place of <domain_blacklist>.
<?xml version="1.0"?>
<feed
   xmlns:doc="http://www.youtube.com/schemas/cms/2.0/doc"
   xmlns="http://www.youtube.com/schemas/cms/2.0"
   notification_email="mailinglist@example.com" channel="TestChannel">
  
   <!-- define the video file -->
 <file type="video">
    <filename>wv-webvideo-02.mov</filename>
  </file>

   <!-- define the video metadata -->
<video>
    <allow_comments>Approve</allow_comments>
    <allow_embedding>False</allow_embedding>
    <allow_ratings>True</allow_ratings>
    <artwork type="custom_thumbnail" path="/feed/file[2]" />
    <channel>channelName</channel>
    <description>Description of another test video.</description>
    <genre>Entertainment</genre>
    <keyword>Dave</keyword>
    <keyword>Internet</keyword>
    <public>True</public>
    <title>I am on the Internet</title>
    <domain_blacklist>*.example.com*, *.sample.com*</domain_blacklist>
  </video>

   <!-- link the file and video metadata -->
<relationship>
    <item path="/feed/video[1]" />
    <related_item path="/feed/file[1]" />
  </relationship>

  </feed>
Was this article helpful?
How can we improve it?
Resources for Creators

Check out the creator resources available to help you build your channel and connect with the community.