TvEpisode元素
注意: 单击示意图中的链接后,此元素会滚动到图下方的焦点。
├── Partner └── Works ├── Movie ├── TvEpisode │ ├── 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 │ ├── Studio │ │ └── Studio │ ├── Language │ ├── CustomerRating │ │ ├── Score │ │ ├── MaxValue │ │ └── Count │ ├── Rank │ ├── IsOriginals │ │ └── IsOriginal │ ├── Genres │ │ └── Genre │ ├── ContentRatings │ │ └── ContentRating │ │ ├── System │ │ └── Certification │ ├── ShowID │ ├── ShowTitle │ ├── SeasonID │ ├── SeasonInShow │ ├── SeasonTitle │ ├── EpisodeInSeason │ └── OriginalAirDates │ │ └── OriginalAirDate ├── TvSeason ├── TvShow └── Extra
<?xml version="1.0" encoding="utf-8" ?> <Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.11"> <!--此亚马逊Fire TV目录示例显示了 如何使用TvEpisode作品类型。这些示例使用了不同标记,涵盖范围从 最少必填信息到全部选填元素。最后 示例中包含了选填元素和 必填元素。--> <! 请注意,所有作品类型中的 大部分元素都是一样的,只有最后1 - 3个元素会因类型而异。这里 适用的大部分内容也适用于其他作品类型。--> <Partner>Everything Ever Made Filmworks</Partner> <Works> <! 此实例为有效条目 提供最少信息。虽然有效,但用户难以通过 搜索或浏览找到此作品。您能提供的元数据 越多越好。--> <TvEpisode> <ID>TVE2329880</ID> <Title locale="en-US">What's in a Name?</Title> <Offers> <SubscriptionOffer> <Quality>SD</Quality> <Regions> <Country>US</Country> <Country>GB</Country> </Regions> <WindowStart>2003-08-08T17:18:37-07:00</WindowStart> <Windowend>2014-06-09T08:15:04-07:00</WindowEnd> </SubscriptionOffer> </Offers> <ShowID>ABC-123457</ShowID> <SeasonInShow>5</SeasonInShow> <EpisodeInSeason>5</EpisodeInSeason> </TvEpisode> <! 此条目添加了一些可选信息, 让作品更易于搜索。例如,您可以通过搜索节目名称或明星姓名 来查找作品。此外,用户找到作品后, 即可阅读更多相关信息。--> <TvEpisode> <ID>TVE234567</ID> <!--选填--> <ExternalID scheme="imdb">tt0000000</ExternalID> <Title locale="en-US">Go for the Moon</Title> <Offers> <SubscriptionOffer> <Regions> <Country>US</Country> <Country>FR</Country> <Country>BE</Country> </Regions> <!--选填--> <LaunchDetails> <Quality>SD</Quality> </LaunchDetails> </SubscriptionOffer> </Offers> <!--选填--> <ShortDescription locale="en-US">Lily goes onto a TV game show and must answer questions in her ideal category - cooking!.</ShortDescription> <!--选填--> <RuntimeMinutes>30</RuntimeMinutes> <!--选填--> <Credits> <CastMember> <Name locale="en-US">Alan Smithee</Name> <ExternalID scheme="imdb">nm0000000</ExternalID> <Role locale="en-US">Lily</Role> </CastMember> </Credits> <ShowID>ABC-123457</ShowID> <SeasonInShow>6</SeasonInShow> <EpisodeInSeason>3</EpisodeInSeason> <!--选填--> <OriginalAirDate>2013-05-13T00:00:00</OriginalAirDate> </TvEpisode> <! 此条目提供所有可能 信息。亚马逊添加的备注旨在说明每个元素是必填的 还是选填的,并说明特定条目的有效值和一些用法 说明。--> <TvEpisode> <!--必填项。ID长度至少要有一个字符,并且在目录中具有唯一性。--> <ID>TVE123456</ID> <! 可选允许添加多个实例。如果 存在,则必须填写scheme属性(可接受值包括imdb、tms、isan、 ean和upc)。--> <ExternalID scheme="imdb">tt4795354</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> <! 必填(且必须填写locale 属性)。允许添加多个实例,但每个区域只能有一个实例。 --> <Title locale="en-US">Undercover Pigeon</Title> <! 可选只有一个实例。如果存在, 则必须填写locale属性。--> <Copyright locale="en-US">© 2015 Amazon Studios</Copyright> <!--必填项。只有一个实例。--> <Offers> <! 有2种服务类型可供选择: FreeOffer或SubscriptionOffer。--> <!--必须包含至少1种服务。--> <SubscriptionOffer> <!--必填项。只有一个实例。--> <Regions> <!--至少填写一个Country。--> <Country>US</Country> <Country>CA</Country> </Regions> <!--可选。只有一个实例。--> <WindowStart>2015-07-02T12:00:00</WindowStart> <!--可选。只有一个实例。--> <WindowEnd>2020-07-02T12:00:00</WindowEnd> <!--可选。允许为不同LaunchId 添加多个实例。--> <LaunchDetails> <! 可选可接受值包括SD、HD 和UHD。允许为不同质量级别添加多个实例。 --> <Quality>HD</Quality> <!--可选。允许为不同音频语言 添加多个实例。--> <AudioLanguage>en-US</AudioLanguage> <!--可选。允许为不同字幕语言 添加多个实例。--> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <!--可选。每个LaunchDetails元素下 只能有一个LaunchId--> <LaunchId>TVE123456_SD_en</LaunchId> </LaunchDetails> <LaunchDetails> <Quality>SD</Quality> <AudioLanguage>en-US</AudioLanguage> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <LaunchId>TVE123456_SD_en_es</LaunchId> </LaunchDetails> </SubscriptionOffer> <FreeOffer> <!--必填项。只有一个实例。--> <Regions> <!--至少填写一个Country。--> <Country>AS</Country> <Country>GU</Country> <Country>MP</Country> <Country>UM</Country> </Regions> <!--可选。只有一个实例。--> <WindowStart>2015-07-02T12:00:00</WindowStart> <!--可选。只有一个实例。--> <WindowEnd>2020-07-02T12:00:00</WindowEnd> <!--可选。允许为不同LaunchId添加多个实例。--> <LaunchDetails> <! 可选可接受值包括SD、HD 和UHD。允许为不同质量级别添加多个实例。 --> <Quality>SD</Quality> <!--可选。允许多个实例使用不同音频语言。--> <AudioLanguage>en-US</AudioLanguage> <!--可选。允许为不同字幕语言 添加多个实例。--> <Subtitle>fr</Subtitle> <!--可选。允许为不同字幕语言 添加多个实例。--> <Subtitle>es</Subtitle> <!--可选。允许为不同字幕语言 添加多个实例。--> <Subtitle>ja</Subtitle> <!--可选。每个LaunchDetails元素下 只能有一个LaunchId--> <LaunchId>TVE123456_SD_en</LaunchId> </LaunchDetails> <LaunchDetails> <Quality>SD</Quality> <AudioLanguage>en-US</AudioLanguage> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <LaunchId>TVE123456_SD_en_es</LaunchId> </LaunchDetails> </FreeOffer> </Offers> <! 选填,但强烈建议填写。只有一个实例。如果存在,则应 与ReleaseDate元素中的年份匹配。此元素虽然可以选填,但亚马逊还是建议您 添加此元素。此值可将本作品与其他提供方的相同作品进行匹配, 以便将所有服务都呈现在一条搜索结果中。 --> <ReleaseYear>2015</ReleaseYear> <! 可选如果存在,则必须填写locale属性。允许添加多个实例, 但每个区域只能有一个实例。 --> <ShortDescription locale="en-US">Nick meets a girl named Charlie who shares his love of science.Pidgely is on a mission to deliver a message, but he has to get resourceful.</ShortDescription> <! 可选如果存在,则必须填写locale属性。允许添加多个实例, 但每个区域只能有一个实例。 --> <Synopsis locale="en-US">It's the first day of school and Nick is nervous about making new friends.Luckily he meets a girl named Charlie who shares his love of science.Meanwhile, Pidgely is on his first "Harrier Pigeon" mission to deliver a message to Nick and Shania, but when he misses the designated time to meet up with them, he has to get resourceful.</Synopsis> <! 可选只有一个实例。添加此元素的条目数量 至少要达到50%,且其指示的图像必须为 有效图像。请为连续剧的每一集使用不同的图片。 --> <Images> <Image> <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url> </Image> </Images> <! 可选只有一个实例。此值应 不大于2880,以免引入报告中出现警告。--> <RuntimeMinutes>24</RuntimeMinutes> <! 可选只有一个实例。可接受 值包括color和black_and_white。--> <Color>color</Color> <! 可选只有一个实例。必须包含 至少一名演员或职员。--> <Credits> <! 如果存在至少一个CrewMember元素, 即为选填项,否则为必填项。允许添加多个实例。 --> <CastMember> <!--必填,且必须填写locale 属性。允许添加多个实例。--> <Name locale="en-US">Addison Holley</Name> <! 可选允许添加多个实例。 如果存在,则必须填写scheme属性(可接受值包括imdb、tms、 isan、ean和upc)。--> <ExternalID scheme="imdb">nm3204147</ExternalID> <! 必填,且必须填写locale 属性。允许添加多个实例。--> <Role locale="en-US">Anne</Role> </CastMember> <CastMember> <Name locale="en-US">Jadiel Dowlin</Name> <ExternalID scheme="imdb">nm6636855</ExternalID> <Role locale="en-US">Nick</Role> </CastMember> <! 如果存在至少一个CastMember元素, 即为选填项,否则为必填项。允许添加多个实例。--> <CrewMember> <! 必填,且必须填写locale属性。 允许添加多个实例。--> <Name locale="en-US">J.J.Johnson</Name> <! 可选允许添加多个实例。 如果存在,则必须填写scheme属性(可接受值包括imdb、tms、 isan、ean和upc)。--> <ExternalID scheme="imdb">nm1664945</ExternalID> <! 必填,且必须填写locale属性。允许添加多个实例。 --> <Job locale="en-US">Writer</Job> <Job locale="en-US">Director</Job> </CrewMember> </Credits> <!--可选。只有一个实例。 --> <Studios> <! 如果存在,则Studios必须包含 至少一个Studio。允许添加多个实例。--> <Studio>Amazon Studios</Studio> <Studio>Sinking Ship Entertainment</Studio> </Studios> <!--可选。只有一个实例。--> <Language>en</Language> <!--可选。只有一个实例。--> <CustomerRating> <!--必填项。只有一个实例。--> <Score>7.3</Score> <!--必填项。只有一个实例。--> <MaxValue>10</MaxValue> <!--可选。只有一个实例。--> <Count>135</Count> </CustomerRating> <!--可选。只有一个实例。1表示最高名次。--> <Rank>4</Rank> <!--可选。只有一个实例。可接受 值包括初始值、许可值、未知值和其他值。--> <Source>original</Source> <!--可选。只有一个实例。 --> <Genres> <! 如果存在,则Genres必须包含 至少一种Genre。允许添加多个实例。必须填写locale 属性。--> <Genre locale="en-US">Family</Genre> </Genres> <!--可选。只有一个实例。--> <ContentRatings> <!--如果存在,则此元素必须 包含至少一个ContentRating。允许添加多个 实例。--> <ContentRating> <!--必填项。只有一个实例。--> <System>TV Parental Guidelines</System> <!--必填项。只有一个实例。--> <Certification>TV-G</Certification> </ContentRating> </ContentRatings> <!--可选。只有一个实例。仅适用于日本地区。--> <JP_Require18PlusAgeConfirmation>false</JP_Require18PlusAgeConfirmation> <!--如果缺失ShowTitle,则为必填项。 只有一个实例。此标签可链接此剧集到指定节目。 必须存在ShowID或ShowTitle。带有此ID的节目必须 处于同一目录,否则使用ShowTitle。--> <ShowID>TV098765</ShowID> <!--如果缺失SeasonInShow, 则为必填项。只有一个实例。此标签可链接此剧集 到指定季。必须存在SeasonID或SeasonInShow。此 ID的播出季必须处于同一目录,否则使用 SeasonInShow。--> <<SeasonID>TVS123457</SeasonID> <!--可选。只有一个实例。无需 匹配TvSeason.Title值,但如有此值, 则应匹配。--> <SeasonTitle locale="en-US">Season 2</SeasonTitle> <!--必填项。只有一个实例。--> <EpisodeInSeason>2</EpisodeInSeason> <!--可选。只有一个实例。此年份 应匹配ReleaseYear中的值(如有)。 --> <OriginalAirDate>2015-07-02T00:00:00</OriginalAirDate> </TvEpisode> </Works> </Catalog>
CDF文件的根元素。每个目录文件都必须添加一项Catalog
元素,其中包含文件的剩余内容。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 | 无 |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (必填,选择一个) |
attribute属性 |
数据类型: 枚举 枚举值: |
标识贵公司为此目录的提供方。无格式要求,但应人类可读。使用在亚马逊应用商店中所用的应用名称是不错的方法。您也可以使用提供方的全名。每个目录文件都必须包含一个Partner元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Catalog |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | string |
其中包含目录中的所有单独条目:电影、电视节目、季、特辑、迷你剧、剧集和花絮。每个目录文件中都必须有一个Works
元素。Works
元素可以根据需要添加任意数量的作品条目,或者为每种类型添加此类条目。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Catalog |
内容模型 | contentType - 序列和选择。您可以为Works 元素添加任意子元素,此元素会按照您想要的顺序多次出现。
|
子元素 | (选填,无限制) (选填,无限制) (选填,无限制) (选填,无限制) (选填,无限制) |
attribute属性 | 无 |
可以表示长篇电影,也可以表示短篇电影。此作品可以在院线上映,也可以作为电视电影。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Works |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (选填,无限制) (必填,无限制) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) |
attribute属性 | 无 |
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Works |
内容模型 | complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowID 或ShowTitle ,但不能同时选择两者。也可以添加SeasonID 或SeasonInShow ,但不能同时选择两者。
|
子元素 | (必填,选择一个) (选填,无限制) (必填,无限制) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (必填,选择一个) (必填,选择一个) (必填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) |
attribute属性 | 无 |
TvSeason
是指TvShow
中的一季,是一种基本作品类型。当TvEpisode
的SeasonID
值与TvSeason
的ID
值相同时,该剧集即为本季内容。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Works |
内容模型 | complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加ShowID 或ShowTitle ,但不能同时选择两者。
|
子元素 | (必填,选择一个) (选填,无限制) (必填,无限制) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (必填,选择一个) (必填,选择一个) |
attribute属性 | 无 |
由季和剧集组成的电视连续剧。当TvSeason
或TvEpisode
的ShowID
值与TvShow
的ID值相同时,本季或剧集即为本节目内容。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Works |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (选填,无限制) (必填,无限制) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) |
attribute属性 | 无 |
独立作品的片段,或通常与(目录上或目录外的)其他作品有关。通常将上述内容视为DVD中的花絮。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Works |
内容模型 | complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。可以添加RelatesToID 或RelatesToExternalID ,但不能同时选择两者。
|
子元素 | (必填,选择一个) (选填,无限制) (必填,无限制) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (选填,选择一个) (必填,选择一个) (必填,无限制) (必填,无限制) |
attribute属性 | 无 |
作品的标识符字符串。此值的长度必须至少有一个字符,并且在您目录的所有其他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 |
外部分类下的作品标识符,如IMDb。此值用于匹配内容,与另一个目录对比作品或人物,确定其是否同属一个作品或人物。还可以作为图像等外部内容的来源。所有包含ExternalID
的元素都可以根据需要添加任意数量的此条目。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
CastMember CrewMember Extra Movie TvEpisode TvSeason TvShow |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: 枚举 枚举值:
数据类型:string |
其中包含作品标题。每部作品都有一个Titles
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | (必填,无限制) |
数据类型 | string(本地化) |
作品标题。为提供本地化标题,每部作品均可添加多个Title
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Titles |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryStringType - 与string相同,但添加了locale 、pronunciation 和territories 属性。 |
作品版权声明。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
其中包含观众可用于欣赏给定作品的服务,如免费、订阅、租赁或购买。每种作品类型只能包含一个Offers
元素,而且此Offers
元素必须包含至少一种服务类型。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 选择。必须从两个子元素中选择一个,但不能两个都选。 |
子元素 | (必填,选择一个) (必填,选择一个) |
attribute属性 | 无 |
订阅了提供方服务的用户可以观看此作品。如有必要,您可以在Offers
下添加多个SubscriptionOffer
元素。SubscriptionOffer
是两种服务类型之一。重要须知: SubscriptionOffer
元素虽然是选填的,但在Offers下至少要添加一种服务类型。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Offers |
内容模型 | complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) (选填,无限制) (选填,选择一个) (选填,选择一个) |
attribute属性 | 无 |
其中包含可以使用给定服务的国家/地区。每种服务类型只能包含一个Regions
元素。
⚠重要须知! 自2021年8月31日起,此字段中的“US”一词将不再涵盖美国领地。要为这些地区提供服务,请明确添加区域。有关实施流程,请参阅以下示例。
以下美国领地代码可供参考:
美属维尔京群岛=VI、关岛=GU、波多黎各=PR、马里亚纳群岛=MP。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
SubscriptionOffer FreeOffer |
内容模型 | complexType - 选择。必须从两个子元素中选择一个,但不能两个都选。 |
子元素 | (必填,选择一个) |
attribute属性 | 无 |
可用使用特定服务的国家、区域和地区,用逗号分隔。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Regions |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
作品在特定服务下开始可用的日期和时间。您可以使用WindowStart
和WindowEnd
,宣布某项服务仅在特定时间窗口内可用。观众无法在此窗口前后使用服务。观众不会看到暂无可用服务的作品。每项服务只能有一个WindowStart。
您可以结合使用WindowStart
与WindowEnd
,也可以单独使用,以控制某项服务下的作品可用性。
- 仅使用
WindowStart
: 从那时起,除非将其从目录中删除,否则该作品将无限期可用。 - 仅使用
WindowEnd
: 在此期间,可以随时观看作品,直至达到指定时间。 - 结合使用
WindowStart
和WindowsEnd
: 只能在这一时间窗口内观看作品。 WindowStart
和WindowEnd
都不使用: 作品将立即可用并一直生效,直至目录将其删除。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
SubscriptionOffer FreeOffer |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | dateTime |
在此日期和时间后,特定服务下的作品将不再可用。每项服务只能有一个WindowEnd
。您可以使用WindowStart
和WindowEnd
,宣布某项服务仅在特定时间窗口内可用。当WindowEnd
指定时间结束后,此服务将不再开放。观众不会看到所有服务均已过期的作品。
您可以结合使用WindowStart
与WindowEnd
,也可以单独使用,以控制某项服务下的作品可用性。
- 仅使用
WindowStart
: 从那时起,除非将其从目录中删除,否则该作品将无限期可用。 - 仅使用
WindowEnd
: 在此期间,可以随时观看作品,直至达到指定时间。 - 结合使用
WindowStart
和WindowsEnd
: 只能在这一时间窗口内观看作品。 WindowStart
和WindowEnd
都不使用: 作品将立即可用并一直生效,直至目录将其删除。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
SubscriptionOffer FreeOffer |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | dateTime |
其中包含的元素可指定作品在特定服务下可用的视频质量、音频语言和字幕选项。LaunchDetails
中还有一个选填元素LaunchId
,让您能以特定的质量、语言和字幕配置直接发行作品。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
SubscriptionOffer FreeOffer |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (选填,无限制) (选填,无限制) (选填,无限制) (选填,无限制) |
attribute属性 | 无 |
作品画质:标准清晰度 (SD
)、高清晰度 (HD
) 和超高清晰度 (UHD
)。一部作品可以提供多种画质选项。
Quality
有两种元素。第一种是各类服务的直接子项,自CDF 1.2版本起已弃用。第二种是LaunchDetails
的子项,也是各类服务的孙项。除父元素外,两者在形式和内容上都是一模一样的,但我们还是讨论第二种版本较新且仍在使用的Quality
元素。property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
LaunchDetails |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | 枚举: SD , HD , UHD |
一种音频选项,适用于配音成其他语言的作品。您可以根据需要添加任意数量的AudioLanguage
元素,为作品指定可用的替代方案。AudioLanguage
虽然是选填项,但亚马逊强烈建议您将其用于配音内容。AudioLanguage
确保内容显示正确的字幕语言。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
LaunchDetails |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | language |
作品字幕的语言选项。一部作品支持多种字幕选项。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
LaunchDetails |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | language |
一种标识符,让您能够使用特定的视频质量、音频语言和字幕(或是这三者的任意子集)配置发行作品。LaunchId
没有给定格式 - 只有应用程序逻辑理解能够此格式即可。每种LaunchDetails
元素都只能包含一个LaunchId
。要指定多个LaunchId
,请务必添加多个LaunchDetails
元素。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
LaunchDetails |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | token |
property属性 | 详细信息 |
---|---|
使用 | |
允许数量 | |
父元素 | |
内容模型 | |
子元素 | |
attribute属性 | |
数据类型 |
您可以随时免费查看作品,也可以只在给定窗口免费观看。如有必要,您可以在Offers
下添加多个FreeOffer
元素。重要须知: FreeOffer
元素虽然是选填的,但在Offers
下至少要添加一种服务类型。FreeOffer
是两种服务类型之一。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Offers |
内容模型 | complexType - 提供部分选项的序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) (选填,无限制) (选填,选择一个) (选填,选择一个) |
attribute属性 | 无 |
其中包含将作品标识为仅供成人观看。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
将作品标识为仅供成人观看。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
IsAdultProducts |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryBooleanType - 与boolean相同,但添加了territories 属性。 |
选填,但强烈建议填写。作品最初公开发行的年份,如果是电视节目,则为首播日期。请注意,此值应该与同一部作品的ReleaseDate
或OriginalAirDate
元素中的给定年份匹配。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | int |
用两三行文字描述不同区域和地区的作品内容。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
其中用两三行文字描述了作品内容。请勿为ShortDescription
使用其他来源的信息,如作品标题。每部作品都能添加多个ShortDescription
元素,以提供本地化描述。要提供更长、更详细的描述,则使用Synopsis
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
ShortDescriptions |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryStringType - 与string相同,但添加了locale 、pronunciation 和territories 属性。 |
其中包含完整的内容描述,因区域和地区而异。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
作品内容描述。Synopsis
旨在提供比ShortDescription
更多的详细信息。请勿使用ShortDescription
或作品Title
作为Synopsis
。为提供本地化描述,每部作品均可包含多个Synopsis
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Synopses |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | TerritoryStringType - 与string相同,但添加了locale 、pronunciation 和territories 属性。 |
包含因地区而异的MetadataAvailabilityDate。假定所有缺少地区值的字段均适用于全球范围。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) |
attribute属性 | 无 |
在此日期之后,应该向观众公开元数据信息。包含此信息可改善匹配度。请注意,MetadataAvailabilityDate
和WindowStart
是一样的,但MetadataAvailabilityDate
不仅隐藏了“播放”按钮,还隐藏了与内容相关的元数据,直到指定日期结束才会公开。结合使用MetadataAvailabilityDate
与WindowStart
,即可保密信息直到首映(如《高堡奇人》首映)。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
MetadataAvailabilityDates |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryDateTimeType - 与dateTime相同,但添加了territories 属性。 |
表示电视或电影内容的图像。有关图像尺寸的详细信息,请参阅Image
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
表示电视或电影内容的图像。应采用JPG或PNG格式(首选JPG)。宽高比为16:9,电视节目/季/剧集的宽高尺寸至少为853 x 480像素。尺寸越大越好(最优宽高为1920 x 1080像素),亚马逊将根据需要缩放图像。亚马逊不会使用宽高尺寸小于853 x 480像素或遵循其他宽高比的图像。在这种情况下,将改用其他图像源(如IMDb)或占位符图像。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Images |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (选填,无限制) |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
图像URL。有关图像大小和尺寸的详细信息,请参阅Image
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Image |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | anyURI |
适用于图像的语言。有关图像大小和尺寸的详细信息,请参阅Image
。
locale
元素可确保内容能够匹配到合适的语言和区域。property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Image |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | language |
其中包含内容的总运行时间,因区域和地区而异。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
按分钟计算的总运行时间。此值为小于2880的非负数,但也可能出现以合法方式超过此值的情况。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Runtimes |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryInteger - 与int相同,但添加了territories 属性。 |
指定电影为彩色电影还是黑白电影。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | 枚举:color 、black_and_white |
其中包含的元素可表示作品的演职人员。同一个人可以作为演员或职员多次出现。每个作品只能有一个Credits
元素。如果出现此元素,Credits
元素可以根据需要添加任意数量的CastMember
或CrewMember
,但必须至少添加一个。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 选择。必须从两个子元素中选择一个,但不能两个都选。 |
子元素 | (必填,选择一个) (必填,选择一个) |
attribute属性 | 无 |
提供有关作品演员阵容的信息,如演员、主持人、旁白人或配音演员。当出现此元素时,选填元素Credits
中必须包含至少一个条目,可以是CastMember
,也可以是CrewMember
。您可以根据需要添加任意数量的CastMember
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Credits |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) (选填,无限制) (选填,无限制) |
attribute属性 | 无 |
与作品有关。作品演员或职员的姓名。对于演职人员,此名称应该是演员的真名,而不是人物的名字。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
CastMember CrewMember |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
外部分类下的作品标识符,如IMDb。此值用于匹配内容,与另一个目录对比作品或人物,确定其是否同属一个作品或人物。还可以作为图像等外部内容的来源。所有包含ExternalID
的元素都可以根据需要添加任意数量的此条目。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
CastMember CrewMember Extra Movie TvEpisode TvSeason TvShow |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: 枚举 枚举值:
数据类型:string |
作品的人物姓名,由CastMember
饰演。例如罗宾汉、兰斯洛特·杜拉克爵士、雅典娜或塞尔夫。请勿使用“actor”(演员)(所有CastMember
条目均为演员)或“unknown”(未知)作为此值。如果一人饰演多个角色,则CastMember
元素可包含多个Role
元素。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
CastMember |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:string
数据类型:language |
数据类型 | string(本地化) |
其中包含的元素可提供有关作品银幕外摄制组人员的信息,如导演、编剧、摄影师、灯光师、动画师或机械组。当出现此元素时,选填元素Credits
中必须包含至少一个CastMember
或CrewMember
条目。您可以根据需要添加任意数量的CrewMember
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Credits |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) (选填,无限制) (必填,无限制) |
attribute属性 | 无 |
由作品的CrewMember
担任的职位,如导演、电影摄影师、编剧或动画师。CrewMember
可以根据需要添加任意数量的Job
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
CrewMember |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
包含一个或多个Stydui
元素,可识别制片厂。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (选填,无限制) |
attribute属性 | 无 |
制作这部作品的工作室。一部作品可以有多个Studio
条目。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Studios |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | string |
最初制作作品时使用的语言,可以指音频。对于无声作品,也可以指屏幕文本。每部作品只能包含一个Language
元素。还可以使用AudioLanguage
,指定任意配音选项。您可以在未选择语言的情况下提交目录,但是亚马逊强烈建议您您遵循最佳实践添加内容语言,尤其是当内容支持多种语言时。您需要为每个内容版本指定语言,确保亚马逊为内容匹配正确的语言。
如需为多个区域提供不同语言版本,则需要提供经过对应语言本地化处理的内容。例如,要在日本发行英语电影,则需要提供对应的日语版本。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | language |
其中包含的元素会提供作品的平均客户评分、最高评分和评分人数。每个作品只能有一个CustomerRating
元素。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (必填,选择一个) (选填,选择一个) |
子元素备注 | Count 仅适用于CDF v1.2和更高版本。 |
attribute属性 | 无 |
基于客户反馈为作品打出的平均分数(评分)。您可以自行决定信息收集方式,并设置MaxValue
,为评分系统限定范围。您可以添加一个选填元素Count
,计算为评分投出的票数。每个CustomerRating
只能添加一个评分
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
CustomerRating |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | decimal(正值) |
客户可对作品打出的最高评分。每个CustomerRating
只能有一个MaxValue
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | decimal(正值) |
进行客户评Score
的用户数量。每个CustomerRating
只能有一个Count
。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
CustomerRating |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | 非负long整数 |
相对于目录中的其他商品而言,这是一种人气分。经过定义,1表示最高名次。您可以自行决定排行方式,多种商品也能排在同一名次。每部作品只能有一个Rank
元素。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | int |
检查商品是否由提供方原创。内容原创性可能因国家和地区而异。例如,全球各国均使用Prime Video制作电影,日本和加拿大除外。您可以使用此元素,指明原创性与全球设置不同的地区。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
描述商品是否由提供方原创。内容原创性可能因国家和地区而异。例如,全球各国均使用Prime Video制作电影,日本和加拿大除外。您可以使用此元素,指明原创性与全球设置不同的地区。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
IsOriginals |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryBooleanType - 与boolean相同,但添加了territories 属性。 |
其中包含一个或多个描述作品类别的Genre
标签,如喜剧片、恐怖片或纪录片。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
作品题材,如喜剧片、恐怖片、剧情片或纪录片。如有必要,一部作品可以添加多个Genre
元素。为优化搜索和匹配结果,请尽量使用标准题材描述。使用多个Genre
标签,而不是将多个描述融合为一个字符串。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Movie |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
其中包含指定认证机构对作品打出的一项或多项官方评分。每部作品只能有一个ContentRatings
元素。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow TvSeason TvEpisode Extra |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
其中包含指定了评分系统或组织以及作品评分的元素。当出现此元素时,选填元素ContentRatings
中必须包含至少一个ContentRating
。您可以根据需要为每一对系统/评分添加任意数量的ContentRating
元素。
以下国家/地区必须具有ContentRatings
: 美国、巴西、澳大利亚、日本。亚马逊强烈建议其他所有国家/地区都添加ContentRatings
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
ContentRatings |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,选择一个) (必填,选择一个) |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
评分系统,往往是官方组织,负责为作品打分。每次评分只能有一个System
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
ContentRating |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | string |
根据指定认证System
向作品授予的认证或评分。每个ContentRating
只能有一个Certification
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
ContentRating |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | string |
用于将TvEpisode
或TvSeason
与目录中的TvShow
关联起来。此值必须与TvShow
元素中的ID值匹配。您可以使用ShowID
或ShowTitle
来指定节目,但不能同时选择两者。当目录中出现TvShow
时,应始终使用ShowID
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvSeason TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | token |
用于将TvEpisode
或TvSeason
与目录中的TvShow
关联起来。此值只是UI所用字符串,无需匹配目录中的任何标题。您可以使用ShowID
或ShowTitle
来指定节目,但不能同时选择两者。只有在缺失ShowID
时才能使用ShowTitle
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvSeason TvEpisode |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
TVEpisode
所属季的编号,该季不在您的目录中。SeasonInShow
只是UI所用编号,无需匹配任何内容。您可以使用SeasonID
或SeasonInShow
来指定本季,但不能同时选择两者。只有在缺失SeasonID
时才能使用SeasonInShow
,但这种情况很罕见。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | int |
用于将TvEpisode
或TvSeason
与目录中的TvShow
关联起来。此值必须与TvShow
元素中的ID值匹配。您可以使用ShowID
或ShowTitle
来指定节目,但不能同时选择两者。当目录中出现TvShow
时,应始终使用ShowID
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvSeason TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | token |
用于将TvEpisode
或TvSeason
与目录中的TvShow
关联起来。此值只是UI所用字符串,无需匹配目录中的任何标题。您可以使用ShowID
或ShowTitle
来指定节目,但不能同时选择两者。只有在缺失ShowID
时才能使用ShowTitle
。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvSeason TvEpisode |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
TvEpisode
是本季ID的内容。带有此ID
的TvSeason
必须作为TvEpisode
,出现在同一个目录中。您可以使用SeasonID
或SeasonInShow
来指定本季,但不能同时选择两者。当目录中出现本季时,应始终使用SeasonID
。否则,请考虑创建TvSeason
条目。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | token |
TVEpisode
所属季的编号,该季不在您的目录中。SeasonInShow
只是UI所用编号,无需匹配任何内容。您可以使用SeasonID
或SeasonInShow
来指定本季,但不能同时选择两者。只有在缺失SeasonID
时才能使用SeasonInShow
,但这种情况很罕见。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | int |
TvEpisode
出现那一季的标题,如“Season 2”(第2季)。请注意,如果目录中包含相应的TvSeason
元素,那么即使此值应与其Title
匹配,您也可以不匹配。每集TvEpisode
只能有一个SeasonTitle
。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型:language
数据类型:string |
数据类型 | string(本地化) |
电视剧集在本季中的序列号。每集TvEpisode
中只能有一个EpisodeInSeason
元素。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | int |
剧集或特辑原定进行首播的日期。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
TvEpisode |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
作品首播的日期和时间。如果出现该选填元素,则此值的年份部分应与ReleaseYear
匹配。此信息可用于匹配此作品和其他目录中的内容。匹配操作能够单列作品,显示其所有可用来源,而不会在搜索同一作品时出现多个结果。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
OriginalAirDates |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryDateTimeType - 与dateTime相同,但添加了territories 属性。 |
其中包括在不同地区的发行日期。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 1 |
父元素 |
Movie TvShow |
内容模型 | complexType - 序列。请务必按指定顺序添加必填子元素。 |
子元素 | (必填,无限制) |
attribute属性 | 无 |
作品最初公开发行的日期和时间,如果是电视节目,则为首播日期。如果出现该选填元素,则此值的年份部分应与ReleaseYear
匹配。此信息尤其适合用来匹配此作品和其他目录中的内容。匹配操作能够单列作品,显示其所有可用来源,而不会在搜索同一作品时出现多个结果。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
ReleaseDates |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: TerritoriesType - 表示地区的string。使用ISO 3166-1 alpha-2国家/地区代码值。如US、PR、VI、GB和DE。 |
数据类型 | TerritoryDateTimeType - 与dateTime相同,但添加了territories 属性。 |
指定Extra
作为片段。您可以将片段作为预告片,也可以扩充内容,作为Extra
中相关Movie
的纪录片。每个Extra
只能有一个Type
。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | 枚举:clip |
用于指定另一部作品,其与Extra
(如电影预告片)相关。带有此ID
的作品必须作为Extra
,出现在同一个目录中。您可以使用RelatesToID
或RelatesToExternalID
来指定相关作品,但不能同时选择两者。当目录中出现相关作品时,应始终使用RelatesToID
。
property属性 | 详细信息 |
---|---|
使用 | 可选 |
允许数量 | 无限制 |
父元素 |
Extra |
内容模型 | simpleType(无子元素) |
子元素 | 无 |
数据类型 | token |
用于指定另一部作品,其与Extra
(如电影预告片)相关。RelatesToExternalID
会在IMDb等外部分类中为其他作品(如电影)指定标识符。当您的目录中缺少相关作品时,可以使用RelatesToExternalID
。您可以使用RelatesToID
或RelatesToExternalID
来指定相关作品,但不能同时选择两者。只有在缺失RelatesToID
时才能使用RelatesToExternalID
。
请勿将RelatesToExternalID
与ExternalID
混淆。ExternalID
是指Extra
本身,而RelatesToExternalID
是指与之相关的作品。
property属性 | 详细信息 |
---|---|
使用 | 必需 |
允许数量 | 无限制 |
父元素 |
Extra |
内容模型 | complexType - 仅限attribute属性。不含子元素,但元素可以添加attribute属性。 |
子元素 | 无 |
attribute属性 |
数据类型: 枚举 枚举值:
数据类型:string |
数据类型 | token |
Last updated: 2024年2月23日