Movie元素

注意：单击示意图中的链接后，此元素会滚动到图下方的焦点。

示意图

├── Partner
└── Works
    ├── Movie
    │   ├── ID
    │   ├── ExternalID
    │   ├── Titles
    │   │   └── Title
    │   ├── Copyright
    │   ├── Offers
    │   │   ├── SubscriptionOffer
    │   │   │   ├── Regions
    │   │   │   │   └── Territories
    │   │   │   ├── WindowStart
    │   │   │   ├── WindowEnd
    │   │   │   └── LaunchDetails
    │   │   │       ├── Quality
    │   │   │       ├── AudioLanguage
    │   │   │       ├── Subtitle
    │   │   │       └── LaunchId
    │   │   └── FreeOffer
    │   │       ├── Regions
    │   │       │   └── Territories
    │   │       ├── WindowStart
    │   │       ├── WindowEnd
    │   │       └── LaunchDetails
    │   │           ├── Quality
    │   │           ├── AudioLanguage
    │   │           ├── Subtitle
    │   │           └── LaunchId
    │   ├── IsAdultProducts
    │   │   └── IsAdultProduct
    │   ├── ReleaseYear
    │   ├── ShortDescriptions
    │   │   └── ShortDescription
    │   ├── Synopses
    │   │   └── Synopsis
    │   ├── MetadataAvailabilityDates
    │   │   └── MetadataAvailabilityDate
    │   ├── Images
    │   │   └── Image
    │   │       ├── Url
    │   │       └── Locale
    │   ├── Runtimes
    │   │   └── RuntimeMinutes
    │   ├── Color
    │   ├── Credits
    │   │   ├── CastMember
    │   │   │   ├── Name
    │   │   │   ├── ExternalID
    │   │   │   └── Role
    │   │   └── CrewMember
    │   │       ├── Name
    │   │       ├── ExternalID
    │   │       └── Job
    │   ├── Studios
    │   │   └── Studio
    │   ├── Language
    │   ├── CustomerRating
    │   │   ├── Score
    │   │   ├── MaxValue
    │   │   └── Count
    │   ├── Rank
    │   ├── IsOriginals
    │   │   └── IsOriginal
    │   ├── Genres
    │   │   └── Genre
    │   ├── ContentRatings
    │   │   └── ContentRating
    │   │       ├── System
    │   │       └── Certification
    │   └── ReleaseDates
    │       └── ReleaseDate
    ├── TvEpisode
    ├── TvSeason
    ├── TvShow
    └── Extra

<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.11">
  <Partner>ACME</Partner>
  <Works>
    <Movie>
      <ID>GN46PVTF92VXV30</ID>
      <ExternalID scheme="tms">28873</ExternalID>
      <Title locale="it">Falcão Negro em Perigo</Title>
      <ReleaseYear>2001</ReleaseYear>
      <ShortDescription locale="it">U.S. soldiers (Josh Hartnett, Ewan McGregor, Tom Sizemore) take heavy fire while trying to capture a warlord's associates in Mogadishu, Somalia.</ShortDescription>
      <Synopsis locale="it">The film takes place in 1993 when the U.S. sent special forces into Somalia to destabilize the government and bring food and humanitarian aid to the starving population.Using Black Hawk helicopters to lower the soldiers onto the ground, an unexpected attack by Somalian forces brings two of the helicopters down immediately.From there, the U.S. soldiers must struggle to regain their balance while enduring heavy gunfire.</Synopsis>
      <Images>
        <Image>
          <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url>
        </Image>
      </Images>
      <RuntimeMinutes>144</RuntimeMinutes>
      <Credits>
        <CastMember>
          <Name locale="it">Sam Shepard</Name>
          <ExternalID scheme="tms">57668</ExternalID>
            <Role locale="it">Garrison</Role>
        </CastMember>
      </Credits>
      <Language>en</Language>
      <Genres>
        <Genre locale="it">Drama</Genre>
        <Genre locale="it">War</Genre>
      </Genres>
    </Movie>
  </Works>
</Catalog>

Catalog

CDF文件的根元素。每个目录文件都必须添加一项Catalog元素，其中包含文件的剩余内容。

property属性	详细信息
使用	必需
允许数量	1
父元素	无
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Partner`（必填，选择一个） `Works`（必填，选择一个）
attribute属性	`xmlns`：必填。XML命名空间。 `version`: 可选。此目录使用的架构版本。请参阅架构“id”，确定当前使用的架构版本。虽然出于兼容性原因，此属性可以选填，但亚马逊仍建议您提供版本信息。数据类型：枚举枚举值： `FireTv-v1.2`、`FireTv-v1.3`、`FireTv-v1.4`、`FireTv-v1.5`、`FireTv-v1.6`、`FireTv-v1.7`、`FireTv-v1.8`、`FireTv-v1.9`、`FireTv-v1.10`、`FireTv-v1.11`、`FireTv-v2.0`

示例：

<xml version="1.0" encoding="utf-8" ?>
<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.3">
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
<Catalog>

Partner

标识贵公司为此目录的提供方。无格式要求，但应人类可读。使用在亚马逊应用商店中所用的应用名称是不错的方法。您也可以使用提供方的全名。每个目录文件都必须包含一个Partner元素。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Catalog`
内容模型	simpleType（无子元素）
子元素	无
数据类型	string

示例：

<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.3">
  <Partner>Everything Ever Made Filmworks</Partner>
  ...
<Catalog>

Works

其中包含目录中的所有单独条目：电影、电视节目、季、特辑、迷你剧、剧集和花絮。每个目录文件中都必须有一个Works元素。Works元素可以根据需要添加任意数量的作品条目，或者为每种类型添加此类条目。

注意： 在CDF 1.0到1.2版本中，作品元素中必须包含至少一部作品。从CDF 1.3版本起，此元素可以为空。这样能从亚马逊Fire TV的通用浏览和搜索结果中删除目录内容。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Catalog`
内容模型	contentType - 序列和选择。您可以为`Works`元素添加任意子元素，此元素会按照您想要的顺序多次出现。
子元素	`Movie`（选填，无限制） `TvEpisode`（选填，无限制） `TvSeason`（选填，无限制） `TvShow`（选填，无限制） `Extra`（选填，无限制）
attribute属性	无

示例：

<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>

Movie

可以表示长篇电影，也可以表示短篇电影。此作品可以在院线上映，也可以作为电视电影。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Works`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`ID`（必填，选择一个） `ExternalID`（选填，无限制） `Titles`（必填，无限制） `Copyright`（选填，选择一个） `Offers`（选填，选择一个） `IsAdultProducts`（选填，选择一个） `ReleaseYear`（选填，选择一个） `ShortDescriptions`（选填，选择一个） `Synopses`（选填，选择一个） `MetadataAvailabilityDates`（选填，选择一个） `Images`（必填，选择一个） `Runtimes`（选填，选择一个） `Color`（选填，选择一个） `Credits`（选填，选择一个） `Studios`（选填，选择一个） `Language`（选填，选择一个） `CustomerRating`（选填，选择一个） `Rank`（选填，选择一个） `IsOriginals`（选填，选择一个） `Genres`（选填，选择一个） `ContentRatings`（选填，选择一个） `ReleaseDates`（选填，选择一个）
attribute属性	无

示例：

<Movie>
    <ID>AMZN-0011</ID>
    <ExternalID scheme="imdb">tt0000008</ExternalID>
    <Titles>
        <!--如果省略territories属性，则此标题适用于全球范围，如下所示-->
        <Title locale="en-US">Global English Movie Title</Title>
        <!--以下标题仅适用于美国境内-->
        <Title locale="es" territories="US">Spanish US Movie Title</Title>
    </Titles>
    <Copyright locale="en-US">Amazon 2021</Copyright>
    <Offers>
        <FreeOffer>
            <Regions>
                <Territories>GB, DE</Territories>
            </Regions>
            <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
            <WindowEnd>2030-01-01T07:00:00-07:00</WindowEnd>
            <LaunchDetails>
                <Quality>SD</Quality>
                <AudioLanguage>en-US</AudioLanguage>
                <Subtitle>en-US</Subtitle>
                <Subtitle>es</Subtitle>
                <LaunchId>AMZN-0011-enUS-SD</LaunchId>
            </LaunchDetails>
        </FreeOffer>
        <SubscriptionOffer>
            <Regions>
                <Territories>US, CA</Territories>
            </Regions>
            <WindowStart>2021-02-06T12:00:00-07:00</WindowStart>
            <WindowEnd>2022-01-01T07:00:00-07:00</WindowEnd>
            <LaunchDetails>
                <Quality>HD</Quality>
                <AudioLanguage>en-US</AudioLanguage>
                <Subtitle>en-US</Subtitle>
                <Subtitle>es</Subtitle>
                <LaunchId>AMZN-0011-enUS-HD</LaunchId>
            </LaunchDetails>
        </SubscriptionOffer>
    </Offers>
    <IsAdultProducts>
        <!-- 如未提供区域，则字段值适用于全球范围。-->
        <IsAdultProduct>false</IsAdultProduct>
        <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
    </IsAdultProducts>
    <ReleaseYear>1959</Releaseyear>
    <ShortDescriptions>
        <ShortDescription locale="en-US" territories="US">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</ShortDescription>
    </ShortDescriptions>
    <Synopses>
        <Synopsis locale="en-US" territories="US, GB">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</Synopsis>
        <Synopsis locale="es" territories="MX">Nulla pellentesque dignissim enim sit amet venenatis urna cursus.Metus vulputate eu scelerisque felis imperdiet.Ullamcorper a lacus vestibulum sed.Sed ullamcorper morbi tincidunt ornare.Odio aenean sed adipiscing diam donec adipiscing tristique risus.Sed vulputate mi sit amet mauris commodo quis.Ac tortor dignissim convallis aenean et tortor at risus.Turpis tincidunt id aliquet risus feugiat in.A scelerisque purus semper eget duis at tellus at.Volutpat ac tincidunt vitae semper.</Synopsis>
        <Synopsis locale="en">Arcu odio ut sem nulla pharetra.Lobortis scelerisque fermentum dui faucibus in.Netus et malesuada fames ac turpis.Aenean sed adipiscing diam donec adipiscing.Egestas egestas fringilla phasellus faucibus scelerisque eleifend donec.Lectus magna fringilla urna porttitor rhoncus dolor purus non.Nibh ipsum consequat nisl vel pretium lectus quam id.Eu consequat ac felis donec et odio pellentesque diam.Lorem ipsum dolor sit amet consectetur adipiscing elit.Quisque egestas diam in arcu cursus.Tristique sollicitudin nibh sit amet.Eleifend quam adipiscing vitae proin sagittis nisl rhoncus mattis rhoncus.</Synopsis>
    </Synopses>
    <MetadataAvailabilityDates>
        <MetadataAvailabilityDate>2021-08-01T12:00:00Z</MetadataAvailabilityDate>
        <MetadataAvailabilityDate territories="US,CA,GB">2021-09-01T12:00:00Z</MetadataAvailabilityDate>
    </MetadataAvailabilityDates>
    ...
    ...
</Movie>

TvEpisode

TvShow中的某一集，通常还和TvSeason有关。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Works`
内容模型	complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加`ShowID`或`ShowTitle`，但不能同时选择两者。也可以添加`SeasonID`或`SeasonInShow`，但不能同时选择两者。
子元素	`ID`（必填，选择一个） `ExternalID`（选填，无限制） `Titles`（必填，无限制） `Copyright`（选填，选择一个） `Offers`（选填，选择一个） `IsAdultProducts`（选填，选择一个） `ReleaseYear`（选填，选择一个） `ShortDescriptions`（选填，选择一个） `Synopses`（选填，选择一个） `MetadataAvailabilityDates`（选填，选择一个） `Images`（必填，选择一个） `Runtimes`（选填，选择一个） `Color`（选填，选择一个） `Credits`（选填，选择一个） `Studios`（选填，选择一个） `Language`（选填，选择一个） `CustomerRating`（选填，选择一个） `Rank`（选填，选择一个） `IsOriginals`（选填，选择一个） `Genres`（选填，选择一个） `ContentRatings`（选填，选择一个） `ShowID`（必填，选择一个） `ShowTitle`（必填，选择一个） `SeasonID`（必填，选择一个） `SeasonInShow`（必填，选择一个） `SeasonTitle`（选填，选择一个） `EpisodeInSeason`（必填，选择一个） `OriginalAirDates`（选填，选择一个）
attribute属性	无

示例：

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS-987654</ID>
  ...
</TvSeason>
<TvEpisode>
  <ID>TVE2329880</ID>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS-987654</SeasonInShow>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>

TvSeason

TvSeason是指TvShow中的一季，是一种基本作品类型。当TvEpisode的SeasonID值与TvSeason的ID值相同时，该剧集即为本季内容。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Works`
内容模型	complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加`ShowID`或`ShowTitle`，但不能同时选择两者。
子元素	`ID`（必填，选择一个） `ExternalID`（选填，无限制） `Titles`（必填，无限制） `Copyright`（选填，选择一个） `Offers`（选填，选择一个） `IsAdultProducts`（选填，选择一个） `ReleaseYear`（选填，选择一个） `ShortDescriptions`（选填，选择一个） `Synopses`（选填，选择一个） `MetadataAvailabilityDates`（选填，选择一个） `Images`（必填，选择一个） `Runtimes`（选填，选择一个） `Color`（选填，选择一个） `Credits`（选填，选择一个） `Studios`（选填，选择一个） `Language`（选填，选择一个） `CustomerRating`（选填，选择一个） `Rank`（选填，选择一个） `IsOriginals`（选填，选择一个） `Genres`（选填，选择一个） `ContentRatings`（选填，选择一个） `ShowID`（必填，选择一个） `ShowTitle`（必填，选择一个） `SeasonInShow`（必填，选择一个）
attribute属性	无

示例：

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  <ShowID>ABC-123457</ShowID>
  <SeasonInShow>5</SeasonInShow>
</TvSeason>
<TvEpisode>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

TvShow

由季和剧集组成的电视连续剧。当TvSeason或TvEpisode的ShowID值与TvShow的ID值相同时，本季或剧集即为本节目内容。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Works`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`ID`（必填，选择一个） `ExternalID`（选填，无限制） `Titles`（必填，无限制） `Copyright`（选填，选择一个） `Offers`（选填，选择一个） `IsAdultProducts`（选填，选择一个） `ReleaseYear`（选填，选择一个） `ShortDescriptions`（选填，选择一个） `Synopses`（选填，选择一个） `MetadataAvailabilityDates`（选填，选择一个） `Images`（必填，选择一个） `Runtimes`（选填，选择一个） `Color`（选填，选择一个） `Credits`（选填，选择一个） `Studios`（选填，选择一个） `Language`（选填，选择一个） `CustomerRating`（选填，选择一个） `Rank`（选填，选择一个） `IsOriginals`（选填，选择一个） `Genres`（选填，选择一个） `ContentRatings`（选填，选择一个） `ReleaseDates`（选填，选择一个）
attribute属性	无

示例：

<TvShow>
  <ID>RS-2329880</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  ...
  <ShowID>RS-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>RS-2329880</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

Extra

独立作品的片段，或通常与（目录上或目录外的）其他作品有关。通常将上述内容视为DVD中的花絮。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Works`
内容模型	complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加`RelatesToID`或`RelatesToExternalID`，但不能同时选择两者。
子元素	`ID`（必填，选择一个） `ExternalID`（选填，无限制） `Titles`（必填，无限制） `Copyright`（选填，选择一个） `Offers`（选填，选择一个） `IsAdultProducts`（选填，选择一个） `ReleaseYear`（选填，选择一个） `ShortDescriptions`（选填，选择一个） `Synopses`（选填，选择一个） `MetadataAvailabilityDates`（选填，选择一个） `Images`（必填，选择一个） `Runtimes`（选填，选择一个） `Color`（选填，选择一个） `Credits`（选填，选择一个） `Studios`（选填，选择一个） `Language`（选填，选择一个） `CustomerRating`（选填，选择一个） `Rank`（选填，选择一个） `IsOriginals`（选填，选择一个） `Genres`（选填，选择一个） `ContentRatings`（选填，选择一个） `Type`（必填，选择一个） `RelatesToID`（必填，无限制） `RelatesToExternalID`（必填，无限制）
attribute属性	无

示例：

<Extra>
  <ID>EXTRA-11111</ID>
  ...
  <Type>clip</Type>
</Extra>

作品的标识符字符串。此值的长度必须至少有一个字符，并且在您目录的所有其他ID中必须具有唯一性。出现两部ID相同的作品时，引入系统会拒绝您的目录。制定ID方案并坚定实施，以免遇到重复ID的问题。例如，对于AmazonStudios_ Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf等ID，您可以使用合作伙伴ID+作品类型+长标识符（如GUID）进行处理。用于确保您目录中唯一ID生效的任意方案。

在构造ID时，请牢记两点：

更新现有目录时，不应更改作品ID。如果某个ID不再出现在目录中，则亚马逊认为您的服务已不再提供此作品，因此索引已将其删除。如果此ID稍后返回目录，则应与之前保持一致。如果在引入后更改ID方案，可能会对客户体验产生负面影响。
ID应仅由以下字符组成：.、-、+、0-9、A-Z、a-z。如要使用URI启动应用程序，请在LaunchDetails区块（Offers的property属性）中使用LaunchID。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	NonEmptyToken

示例：

<Movie>
  <ID>AmazonStudios_Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf</ID>
  ...
</Movie>

ExternalID

外部分类下的作品标识符，如IMDb。此值用于匹配内容，与另一个目录对比作品或人物，确定其是否同属一个作品或人物。还可以作为图像等外部内容的来源。所有包含ExternalID的元素都可以根据需要添加任意数量的此条目。

property属性	详细信息
使用	必需
允许数量	1
父元素	`CastMember` `CrewMember` `Extra` `Movie` `TvEpisode` `TvSeason` `TvShow`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`scheme`: 必填。提供此ID的外部来源。数据类型：枚举枚举值： `imdb`：互联网电影数据库 (IMDb)。ID是组成给定页面URL的一部分。 `tms`： OnTV域 - 以前作为Tribune Media Service，但本质是一种较早的Gracenote ID空间。 `isan`：视听数码国际标准 (ISAN)，由26个字符组成的字母数字字符串，通常用短划线分隔。 `ean`: 欧洲商品编号 (EAN)是一种条形码标准，是12位或13位的产品识别码。每个EAN都是商品、制造商及其attribute属性的唯一标识符。 `upc`：通用产品代码 (UPC)是一种12位条形码，广泛用于美国的零售包装。 `asin`: 亚马逊标准识别码 (ASIN) 是由10个字母和/或数字组成的唯一编码，用于标识商品。 `gvd`： Gracenote视频数据 - Gracenote ID提供“电视节目和电影的唯一标识符，[以]链接到电视节目表数据和点播目录”。 `region`: 可选。`externalId`相关区域，如销售亚马逊ASIN商品的市场或提供TMS ID的国家/地区。例如，推行TMS方案的`US`。数据类型：string

示例：

<Movie>
  <ID>MV123456</ID>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <ExternalID scheme="tms">MV000000000000</ExternalID>
  <ExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</ExternalID>
  <ExternalID scheme="ean">0011559514120</ExternalID>
  <ExternalID scheme="upc">123456789990</ExternalID>
  ...
</Movie>

Titles

其中包含作品标题。每部作品都有一个Titles元素。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	`Title`（必填，无限制）
数据类型	string（本地化）

示例：

<TvShow>
  <ID>TV123456</ID>
  <Titles>
    ...
  </Titles>
  ...
</TvShow>

Title

作品标题。为提供本地化标题，每部作品均可添加多个Title元素。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Titles`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string `territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryStringType - 与string相同，但添加了`locale`、`pronunciation`和`territories`属性。

示例：

<TvShow>
  <ID>TV123456</ID>
  <Titles>
    <!--如果省略territories属性，则此标题适用于全球范围，如下所示-->
    <Title locale="en-US">Global English Movie Title</Title>
    <!--以下标题仅适用于美国境内-->
    <Title locale="es" territories="US">Spanish US Movie Title</Title>
  </Titles>
  ...
</TvShow>

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<Copyright locale="en-US">© 2014 Amazon Studios</Copyright>

Offers

其中包含观众可用于欣赏给定作品的服务，如免费、订阅、租赁或购买。每种作品类型只能包含一个Offers元素，而且此Offers元素必须包含至少一种服务类型。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 选择。必须从两个子元素中选择一个，但不能两个都选。
子元素	`SubscriptionOffer`（必填，选择一个） `FreeOffer`（必填，选择一个）
attribute属性	无

示例：

<Offers>
  <FreeOffer>
    <Regions>
      <Territories>US, PR, VI, GB, DE</Territories>
    </Regions>
    <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
    <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
    <LaunchDetails>
      <Quality>SD</Quality>
    </LaunchDetails>
  </FreeOffer>
  <SubscriptionOffer>
    <Regions>
      <Territories>CA</Territories>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>

SubscriptionOffer

订阅了提供方服务的用户可以观看此作品。如有必要，您可以在Offers下添加多个SubscriptionOffer元素。SubscriptionOffer是两种服务类型之一。重要须知： SubscriptionOffer元素虽然是选填的，但在Offers下至少要添加一种服务类型。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Offers`
内容模型	complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。
子元素	`Regions`（必填，无限制） `LaunchDetails`（选填，无限制） `WindowStart`（选填，选择一个） `WindowEnd`（选填，选择一个）
attribute属性	无

示例：

<SubscriptionOffer>
  <Regions>
    <Territories>US, CA</Territories>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

Regions

其中包含可以使用给定服务的国家/地区。每种服务类型只能包含一个Regions元素。

⚠重要须知！ 自2021年8月31日起，此字段中的“US”一词将不再涵盖美国领地。要为这些地区提供服务，请明确添加区域。有关实施流程，请参阅以下示例。

以下美国领地代码可供参考：
美属维尔京群岛=VI、关岛=GU、波多黎各=PR、马里亚纳群岛=MP。

property属性	详细信息
使用	必需
允许数量	1
父元素	`SubscriptionOffer` `FreeOffer`
内容模型	complexType - 选择。必须从两个子元素中选择一个，但不能两个都选。
子元素	`Territories`（必填，选择一个）
attribute属性	无

示例：

<FreeOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</FreeOffer>

Territories

可用使用特定服务的国家、区域和地区，用逗号分隔。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Regions`
内容模型	simpleType（无子元素）
子元素	无
数据类型	TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。

示例：

<SubscriptionOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</SubscriptionOffer>

WindowStart

作品在特定服务下开始可用的日期和时间。您可以使用WindowStart和WindowEnd，宣布某项服务仅在特定时间窗口内可用。观众无法在此窗口前后使用服务。观众不会看到暂无可用服务的作品。每项服务只能有一个WindowStart。

您可以结合使用WindowStart与WindowEnd，也可以单独使用，以控制某项服务下的作品可用性。

仅使用WindowStart： 从那时起，除非将其从目录中删除，否则该作品将无限期可用。
仅使用WindowEnd： 在此期间，可以随时观看作品，直至达到指定时间。
结合使用WindowStart和WindowsEnd： 只能在这一时间窗口内观看作品。
WindowStart和WindowEnd都不使用： 作品将立即可用并一直生效，直至目录将其删除。

property属性	详细信息
使用	可选
允许数量	1
父元素	`SubscriptionOffer` `FreeOffer`
内容模型	simpleType（无子元素）
子元素	无
数据类型	dateTime

示例：

<FreeOffer>
  ...
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  ...
</FreeOffer>

WindowEnd

在此日期和时间后，特定服务下的作品将不再可用。每项服务只能有一个WindowEnd。您可以使用WindowStart和WindowEnd，宣布某项服务仅在特定时间窗口内可用。当WindowEnd指定时间结束后，此服务将不再开放。观众不会看到所有服务均已过期的作品。

您可以结合使用WindowStart与WindowEnd，也可以单独使用，以控制某项服务下的作品可用性。

仅使用WindowStart：从那时起，除非将其从目录中删除，否则该作品将无限期可用。
仅使用WindowEnd：在此期间，可以随时观看作品，直至达到指定时间。
结合使用WindowStart和WindowsEnd：只能在这一时间窗口内观看作品。
WindowStart和WindowEnd都不使用：作品将立即可用并一直生效，直至目录将其删除。

property属性	详细信息
使用	可选
允许数量	1
父元素	`SubscriptionOffer` `FreeOffer`
内容模型	simpleType（无子元素）
子元素	无
数据类型	dateTime

示例：

<FreeOffer>
  ...
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  ...
</FreeOffer>

LaunchDetails

其中包含的元素可指定作品在特定服务下可用的视频质量、音频语言和字幕选项。LaunchDetails中还有一个选填元素LaunchId，让您能以特定的质量、语言和字幕配置直接发行作品。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`SubscriptionOffer` `FreeOffer`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Quality`（选填，无限制） `AudioLanguage`（选填，无限制） `Subtitle`（选填，无限制） `LaunchId`（选填，无限制）
attribute属性	无

示例：

<FreeOffer>
  <Regions>
    <Territories>US, CA</Territories>
  </Regions>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

Quality

作品画质：标准清晰度 (SD)、高清晰度 (HD) 和超高清晰度 (UHD)。一部作品可以提供多种画质选项。

注意： Quality有两种元素。第一种是各类服务的直接子项，自CDF 1.2版本起已弃用。第二种是LaunchDetails的子项，也是各类服务的孙项。除父元素外，两者在形式和内容上都是一模一样的，但我们还是讨论第二种版本较新且仍在使用的Quality元素。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`LaunchDetails`
内容模型	simpleType（无子元素）
子元素	无
数据类型	枚举： `SD`, `HD`, `UHD`

示例：

<FreeOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
    <Quality>SD</Quality>
  </LaunchDetails>
  ...
</FreeOffer>

AudioLanguage

一种音频选项，适用于配音成其他语言的作品。您可以根据需要添加任意数量的AudioLanguage元素，为作品指定可用的替代方案。AudioLanguage虽然是选填项，但亚马逊强烈建议您将其用于配音内容。AudioLanguage确保内容显示正确的字幕语言。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`LaunchDetails`
内容模型	simpleType（无子元素）
子元素	无
数据类型	language

示例：

<LaunchDetails>
  <Quality>SD</Quality>
  <Quality>HD</Quality>
  <AudioLanguage>en-US</AudioLanguage>
  <AudioLanguage>es-MX</AudioLanguage>
  <Subtitle>en-US</Subtitle>
  <Subtitle>es-MX</Subtitle>
  <LaunchId>MV123456_HD_es-MX_en</LaunchId>
</LaunchDetails>

Subtitle

作品字幕的语言选项。一部作品支持多种字幕选项。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`LaunchDetails`
内容模型	simpleType（无子元素）
子元素	无
数据类型	language

示例：

<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>

LaunchId

一种标识符，让您能够使用特定的视频质量、音频语言和字幕（或是这三者的任意子集）配置发行作品。LaunchId没有给定格式 - 只有应用程序逻辑理解能够此格式即可。每种LaunchDetails元素都只能包含一个LaunchId。要指定多个LaunchId，请务必添加多个LaunchDetails元素。

property属性	详细信息
使用	可选
允许数量	1
父元素	`LaunchDetails`
内容模型	simpleType（无子元素）
子元素	无
数据类型	token

示例：

<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_SD_fr-FR_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

property属性	详细信息
使用
允许数量
父元素
内容模型
子元素
attribute属性
数据类型

FreeOffer

您可以随时免费查看作品，也可以只在给定窗口免费观看。如有必要，您可以在Offers下添加多个FreeOffer元素。重要须知： FreeOffer元素虽然是选填的，但在Offers下至少要添加一种服务类型。FreeOffer是两种服务类型之一。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Offers`
内容模型	complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。
子元素	`Regions`（必填，无限制） `LaunchDetails`（选填，无限制） `WindowStart`（选填，选择一个） `WindowEnd`（选填，选择一个）
attribute属性	无

示例：

<FreeOffer>
  <Regions>
    <Territories>US, GB, DE</Territories>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

IsAdultProducts

其中包含将作品标识为仅供成人观看。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`IsAdultProduct`（必填，无限制）
attribute属性	无

示例：

<IsAdultProducts>
  <!-- 如未提供区域，则字段值适用于全球范围。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>

IsAdultProduct

将作品标识为仅供成人观看。

property属性	详细信息
使用	可选
允许数量	1
父元素	`IsAdultProducts`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryBooleanType - 与boolean相同，但添加了`territories`属性。

示例：

<IsAdultProducts>
  <!-- 如未提供区域，则字段值适用于全球范围。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>

ReleaseYear

选填，但强烈建议填写。作品最初公开发行的年份，如果是电视节目，则为首播日期。请注意，此值应该与同一部作品的ReleaseDate或OriginalAirDate元素中的给定年份匹配。

注意： 这虽然是选填元素，但亚马逊建议您添加此元素。此值尤其适用于将此作品与其他提供方的相同作品进行匹配，将所有作品相关服务全部呈现在一条搜索结果中，从而改善客户搜索体验。如此一来，相关人员更容易发现您的特定服务。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	int

示例：

<TvEpisode>
  ...
  <ReleaseYear>1959</ReleaseYear>
  ...
</TvEpisode>

ShortDescriptions

用两三行文字描述不同区域和地区的作品内容。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`ShortDescription`（必填，无限制）
attribute属性	无

示例：

<Movie>
  ...
  <ShortDescriptions>
    ...
  </ShortDescriptions>
  ...
</Movie>

ShortDescription

其中用两三行文字描述了作品内容。请勿为ShortDescription使用其他来源的信息，如作品标题。每部作品都能添加多个ShortDescription元素，以提供本地化描述。要提供更长、更详细的描述，则使用Synopsis元素。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`ShortDescriptions`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string `territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryStringType - 与string相同，但添加了`locale`、`pronunciation`和`territories`属性。

示例：

<Movie>
...
  <ShortDescriptions>
    <ShortDescription locale="en-US" territories="US">Alan shows us some trees and sings songs about them.</ShortDescription>
  </ShortDescriptions>
...
</Movie>

Synopses

其中包含完整的内容描述，因区域和地区而异。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Synopsis`（必填，无限制）
attribute属性	无

示例：

<Movie>
...
  <Synopses>
    ...
  </Synopses>
...
</Movie>

Synopsis

作品内容描述。Synopsis旨在提供比ShortDescription更多的详细信息。请勿使用ShortDescription或作品Title作为Synopsis。为提供本地化描述，每部作品均可包含多个Synopsis元素。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Synopses`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	TerritoryStringType - 与string相同，但添加了`locale`、`pronunciation`和`territories`属性。

示例：

<Movie>
...
  <Synopses>
    <Synopsis locale="en-US" territories="US, CA">Alan Smithee, man about town and fervent urban arborist, takes us on a musical journey around his home town, stopping by some favorite trees to sing about them.As expected from Mr. Smithee, no path runs straight and his plans meander as he encounters guest stars and battles a lumberjack with a literal ax to grind.</Synopsis>
  </Synopses>
...
</Movie>

MetadataAvailabilityDates

包含因地区而异的MetadataAvailabilityDate。假定所有缺少地区值的字段均适用于全球范围。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`MetadataAvailabilityDate`（必填，选择一个）
attribute属性	无

示例：

<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    ...
  </MetadataAvailabilityDates>
  ...
</Movie>

MetadataAvailabilityDate

在此日期之后，应该向观众公开元数据信息。包含此信息可改善匹配度。请注意，MetadataAvailabilityDate和WindowStart是一样的，但MetadataAvailabilityDate不仅隐藏了“播放”按钮，还隐藏了与内容相关的元数据，直到指定日期结束才会公开。结合使用MetadataAvailabilityDate与WindowStart，即可保密信息直到首映（如《高堡奇人》首映）。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`MetadataAvailabilityDates`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryDateTimeType - 与dateTime相同，但添加了`territories`属性。

示例：

<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    //电影将于9月1日在美国、加拿大和英国上映，其他地区将在
    //9月15日上映
    <MetadataAvailabilityDate>2021-09-15T12:00:00Z</MetadataAvailabilityDate>
    <MetadataAvailabilityDate territories="US,CA,GB">2021-09-01T12:00:00Z</MetadataAvailabilityDate>
  </MetadataAvailabilityDates>
  ...
</Movie>

Images

表示电视或电影内容的图像。有关图像尺寸的详细信息，请参阅Image。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Image`（必填，无限制）
attribute属性	无

示例：

<Movie>
  ...
  <Images>
    <Image>
      ...
    </Image>
  </Images>
  ...
 </Movie>

Image

表示电视或电影内容的图像。应采用JPG或PNG格式（首选JPG）。宽高比为16:9，电视节目/季/剧集的宽高尺寸至少为853 x 480像素。尺寸越大越好（最优宽高为1920 x 1080像素），亚马逊将根据需要缩放图像。亚马逊不会使用宽高尺寸小于853 x 480像素或遵循其他宽高比的图像。在这种情况下，将改用其他图像源（如IMDb）或占位符图像。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Images`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Url`（必填，选择一个） `Locale`（选填，无限制）
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。

示例：

<Movie>
  ...
    <Images>
      <Image territories="VI,GU,PR,GB">
        <Url>http://amzf.tmsimg.com/zh/assets/28873/p28873_k_h2_aa.jpg</Url>
        <Locale>en</Locale>
      </Image>
      <Image territories="US">
        <Url>http://amzf.tmsimg.com/zh/assets/28873/p28873_k_h2_haa.jpg</Url>
        <Locale>en</Locale>
      </Image>
    </Images>
  ...
</Movie>

Url

图像URL。有关图像大小和尺寸的详细信息，请参阅Image。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Image`
内容模型	simpleType（无子元素）
子元素	无
数据类型	anyURI

示例：

<Movie>
  ...
    <Images>
      <Image>
        <Url>http://sample-server.net/cds/1.0/image/B23R/FJK8/9FAR/39RTE_992.png</Url>
        <Locale>es</Locale>
      </Image>
    </Images>
    ...
  </Movie>

Locale

适用于图像的语言。有关图像大小和尺寸的详细信息，请参阅Image。

注意： 如需为不同区域提供数据，亚马逊强烈建议您添加此元素。添加locale元素可确保内容能够匹配到合适的语言和区域。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Image`
内容模型	simpleType（无子元素）
子元素	无
数据类型	language

示例：

<Image>
   <Url>http://sample-server.net/cds/1.0/image/B23R/FJK8/9FAR/39RTE_992.png</Url>
   <Locale>es</Locale>
</Image>

Runtimes

其中包含内容的总运行时间，因区域和地区而异。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`RuntimeMinutes`（必填，无限制）
attribute属性	无

示例：

<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>

RuntimeMinutes

按分钟计算的总运行时间。此值为小于2880的非负数，但也可能出现以合法方式超过此值的情况。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Runtimes`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryInteger - 与int相同，但添加了`territories`属性。

示例：

<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>

Color

指定电影为彩色电影还是黑白电影。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	枚举：`color`、`black_and_white`

示例：

<Movie>
  ...
  <Color>black_and_white</Color>
  ...
</Movie>

Credits

其中包含的元素可表示作品的演职人员。同一个人可以作为演员或职员多次出现。每个作品只能有一个Credits元素。如果出现此元素，Credits元素可以根据需要添加任意数量的CastMember或CrewMember，但必须至少添加一个。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 选择。必须从两个子元素中选择一个，但不能两个都选。
子元素	`CastMember`（必填，选择一个） `CrewMember`（必填，选择一个）
attribute属性	无

示例：

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

CastMember

提供有关作品演员阵容的信息，如演员、主持人、旁白人或配音演员。当出现此元素时，选填元素Credits中必须包含至少一个条目，可以是CastMember，也可以是CrewMember。您可以根据需要添加任意数量的CastMember元素。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Credits`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Name`（必填，无限制） `ExternalID`（选填，无限制） `Role`（选填，无限制）
attribute属性	无

示例：

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

Name

与作品有关。作品演员或职员的姓名。对于演职人员，此名称应该是演员的真名，而不是人物的名字。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`CastMember` `CrewMember`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>

ExternalID

property属性	详细信息
使用	必需
允许数量	1
父元素	`CastMember` `CrewMember` `Extra` `Movie` `TvEpisode` `TvSeason` `TvShow`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`scheme`: 必填。提供此ID的外部来源。数据类型：枚举枚举值： `imdb`：互联网电影数据库 (IMDb)。ID是组成给定页面URL的一部分。 `tms`： OnTV域 - 以前作为Tribune Media Service，但本质是一种较早的Gracenote ID空间。 `isan`：视听数码国际标准 (ISAN)，由26个字符组成的字母数字字符串，通常用短划线分隔。 `ean`: 欧洲商品编号 (EAN)是一种条形码标准，是12位或13位的产品识别码。每个EAN都是商品、制造商及其attribute属性的唯一标识符。 `upc`：通用产品代码 (UPC)是一种12位条形码，广泛用于美国的零售包装。 `asin`: 亚马逊标准识别码 (ASIN) 是由10个字母和/或数字组成的唯一编码，用于标识商品。 `gvd`： Gracenote视频数据 - Gracenote ID提供“电视节目和电影的唯一标识符，[以]链接到电视节目表数据和点播目录”。 `region`: 可选。`externalId`相关区域，如销售亚马逊ASIN商品的市场或提供TMS ID的国家/地区。例如，推行TMS方案的`US`。数据类型：string

示例：

<Movie>
  <ID>MV123456</ID>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <ExternalID scheme="tms">MV000000000000</ExternalID>
  <ExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</ExternalID>
  <ExternalID scheme="ean">0011559514120</ExternalID>
  <ExternalID scheme="upc">123456789990</ExternalID>
  ...
</Movie>

Role

作品的人物姓名，由CastMember饰演。例如罗宾汉、兰斯洛特·杜拉克爵士、雅典娜或塞尔夫。请勿使用“actor”（演员）（所有CastMember条目均为演员）或“unknown”（未知）作为此值。如果一人饰演多个角色，则CastMember元素可包含多个Role元素。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`CastMember`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string `locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language
数据类型	string（本地化）

示例：

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Robin Hood</Role>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

CrewMember

其中包含的元素可提供有关作品银幕外摄制组人员的信息，如导演、编剧、摄影师、灯光师、动画师或机械组。当出现此元素时，选填元素Credits中必须包含至少一个CastMember或CrewMember条目。您可以根据需要添加任意数量的CrewMember元素。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Credits`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Name`（必填，无限制） `ExternalID`（选填，无限制） `Job`（必填，无限制）
attribute属性	无

示例：

<Credits>
  <CrewMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Job locale="en-US">Director</Job>
  </CrewMember>
</Credits>

Job

由作品的CrewMember担任的职位，如导演、电影摄影师、编剧或动画师。CrewMember可以根据需要添加任意数量的Job元素。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`CrewMember`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<CrewMember>
  <Name locale="en-US">Alan Smithee</Name>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <Job locale="en-US">Grip</Job>
</CrewMember>

Studios

包含一个或多个Stydui元素，可识别制片厂。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `TvSpecial` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Studio`（选填，无限制）
attribute属性	无

示例：

<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>

Studio

制作这部作品的工作室。一部作品可以有多个Studio条目。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Studios`
内容模型	simpleType（无子元素）
子元素	无
数据类型	string

示例：

<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>

Language

最初制作作品时使用的语言，可以指音频。对于无声作品，也可以指屏幕文本。每部作品只能包含一个Language元素。还可以使用AudioLanguage，指定任意配音选项。您可以在未选择语言的情况下提交目录，但是亚马逊强烈建议您您遵循最佳实践添加内容语言，尤其是当内容支持多种语言时。您需要为每个内容版本指定语言，确保亚马逊为内容匹配正确的语言。

如需为多个区域提供不同语言版本，则需要提供经过对应语言本地化处理的内容。例如，要在日本发行英语电影，则需要提供对应的日语版本。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	language

示例：

<Movie>
  ...
  <Language>ja</Language>
  ...
</Movie>

CustomerRating

其中包含的元素会提供作品的平均客户评分、最高评分和评分人数。每个作品只能有一个CustomerRating元素。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Score`（必填，选择一个） `MaxValue`（必填，选择一个） `Count`（选填，选择一个）
子元素备注	`Count`仅适用于CDF v1.2和更高版本。
attribute属性	无

示例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Score

基于客户反馈为作品打出的平均分数（评分）。您可以自行决定信息收集方式，并设置MaxValue，为评分系统限定范围。您可以添加一个选填元素Count，计算为评分投出的票数。每个CustomerRating只能添加一个评分。

property属性	详细信息
使用	必需
允许数量	1
父元素	`CustomerRating`
内容模型	simpleType（无子元素）
子元素	无
数据类型	decimal（正值）

示例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

MaxValue

客户可对作品打出的最高评分。每个CustomerRating只能有一个MaxValue。

property属性	详细信息
使用	必需
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	decimal（正值）

示例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Count

进行客户评Score的用户数量。每个CustomerRating只能有一个Count。

property属性	详细信息
使用	可选
允许数量	1
父元素	`CustomerRating`
内容模型	simpleType（无子元素）
子元素	无
数据类型	非负long整数

示例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Rank

相对于目录中的其他商品而言，这是一种人气分。经过定义，1表示最高名次。您可以自行决定排行方式，多种商品也能排在同一名次。每部作品只能有一个Rank元素。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	int

示例：

<TvShow>
  ...
  <Rank>36</Rank>
  ...
</TvShow>

IsOriginals

检查商品是否由提供方原创。内容原创性可能因国家和地区而异。例如，全球各国均使用Prime Video制作电影，日本和加拿大除外。您可以使用此元素，指明原创性与全球设置不同的地区。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`IsOriginal`（必填，无限制）
attribute属性	无

示例：

<IsOriginals>
  <!--要使商品符合全球原创设置，请使用不带territories属性的IsOriginal子元素。-->
  <IsOriginal>true</IsOriginal>
  <!--如果相同内容不应由美国和加拿大的提供方原创，则在  下添加其他元素-->
  <IsOrignal territories="US,CA">false</IsOrignal>
</IsOriginals>

IsOriginal

描述商品是否由提供方原创。内容原创性可能因国家和地区而异。例如，全球各国均使用Prime Video制作电影，日本和加拿大除外。您可以使用此元素，指明原创性与全球设置不同的地区。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`IsOriginals`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryBooleanType - 与boolean相同，但添加了`territories`属性。

示例：

<IsOriginals>
  <!--要使商品符合全球原创设置，请使用不带territories属性的IsOriginal子元素。-->
  <IsOriginal>true</IsOriginal>
  <!--如果相同内容不应由美国和加拿大的提供方原创，则在  下添加其他元素-->
  <IsOrignal territories="US,CA">false</IsOrignal>
</IsOriginals>

Genres

其中包含一个或多个描述作品类别的Genre标签，如喜剧片、恐怖片或纪录片。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`Genre`（必填，无限制）
attribute属性	无

示例：

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

Genre

作品题材，如喜剧片、恐怖片、剧情片或纪录片。如有必要，一部作品可以添加多个Genre元素。为优化搜索和匹配结果，请尽量使用标准题材描述。使用多个Genre标签，而不是将多个描述融合为一个字符串。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Movie`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

ContentRatings

其中包含指定认证机构对作品打出的一项或多项官方评分。每部作品只能有一个ContentRatings元素。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`ContentRating`（必填，无限制）
attribute属性	无

示例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

ContentRating

其中包含指定了评分系统或组织以及作品评分的元素。当出现此元素时，选填元素ContentRatings中必须包含至少一个ContentRating。您可以根据需要为每一对系统/评分添加任意数量的ContentRating元素。

以下国家/地区必须具有ContentRatings：美国、巴西、澳大利亚、日本。亚马逊强烈建议其他所有国家/地区都添加ContentRatings。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`ContentRatings`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`System`（必填，选择一个） `Certification`（必填，选择一个）
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。

示例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

System

评分系统，往往是官方组织，负责为作品打分。每次评分只能有一个System。

property属性	详细信息
使用	必需
允许数量	1
父元素	`ContentRating`
内容模型	simpleType（无子元素）
子元素	无
数据类型	string

示例：

<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>G</Certification>
  </ContentRating>
</ContentRatings>

Certification

根据指定认证System向作品授予的认证或评分。每个ContentRating只能有一个Certification元素。

property属性	详细信息
使用	必需
允许数量	1
父元素	`ContentRating`
内容模型	simpleType（无子元素）
子元素	无
数据类型	string

示例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
<ContentRating>

ShowID

用于将TvEpisode或TvSeason与目录中的TvShow关联起来。此值必须与TvShow元素中的ID值匹配。您可以使用ShowID或ShowTitle来指定节目，但不能同时选择两者。当目录中出现TvShow时，应始终使用ShowID。

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvSeason` `TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	token

示例：

<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>

ShowTitle

用于将TvEpisode或TvSeason与目录中的TvShow关联起来。此值只是UI所用字符串，无需匹配目录中的任何标题。您可以使用ShowID或ShowTitle来指定节目，但不能同时选择两者。只有在缺失ShowID时才能使用ShowTitle。

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvSeason` `TvEpisode`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>

SeasonInShow

TVEpisode所属季的编号，该季不在您的目录中。SeasonInShow只是UI所用编号，无需匹配任何内容。您可以使用SeasonID或SeasonInShow来指定本季，但不能同时选择两者。只有在缺失SeasonID时才能使用SeasonInShow，但这种情况很罕见。

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	int

示例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>

ShowID

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvSeason` `TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	token

示例：

<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>

ShowTitle

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvSeason` `TvEpisode`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>

SeasonID

TvEpisode是本季ID的内容。带有此ID的TvSeason必须作为TvEpisode，出现在同一个目录中。您可以使用SeasonID或SeasonInShow来指定本季，但不能同时选择两者。当目录中出现本季时，应始终使用SeasonID。否则，请考虑创建TvSeason条目。

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	token

示例：

<TvSeason>
  <ID>SEA-2329880</ID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <SeasonID>SEA-2329880</SeasonID>
  ...
</TvEpisode>

SeasonInShow

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	int

示例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>

SeasonTitle

TvEpisode出现那一季的标题，如“Season 2”（第2季）。请注意，如果目录中包含相应的TvSeason元素，那么即使此值应与其Title匹配，您也可以不匹配。每集TvEpisode只能有一个SeasonTitle。

property属性	详细信息
使用	可选
允许数量	1
父元素	`TvEpisode`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`locale`: 必填。设备或软件的语言设置，在此项下使用字符串。数据类型：language `pronunciation`: 可选。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序（无法根据汉字确定）。pronunciation属性通常使用平假名，可提供此信息。数据类型：string
数据类型	string（本地化）

示例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  <SeasonTitle locale="en-US">Season 2</SeasonTitle>
  ...
</TvEpisode>

EpisodeInSeason

电视剧集在本季中的序列号。每集TvEpisode中只能有一个EpisodeInSeason元素。

property属性	详细信息
使用	必需
允许数量	1
父元素	`TvEpisode`
内容模型	simpleType（无子元素）
子元素	无
数据类型	int

示例：

<TvEpisode>
  ...
  <EpisodeInSeason>6</EpisodeInSeason>
  ...
</TvEpisode>

OriginalAirDates

剧集或特辑原定进行首播的日期。

property属性	详细信息
使用	可选
允许数量	1
父元素	`TvEpisode`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`OriginalAirDate`（必填，无限制）
attribute属性	无

示例：

<Movie>
  ...
  <OriginalAirDates>
    ...
  </OriginalAirDate>
</Movie>

OriginalAirDate

作品首播的日期和时间。如果出现该选填元素，则此值的年份部分应与ReleaseYear匹配。此信息可用于匹配此作品和其他目录中的内容。匹配操作能够单列作品，显示其所有可用来源，而不会在搜索同一作品时出现多个结果。

property属性	详细信息
使用	可选
允许数量	1
父元素	`OriginalAirDates`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryDateTimeType - 与dateTime相同，但添加了`territories`属性。

示例：

<Movie>
...
  <OriginalAirDates>
    <OriginalAirDate territories="US,CA">2014-01-01T11:30:00+08:00</OriginalAirDate>
  </OriginalAirDates>
</Movie>

ReleaseDates

其中包括在不同地区的发行日期。

property属性	详细信息
使用	可选
允许数量	1
父元素	`Movie` `TvShow`
内容模型	complexType - 序列。请务必按指定顺序添加必填子元素。
子元素	`ReleaseDate`（必填，无限制）
attribute属性	无

示例：

<TvShow>
  ...
  <ReleaseDates>
  ...
  </ReleaseDates>
</TvShow>

ReleaseDate

作品最初公开发行的日期和时间，如果是电视节目，则为首播日期。如果出现该选填元素，则此值的年份部分应与ReleaseYear匹配。此信息尤其适合用来匹配此作品和其他目录中的内容。匹配操作能够单列作品，显示其所有可用来源，而不会在搜索同一作品时出现多个结果。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`ReleaseDates`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`territories`：可选。国家和地区列表，用逗号分隔，表示受此元素影响的地点。留空则表示全球范围。数据类型： TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。
数据类型	TerritoryDateTimeType - 与dateTime相同，但添加了`territories`属性。

示例：

<TvShow>
  ...
  <ReleaseDates>
    <ReleaseDate territories="US,CA">2012-05-13T00:00:00</ReleaseDate>
  </ReleaseDates>
</TvShow>

Type

指定Extra作为片段。您可以将片段作为预告片，也可以扩充内容，作为Extra中相关Movie的纪录片。每个Extra只能有一个Type。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	枚举：`clip`

示例：

<Extra>
  ...
  <Type>clip</Type>
  ...
</Extra>

RelatesToID

用于指定另一部作品，其与Extra（如电影预告片）相关。带有此ID的作品必须作为Extra，出现在同一个目录中。您可以使用RelatesToID或RelatesToExternalID来指定相关作品，但不能同时选择两者。当目录中出现相关作品时，应始终使用RelatesToID。

property属性	详细信息
使用	可选
允许数量	无限制
父元素	`Extra`
内容模型	simpleType（无子元素）
子元素	无
数据类型	token

示例：

<TvShow>
  <ID>TV123456</ID>
  ...
</TvShow>
<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToID>TV123456</RelatesToID>
</Extra>

RelatesToExternalID

用于指定另一部作品，其与Extra（如电影预告片）相关。RelatesToExternalID会在IMDb等外部分类中为其他作品（如电影）指定标识符。当您的目录中缺少相关作品时，可以使用RelatesToExternalID。您可以使用RelatesToID或RelatesToExternalID来指定相关作品，但不能同时选择两者。只有在缺失RelatesToID时才能使用RelatesToExternalID。

请勿将RelatesToExternalID与ExternalID混淆。ExternalID是指Extra本身，而RelatesToExternalID是指与之相关的作品。

property属性	详细信息
使用	必需
允许数量	无限制
父元素	`Extra`
内容模型	complexType - 仅限attribute属性。不含子元素，但元素可以添加attribute属性。
子元素	无
attribute属性	`scheme`: 必填。提供此ID的外部来源。数据类型：枚举枚举值： `imdb`：互联网电影数据库 (IMDb)。ID是组成给定页面URL的一部分。 `tms`： OnTV域 - 以前作为Tribune Media Service，但本质是一种较早的Gracenote ID空间。 `isan`：视听数码国际标准 (ISAN)，由26个字符组成的字母数字字符串，通常用短划线分隔。 `ean`: 欧洲商品编号 (EAN)是一种条形码标准，是12位或13位的产品识别码。每个EAN都是商品、制造商及其attribute属性的唯一标识符。 `upc`：通用产品代码 (UPC)是一种12位条形码，广泛用于美国的零售包装。 `asin`: 亚马逊标准识别码 (ASIN) 是由10个字母和/或数字组成的唯一编码，用于标识商品。 `gvd`： Gracenote视频数据 - Gracenote ID提供“电视节目和电影的唯一标识符，[以]链接到电视节目表数据和点播目录”。 `region`: 可选。`externalId`相关区域，如销售亚马逊ASIN商品的市场或提供TMS ID的国家/地区。例如，推行TMS方案的`US`。数据类型：string
数据类型	token

示例：

<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToExternalID scheme="imdb">tt0000000</RelatesToExternalID>
  <RelatesToExternalID scheme="tms">MV000000000000</RelatesToExternalID>
  <RelatesToExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</RelatesToExternalID>
  <RelatesToExternalID scheme="ean">0011559514120</RelatesToExternalID>
  <RelatesToExternalID scheme="upc">123456789990</RelatesToExternalID>
</Extra>

Last updated: 2024年2月23日