Works元素
注意: 单击示意图中的链接后,此元素会滚动到图下方的焦点。
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: 2023年12月18日