开发者控制台

所有CDF元素

所有CDF元素
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>
↑ 返回顶部
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>
↑ 返回顶部
Catalog

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

property属性 详细信息
使用 必需
允许数量 1
父元素
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 Partner(必填,选择一个)
Works(必填,选择一个)
attribute属性

xmlns必填。XML命名空间。


version: 选填。此目录使用的架构版本。请参阅架构“id”,确定当前使用的架构版本。虽然出于兼容性原因,此attribute属性可以选填,但亚马逊仍建议您提供版本信息。

数据类型: 枚举

枚举值: FireTv-v1.2FireTv-v1.3FireTv-v1.4FireTv-v1.5FireTv-v1.6FireTv-v1.7FireTv-v1.8FireTv-v1.9FireTv-v1.10FireTv-v1.11FireTv-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>
↑ 返回顶部
Certification

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

property属性 详细信息
使用 必需
允许数量 1
父元素 ContentRating
内容模型 simpleType(无子元素)
子元素
数据类型 string
示例
<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
<ContentRating>
↑ 返回顶部
Color

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 枚举:colorblack_and_white
示例
<Movie>
  ...
  <Color>black_and_white</Color>
  ...
</Movie>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部

作品版权声明。

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>
↑ 返回顶部
Count

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

property属性 详细信息
使用 可选
允许数量 1
父元素 CustomerRating
内容模型 simpleType(无子元素)
子元素
数据类型 非负long整数
示例
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑ 返回顶部
Credits

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 选择。必须从两个子元素中选择一个,但不能两个都选。
子元素 CastMember(必填,选择一个)
CrewMember(必填,选择一个)
attribute属性
示例
<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">塞尔夫</Role>
  </CastMember>
</Credits>
↑ 返回顶部
CrewMember

其中包含的元素可提供有关作品银幕外摄制组人员的信息,如导演、编剧、摄影师、灯光师、动画师或机械组。当出现此元素时,选填元素Credits中必须包含至少一个CastMemberCrewMember条目。您可以根据需要添加任意数量的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>
↑ 返回顶部
CustomerRating

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 Score(必填,选择一个)
MaxValue(必填,选择一个)
Count(选填,选择一个)
子元素备注 Count仅适用于CDF 1.2和更高版本。
attribute属性
示例
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑ 返回顶部
EpisodeInSeason

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

property属性 详细信息
使用 必需
允许数量 1
父元素 TvEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<TvEpisode>
  ...
  <EpisodeInSeason>6</EpisodeInSeason>
  ...
</TvEpisode>
↑ 返回顶部
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个字母和/或数字组成的唯一编码,用于标识商品。
  • gvdGracenote视频数据 - 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>
↑ 返回顶部
Extra

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Works
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加RelatesToIDRelatesToExternalID,但不能同时选择两者。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Titles(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
IsAdultProducts(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescriptions(选填,选择一个)
Synopses(选填,选择一个)
MetadataAvailabilityDates(选填,选择一个)
Images(必填,选择一个)
Runtimes(选填,选择一个)
Color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
CustomerRating(选填,选择一个)
Rank(选填,选择一个)
IsOriginals(选填,选择一个)
Genres(选填,选择一个)
ContentRatings(选填,选择一个)
Type(必填,选择一个)
RelatesToID(必填,无限制)
RelatesToExternalID(必填,无限制)
attribute属性
示例
<Extra>
  <ID>EXTRA-11111</ID>
  ...
  <Type>clip</Type>
</Extra>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
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>英语</Locale>
      </Image>
      <Image territories="US">
        <Url>http://amzf.tmsimg.com/zh/assets/28873/p28873_k_h2_haa.jpg</Url>
        <Locale>英语</Locale>
      </Image>
    </Images>
  ...
</Movie>
↑ 返回顶部
Images

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 Image(必填,无限制)
attribute属性
示例
<Movie>
  ...
  <Images>
    <Image>
      ...
    </Image>
  </Images>
  ...
 </Movie>
↑ 返回顶部
ID

作品的标识符字符串。此值的长度必须至少有一个字符,并且在您目录的所有其他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>
↑ 返回顶部
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>
↑ 返回顶部
IsAdultProducts

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 IsAdultProduct(必填,无限制)
attribute属性
示例
<IsAdultProducts>
  <!-- 如未提供区域,则字段值适用于全球范围。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
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">机械组</Job>
</CrewMember>
↑ 返回顶部
Language

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

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 language
示例
<Movie>
  ...
  <Language>ja</Language>
  ...
</Movie>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
Locale

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

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>
↑ 返回顶部
MaxValue

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 decimal(正值)
示例
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑ 返回顶部
MetadataAvailabilityDate

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

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>
↑ 返回顶部
MetadataAvailabilityDates

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 MetadataAvailabilityDate(必填,选择一个)
attribute属性
示例
<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    ...
  </MetadataAvailabilityDates>
  ...
</Movie>
↑ 返回顶部
Movie

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Titles(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
IsAdultProducts(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescriptions(选填,选择一个)
Synopses(选填,选择一个)
MetadataAvailabilityDates(选填,选择一个)
Images(必填,选择一个)
Runtimes(选填,选择一个)
Color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
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>
↑ 返回顶部
Name

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

property属性 详细信息
使用 必需
允许数量 无限制
父元素 CastMember
CrewMember
内容模型 complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。
子元素
attribute属性

locale: 必填。设备或软件的语言设置,在此项下使用字符串。

数据类型:language


pronunciation: 选填。适用于以日文汉字编写的元素文本。日语基于发音而不是字符进行预期排序(无法根据汉字确定)。pronunciation属性通常使用平假名,可提供此信息。

数据类型:string

数据类型 string(本地化)
示例
<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
OriginalAirDates

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

property属性 详细信息
使用 可选
允许数量 1
父元素 TvEpisode
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 OriginalAirDate(必填,无限制)
attribute属性
示例
<Movie>
  ...
  <OriginalAirDates>
    ...
  </OriginalAirDate>
</Movie>
↑ 返回顶部
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>
↑ 返回顶部
Quality

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 LaunchDetails
内容模型 simpleType(无子元素)
子元素
数据类型 枚举: SD, HD, UHD
示例
<FreeOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
    <Quality>SD</Quality>
  </LaunchDetails>
  ...
</FreeOffer>
↑ 返回顶部
Rank

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<TvShow>
  ...
  <Rank>36</Rank>
  ...
</TvShow>
↑ 返回顶部
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>
↑ 返回顶部
RelatesToExternalID

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

请勿将RelatesToExternalIDExternalID混淆。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个字母和/或数字组成的唯一编码,用于标识商品。
  • gvdGracenote视频数据 - 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>
↑ 返回顶部
RelatesToID

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Extra
内容模型 simpleType(无子元素)
子元素
数据类型 token
示例
<TvShow>
  <ID>TV123456</ID>
  ...
</TvShow>
<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToID>TV123456</RelatesToID>
</Extra>
↑ 返回顶部
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>
↑ 返回顶部
ReleaseDates

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ReleaseDate(必填,无限制)
attribute属性
示例
<TvShow>
  ...
  <ReleaseDates>
  ...
  </ReleaseDates>
</TvShow>
↑ 返回顶部
ReleaseYear

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<TvEpisode>
  ...
  <ReleaseYear>1959</ReleaseYear>
  ...
</TvEpisode>
↑ 返回顶部
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">罗宾汉</Role>
    <Role locale="en-US">塞尔夫</Role>
  </CastMember>
</Credits>
↑ 返回顶部
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>
↑ 返回顶部
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>
↑ 返回顶部
Score

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

property属性 详细信息
使用 必需
允许数量 1
父元素 CustomerRating
内容模型 simpleType(无子元素)
子元素
数据类型 decimal(正值)
示例
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑ 返回顶部
SeasonID

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

property属性 详细信息
使用 必需
允许数量 1
父元素 TvEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 token
示例
<TvSeason>
  <ID>SEA-2329880</ID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <SeasonID>SEA-2329880</SeasonID>
  ...
</TvEpisode>
↑ 返回顶部
SeasonInShow

TVEpisode所属季的编号,该季不在您的目录中。SeasonInShow只是UI所用编号,无需匹配任何内容。您可以使用SeasonIDSeasonInShow来指定本季,但不能同时选择两者。只有在缺失SeasonID时才能使用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>
↑ 返回顶部
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相同,但添加了localepronunciationterritories属性。
示例
<Movie>
...
  <ShortDescriptions>
    <ShortDescription locale="en-US" territories="US">Alan shows us some trees and sings songs about them.</ShortDescription>
  </ShortDescriptions>
...
</Movie>
↑ 返回顶部
ShortDescriptions

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ShortDescription(必填,无限制)
attribute属性
示例
<Movie>
  ...
  <ShortDescriptions>
    ...
  </ShortDescriptions>
  ...
</Movie>
↑ 返回顶部
ShowID

用于将TvEpisodeTvSeason与目录中的TvShow关联起来。此值必须与TvShow元素中的ID值匹配。您可以使用ShowIDShowTitle来指定节目,但不能同时选择两者。当目录中出现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

用于将TvEpisodeTvSeason与目录中的TvShow关联起来。此值只是UI所用字符串,无需匹配目录中的任何标题。您可以使用ShowIDShowTitle来指定节目,但不能同时选择两者。只有在缺失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>
↑ 返回顶部
Studio

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

property属性 详细信息
使用 必需
允许数量 无限制
父元素 Studios
内容模型 simpleType(无子元素)
子元素
数据类型 string
示例
<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>
↑ 返回顶部
Studios

包含一个或多个Studio元素,用于标识制作作品的工作室。

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 Studio(选填,无限制)
attribute属性
示例
<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>
↑ 返回顶部
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>
↑ 返回顶部
Subtitle

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 LaunchDetails
内容模型 simpleType(无子元素)
子元素
数据类型 language
示例
<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>
↑ 返回顶部
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相同,但添加了localepronunciationterritories属性。
示例
<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>
↑ 返回顶部
System

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

property属性 详细信息
使用 必需
允许数量 1
父元素 ContentRating
内容模型 simpleType(无子元素)
子元素
数据类型 string
示例
<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>G</Certification>
  </ContentRating>
</ContentRatings>
↑ 返回顶部
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>
↑ 返回顶部
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相同,但添加了localepronunciationterritories属性。
示例
<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>
↑ 返回顶部
Titles

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素 Title(必填,无限制)
数据类型 string(本地化)
示例
<TvShow>
  <ID>TV123456</ID>
  <Titles>
    ...
  </Titles>
  ...
</TvShow>
↑ 返回顶部
TvEpisode

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowIDShowTitle,但不能同时选择两者。也可以添加SeasonIDSeasonInShow,但不能同时选择两者。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Titles(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
IsAdultProducts(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescriptions(选填,选择一个)
Synopses(选填,选择一个)
MetadataAvailabilityDates(选填,选择一个)
Images(必填,选择一个)
Runtimes(选填,选择一个)
Color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
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中的一季,是一种基本作品类型。当TvEpisodeSeasonID值与TvSeasonID值相同时,该剧集即为本季内容。

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowIDShowTitle,但不能同时选择两者。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Titles(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
IsAdultProducts(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescriptions(选填,选择一个)
Synopses(选填,选择一个)
MetadataAvailabilityDates(选填,选择一个)
Images(必填,选择一个)
Runtimes(选填,选择一个)
Color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
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

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Titles(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
IsAdultProducts(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescriptions(选填,选择一个)
Synopses(选填,选择一个)
MetadataAvailabilityDates(选填,选择一个)
Images(必填,选择一个)
Runtimes(选填,选择一个)
Color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
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>
↑ 返回顶部
Type

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Extra
内容模型 simpleType(无子元素)
子元素
数据类型 枚举:clip
示例
<Extra>
  ...
  <Type>clip</Type>
  ...
</Extra>
↑ 返回顶部
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>
↑ 返回顶部
WindowEnd

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

您可以结合使用WindowStartWindowEnd,也可以单独使用,以控制某项服务下的作品可用性。

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

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>
↑ 返回顶部
WindowStart

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

您可以结合使用WindowStartWindowEnd,也可以单独使用,以控制某项服务下的作品可用性。

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

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>
↑ 返回顶部
Works

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Catalog
内容模型 contentType - 序列和选择。您可以为Works元素添加任意子元素,此元素会按照您想要的顺序多次出现。
子元素 Movie(选填,无限制)
TvEpisode(选填,无限制)
TvSeason(选填,无限制)
TvShow(选填,无限制)
Extra(选填,无限制)
attribute属性
示例
<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>
↑ 返回顶部

已弃用的元素

这些元素已弃用。请注意,如果目录数据文件包含已弃用元素,则您的目录不会遭到拒绝。您应该尽力删除这些元素,提高匹配度。

AdultProduct

将作品标识为仅供成人观看。在日本,您还可以使用JP_Require18PlusAgeConfirmation

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 boolean
示例
<Movie>false</Movie>
  ...
  <AdultProduct>false</AdultProduct>
  ...
</Movie>false</Movie>
↑ 返回顶部
Country

提供特定服务(订阅服务、免费服务、购买服务或租赁服务)的国家或地区。所有服务都可以根据需要添加任意数量的Country元素。

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

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

property属性 详细信息
使用 必需
允许数量 1
父元素 Regions
内容模型 simpleType(无子元素)
子元素
数据类型 枚举允许使用以下ISO 3166-1国家/地区代码子集: AF AX AL DZ AS AD AO AI AQ AG AR AM AW AU AT AZ BS BH BD BB BY BE BZ BJ BM BT BO BQ BA BW BV BR IO BN BG BF BI KH CM CA CV KY CF TD CL CN CX CC CO KM CG CD CK CR CI HR CU CW CY CZ DK DJ DM DO EC EG SV GQ ER EE ET FK FO FJ FI FR GF PF TF GA GM GE DE GH GI GR GL GD GP GU GT GG GN GW GY HT HM VA HN HK HU IS IN ID IR IQ IE IM IL IT JM JP JE JO KZ KE KI KP KR KW KG LA LV LB LS LR LY LI LT LU MO MK MG MW MY MV ML MT MH MQ MR MU YT MX FM MD MC MN ME MS MA MZ MM NA NR NP NL NC NZ NI NE NG NU NF MP NO OM PK PW PS PA PG PY PE PH PN PL PT PR QA RE RO RU RW BL SH KN LC MF PM VC WS SM ST SA SN RS SC SL SG SX SK SI SB SO ZA GS SS ES LK SD SR SJ SZ SE CH SY TW TJ TZ TH TL TG TK TO TT TN TR TM TC TV UG UA AE GB US UM UY UZ VU VE VN VG VI WF EH YE ZM ZW
示例
<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </Regions>
  ...
</SubscriptionOffer>
↑ 返回顶部
Duration

以小时为单位,定义作品的租赁时间。每个RentalOffer只能包含一个Duration元素。

property属性 详细信息
使用 必需
允许数量 1
父元素 RentalOffer
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<RentalOffer>
  ...
  <Duration>120</Duration>
</RentalOffer>
↑ 返回顶部
EpisodeInSeries

迷你剧剧集在所属系列中的序列号。每个MiniSeriesEpisode只能包含一个EpisodeInSeries元素。

property属性 详细信息
使用 必需
允许数量 1
父元素 MiniSeriesEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<MiniSeriesEpisode>
  ...
  <EpisodeInSeries>13</EpisodeInSeries>
  ...
</MiniSeriesEpisode>
↑ 返回顶部
ImageUrl

表示作品的图像URL,有时也叫“封面图”。 每部作品只能包含一个ImageUrl元素。如果您没有添加ImageUrl,则亚马逊会尝试使用其他来源的可用封面图,如IMDb,也可能使用通用的占位符图像。有关图像要求,请参阅封面图要求(ImageUrl)。注意:​ 为每部作品都提供适用于内容的特殊图像。请勿使用标志等通用占位符图像。

property属性 详细信息
使用 必需
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 anyURI
示例
<TvShow>
  ...
  <ImageUrl>http://amazon.com/zh/images/01152ce2de7e44c1/image.jpg</ImageUrl>
  ...
</TvShow>
↑ 返回顶部
JP_Require18PlusAgeConfirmation

标记日本市场中仅供成年人观看的内容。请根据日本法律要求,要将此标记设置为true,则需要观看内容的日本观众确认自己已成年。

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 boolean
示例
<Movie>
  ...
  <JP_Require18PlusAgeConfirmation>true</JP_Require18PlusAgeConfirmation>
</Movie>
↑ 返回顶部
MetadataAvailabilityDate - 已弃用

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 dateTime
示例
<Movie>
  <ID>MV-123456</ID>
  <Title locale="en-US">Chase the Prawns</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <MetadataAvailabilityDate>2000-01-01T12:00:00Z</MetadataAvailabilityDate>
  <ReleaseDate>2013-10-04T00:00:00</ReleaseDate>
</Movie>
↑ 返回顶部
MiniSeries

可以将其大致定义为电视节目,其中收录了这一季中未播放的少量预定剧集。MiniSeries可以包含的剧集数量并无明确限制,但这个数字应该相当低。

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Title(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescription(选填,无限制)
Synopsis(选填,无限制)
MetadataAvailabilityDate(选填,选择一个)
Images(必填,选择一个)
RuntimeMinutes(选填,选择一个)
color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
CustomerRating(选填,选择一个)
Rank(选填,选择一个)
Source(选填,选择一个)
Genres(选填,选择一个)
ContentRatings(选填,选择一个)
JP_Require18PlusAgeConfirmation(选填,选择一个)
ReleaseDate(选填,选择一个)
attribute属性
示例
<MiniSeries>
  <ID>MS-2329880</ID>
  <Title locale="en-US">All the Best People</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ReleaseDate>2005-04-29T20:00:00</ReleaseDate>
</MiniSeries>
↑ 返回顶部
MiniSeriesEpisode

MiniSeriesEpisode是指MiniSeries中的某一集,是一种基本作品类型。此内容与这一季无关,但会根据MiniSeries的前后剧情排序。

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowIDShowTitle,但不能同时选择两者。也可以添加MiniSeriesIDMiniSeriesTitle
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Title(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescription(选填,无限制)
Synopsis(选填,无限制)
MetadataAvailabilityDate(选填,选择一个)
Images(必填,选择一个)
RuntimeMinutes(选填,选择一个)
color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
CustomerRating(选填,选择一个)
Rank(选填,选择一个)
Source(选填,选择一个)
Genres(选填,选择一个)
ContentRatings(选填,选择一个)
JP_Require18PlusAgeConfirmation(选填,选择一个)
MiniSeriesID(必填,选择一个)
MiniSeriesTitle(必填,选择一个)
OriginalAirDate(选填,选择一个)
attribute属性
示例
<MiniSeries>
  <ID>MS-123456789</ID>
  ...
</MiniSeries>
<MiniSeriesEpisode>
  <ID>MSE-2329880</ID>
  <Title locale="en-US">The First Steps on a New Planet</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <MiniSeriesID>MS-123456789</MiniSeriesID>
  <EpisodeInSeries>1</EpisodeInSeries>
  <OriginalAirDate>2012-07-02T20:00:00</OriginalAirDate>
</MiniSeriesEpisode>
↑ 返回顶部
MiniSeriesID

用于指定剧集所属的迷你剧。带有此IDMiniSeries必须作为MiniSeriesEpisode,出现在同一个目录中。您可以使用MiniSeriesIDMiniSeriesTitle来指定迷你剧,但不能同时选择两者。当目录中出现迷你剧时,应始终使用MiniSeriesID。否则,亚马逊建议您创建MiniSeries条目以供使用。

property属性 详细信息
使用 必需
允许数量 1
父元素 MiniSeriesEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 token
示例
<MiniSeries>
  <ID>MS-2329880</ID>
  ...
</MiniSeries>
</MiniSeriesEpisode>
  ...
  <MiniSeriesID>MS-2329880</MiniSeriesID>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
↑ 返回顶部
MiniSeriesTitle

当目录中找不到迷你剧时,指定剧集所属的迷你剧。MiniSeriesTitle只是UI所用字符串,无需匹配目录中的任何现有标题。您可以使用MiniSeriesIDMiniSeriesTitle来指定迷你剧,但不能同时选择两者。只有在缺失MiniSeriesID时才能使用MiniSeriesTitle,但这种情况很罕见。

property属性 详细信息
使用 必需
允许数量 1
父元素 MiniSeriesEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 string(本地化)
示例
<MiniSeriesEpisode>
  ...
  <MiniSeriesTitle>Cats, The Most Beautiful Creature</MiniSeriesTitle>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
↑ 返回顶部
OriginalAirDate - 已弃用

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

property属性 详细信息
使用 可选
允许数量 1
父元素 TvEpisode
内容模型 simpleType(无子元素)
子元素
数据类型 dateTime
示例
<TvEpisode>
  ...
  <OriginalAirDate>2012-05-13T00:00:00</OriginalAirDate>
</TvEpisode>
↑ 返回顶部
Price

作品的租赁或购买成本。

property属性 详细信息
使用 必需
允许数量 1
父元素 PurchaseOffer
RentalOffer
内容模型 simpleType(无子元素)
子元素
数据类型 xsd:float
示例
<PurchaseOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <Price currency="USD">1.99</Price>
</PurchaseOffer>
↑ 返回顶部
PurchaseOffer

一次性付清作品费用即可拥有并随时观看。如有必要,您可以在Offers下添加多个PurchaseOffer元素。PurchaseOffer是两种服务类型之一。重要须知: PurchaseOffer元素虽然是选填的,但在Offers下至少要添加一种服务类型。(请注意,Fire TV目前不会处理显示屏上的PurchaseOffer信息。)

property属性 详细信息
使用 必需
允许数量 1
父元素 Offers
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。
子元素 Regions(必填,无限制)
LaunchDetails(选填,无限制)
WindowStart(选填,选择一个)
WindowEnd(选填,选择一个)
Price(必填,选择一个)
attribute属性
示例
<PurchaseOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
  <Price currency="USD">1.99</Price>
</PurchaseOffer>
↑ 返回顶部
ReleaseCountry

property属性 详细信息
使用 可选
允许数量 1
父元素 ReleaseInfo
内容模型 simpleType(无子元素)
子元素
数据类型 枚举允许使用以下ISO 3166-1国家/地区代码子集: AF AX AL DZ AS AD AO AI AQ AG AR AM AW AU AT AZ BS BH BD BB BY BE BZ BJ BM BT BO BQ BA BW BV BR IO BN BG BF BI KH CM CA CV KY CF TD CL CN CX CC CO KM CG CD CK CR CI HR CU CW CY CZ DK DJ DM DO EC EG SV GQ ER EE ET FK FO FJ FI FR GF PF TF GA GM GE DE GH GI GR GL GD GP GU GT GG GN GW GY HT HM VA HN HK HU IS IN ID IR IQ IE IM IL IT JM JP JE JO KZ KE KI KP KR KW KG LA LV LB LS LR LY LI LT LU MO MK MG MW MY MV ML MT MH MQ MR MU YT MX FM MD MC MN ME MS MA MZ MM NA NR NP NL NC NZ NI NE NG NU NF MP NO OM PK PW PS PA PG PY PE PH PN PL PT PR QA RE RO RU RW BL SH KN LC MF PM VC WS SM ST SA SN RS SC SL SG SX SK SI SB SO ZA GS SS ES LK SD SR SJ SZ SE CH SY TW TJ TZ TH TL TG TK TO TT TN TR TM TC TV UG UA AE GB US UM UY UZ VU VE VN VG VI WF EH YE ZM ZW
示例
<TvEpisode>
  ...
  <ReleaseInfo>
    <ReleaseDate>2002-02-20</ReleaseDate>
    <ReleaseCountry>BT</ReleaseCountry>
  </ReleaseInfo>
  ...
</TvEpisode>
↑ 返回顶部
ReleaseDate - 已弃用

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
内容模型 simpleType(无子元素)
子元素
数据类型 dateTime
示例
<TvShow>
  ...
  <ReleaseDate>2012-05-13T00:00:00</ReleaseDate>
</TvShow>
↑ 返回顶部
ReleaseDate - 版本信息

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

property属性 详细信息
使用 可选
允许数量 1
父元素 ReleaseInfo
内容模型 simpleType(无子元素)
子元素
数据类型 dateTime
示例
<TvShow>
  ...
  <ReleaseInfo>
    <ReleaseDate>2012-05-13</ReleaseDate>
  </ReleaseInfo>
</TvShow>
↑ 返回顶部
ReleaseInfo

其中包含的元素指定了发行作品的国家/地区或区域以及发行日期。

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 complexType - 序列。请务必按指定顺序添加必填子元素。
子元素 ReleaseDate(必填,选择一个)
ReleaseCountry(选填,选择一个)
attribute属性
示例
<TvEpisode>
  ...
  <ReleaseInfo>
    <ReleaseDate>2002-02-20</ReleaseDate>
    <ReleaseCountry>BT</ReleaseCountry>
  </ReleaseInfo>
  ...
</TvEpisode>
↑ 返回顶部
RentalOffer

一次性付清作品费用后,即可在规定时间内随时查看。如有必要,您可以在Offers下添加多个RentalOffer元素。RentalOffer是两种服务类型之一。重要须知: RentalOffer元素虽然是选填的,但在Offers下至少要添加一种服务类型。(请注意,Fire TV目前不会处理显示屏上的RentalOffer信息。)

property属性 详细信息
使用 必需
允许数量 1
父元素 Offers
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。
子元素 Regions(必填,无限制)
LaunchDetails(选填,无限制)
WindowStart(选填,选择一个)
WindowEnd(选填,选择一个)
Price(必填,选择一个)
Duration(必填,选择一个)
attribute属性
示例
<RentalOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
  <Price currency="USD">1.99</Price>
  <Duration>120</Duration>
</RentalOffer>
↑ 返回顶部
RuntimeMinutes - 已弃用

按分钟计算的总运行时间。此值为小于2880的非负数,但也可能出现以合法方式超过此值的情况。每部作品只能有一个RuntimeMinutes元素。

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 int
示例
<TvEpisode>
  ...
  <RuntimeMinutes>37</RuntimeMinutes>
  ...
</TvEpisode>
↑ 返回顶部
ShortDescription - 已弃用

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

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 string(本地化)
示例
<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan带我们看了一些树,又唱了一些相关的歌曲。</ShortDescription>
  ...
</TvSpecial>
↑ 返回顶部
Source

作品的来源。每部作品只能有一个Source。选项如下:
  • original: 目录提供方制作或创作了此内容。
  • licensed: 目录提供方已从另一方处获得作品许可。
  • unknown: 此内容的来源未知。
  • other: 作品来源已知,但既非原创也未获得许可。

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 枚举:originallicensedunknownother
示例
<TvEpisode>
  ...
  <Source>licensed</Source>
  ...
</TvEpisode>
↑ 返回顶部
Synopsis - 已弃用

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

property属性 详细信息
使用 可选
允许数量 1
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 string(本地化)
示例
<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan带我们看了一些树,又唱了一些相关的歌曲。</ShortDescription>
  <Synopsis locale="en-US">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>
  ...
</TvSpecial>
↑ 返回顶部
Title - 已弃用

作品标题。为提供本地化标题,每部作品均可添加多个Title元素。补充: CDF 1.0

property属性 详细信息
使用 必需
允许数量 无限制
父元素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
内容模型 simpleType(无子元素)
子元素
数据类型 string(本地化)
示例
<TvShow>
  <ID>TV123456</ID>
  <Title locale="en-US">Office Factor</Title>
  ...
</TvShow>
↑ 返回顶部
TvSpecial

电视直播事件不属于传统的播放结构,即节目-季-剧集。这些事件可以是节日特辑等一次性活动,也可以说明每集都是按唯一播出日期而非剧集编号播出的(如新闻节目)。TvSpecial可以关联至TvShow(虽然不是TvSeason),也可以作为单独的事件。其他的颁奖节目、电视音乐会和回顾展也可作为示例。

property属性 详细信息
使用 可选
允许数量 无限制
父元素 Works
内容模型 complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowIDShowTitle,但不能同时选择两者。
子元素 ID(必填,选择一个)
ExternalID(选填,无限制)
Title(必填,无限制)
Copyright(选填,选择一个)
Offers(选填,选择一个)
ReleaseYear(选填,选择一个)
ShortDescription(选填,无限制)
Synopsis(选填,无限制)
MetadataAvailabilityDate(选填,选择一个)
Images(必填,选择一个)
RuntimeMinutes(选填,选择一个)
color(选填,选择一个)
Credits(选填,选择一个)
Studios(选填,选择一个)
Languages(选填,选择一个)
CustomerRating(选填,选择一个)
Rank(选填,选择一个)
Source(选填,选择一个)
Genres(选填,选择一个)
ContentRatings(选填,选择一个)
JP_Require18PlusAgeConfirmation(选填,选择一个)
ShowID(选填,选择一个)
ShowTitle(选填,选择一个)
OriginalAirDate(必填,选择一个)
attribute属性
示例
<TvSpecial>
  <ID>SP-2329880</ID>
  <Title locale="en-US">Cheese -- Friend or Enemy?</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <OriginalAirDate>2005-04-29T20:00:00</OriginalAirDate>
</TvSpecial>
↑ 返回顶部

Last updated: 2024年2月23日