节目目录

节目目录包含目录中的所有节目实体。节目表引用节目目录的id属性来进行节目标识符命名空间处理。ProgramCatalog元素可以根据需要包含任意数量的条目，以及任意数量的每种类型。

属性	详细信息
父元素	`DataCollections`
数据类型	ProgramCatalogType
子元素	描述
`Delete`	用于从目录中删除节目的管理动词。
`Movie`	代表电影节目，其内容未连续化，在最初发行时已预先录制。
`TVEpisode`	代表电视剧集节目，必须与电视季和电视连续剧相关。
`TVSeason`	代表电视季节目。电视季是分层实体。
`TVSeries`	代表电视连续剧节目。电视连续剧是分层实体。
`SportsEvent`	代表一个体育节目，模拟包含一名或多名参与者或团队的体育赛事。
`Event`	代表一个活动节目，用于在可以直播的物理地点上演的独立节目。仅用于非体育赛事。
`OffAir`	代表非播出节目，它向客户传达目前没有节目正在播出。
`Other`	代表其他类节目，为不属于明确类别的节目类型提供基本信息。
`ToBeAnnounced`	代表待公布的节目，是即将到来的节目的占位符。
`Extra`	代表与节目相关的额外内容。
属性	描述
`id`	节目目录的标识符。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`action`	指明在提交目录时应采取哪个操作。默认值为`upsert`。有效值：`upsert`、`replace`。数据类型： CatalogActionType

↑返回顶部

一个管理动词，能够以编程方式从目录中删除项目。当引入系统处理Delete元素时，它会将具有指定ID的项目从系统中移除。

属性	详细信息
父元素	`DataCollections` `ProgramCatalog` `ScheduleCatalog` `OfferCatalog` `StationCatalog` `LineupCatalog` `PolicyCatalog`
数据类型	DeleteType
属性	描述
`id` 必需	要删除的实体的唯一标识符。数据类型： ID
`version`	要删除的实体的版本。必须大于或等于当前实体版本。默认值为`1`。数据类型：long

↑返回顶部

任何长度的节目，其内容未连续化，在最初发行时已预先录制。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	MovieType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`edit`	以逗号分隔的节目编辑类型列表。允许您指定多种编辑类型，例如`"DIRECTORSCUT,UNRATED"`。有效的编辑类型包括`ORIGINAL`、`DIRECTORSCUT`、`EXTENDED`, `UNRATED`、`CENSORED`、`REGIONALIZED`、`COLORIZED`、`SHORTENED`。数据类型： EditTypeList

↑ 返回顶部

代表电视剧集节目，必须与电视季和电视连续剧相关。电视剧集是更大型作品（电视季和电视连续剧）的一部分。必须在电视连续剧的电视季开始之前将其添加到节目目录中。在添加电视剧集之前，必须添加电视季。

您可以将圣诞节特别节目等特别剧集建模为电视剧集并引用电视连续剧。特别剧集还必须有发行年份。

电视剧集要求

不遵守这些要求可能会导致错误报告。

在引用依赖父节目的子节目之前发送依赖父节目。
在添加相应的电视季之前添加电视连续剧。
在添加电视剧集之前添加电视季。
在删除父节目之前，先删除父节目的子元素。
在删除季之前，请移除其所有剧集。
在删除连续剧之前，请删除其所有季。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	TVEpisodeType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Relationships` 必需	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`edit`	以逗号分隔的节目编辑类型列表。允许您指定多种编辑类型，例如`"DIRECTORSCUT,UNRATED"`。有效的编辑类型包括`ORIGINAL`、`DIRECTORSCUT`、`EXTENDED`, `UNRATED`、`CENSORED`、`REGIONALIZED`、`COLORIZED`、`SHORTENED`。数据类型： EditTypeList

<TVEpisode id="JAM_S01E01" version="1">
    <ExternalIds>
        <ExternalId scheme="imdb">tt4318858</ExternalId>
        <ExternalId scheme="asin">B01578XLQU</ExternalId>
    </ExternalIds>
    
    <Titles>
        <Title language="en" territories="US,GB,CA,AU" default="true">Just Add Magic</Title>
        <Title language="es" territories="ES,MX">Solo Añade Magia</Title>
        <Title language="fr" territories="FR,CA">Il Suffit d'Ajouter de la Magie</Title>
        <Title language="de" territories="DE,AT,CH">Einfach Magie Hinzufügen</Title>
    </Titles>

    <Descriptions>
        <Description language="en" territories="US,GB,CA,AU">
            Kelly Quinn和她的两个好朋友在她的阁楼里发现了一本神秘的烹饪书，并发现它的食谱很神奇。当他们试图利用这本书来帮助Kelly的祖母时，却发现每道食谱都有相应代价。
        </Description>
    </Descriptions>

    <Synopses>
        <Synopsis language="en" territories="US,GB,CA,AU">
            当Kelly Quinn在阁楼里偶然发现祖母的神秘烹饪书时，她和朋友Darbie及Hannah发现这本书里写满了神奇的食谱。As they attempt to help Kelly's grandmother, who hasn't spoken in years, they learn that every magical recipe comes with unexpected consequences and they must be careful with their newfound powers.
        </Synopsis>
    </Synopses>

    <Images>
        <Image category="episodic" language="en" territories="GLOBAL" 
              aspectRatio="16:9" mimeType="image/jpeg" resolution="HD">
            https://example.com/images/just_add_magic/s01e01.jpg
        </Image>
    </Images>

    <Genres>
        <Genre scheme="ember_genre">ember_genre_family</Genre>
        <Genre scheme="ember_genre">ember_genre_fantasy</Genre>
        <Genre scheme="ember_genre">ember_subgenre_family_kids</Genre>
    </Genres>

    <Keywords>
        <Keyword language="en" territories="GLOBAL">魔法</Keyword>
        <Keyword language="en" territories="GLOBAL">烹饪</Keyword>
        <Keyword language="en" territories="GLOBAL">友谊</Keyword>
        <Keyword language="en" territories="GLOBAL">家庭</Keyword>
        <Keyword language="en" territories="GLOBAL">冒险</Keyword>
    </Keywords>

    <Ratings>
        <Rating system="TV" certification="TV-Y7">
            <Descriptors>
                <Descriptor code="FV">Fantasy Violence</Descriptor>
            </Descriptors>
        </Rating>
    </Ratings>

    <Studios>
        <Studio>
            <StudioNames>
                <StudioName>Amazon Studios</StudioName>
            </StudioNames>
        </Studio>
    </Studios>

    <Credits>
        <Credit>
            <PersonNames>
                <PersonName>Olivia Sanabia</PersonName>
            </PersonNames>
            <ContributionNames>
                <ContributionName>演员</ContributionName>
            </ContributionNames>
            <CharacterNames>
                <CharacterName language="en" territories="GLOBAL">Kelly Quinn</CharacterName>
            </CharacterNames>
            <ExternalIds>
                <ExternalId scheme="imdb">nm3821346</ExternalId>
            </ExternalIds>
        </Credit>
        <!-- 其他工作人员 -->
    </Credits>

    <RunLengths>
        <RunLength territories="GLOBAL">PT27M</RunLength>
    </RunLengths>

    <PictureColor>color</PictureColor>

    <ReleaseDates>
        <ReleaseDate territories="GLOBAL" releaseType="streaming">2015-01-15</ReleaseDate>
    </ReleaseDates>

    <Relationships>
        <isEpisodeOfSeries programRef="JAM_SERIES" episodeNum="1"/>
    </Relationships>
</TVEpisode>

↑返回顶部

代表电视季节目。电视季是层次结构实体，将电视连续剧作为父实体，可播放的电视剧集作为子实体。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	TVSeasonType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`ReleaseDates`	`ReleaseDate`元素列表。
`Relationships` 必需	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`edit`	以逗号分隔的节目编辑类型列表。允许您指定多种编辑类型，例如`"DIRECTORSCUT,UNRATED"`。有效的编辑类型包括`ORIGINAL`、`DIRECTORSCUT`、`EXTENDED`, `UNRATED`、`CENSORED`、`REGIONALIZED`、`COLORIZED`、`SHORTENED`。数据类型： EditTypeList

↑返回顶部

代表电视连续剧节目。电视连续剧是分层实体。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	TVSeriesType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`ReleaseDates`	`ReleaseDate`元素列表。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`edit`	以逗号分隔的节目编辑类型列表。允许您指定多种编辑类型，例如`"DIRECTORSCUT,UNRATED"`。有效的编辑类型包括`ORIGINAL`、`DIRECTORSCUT`、`EXTENDED`, `UNRATED`、`CENSORED`、`REGIONALIZED`、`COLORIZED`、`SHORTENED`。数据类型： EditTypeList

↑ 返回顶部

代表一个体育节目，模拟包含一名或多名参与者或团队的体育赛事。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	SportsEventType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Venues`	`Venue`元素列表。
`Sports`	`Sport`元素列表。
`Leagues`	`League`元素列表。
`Season`	正在举行的比赛所对应赛季的官方名称或编号。
`Tournament`	与体育节目或赛事相关的锦标赛。
`Round`	与锦标赛或体育节目比赛相关的比赛轮次。
`Teams`	`Team`元素列表。
`Players`	比赛或赛事的参赛选手名单。
`Gender`	比赛或赛事的性别详情。
`Format`	比赛或赛事的形式详情。
`EventDateTime`	实际节目的开始时间，不一定是广播的开始时间。例如，在美式足球中，这个时间被称为“开球”，而对于篮球来说，则称为“开赛跳球”。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long

<SportsEvent id="NFLS52W05G4" version="1648486014">
    <ExternalIds>
        <ExternalId scheme="SportsRadar">SR123456789012</ExternalId>
    </ExternalIds>
    <Titles>
        <Title language="en"
              territories="US"
              default="true">巴尔的摩对克利夫兰</Title>
    </Titles>
    <Descriptions>
        <Description language="en"
                    territories="US"
                    default="true">克利夫兰布朗队在克利夫兰的M&amp;T Bank体育场主场迎战巴尔的摩乌鸦队</Description>
    </Descriptions>
    <Synopses>
        <Synopsis language="en"
                  territories="US"
                  default="true">布朗队教练Kevin Stefanski与乌鸦队教练John Harbaugh展开较量，这场蓝领球队之间的宿敌对决预计将上演一场进攻大战。布朗队有主场优势，但0-3的乌鸦队渴望获胜。</Synopsis>
    </Synopses>
    <Images>
        <Image category="cover"
              language="en"
              territories="US"
              aspectRatio="16:9"
              mimeType="image/jpeg">
                https://i.ytimg.com/vi/4DEMG6ulA4o/maxresdefault.jpg 
            </Image>
        <Image category="background"
              aspectRatio="16:9"
              mimeType="image/jpeg">
                https://i.ytimg.com/vi/4DEMG6ulA4o/maxresdefault.jpg
            </Image>
    </Images>
    <Genres>
        <Genre>ember_genre_sports_programming</Genre>
    </Genres>
    <Keywords>
        <Keyword language="en"
                territories="US">足球</Keyword>
        <Keyword language="es"
                territories="US">fútbol americano</Keyword>
        <Keyword language="en"
                territories="GB">美式足球</Keyword>
    </Keywords>
    <Ratings>
        <Rating system="电视家长指南"
                certification="TVG"/>
    </Ratings>
    <Studios>
        <Studio>
            <StudioNames>
                <StudioName>CBS Sports</StudioName>
            </StudioNames>
        </Studio>
    </Studios>
    <RunLengths>
        <RunLength>PT3H</RunLength>
    </RunLengths>
    <PictureColor>颜色</PictureColor>
    <ReleaseDates>
        <ReleaseDate>2020-05-14</ReleaseDate>
    </ReleaseDates>
    <Venues>
        <Venue>
            <VenueNames>
                <VenueName>M&amp;T Bank体育场</VenueName>
                <VenueName language="es">Estadio M&amp;T Bank</VenueName>
            </VenueNames>
            <Address>
                <City>克里夫兰</City>
                <StateOrProvince>俄亥俄</StateOrProvince>
                <Country>美国</Country>
            </Address>
        </Venue>
    </Venues>
    <Sports>
        <Sport>
            <SportNames>
                <SportName>美式足球</SportName>
            </SportNames>
        </Sport>
    </Sports>
    <Leagues>
        <League>
            <LeagueNames>
                <LeagueName>全国足球联赛</LeagueName>
            </LeagueNames>
            <ExternalIds>
                <ExternalId scheme="sportsRadar">lg3344</ExternalId>
            </ExternalIds>
        </League>
    </Leagues>
    <Teams>
        <Team homeTeam="true">
            <TeamNames>
                <TeamName>克利夫兰布朗</TeamName>
            </TeamNames>
            <ExternalIds>
                <ExternalId scheme="sportsRadar">sr2345</ExternalId>
            </ExternalIds>
        </Team>
        <Team>
            <TeamNames>
                <TeamName>巴尔的摩乌鸦</TeamName>
            </TeamNames>
            <ExternalIds>
                <ExternalId scheme="sportsRadar">sr3425</ExternalId>
            </ExternalIds>
        </Team>
    </Teams>
    <EventDateTime>2020-05-14T13:20:00Z</EventDateTime>
</SportsEvent>

↑ 返回顶部

将活动用于在可以直播的物理地点上演的独立节目。例如，“现场援助音乐会”、“玫瑰花车游行”和电视马拉松。不要将Event元素用于体育运动。活动也可以是非体育锦标赛或比赛，例如“美国小姐选美大赛”。如果活动分几轮进行，但与电视连续剧无关，则应使用“锦标赛”和“轮次”这两个术语。例如，“Concours de Genève”是一个独立于电视报道的年度多日音乐节和比赛。“威斯敏斯特养犬俱乐部狗展”是音乐和表演艺术以外的非体育活动的又一个例子。

不要在持续一季的真人秀电视剧中使用Event元素。例如，“美国偶像”是一部电视连续剧，其内容结构模仿锦标赛，但不是活动。同样，其他竞赛式的真人秀电视剧，例如“幸存者”、“老大哥”、“美国之声”和“与星共舞”，也不是活动。特别剧集（例如节日特别节目）不是活动。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	EventType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Venues`	`Venue`元素列表。
`Tournament`	与体育节目或赛事相关的锦标赛。
`Round`	与锦标赛或体育节目比赛相关的比赛轮次。
`EventDateTime`	实际节目的开始时间，不一定是广播的开始时间。例如，在美式足球中，这个时间被称为“开球”，而对于篮球来说，则称为“开赛跳球”。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long

<Event id="MUSIC_FEST_2024" version="1">
    <!-- 基本活动信息 -->
    <Titles>
        <Title language="en" territories="US,CA" default="true">
            2024年夏季音乐节 - 中央公园直播
        </Title>
        <Title language="es" territories="MX">
            Festival de Música Verano 2024 - En vivo desde Central Park
        </Title>
    </Titles>

    <!-- 活动描述 -->
    <Descriptions>
        <Description language="en" territories="US,CA" default="true">
            一年一度的夏季音乐节，由顶级艺术家在中央公园现场表演。
            头牌人物包括摇滚乐队、流行歌星和著名DJ。
        </Description>
    </Descriptions>

    <!-- 详细提要 -->
    <Synopses>
        <Synopsis language="en" territories="US,CA" default="true">
            加入我们，参加夏季最大的音乐盛会！ 这场6小时的现场直播将奉上 
            摇滚乐队、流行歌星、著名DJ等的表演。特邀嘉宾出席、
            幕后花絮，以及对艺术家的独家采访。主持人 
            著名主持人，现场解说并和人群互动。
        </Synopsis>
    </Synopses>

    <!-- 活动图像 -->
    <Images>
        <Image category="background" territories="US,CA" 
               aspectRatio="16:9" mimeType="image/jpeg">
            https://images.example.com/musicfest/background.jpg
        </Image>
        <Image category="cover" language="en" territories="US,CA" 
               aspectRatio="16:9" mimeType="image/jpeg">
            https://images.example.com/musicfest/cover.jpg
        </Image>
    </Images>

    <!-- 活动关键字 -->
    <Keywords>
        <Keyword language="en" territories="US,CA">夏日音乐节</Keyword>
        <Keyword language="en" territories="US,CA">现场音乐</Keyword>
        <Keyword language="en" territories="US,CA">音乐会</Keyword>
    </Keywords>

    <!-- 内容评级 -->
    <Ratings>
        <Rating system="USA_TV" certification="TV-PG" territories="US">
            <Descriptors>
                <Descriptor code="L">温和的语言</Descriptor>
            </Descriptors>
        </Rating>
    </Ratings>

    <!-- 制作工作室 -->
    <Studios>
        <Studio>
            <StudioNames>
                <StudioName>音乐节制作</StudioName>
            </StudioNames>
        </Studio>
    </Studios>

    <!-- 工作人员名单（主持人、表演者等）-->
    <Credits>
        <Credit>
            <PersonNames>
                <PersonName>著名主持人</PersonName>
            </PersonNames>
            <ContributionNames>
                <ContributionName>主持人</ContributionName>
           </ContributionNames>
            <ExternalIds>
                <ExternalId scheme="imdb">nm123456</ExternalId>
            </ExternalIds>
        </Credit>

        <Credit>
           <PersonNames>
                <PersonName>摇滚乐队</PersonName>
            </PersonNames>
            <ContributionNames>
                <ContributionName>表演者</ContributionName>
            </ContributionNames>
        </Credit>

        <Credit>
            <PersonNames>
                <PersonName>流行歌星</PersonName>
            </PersonNames>
            <ContributionNames>
                <ContributionName>表演者</ContributionName>
            </ContributionNames>
        </Credit>
    </Credits>

    <!-- 活动持续时间 -->
    <RunLengths>
        <RunLength territories="US,CA">PT6H</RunLength>
    </RunLengths>

    <!-- 发布信息 -->
    <ReleaseDates>
        <ReleaseDate territories="US,CA">2024-07-15</ReleaseDate>
    </ReleaseDates>

    <!-- 场地信息 -->
    <Venues>
        <Venue>
            <VenueNames>
                <VenueName language="en">中央公园大草坪</VenueName>
            </VenueNames>
            <Address>
                <Street>中央公园西</Street>
                <City>纽约</City>
                <StateOrProvince>纽约州</StateOrProvince>
                <Country>美国</Country>
                <PostalCode>10024</PostalCode>
            </Address>
        </Venue>
    </Venues>

    <!-- 活动日期/时间 -->
    <EventDateTime>2024-07-15T18:00:00Z</EventDateTime>
</Event>

↑ 返回顶部

代表非播出节目，它向客户传达目前没有节目正在播出。您可以使用OffAir提供即将推出的节目的详细信息，或以其他方式自定义非播出时段的观看体验。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	OffAirType
子元素	描述
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Tags`	`Tag`元素列表。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long

↑返回顶部

代表其他类型节目，为不属于明确类别的节目类型提供基本信息。不得使用Other来避免创建TVSeries或TVSeason实体。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	OtherType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Sports`	`Sport`元素列表。
`Leagues`	`League`元素列表。
`Teams`	`Team`元素列表。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long

↑ 返回顶部

代表待公布的节目，是即将到来的节目的占位符。待公布的节目仅适用于电视直播情况，并且必须在播出时解析为节目表中的实际节目。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	ToBeAnnouncedType
子元素	描述
`Titles`	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Tags`	`Tag`元素列表。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long

↑ 返回顶部

代表与节目相关的额外内容。包含以下内容类型：先导预告片、正式预告片、片段、花絮、幕后特辑、删减场景、拍摄花絮、评论音轨、访谈、精彩集锦、活动前导和活动回顾。

属性	详细信息
父元素	`ProgramCatalog`
数据类型	ExtraType
子元素	描述
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Synopses`	`Synopsis`元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。
`Images`	`Image`元素列表。
`Genres`	类型列表。
`Keywords`	由本地化字符串表示的`Keyword`元素列表。目录系统使用关键字作为节目的搜索词。
`Ratings`	`Rating`元素列表。
`Studios`	`Studio`元素列表。
`Credits`	`Credits`元素列表。
`Tags`	`Tag`元素列表。
`RunLengths`	应用于节目的本地化时长列表。
`PictureColor`	描述图片颜色特征的枚举值。
`ReleaseDates`	`ReleaseDate`元素列表。
`Sports`	`Sport`元素列表。
`Leagues`	`League`元素列表。
`Teams`	`Team`元素列表。
`Relationships`	表示内容之间的关系。
属性	描述
`id` 必需	包含仅为引用的节目保留的持久标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`category` 必需	额外内容的类别。有效值：`teaser`、`trailer`、`clip`、`featurette`、`behindthescenes`、`deletedscenes`、`bloopers`、`commentary`、`interview`、`highlights`、`preevent`、`postevent`。数据类型： ExtraCategoryType

↑返回顶部

包含外部系统标识符。允许与第三方系统交叉引用。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `Studio` `Credit` `Sport` `League` `Season` `Tournament` `Round` `Team` `Player` `Station` `Lineup`
数据类型	ExternalIdList
子元素	描述
`ExternalId` 必需	将节目或其他实体链接到外部来源。

↑返回顶部

将节目或其他实体链接到外部来源。scheme属性标识外部来源，该值是该命名空间内的有效ID。节目ID架构的部分列表包括：imdb、tms、isan、ean、upc、asin、gvd、sportsradar和stats。其他架构适用于个人和体育实体，例如队伍和队员。您还可以使用ExternalId元素来关联体育事实数据和体育节目。如果有多个外部ID可用，可以使用它们。

ExternalStation元素只能有一个ExternalId。ExternalStation适用的外部ID架构是tms和gvd。

属性	详细信息
父元素	`ExternalIds` `ExternalStation`
数据类型	ExternalIdType - 具有必需`scheme`属性的string。
属性	描述
`scheme` 必需	外部ID的来源。数据类型：string

↑ 返回顶部

Title元素列表。Title元素代表节目的标题及其适用的区域设置。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `OffAir` `ToBeAnnounced` `Station` `ExternalStation`
数据类型	TitleList
子元素	描述
`Title` 必需	一个本地化字符串，表示节目的标题及其适用的语言和地区。

↑返回顶部

一个本地化字符串，表示节目的标题及其适用的语言和地区。default属性为原始发行地区指定标题，是任何未指定的语言的备用标题。在指定了特定于地区的值时，使用此类值。

属性	详细信息
父元素	`Titles` `SeriesTitles`
数据类型	LocalizedStringType
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

由本地化字符串表示的Description元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `OffAir` `ToBeAnnounced` `Station`
数据类型	DescriptionList
子元素	描述
`Description` 必需	一个本地化字符串，用于描述节目，但不会透露剧情，也不会详细说明其基本设定。

↑返回顶部

一个本地化字符串，用于描述节目，但不透露故事或详细说明其前提。

属性	详细信息
父元素	`Descriptions`
数据类型	LocalizedStringType
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

Synopsis元素列表。提要是对节目要点的简洁但有趣的总结，支持本地化的值。提要通常比描述长。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `OffAir` `ToBeAnnounced`
数据类型	SynopsisList
子元素	描述
`Synopsis` 必需	对节目要点的简洁但有趣的总结。提要通常比描述长。

↑返回顶部

对节目要点的简洁但有趣的总结。提要通常比描述长。

属性	详细信息
父元素	`Synopses`
数据类型	LocalizedStringType
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑ 返回顶部

Image元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `OffAir` `ToBeAnnounced` `Station` `ExternalStation`
数据类型	ImageList
子元素	描述
`Image` 必需	图像位置的公开URL。

↑返回顶部

图像位置的公开URL。支持HTTP和HTTPS协议。亚马逊导入这些图像并向Fire TV客户端提供图像的地理分布副本 (CDN)。图像位置必须允许匿名公众访问，符合统一资源定位器 (w3.org) 规范，并且大小不得超过10MB。为避免URL中出现空格和其他无效字符，必须执行URL编码。URL必须无需额外身份验证即可供访问（不得受密码保护）。HTTPS访问必须维持最新的有效证书。

有关图像的详细信息和示例，请参阅EMBER图像。

属性	详细信息
父元素	`Images`
数据类型	ImageType - 提供图像数据的结构。Image URL值是一个模式为`(http\|HTTP)(s\|S)://.`的字符串。
属性	描述
`category`	图像的类型。支持的图像类别如下： `background` – 没有录入标题文本的节目图像。此图像类型没有任何语言性质的属性。环境文本（例如场景中的标志）没有必要本地化。JPEG格式。宽高比： 16:9。 `cover` – 带有录入文本的节目图像。语言必须与标题文本语言一致。语言是该图像类别的必需属性。JPEG格式。宽高比： 16:9。 `poster` – 海报艺术。JPEG格式。宽高比： 2:3。首选尺寸： 2000 x 3000像素。最小尺寸： 2000 x 3000像素。 `episodic` – 用于捕获内容的上下文。它通常是电视剧集或额外内容（例如预告片）的剧照。JPEG格式。宽高比： 16:9。 `title` – 目录系统使用这种类型的图像代替详情页面上的标题文本。它由一个带有透明背景的节目标题5:2 PNG图像构成。 `logo` – 用于电视台标志。PNG格式。宽高比： 16:9。首选尺寸： 3840 x 2160像素。最小尺寸： 1920 x 1080像素。有背景颜色选项：彩色、白色、浅色、黑色、灰色、深色。数据类型： ImageCategory
`language`	适用于封面、海报和标题图像。图片中嵌入标题文字必须和相同语言/地区组合对应的标题文字保持一致。背景图像没有文本，因此没有语言。它们可以具有地区。数据类型： LanguageType
`territories`	（可选）适用于所有图像类型，包括background类型。如果存在，则表示该图像是首选在指定地区分发的图像。使用ISO 3166-1 alpha-2格式或`GLOBAL`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`aspectRatio`	以宽高比表示，例如： 16:9、2:3。数据类型： AspectRatioType
`mimeType`	背景、封面、海报和剧集图像必须是JPEG图像。标题图像（用于代替文字标题）和电视台标志必须是透明的PNG图像。数据类型： MimeType
`resolution`	封闭枚举，表示图像有足够的垂直像素可用作常见屏幕分辨率的背景。有效值包括`SD`、`HD`、`FullHD`、`4K`和`8K`。数据类型： ResolutionType
`version`	图像的版本或校验和。每当您在不更改URL的情况下更新图像内容时，此值都必须更改。或者，您可以在更新图像时更改图像URL。该值用于优化图像下载、编码和CDN再分发过程。数据类型：long
`color`	指定图像的颜色变体，特别是标志的颜色变体。数据类型： ImageColorType
`default`	如果设置为true，则目录系统将此图像用于未提供明确图像的语言和地区。对于每种图像类型，只会将默认设置应用于至多一张图片。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

类型列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `Station`
数据类型	GenreList
子元素	描述
`Genre` 必需	内容的类型。

↑返回顶部

内容的类型。您可以使用scheme属性来表示特定的类型枚举值。支持的架构值为ember_genre。您也可以使用不带scheme属性的自由格式文本。有关EMBER类型架构中支持的类型代码列表，请参阅EMBER类型。

属性	详细信息
父元素	`Genres`
数据类型	GenreType - 一种保存类型命名空间和值的结构。使用scheme属性表示特定的类型枚举值，或使用不带scheme属性的自由格式文本。
属性	描述
`scheme`	类型命名空间。数据类型：string
`language`	包含此项目的语言数据。数据类型： LanguageType
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

由本地化字符串表示的Keyword元素列表。目录系统使用关键字作为节目的搜索词。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other`
数据类型	KeywordList
子元素	描述
`Keyword` 必需	供目录系统用作节目搜索词的本地化字符串。搜索词是针对特定语言的，也可以是针对特定地区的。

↑返回顶部

供目录系统用作节目搜索词的本地化字符串。搜索词是针对特定语言的，也可以是针对特定地区的。

属性	详细信息
父元素	`Keywords`
数据类型	LocalizedStringType
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

Rating元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `Airing` `Station`
数据类型	RatingList
子元素	描述
`Rating` 必需	提供针对适龄观众限制的认证。

↑返回顶部

提供针对适龄观众限制的认证。adultProduct和notRated标记是布尔属性，表示该计划已应用适用的年龄限制业务规则。实际节目和播出都有评分值。Rating元素包括内容描述符，其具有代码和相应的描述。描述来自评分系统的管理机构，并使用评分机构的主要语言。在某些地区，法律要求提供内容描述符。Video Central文档（仅提供英文版）中列出了支持的评分和描述符。使用全球评分规范。

特定于目录的条件：

节目表目录：如果您为播出指定评分，它将覆盖节目评分信息。
电视台目录：如果没有节目或播出评分，则目录系统使用电视台评分。

属性	详细信息
父元素	`Ratings`
数据类型	RatingType - 包含针对适龄观众限制的认证的结构。
子元素	描述
`Descriptors`	`Descriptor`元素列表。
属性	描述
`system` 必需	电影内容评级系统。数据类型：string
`certification` 必需	认证价值取决于节目对受众的适用性。数据类型：string
`adultProduct`	指明节目是否应用了适用的年龄限制业务规则。数据类型：boolean
`notRated`	指明节目是否应用了适用的年龄限制业务规则。数据类型：boolean
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

Descriptor元素列表。

属性	详细信息
父元素	`Rating`
数据类型	DescriptorList
子元素	描述
`Descriptor` 必需	`Descriptor`元素提供内容描述符。内容描述符包括代码和相应的描述。

↑返回顶部

Descriptor元素提供内容描述符。内容描述符包括代码和相应的描述。描述来自评分系统的管理机构，并使用评分机构的主要语言。在某些地区，法律要求提供内容描述符。Video Central文档（仅提供英文版）中列出了支持的评分和描述符。使用全球评分规范。

属性	详细信息
父元素	`Descriptors`
数据类型	DescriptorType
属性	描述
`code`	描述符的两个字母的编码。数据类型：string

↑返回顶部

Studio元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other`
数据类型	StudioList
子元素	描述
`Studio` 必需	引用创意组织。它是一种开放的枚举类型，支持外部ID。

↑返回顶部

引用创意组织。它是一种开放的枚举类型，支持外部ID。

属性	详细信息
父元素	`Studios`
数据类型	StudioType - 包含对创意组织的引用的结构。
子元素	描述
`StudioNames` 必需	`StudioName`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑ 返回顶部

StudioName元素列表。

属性	详细信息
父元素	`Studio`
数据类型	StudioNameList
子元素	描述
`StudioName` 必需	工作室的名称。

↑返回顶部

工作室的名称。

属性	详细信息
父元素	`StudioNames`
数据类型	string

↑返回顶部

Credits元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `SportsEvent` `Event` `Other` `Extra`
数据类型	CreditList
子元素	描述
`Credit` 必需	提供电影、电视特别节目、电视剧集或体育节目的演员和工作人员信息。

↑返回顶部

提供电影、电视特别节目、电视剧集或体育节目的演员和工作人员信息。Credit适用于作品制作的任何贡献者。对于扮演指定人物角色的演员，请添加Character元素。ExternalIds指的是人物，而不是角色。

属性	详细信息
父元素	`Credits`
数据类型	CreditType - 承载节目的演员和工作人员信息的结构。
子元素	描述
`PersonNames` 必需	包含不同语言“人名”的列表。
`ContributionNames` 必需	包含不同语言“贡献名称”的列表。
`CharacterNames`	本地化人物名称列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

包含不同语言“人名”的列表。

属性	详细信息
父元素	`Credit`
数据类型	PersonNameList
子元素	描述
`PersonName` 必需	贡献者的姓名。

↑ 返回顶部

贡献者的姓名。

属性	详细信息
父元素	`PersonNames`
数据类型	string
属性	描述
`language`	包含此项目的语言数据。默认值为`en`。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。数据类型：boolean

↑返回顶部

包含不同语言“贡献名称”的列表。

属性	详细信息
父元素	`Credit`
数据类型	ContributionNameList
子元素	描述
`ContributionName` 必需	表示贡献者的角色。

↑返回顶部

表示贡献者的角色。下表列出了推荐的贡献值。

角色	描述	示例
`演员`	在节目中为某个人物或本人提供实际出镜表演的人。	Leonard Nemoy在“Star Trek”中饰演Spock先生。 Harrison Ford在“Indiana Jones”电影中饰演Henry "Indiana" Jones Jr.一角。
`嘉宾`	在节目中为角色或自己展现实际存在的人，通常与节目无关。配角、客串演出或核心演员之外的主角通常属于这一类。	Cary Elwes在电视连续剧“Psych”的多集剧情中饰演常驻角色Pierre Desperaux。 Alfred Hitchcock在他执导的每部电影中都会客串演出。 Stan Lee从1989年开始在漫威电影中客串演出，包括他去世之前的所有MCU电影和电视连续剧。
`语音`	在节目中仅为人物提供语音的人。通常不是讲述者，尽管在某些节目中，讲述者是与其他角色互动的角色。	James Earl Jones在“Star Wars”电影中给Darth Vader配音。 Nancy Cartwright在“The Simpsons”中给Bartholomew Jojo "Bart" Simpson配音。
`Director`	监督演员、摄制组和其他工作人员。	Ron Howard导演了“Far and Away”（1992年）、“Apollo 13”（1995年）和“Thirteen Lives”（2022年）。
`Producer`	负责财务和管理方面。	Francis Ford Coppola执导并制作了“The Godfather Part II”和“The Godfather Part III”，但在“The Godfather”只担任导演。
`Writer`	编写节目剧本的贡献者。	Francis Ford Coppola和Mario Puzo共同创作了“The Godfather”三部曲。
`Composer`	为节目创作音乐的贡献者。	John Williams为“Jaws”（1975年）、“Star Wars”（1977年）和“Close Encounters of the Third Kind”（1978年）创作了音乐。每部作品的主题曲都进入了“公告牌”百强单和成人当代排行榜的前25名。
`Creator`	负责开发节目格式、概念、人物和试播剧本的重要部分。	Jos Whedon创作了“Buffy the Vampire Slayer”（1997-2003年）、“Firefly”（2002-2003年）和“Agents of S.H.I.E.L.D”（2013-2020年）
`组员`	为节目制作做出贡献的任何其他非表演角色。	场务领班、灯光师、照明人员、特效人员、烟火和特技人员。
`Performer`	给观众带来娱乐的人。	Bruce Springsteen是“滚石”杂志评选的顶级现场音乐表演者。 Tony Bennet担任表演者超过74年。
`教练`	负责训练运动员或团队的人。	Nick Saban执教阿拉巴马州赢得了六次NCAA全国足球锦标赛。
`Athlete`	参加涉及体力、敏捷性、耐力、速度或技能的运动或赛事的人。	Christiano Ronaldo是世界上所有运动中收入最高的球员，收入为1.36亿美元，其次是Lionel Messi，为1.3亿美元。
`Self`	配角（以本人身份）、访谈、新闻播音员，即角色就是本人，由本人扮演，无论节目内容是虚构的还是非虚构的。	披头士乐队（John Lennon、Paul McCartney、George Harrison和Ringo Starr）在“A Hard Day's Night”中扮演自己的虚构版本。
`主持人`	脱口秀或游戏节目的主持人。	Pat Sajack长期担任游戏节目“Wheel of Fortune”的主持人。
`Narrator`	提供评论或见解的画外音人员（如在纪录片中）。	Sebastian Cabot是“Winnie the Pooh and the Honey Tree”（1966年）中的讲述者。
`法官`	竞赛法庭或非戏剧化法庭的仲裁员。	Judy Sheindlin是名义上的“Judy法官”。
`Contestant`	非体育比赛（例如赛事节目）的参与者。	Brad Rutter在38集“Jeopardy”中出演，赚了489万美元！
`Anchor`	通常是新闻节目的主要播报人员。	作为“CBS Evening News”的新闻节目主持人，Walter Cronkite在19年（1962-1981年）中一直是“美国最值得信赖的人”。
`Correspondent`	通常对于新闻广播来说，是对一篇文章进行叙述和报道的人。	Ed Bradley是一名记者，曾在CBS报道越南战争、1976年总统大选和白宫，并担任“60 Minutes”的记者26年。
`Announcer`	在体育赛事中，此人员负责进行实况解说。	作为WGN棒球解说员，Harry Caray担任芝加哥小熊队的播报员长达17年。
`Analyst`	对于体育或新闻节目，由该人员提供深入的见解和观点。	Terry Bradshaw因其在全国橄榄球联盟 (NFL) 的非凡职业生涯以及担任足球分析员时表现出的知识渊博、富有趣味而获得广泛认可。

属性	详细信息
父元素	`ContributionNames`
数据类型	string
属性	描述
`language`	字符串的语言。默认值为`en`。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。数据类型：boolean

↑返回顶部

本地化人物名称列表。

属性	详细信息
父元素	`Credit`
数据类型	CharacterNameList
子元素	描述
`CharacterName` 必需	节目中的人物角色。

↑返回顶部

节目中的人物角色。

属性	详细信息
父元素	`CharacterNames`
数据类型	LocalizedStringType
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

Tag元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other` `OffAir` `ToBeAnnounced` `Airing` `ProgramOffer` `StationOffer` `ProgramAiringOffer` `Station` `EntitlementPolicy`
数据类型	TagList
子元素	描述
`Tag` 必需	用于对节目或播出进行分类、推广或以其他方式应用自定义处理的其他元数据。

↑返回顶部

用于对节目或播出进行分类、推广或以其他方式应用自定义处理的其他元数据。这些值的架构、键和有效格式必须由您和亚马逊协商。此功能用于启用非标准或新兴用例，直到在规范中添加专用实体或属性并对其进行版本控制为止。

属性	详细信息
父元素	`Tags`
数据类型	TagType - 添加了必需的`scheme`和`key`属性的string。
属性	描述
`scheme` 必需	键值对的通用唯一命名空间。数据类型：string
`key` 必需	键值对的键。该值是元素值。数据类型：string

↑返回顶部

应用于节目的本地化时长列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `Extra` `SportsEvent` `Event` `Other`
数据类型	LocalizedRunLengthList
子元素	描述
`RunLength` 必需	节目未经编辑的长度及其适用的地区。

↑返回顶部

节目未经编辑的长度及其适用的一个或多个地区。

属性	详细信息
父元素	`RunLengths`
数据类型	LocalizedDurationType - 一种结构，包含节目未经编辑的长度及其适用的一个或多个地区。
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType

↑返回顶部

描述图片颜色特征的枚举值。此属性适用于实际节目（而非季或连续剧）。有效值可参见MovieLabs PictureColor规格（仅提供英文版），包括的值有color、bandw、colorized、composite和unknown。

属性	详细信息
父元素	`Movie` `TVEpisode` `Extra` `SportsEvent` `Event` `Other`
数据类型	PictureColorType - PictureColorEnumType，添加了源属性`sourceName`、`sourceDate`和`sourceId`。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

ReleaseDate元素列表。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `Extra` `SportsEvent` `Event` `Other`
数据类型	ReleaseDateList
子元素	描述
`ReleaseDate` 必需	该节目首次在其初始地区或指定地区上线的日期。

↑返回顶部

该节目首次在其初始地区或指定地区上线的日期。发布日期与电视节目的初始上映日期同义。发布日期可以包含日期，如果实际日期未知，则仅包含年份。允许在一个地区内多次发布。但是，在同一地区发布的多个相同类型的版本必须有不同的日期。

属性	详细信息
父元素	`ReleaseDates`
数据类型	ReleaseDateType - 采用模式`(\d{4})-(0[1-9]\|1[012])-(0[1-9]\|[12][0-9]\|3[01])\|(\d{4})`的字符串。定义发布年份或日期的模式。日期以YYYY-MM-DD或YYYY表示。使用ISO-8601协调世界时值。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`releaseType`	指定发行版本的分发机制。有效值：`theater`、`video`、`streaming`。数据类型： ReleaseType
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

表示内容之间的关系。

属性	详细信息
父元素	`Movie` `TVEpisode` `TVSeason` `TVSeries` `SportsEvent` `Event` `Other` `Extra`
数据类型	RelationshipsType - 内容项之间所有关系的容器。
子元素	描述
`isSeasonOfSeries`	电视季与其父电视连续剧的关系。
`isEpisodeOfSeason`	电视剧集与其父电视季的关系。
`isEpisodeOfSeries`	电视剧集与其电视连续剧间的直接关系。
`isExtraOf`	额外内容的关系，例如预告片、专题片或赛前和赛后内容。
`isRelatedTo`	内容之间的一般关系。例如，“Lord of the Rings”与“The Hobbit”有关。

↑返回顶部

电视季与其父电视连续剧的关系。

属性	详细信息
父元素	`Relationships`
数据类型	isSeasonOfSeriesType
子元素	描述
`SeriesTitles`	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`seasonNum` 必需	电视连续剧中的季号。数据类型：nonNegativeInteger
`programRef`	节目的ID。数据类型： ID
`programCatalogRef`	包含节目的节目目录的引用。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID

↑返回顶部

电视剧集与其父电视季的关系。

属性	详细信息
父元素	`Relationships`
数据类型	isEpisodeOfSeasonType
子元素	描述
`SeriesTitles`	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`episodeNum` 必需	电视季中的剧集编号。数据类型：nonNegativeInteger
`seasonNum`	电视连续剧中的季号。如果未指定`seasonNum`，则为该剧集分配剧集发行年份或“第1季”。数据类型：nonNegativeInteger
`premiere`	表示该剧集是否是本季的第一集。数据类型：boolean
`finale`	表示该剧集是否是本季的最后一集。数据类型：boolean
`programRef`	节目的ID。数据类型： ID
`programCatalogRef`	包含节目的节目目录的引用。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID

↑返回顶部

电视剧集与其所属电视连续剧的直接关系。

注意： 您可以将圣诞节特别节目等特别剧集建模为电视剧集并引用电视连续剧而无需添加电视季。

属性	详细信息
父元素	`Relationships`
数据类型	isEpisodeOfSeriesType
子元素	描述
`SeriesTitles`	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`episodeNum` 必需	电视季中的剧集编号。数据类型：nonNegativeInteger
`premiere`	表示该剧集是否是连续剧的第一集。数据类型：boolean
`finale`	表示该剧集是否是连续剧的最后一集。数据类型：boolean
`programRef`	节目的ID。数据类型： ID
`programCatalogRef`	包含节目的节目目录的引用。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID

↑返回顶部

Title元素列表。Title元素代表节目的标题及其适用的区域设置。

属性	详细信息
父元素	`isSeasonOfSeries` `isEpisodeOfSeason` `isEpisodeOfSeries`
数据类型	TitleList
子元素	描述
`Title` 必需	一个本地化字符串，表示节目的标题及其适用的语言和地区。

↑ 返回顶部

额外内容的关系，例如预告片、专题片或赛前和赛后内容。

属性	详细信息
父元素	`Relationships`
数据类型	isExtraOfType
子元素	描述
`RelatedExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`orderNum`	相关附加内容的排序编号。如果`programRef`存在重复值，则排序是不确定的。数据类型：nonNegativeInteger
`programRef`	节目的ID。除非定义了`RelatedExternalIDs`，否则为必需。数据类型： ID
`programCatalogRef`	包含节目的节目目录的引用。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID

↑返回顶部

内容之间的一般关系。例如，“Lord of the Rings”与“The Hobbit”有关。

属性	详细信息
父元素	`Relationships`
数据类型	isRelatedToType
子元素	描述
`RelatedExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`programRef`	节目的ID。除非定义了`RelatedExternalIDs`，否则为必需。数据类型： ID
`programCatalogRef`	包含节目的节目目录的引用。默认值为`DEFAULT_PROGRAM_CATALOG`。数据类型： ID

↑返回顶部

包含外部系统标识符。允许与第三方系统交叉引用。

属性	详细信息
父元素	`isExtraOf` `isRelatedTo`
数据类型	ExternalIdList
子元素	描述
`ExternalId` 必需	将节目或其他实体链接到外部来源。

↑返回顶部

Venue元素列表。

属性	详细信息
父元素	`SportsEvent` `Event`
数据类型	VenueList
子元素	描述
`Venue` 必需	活动的地点信息。

↑返回顶部

活动的地点信息。Address元素中的VenueNames和City元素是必需字段。默认名称是场地的正式名称。

属性	详细信息
父元素	`Venues`
数据类型	VenueType - 承载活动位置信息的结构。
子元素	描述
`VenueNames` 必需	`VenueName`元素列表。
`Address`	保存地址数据。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

VenueName元素列表。

属性	详细信息
父元素	`Venue`
数据类型	VenueNameList
子元素	描述
`VenueName` 必需	带有可选翻译语言的场地名称。

↑返回顶部

带有可选翻译语言的场地名称。

属性	详细信息
父元素	`VenueNames`
数据类型	VenueNameType - 表示带有可选`language`属性的场地名称的字符串。
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

保存地址数据。

属性	详细信息
父元素	`Venue`
数据类型	AddressType - 承载地址数据的结构。
子元素	描述
`Street`	场地地址中的街道。
`City`	场地地址中的城市。
`StateOrProvince`	场地地址中的州或省。
`Country`	场地地址中的国家/地区。
`PostalCode`	该地区的特定邮政编码。

↑返回顶部

场地地址中的街道。

属性	详细信息
父元素	`Address`
数据类型	string

↑返回顶部

场地地址中的城市。

属性	详细信息
父元素	`Address`
数据类型	string

↑返回顶部

场地地址中的州或省。

属性	详细信息
父元素	`Address`
数据类型	string

↑返回顶部

场地地址中的国家/地区。

属性	详细信息
父元素	`Address`
数据类型	string

↑返回顶部

定义特定的邮政编码。在区域政策中，邮政编码用于内容可用性控制。在场地地址元素中，它用作地址的邮政编码。

属性	详细信息
父元素	`Address` `Region`
数据类型	string

↑返回顶部

Sport元素列表。

属性	详细信息
父元素	`SportsEvent` `Other` `Extra`
数据类型	SportList
子元素	描述
`Sport` 必需	该体育项目的默认名称以及可选的语言和地区特定名称。

↑返回顶部

该体育项目的默认名称以及可选的语言和地区特定名称。默认名称“必须”是相应体育联合会指定的体育项目名称。有关认可的体育项目列表，请参阅EMBER体育。您可以为这项体育项目提供外部ID。

属性	详细信息
父元素	`Sports`
数据类型	SportType - 承载体育项目信息的结构。
子元素	描述
`SportNames`	`SportName`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

SportName元素列表。

属性	详细信息
父元素	`Sport`
数据类型	SportNameList
子元素	描述
`SportName` 必需	体育运动的名称。有关认可的体育项目列表，请参阅EMBER体育。

↑返回顶部

体育运动的名称。有关认可的体育项目列表，请参阅EMBER体育。

属性	详细信息
父元素	`SportNames`
数据类型	SportNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

League元素列表。

属性	详细信息
父元素	`SportsEvent` `Other` `Extra`
数据类型	LeagueList
子元素	描述
`League` 必需	开放枚举类型，表示与该体育节目相关的联赛。

↑返回顶部

公开列举与体育节目相关的联赛。默认名称必须是联赛的官方名称（非缩写），使用管理机构的主要语言。例如，德甲（德语）、意甲（意大利语）、法甲（法语）、西甲（西班牙语）和英超联赛（英语）。您可以提供特定语言的翻译。

考虑下表后的XML示例。如果引入，目录系统在向美国的英语使用者显示联赛时将使用NFL作为缩写，他们理应熟悉此联赛。系统将对其他所有人使用默认值。您可以为联赛提供外部ID。

属性	详细信息
父元素	`Leagues`
数据类型	LeagueType - 承载与体育节目相关的联赛的结构。
子元素	描述
`LeagueNames`	`LeagueName`元素的列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

LeagueName元素的列表。

属性	详细信息
父元素	`League`
数据类型	LeagueNameList
子元素	描述
`LeagueName` 必需	带有可选翻译语言的联赛名称字符串。

↑返回顶部

带有可选翻译语言的联赛名称字符串。

属性	详细信息
父元素	`LeagueNames`
数据类型	LeagueNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

正在举行的比赛所对应赛季的官方名称或编号。这可能与节目的发布日期（可能仅为一个年份）有所不同，因为某些体育赛事的举办时间跨越了日历年的分界。例如，NBA在常规赛中使用带连字符的年份名称，例如2023-24，而NFL使用单一年份，例如2023年。与其他体育数据一致，联盟的管理机构决定赛季的语言。

属性	详细信息
父元素	`SportsEvent`
数据类型	SportSeasonType - 包含正在举行的比赛所对应赛季的官方名称或编号的结构。
子元素	描述
`SeasonNames`	播放比赛时的`Season`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

播放比赛时的Season元素列表。

属性	详细信息
父元素	`Season`
数据类型	SeasonNameList
子元素	描述
`SeasonName` 必需	播放比赛时的季名称。

↑返回顶部

播放体育比赛（例如，2023-24年NBA赛季）时的季名称，可选择翻译语言。

属性	详细信息
父元素	`SeasonNames`
数据类型	SeasonNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

与体育节目或赛事相关的锦标赛。默认值必须是管理机构主要语言的锦标赛的正式名称（非缩写）。例如，FIFA World Cup（英语）。如果可用，提供特定语言的翻译。例如，La Copa Mundial De Fútbol（西班牙语）、La Coppa Mondiale di Calcio（意大利语）。

此表后面的XML示例指定了FIFA世界杯的默认和美国特有版本。请注意，世界杯的默认语言是法语，即管理机构的语言： Fédération Internationale de Football Association (FIFA)。您可以为锦标赛提供外部ID。

属性	详细信息
父元素	`SportsEvent` `Event`
数据类型	TournamentType - 承载与体育节目相关的锦标赛的结构。
子元素	描述
`TournamentNames`	`TournamentName`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

TournamentName元素列表。

属性	详细信息
父元素	`Tournament`
数据类型	TournamentNameList
子元素	描述
`TournamentName` 必需	带有可选翻译语言的锦标赛名称字符串。

↑返回顶部

带有可选翻译语言的锦标赛名称字符串。

属性	详细信息
父元素	`TournamentNames`
数据类型	TournamentNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

与锦标赛或体育节目比赛相关的比赛轮次。轮次名称将因锦标赛类型和体育项目而异。例如，FIFA世界杯有：16强赛、四分之一决赛、半决赛、附加赛第三名争夺赛，以及决赛，而罗兰加洛斯法国网球公开赛有：资格赛、正赛轮次、第一轮、第二轮、第三轮、第四轮、四分之一决赛、半决赛和决赛。轮次这个词被用作阶段、预赛以及其他相关词汇的同义词。没有翻译的轮次名称必须是采用管理机构主要语言的该轮次的正式名称（非缩写）。

属性	详细信息
父元素	`SportsEvent` `Event`
数据类型	RoundType - 承载与体育节目相关的轮次的结构。
子元素	描述
`RoundNames`	`RoundName`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

RoundName元素列表。

属性	详细信息
父元素	`Round`
数据类型	RoundNameList
子元素	描述
`RoundName` 必需	带有可选翻译语言的轮次名称字符串。

↑返回顶部

带有可选翻译语言的轮次名称字符串。

属性	详细信息
父元素	`RoundNames`
数据类型	RoundNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

Team元素列表。

属性	详细信息
父元素	`SportsEvent` `Other` `Extra`
数据类型	TeamList
子元素	描述
`Team` 必需	比赛或赛事的参赛队伍。

↑返回顶部

比赛或赛事的参赛队伍。您可以提供翻译。对于个人之间的匹配，不要翻译姓名。确保姓名符合字母顺序标准（例如，Lincoln, Abraham）。将homeTeam属性应用到最多一个队伍。

考虑下表后的XML示例。如果引入，目录系统将为除美国英语客户外的所有人使用球队的官方名称。

属性	详细信息
父元素	`Teams`
数据类型	TeamType - 在体育节目中提供队伍数据的结构。
子元素	描述
`TeamNames`	`TeamName`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
属性	描述
`homeTeam`	表示该队伍是否是体育节目的主队。数据类型：boolean
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

TeamName元素列表。

属性	详细信息
父元素	`Team`
数据类型	TeamNameList
子元素	描述
`TeamName` 必需	带有可选翻译语言的队伍名称字符串。

↑返回顶部

带有可选翻译语言的队伍名称字符串。

属性	详细信息
父元素	`TeamNames`
数据类型	TeamNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

比赛或赛事的参赛选手名单。

属性	详细信息
父元素	`SportsEvent`
数据类型	PlayerList
子元素	描述
`Player` 必需	参与比赛或赛事的选手。

↑返回顶部

参与比赛或赛事的选手。

属性	详细信息
父元素	`Players`
数据类型	PlayerType
子元素	描述
`PlayerNames`	本地化的选手姓名的列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。

↑返回顶部

本地化的选手姓名列表。

属性	详细信息
父元素	`Player`
数据类型	PlayerNameList
子元素	描述
`PlayerName` 必需	选手的姓名。

↑返回顶部

选手的姓名。

属性	详细信息
父元素	`PlayerNames`
数据类型	PlayerNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType

↑返回顶部

比赛或赛事的性别详情。

属性	详细信息
父元素	`SportsEvent`
数据类型	GenderType
子元素	描述
`GenderNames` 必需	比赛或赛事的本地化性别详细信息列表。

↑返回顶部

比赛或赛事的本地化性别详细信息列表。

属性	详细信息
父元素	`Gender`
数据类型	GenderNameList
子元素	描述
`GenderName` 必需	比赛的性别详情。有效值： `Mens`、`Womens`、`Mixed`。

↑返回顶部

比赛的性别详情。有效值： Mens、Womens、Mixed。

属性	详细信息
父元素	`GenderNames`
数据类型	GenderNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

比赛或赛事的形式详情。

属性	详细信息
父元素	`SportsEvent`
数据类型	FormatType
子元素	描述
`FormatNames` 必需	比赛或赛事的本地化形式列表。

↑返回顶部

比赛或赛事的本地化形式列表。

属性	详细信息
父元素	`Format`
数据类型	FormatNameList
子元素	描述
`FormatName` 必需	比赛的形式。有效值： `Singles`、`Doubles`、`Legends`。

↑返回顶部

比赛的形式。有效值： Singles、Doubles、Legends。

属性	详细信息
父元素	`FormatNames`
数据类型	FormatNameType
属性	描述
`language`	包含此项目的语言数据。数据类型： LanguageType
`default`	当没有匹配的语言可用时，目录系统将使用此值作为默认值。只能对原始语言、语言和地区的每个属性应用一个值。标题、带字幕的图像、描述和摘要遵循此惯例。数据类型：boolean

↑返回顶部

实际节目的开始时间，不一定是广播的开始时间。例如，在美式足球中，这个时间被称为“开球”，而对于篮球来说，则称为“开赛跳球”。

属性	详细信息
父元素	`SportsEvent` `Event`
数据类型	EventDateTimeType - 一个字符串，采用模式`(\d{4})-(0[1-9]\|1[012])-(0[1-9]\|[12][0-9]\|3[01])[T]([01][0-9]\|2[0-3]):([0-5][0-9]):([0-5][0-9]\|60)(\.[0-9]+)?(([Zz])\|([\+\|\-]([01][0-9]\|2[0-3]):[0-5][0-9]))`并添加`sourceName`、`sourceDate`和`sourceId`属性。使用ISO-8601协调世界时值。
属性	描述
`sourceName`	来源的名称。如果未提供，则目录系统使用数据提交者作为数据元素的来源。数据类型： SourceNameType
`sourceDate`	检索信息的日期。如果未提供，则系统使用数据提交日期。数据类型： SourceDateType
`sourceId`	提供值的数据记录的标识符（内部或外部）或URI。如果未提供，则默认为包含实体的ID。数据类型： SourceIdType

↑返回顶部

ProgramCatalog

Delete

Movie

TVEpisode

TVSeason

TVSeries

SportsEvent

Event

OffAir

Other

ToBeAnnounced

Extra

ExternalIds

ExternalId

Titles

Title

Descriptions

描述

Synopses

Synopsis

Images

Image

Genres

Genre

Keywords

Keyword

Ratings

Rating

Descriptors

Descriptor

Studios

Studio

StudioNames

StudioName

Credits

Credit

PersonNames

PersonName

ContributionNames

ContributionName

CharacterNames

CharacterName

Tags

Tag

RunLengths

RunLength

PictureColor

ReleaseDates

ReleaseDate

Relationships

isSeasonOfSeries

isEpisodeOfSeason

isEpisodeOfSeries

SeriesTitles

isExtraOf

isRelatedTo

RelatedExternalIds

Venues

Venue

VenueNames

VenueName

Address

Street

City

StateOrProvince

Country

PostalCode

Sports

Sport

SportNames

SportName

Leagues

League

LeagueNames

LeagueName

Season

SeasonNames

SeasonName

Tournament