Program Types

Prev Next

When you integrate your metadata, you need to know what types of programming you have on your App, because each type supports different fields. There are several main program types:

  • Movie: A film that is primarily theatrical, made-for-TV, direct-to-video, or streaming-first.
  • SeriesMaster: A top-level ID for sets of two or more programs, which are typically episodes but can also be SportingEvent or Other; SeriesMaster also stores data that applies to the entire series.
  • TvSeason: A season of episodes within a TV series.
  • Episode: An individual airing of a TV series, linked to a SeriesMaster, typically ordered through episode number and linked to a TvSeason.
  • SportingEvent: An athletic event or other team-vs-team game, not including pre/post-game shows, documentaries, or specials.
  • Other: A one-time-only (OTO) program that is not an Episode, Movie, SportingEvent, or SeriesMaster (for example, the Oscars).

There are also short form program types that are tied to longer content. Some short form types include:

  • Preview: A collection of scenes for viewers to see what a piece of content is about, such as a teaser or trailer for an upcoming movie.
  • Extra: An additional or bonus piece of content, such as a behind-the-scenes interview or deleted scene for a program.

Note: There is overlap in which types support specific fields, but not all types support all fields, and no type supports every field.

The following section provides lists of the fields used for each specific program type, with links to descriptions of each field. To view the list of all fields regardless of program type, see the full Metadata Specifications. To view examples of the program types, see the Examples section below.

Movie

General Fields

Content Fields

Distribution Rights Fields

Content Rights Fields (legacy)

SeriesMaster

General Fields

TvSeason

General Fields

Episode

General Fields

Content Fields

Distribution Rights Fields

Content Rights Fields (legacy)

SportingEvent

General Fields

Distribution Rights Fields

Examples

Movie Example

<item>
    <title>Harry Potter and the Goblet of Fire</title>
    <releaseYear>2018</releaseYear><!-- if you have a date, use pub date, if you only have a year use release year-->
    <!-- video asset metadata -->
    <gmrss:videoAssetId provider="NBC" namespace="SkyShowtime">GMO_1111</gmrss:videoAssetId>
    <gmrss:programVariantId provider="NBC" namespace="SkyShowtime-en-US">GTMV0000645117</gmrss:programVariantId>

    <gmrss:videoForm>long</gmrss:videoForm>

    <gmrss:distributor>SkyShowtime</gmrss:distributor>
    <gmrss:brand>Warner Brothers</gmrss:brand>
    <gmrss:durableAppId>appId</gmrss:durableAppId>

    <gmrss:entityType>Movie</gmrss:entityType>
    <gmrss:externalEntityId>entity123</gmrss:externalEntityId>

    <gmrss:shortDescription>Harry Potter</gmrss:shortDescription>
    <gmrss:mediumDescription>Harry Potter and the Goblet of Fire medium synopsis.</gmrss:mediumDescription>
    <gmrss:longDescription>Hermione and Ron try to help Harry win the tri-wizard tournament.</gmrss:longDescription>
    <gmrss:duration>3800</gmrss:duration>

    <!-- ratings -->
    <media:rating scheme="urn:sky:bskybca:gb">5</media:rating>
    <media:rating scheme="urn:sky:advisory" subRatings = "private:VIOLENCE">N/A</media:rating>

    <!-- tags: from NBC will of 2 types: without type for Genre/Subgenre and with Type for ProviderPlacement. NBC tags will be plain text. Gracenote be video descriptor id -->
    <gmrss:tagReference provider="NBC">Genre:Movies</gmrss:tagReference>
    <gmrss:tagReference provider="NBC">Subgenre:Sci-Fi &amp; Fantasy</gmrss:tagReference>
    <gmrss:tagReference provider="GRACENOTE_VIDEO_DESCRIPTOR">GN164S651XQJ19N</gmrss:tagReference>
    <gmrss:tagReference provider="NBC" type="ProviderPlacement">action</gmrss:tagReference>

    <!-- entity ref -->
    <gmrss:entityReference provider="NBC" entityType="EntityCollection" isPrimary="true">GTMV0000645117</gmrss:entityReference>
    <gmrss:entityReference provider="GRACENOTE" entityType="Movie">SH030065870000</gmrss:entityReference>

    <!-- person reference: similar to tags, only Gracenote references expected in MVP, characters not supported-->
     <gmrss:creditAssociation type="Actor" partName="Albus Dumbledore" >
        <gmrss:personReference provider="NBC" namespace="SkyShowtime-en-US">NBC_ID_MM</gmrss:personReference>
        <gmrss:partReference provider="NBC" namespace="SkyShowtime-en-US">NBC_ID_DUMBLE</gmrss:partReference>
     </gmrss:creditAssociation>

    <!--end display block-->
    <!-- Content metadata: repeated for each content type-->
    <media:group>
        <media:content duration="5047" lang="en-US" gmrss:videoQuality="HD" gmrss:framerate="23.976" gmrss:sap="false" gmrss:dvs="true" gmrss:subtitle="true" gmrss:cc="true" type="MPEG-DASH" url=[https://$%7bUS_VOD_PROD%7d/pub/global/%20xYh/EIw/SKYSHOWTIME_1611852294372.3757_01/cmaf/mpeg_cenc/master_cmaf.mpd]https://${US_VOD_PROD}/pub/global/ xYh/EIw/SKYSHOWTIME_1611852294372.3757_01/cmaf/mpeg_cenc/master_cmaf.mpd>
            <gmrss:audioTrack dvs="false" index="0" lang="en-US" audioType="Surround" original="true"/>
            <gmrss:audioTrack dvs="false" index="1" lang="en-US" audioType="Stereo"/>
            <gmrss:audioTrack dvs="false" index="2" lang="es-ES" audioType="Surround"/>
            <gmrss:audioTrack dvs="false" index="3" lang="es-ES" audioType="Stereo"/>
            <gmrss:subtitle lang="en-US" role="cc" />
            <gmrss:subtitle lang="pl-PL" role="subtitle" />
            <gmrss:subtitle lang="pl-PL" role="forcedNarrative" />
            <gmrss:subtitle lang="nl-NL" role="subtitle" />
            <gmrss:subtitle lang="nb-NO" role="subtitle" />
            <gmrss:subtitle lang="sv-SE" role="subtitle" />
            <gmrss:subtitle lang="da-DK" role="subtitle" />
            <gmrss:subtitle lang="fi-FI" role="subtitle" />
            <gmrss:videoCodec>H.264</gmrss:videoCodec>
            <gmrss:audioCodec>AAC</gmrss:audioCodec>
            <gmrss:transport>HLS</gmrss:transport>
            <gmrss:playerConfig key="ad_compatibility_encoding_profile">cmaf-hls-24fps-peacock-v1</gmrss:playerConfig>
            <gmrss:transferMode>Streaming</gmrss:transferMode>
            <gmrss:container>ISOBMFF</gmrss:container>
            <gmrss:protectionScheme>CBCS</gmrss:protectionScheme>
            <gmrss:protectionSystem>CKS</gmrss:protectionSystem>
            <gmrss:protectionMethod>PLAYREADY</gmrss:protectionMethod>
            <gmrss:protectionMethod>WIDEVINE</gmrss:protectionMethod>
            <gmrss:protectionKey>"TEST-US-SLE-1-CENC:peacock_801363"</gmrss:protectionKey>
        </media:content>
    </media:group>

    <!-- Coppa/GDPR info: not a part of MVP used as flag for DAI-->
    <gmrss:subjectToCoppa xsi:nil="false" xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance />

    <!-- Rights metadata -->
    <gmrss:contentProviderName>NBC</gmrss:contentProviderName>
    <gmrss:distributionRights>
        <gmrss:valid>start=2021-04-20T00:00:00Z;end=2120-01-01T05:00:00Z;scheme=W3C-DTF</gmrss:valid>
        <gmrss:contentClass>SVOD</gmrss:contentClass>
        <gmrss:contentTier>Basic</gmrss:contentTier>
        <gmrss:playRegions>
            <gmrss:playRegion type="ISODIVISION">PL</gmrss:playRegion>
        </gmrss:playRegions>
    </gmrss:distributionRights>

    <gmrss:restriction type="REST:PLAYTERR">
         <gmrss:playRegion>PL</gmrss:playRegion>
         <gmrss:usage>inclusive</gmrss:usage>
     </gmrss:restriction>
     <gmrss:restriction type="REST:PLATFORMCAPABILITY">
         <gmrss:platformCapability>RECS</gmrss:platformCapability>
         <gmrss:usage>exclusive</gmrss:usage>
     </gmrss:restriction>

     <media:status reason="add" state="active"/>
     <gmrss:languageDetails intendedAudience="en-GB"/>

  </item>  

SeriesMaster Example

<item>
    <title>Angry Birds Toons [TV Series]</title>
    <description type="text/html">Brings to life the characters and adventures from the Angry Birds game.</description>
    <gmrss:seriesAssetId provider="PROVIDER">736369</gmrss:seriesAssetId>
    <gmrss:programVariantId provider="PROVIDER">736369</gmrss:programVariantId>
    <gmrss:entityReference provider="GRACENOTE" entityType="SeriesMaster">SH017110630000</gmrss:entityReference>
    <gmrss:entityType>SeriesMaster</gmrss:entityType>
    <media:status reason="add" state="active"/>
    <gmrss:languageDetails title="en-US" description="en-US" originalAudio="en-US" intendedAudience="en-US"/>
</item>

TvSeason Example

<item>
   <title>The Office Season 1</title>
   <description type="text/html">Season 1 of the acclaimed Comedy about people who work in an office.</description>
   <gmrss:seasonAssetId namespace="PROVIDER" provider="PROVIDER">GTMV0000111111-1</gmrss:seasonAssetId>
   <gmrss:seasonNumber>1</gmrss:seasonNumber>
   <gmrss:entityType>TvSeason</gmrss:entityType>
   <media:status reason="add" state="active"/>
   <gmrss:languageDetails title="en-US" description="en-US" intendedAudience="en-US"/>
   <gmrss:entityReference provider="PROVIDER" entityType="SeriesMaster">736369</gmrss:entityReference>
   <gmrss:entityReference provider="PROVIDER" namespace="PROVIDER" entityType="EntityCollection" isPrimary="true">GTMV0000111111-1</gmrss:entityReference>
</item>

Episode Example

<item>
    <title>Basketball</title>
    <gmrss:seriesTitle>The Office</gmrss:seriesTitle>
    <gmrss:shortDescription>Basketball</gmrss:shortDescription>
    <gmrss:mediumDescription>Basketball medium Description</gmrss:mediumDescription>
    <gmrss:longDescription>Facing a basketball game against the warehouse employees, Michael raises the stakes and bets on his handpicked team.</gmrss:longDescription>

    <pubDate>1312416000000</pubDate>
    <gmrss:videoAssetId namespace="SkyShowtime" provider="NBC">GMO_14713006559</gmrss:videoAssetId>
    <gmrss:programVariantId namespace="SkyShowtime:en-US" provider="NBC">GTM1234</gmrss:programVariantId>
    <gmrss:videoForm>long</gmrss:videoForm>

    <gmrss:brand>nbcentertainment</gmrss:brand>
    <gmrss:distributor>SkyShowtime</gmrss:distributor>
    <gmrss:durableAppId>appId</gmrss:durableAppId>
    <gmrss:entityType>Episode</gmrss:entityType>
    <gmrss:seasonNumber>1</gmrss:seasonNumber>
    <gmrss:episodeNumber>5</gmrss:episodeNumber>
    <gmrss:duration>3800</gmrss:duration>
    <gmrss:externalEntityId>entity123</gmrss:externalEntityId>
    <gmrss:externalSeriesId>series123</gmrss:externalSeriesId>

    <!--If we needed both ratings included on the primary program -->
    <media:rating scheme="urn:sky:bskybca:gb">5</media:rating>

    <!-- tags: from NBC will of 2 types: without type for Genre/Subgenre and with Type for ProviderPlacement. NBC tags will be plain text. Gracenote be video descriptor id -->
    <gmrss:tagReference provider="NBC">Genre:Movies</gmrss:tagReference>
    <gmrss:tagReference provider="NBC">Subgenre:Sci-Fi &amp; Fantasy</gmrss:tagReference>
    <gmrss:tagReference provider="GRACENOTE_VIDEO_DESCRIPTOR">GN164S651XQJ19N</gmrss:tagReference>
    <gmrss:tagReference provider="NBC" type="ProviderPlacement">action</gmrss:tagReference>

    <!-- Reference to the Gracenote episode -->
    <gmrss:entityReference provider="GRACENOTE" entityType="Episode">EP034829100019</gmrss:entityReference>

    <!-- Reference to english series -->
    <gmrss:entityReference provider="NBC" entityType="SeriesMaster">SM5678</gmrss:entityReference>

    <!-- Entity Collection Reference links multi-language programs together. They should reference the programVariant id of the primary program -->
    <gmrss:entityReference provider="NBC" entityType="EntityCollection" isPrimary="true">GTMV0000645117</gmrss:entityReference>

    <!-- Content metadata: repeated for each content type-->
    <media:group>
        <media:content duration="5047" lang="en-US" gmrss:videoQuality="HD" gmrss:framerate="23.976" gmrss:sap="false" gmrss:dvs="true" gmrss:subtitle="true" gmrss:cc="true" type="M3U" url=[https://$%7bUS_VOD_PROD%7d/pub/global/%20xYh/EIw/SKYSHOWTIME_1611852294372.3757_01/cmaf/mpeg_cenc/master_cmaf.m3u8]https://${US_VOD_PROD}/pub/global/ xYh/EIw/SKYSHOWTIME_1611852294372.3757_01/cmaf/mpeg_cenc/master_cmaf.m3u8>
            <gmrss:audioTrack dvs="false" index="0" lang="en-US" audioType="Surround" original="true"/>
            <gmrss:audioTrack dvs="false" index="1" lang="en-US" audioType="Stereo"/>
            <gmrss:audioTrack dvs="false" index="2" lang="es-ES" audioType="Surround"/>
            <gmrss:audioTrack dvs="false" index="3" lang="es-ES" audioType="Stereo"/>
            <gmrss:subtitle lang="en-US" role="cc" />
            <gmrss:subtitle lang="pl-PL" role="subtitle" />
            <gmrss:subtitle lang="pl-PL" role="forcedNarrative" />
            <gmrss:subtitle lang="nl-NL" role="subtitle" />
            <gmrss:subtitle lang="nb-NO" role="subtitle" />
            <gmrss:subtitle lang="sv-SE" role="subtitle" />
            <gmrss:subtitle lang="da-DK" role="subtitle" />
            <gmrss:subtitle lang="fi-FI" role="subtitle" />
            <gmrss:videoCodec>H.264</gmrss:videoCodec>
            <gmrss:audioCodec>AAC</gmrss:audioCodec>
            <gmrss:transport>HLS</gmrss:transport>
            <gmrss:playerConfig key="ad_compatibility_encoding_profile">cmaf-hls-24fps-peacock-v1</gmrss:playerConfig>
            <gmrss:transferMode>Streaming</gmrss:transferMode>
            <gmrss:container>ISOBMFF</gmrss:container>
            <gmrss:protectionScheme>CBCS</gmrss:protectionScheme>
            <gmrss:protectionSystem>CKS</gmrss:protectionSystem>
            <gmrss:protectionMethod>PLAYREADY</gmrss:protectionMethod>
            <gmrss:protectionMethod>WIDEVINE</gmrss:protectionMethod>
            <gmrss:protectionKey>"TEST-US-SLE-1-CENC:peacock_801363"</gmrss:protectionKey>
        </media:content>
    </media:group>
 

   <!-- Rights metadata -->
    <gmrss:contentRights>
        <gmrss:segment>
            <gmrss:segmentCode>SKYSHOWTIME</gmrss:segmentCode>
            <gmrss:accessRole>base_d2c</gmrss:accessRole>
        </gmrss:segment>
        <gmrss:proposition>
            <gmrss:territory>PL</gmrss:territory>
            <gmrss:serviceProviderCode>SKYSHOWTIME</gmrss:serviceProviderCode>
            <gmrss:propositionCode>SKYSHOWTIME</gmrss:propositionCode>
        </gmrss:proposition>
        <gmrss:windowType>ARCHIVE</gmrss:windowType>
        <gmrss:windowMode>SVOD</gmrss:windowMode>
        <gmrss:valid>start=2021-01-01T00:00Z;end=2021-12-31T00:00Z;scheme=W3C-DTF</gmrss:valid>
        <gmrss:restriction type="REST:PLAYTERR">
             <gmrss:playRegion>PL</gmrss:playRegion>
             <gmrss:usage>inclusive</gmrss:usage>
         </gmrss:restriction>
         <gmrss:restriction type="REST:PLATFORMCAPABILITY">
             <gmrss:platformCapability>RECS</gmrss:platformCapability>
             <gmrss:usage>exclusive</gmrss:usage>
         </gmrss:restriction>
        <gmrss:downloadable>true</gmrss:downloadable>
        <gmrss:streamable>true</gmrss:streamable>
    <!-- Device Restrictions will be hardcoded downstream for MVP and do not need to be sent via OpenIngest-->
     </gmrss:contentRights>
     
    <gmrss:restriction type="REST:PRIVACY">
        <gmrss:usage>inclusive</gmrss:usage>
        <gmrss:privacyIdentifier>subjectToCoppa</gmrss:privacyIdentifier>
    </gmrss:restriction>
    
    <media:status reason="add" state="active"/>
    <gmrss:languageDetails intendedAudience="en-US"/>
</item>

SportingEvent Example

<rss xmlns:gmrss="urn:uri:merlin-gold-FIXME" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/">
    <channel>
        <title>sample feed</title>
        <description>sample feed</description>
        <item>
            <title>Broncos v Panthers</title>
            <gmrss:seriesTitle>National Rugby League</gmrss:seriesTitle>
            <description>....</description>
            <gmrss:videoAssetId provider="SAMP" namespace="SAMP">199978</gmrss:videoAssetId>
            <gmrss:programVariantId provider="SAMP" namespace="SAMP">199978</gmrss:programVariantId>
            <gmrss:entityType>SportingEvent</gmrss:entityType>
            <gmrss:brand>SAMP</gmrss:brand>
            <media:rating scheme="urn:ncs">G</media:rating>
            <gmrss:distributionRights>
                <gmrss:valid>start=2023-05-18T09:50Z;end=2023-05-25T12:45Z;scheme=W3C-DTF</gmrss:valid>
                <gmrss:contentCatalog>LIVE</gmrss:contentCatalog>
                <gmrss:contentClass>SVOD</gmrss:contentClass>
                <gmrss:contentTier>basic</gmrss:contentTier>
                <gmrss:playRegions>
                    <gmrss:playRegion type="ISODIVISION">ZA</gmrss:playRegion>
                </gmrss:playRegions>
            </gmrss:distributionRights>
            <media:status reason="add" state="active"/>
            <gmrss:languageDetails title="en-GB" description="en-GB" intendedAudience="en-GB" originalAudio="en-GB"/>
            <media:group>
                <media:content type="APP" url="" duration="15300" gmrss:videoQuality="HD" gmrss:colorDepth="SDR">
                    <gmrss:audioTrack dvs="false" index="0" lang="en-GB" audioType="Stereo" original="true"/>
                    <gmrss:subtitle lang="en-GB" role="cc"/>
                </media:content>
            </media:group>
            <gmrss:displayStartDate>2023-05-18T08:30Z</gmrss:displayStartDate>
            <gmrss:liveWindowEnd>2023-05-18T12:45Z</gmrss:liveWindowEnd>
            <gmrss:streamingClass>EphemeralStream</gmrss:streamingClass>
            <gmrss:availabilityStatus>UPCOMING</gmrss:availabilityStatus>
            <gmrss:contentProviderName>SAMP</gmrss:contentProviderName>
            <gmrss:airingType>LIVE</gmrss:airingType>
            <gmrss:sportsTeamReference provider="SAMP" type="HOME" competition="true">Brisbane</gmrss:sportsTeamReference>
            <gmrss:sportsTeamReference provider="SAMP" type="AWAY" competition="true">Penrith</gmrss:sportsTeamReference>
            <gmrss:sportsLeagueReference provider="SAMP">NRL</gmrss:sportsLeagueReference>
            <gmrss:tagReference provider="MERLIN_OTT" type="Genre">Rugby league</gmrss:tagReference>
   <!-- external IDs are inserted into the deeplink format -->
            <gmrss:externalAssetId>IH000401298</gmrss:externalAssetId>
            <gmrss:externalEntityId>IH000401298</gmrss:externalEntityId>
            <gmrss:externalSeriesId    >SI000000001</gmrss:externalSeriesId>
            <gmrss:durableAppId>com.sky.SAMP</gmrss:durableAppId>       
        </item>
    </channel>
</rss>