电视台目录

定义电视台或频道面向客户的属性和管理属性。

属性	详细信息
父元素	`DataCollections`
数据类型	StationCatalogType
子元素	描述
`Delete`	用于从目录中删除电视台的管理动词。
`Station`	包含电视台详细信息，例如名称、图像、呼号和附属信息。
`ExternalStation`	引用外部元数据系统的电视台实体，能够覆盖某些字段。
属性	描述
`id`	电视台目录的标识符。默认值为`DEFAULT_STATION_CATALOG`。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`action`	指明在提交目录时应采取哪个操作。默认值为`upsert`。有效值：`upsert`、`replace`。数据类型： CatalogActionType

<StationCatalog id="LOCAL_STA_123" 
                version="1">
    
    <!-- 本地网络分台 -->
    <Station id="STA_KIRO_HD" 
             version="1"
             name="CBS_NEWS_SEA"
             territories="US">
        <Titles>
            <Title language="en" territories="US" default="true">CBS News Seattle</Title>
        </Titles>
        <Images>
            <Image category="logo"
                   language="en"
                   aspectRatio="16:9"
                   mimeType="image/png"
                   resolution="HD"
                   version="1">
                https://images.example.com/logos/cbs_seattle.png
            </Image>
            
            <Image category="cover"
               language="en"
               aspectRatio="16:9"
               mimeType="image/jpeg"
               resolution="HD"
               version="1">
            https://images.example.com/covers/cbs_seattle_cover.jpg
        </Image>
        </Images>
        <ExternalIds>
            <ExternalId scheme="tms">TMS123456789</ExternalId>
        </ExternalIds>
        <CallSign>KIRO7</CallSign>
        <Descriptions>
            <Description language="en" territories="US">
                CBS网络分台为西雅图-塔科马地区提供当地新闻、
                天气和CBS网络节目。
            </Description>
        </Descriptions>
        <Genres>
            <Genre scheme="ember_genre">ember_genre_news_current_affairs</Genre>
        </Genres>
        <OriginalBroadcastType>Full Power Broadcast</OriginalBroadcastType>
        <AffiliatedNetworks>
            <AffiliatedNetwork>CBS</AffiliatedNetwork>
        </AffiliatedNetworks>
        <VideoResolutions>
            <VideoResolution>HD</VideoResolution>
        </VideoResolutions>
        <Ratings>
            <Rating system="TVPG" 
                   certification="TV-PG" 
                   territories="US"
                   adultProduct="false"
                   notRated="false"/>
        </Ratings>
        <AudioLanguages>
            <AudioLanguage language="en" default="true" original="true">English</AudioLanguage>
            <AudioLanguage language="es">Español</AudioLanguage>
        </AudioLanguages>
        <SubtitleLanguages>
            <SubtitleLanguage language="en" closed="true" default="true"/>
            <SubtitleLanguage language="es" closed="true"/>
        </SubtitleLanguages>
    </Station>
</StationCatalog>

↑ 返回顶部

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

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

↑返回顶部

包含电视台详细信息，例如名称、图像、呼叫信号和附属信息。有关何时使用Station元素以及何时使用ExternalStation元素的详细信息，请参阅最佳实践页面上的线性目录。

属性	详细信息
父元素	`StationCatalog`
数据类型	StationType
子元素	描述
`Titles` 必需	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Images`	`Image`元素列表。
`ExternalIds`	包含外部系统标识符。允许与第三方系统交叉引用。
`CallSign`	广播电视台的唯一标识符。
`Descriptions`	由本地化字符串表示的`Description`元素列表。
`Genres`	类型列表。
`Tags`	`Tag`元素列表。
`StationCategories`	包含电视台类别实体。
`OriginalBroadcastType`	电视台提供的广播类型。
`AffiliatedNetworks`	附属网络列表。
`VideoResolutions`	包含可用的视频分辨率选项。
`Ratings`	`Rating`元素列表。
`AudioLanguages`	包含可用的音频语言选项。
`SubtitleLanguages`	包含可用的字幕语言选项。
属性	描述
`id` 必需	电视台实体的主要标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`name` 必需	可用于操作的电视台的英文名称。数据类型：string
`territories`	以逗号分隔的地区代码列表，例如`"US,CA"`。默认值为`GLOBAL`（表示该值适用于所有地区）。数据类型： TerritoriesType

↑ 返回顶部

引用外部元数据系统的电视台实体，能够覆盖某些字段。外部电视台支持的外部ID方案是tms和gvd。有关何时使用Station元素以及何时使用ExternalStation元素的详细信息，请参阅最佳实践页面上的线性目录。

属性	详细信息
父元素	`StationCatalog`
数据类型	ExternalStationType
子元素	描述
`ExternalId` 必需	将节目或其他实体链接到外部来源。
`Titles`	`Title`元素列表。`Title`元素代表节目的标题及其适用的区域设置。
`Images`	`Image`元素列表。
属性	描述
`id` 必需	电视台实体的主要标识符。数据类型： ID
`version`	每次修订都会增加的整数。用于版本控制。默认值为`1`。数据类型：long
`name` 必需	可用于操作的电视台的英文名称。数据类型：string
`territories`	可收看电视台节目的国家/地区。以逗号分隔的地区代码列表，例如`"US,CA"`。要表示该值适用于所有地区，请使用`GLOBAL`。数据类型： TerritoriesType

↑返回顶部

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

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

↑返回顶部

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

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

↑返回顶部

Image元素列表。

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

↑返回顶部

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

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

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

↑返回顶部

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

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

↑返回顶部

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

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

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

↑ 返回顶部

广播电视台的唯一标识符。

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

↑返回顶部

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

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

↑返回顶部

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

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

↑返回顶部

类型列表。

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

↑返回顶部

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

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

↑返回顶部

Tag元素列表。

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

↑返回顶部

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

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

↑返回顶部

包含电视台类别实体。

属性	详细信息
父元素	`Station`
数据类型	StationCategoryList
子元素	描述
`StationCategory` 必需	电视台类别的枚举。

↑ 返回顶部

电视台类别的枚举。允许将内容相似的电视台组合在一起。一些电视台类别类似于节目类型。对于内容同质化的电视台，除了电视台类别外，还应使用类型。下表列出了有效类别。

名称	值	描述
儿童	`ember_category_children`	包含面向年幼观众的节目。
经典电视	`ember_category_classic_tv`	包含怀旧节目，此类节目通常已有20年以上历史。
DIY	`ember_category_diy`	爱好、手工艺和教学内容。例如，烹饪、家居装修、房地产和绘画。
教育	`ember_category_education`	纪录片、讲座、科学、旅行、历史和自然。
娱乐	`ember_category_entertainment`	具有广泛吸引力的节目。大制作的电影，以及演艺界的商业运作。
家庭	`ember_category_family`	包含适合所有年龄段的节目。
游戏节目	`ember_category_game`	包含无剧本的知识、技能或运气竞赛，有参赛者和奖品。
一般节目	`ember_category_general`	为许多观众准备的混合节目。空中下载 (OTA) 本地广播分台 (LBA) 通常属于这一类。
电影	`ember_category_movies`	通常时长较长的非连续化内容。
音乐	`ember_category_music`	仅限表演、音乐会、音乐视频、综艺节目和音频。
新闻	`ember_category_news`	地方、全国和世界新闻节目。
季节性内容	`ember_category_seasonal`	基于假日的节目。例如，情人节、阵亡将士纪念日、感恩节和排灯节。
体育	`ember_category_sports`	内容侧重于体育和体育相关话题。
电视节目	`ember_category_shows`	主要包含连续化内容。
天气	`ember_category_weather`	当地、全国和国际天气报告。

属性	详细信息
父元素	`StationCategories`
数据类型	StationCategoryType - 电视台类别值的枚举。
属性	描述
`scheme`	电视台类别的方案。数据类型：string

↑ 返回顶部

电视台提供的广播类型。有效值： TV、VOD、Radio、Full Power Broadcast、Low Power Broadcast、Cable Only、Digital Broadcast Network、Network、Satellite、Split、Over the Top。例如，Split是白天全功率广播，晚上切换为低功率广播。

属性	详细信息
父元素	`Station`
数据类型	OriginalBroadcastType

↑返回顶部

附属网络列表。

属性	详细信息
父元素	`Station`
数据类型	AffiliatedNetworkList
子元素	描述
`AffiliatedNetwork` 必需	引用此电视台的附属网络（如果有）。例如，ABC、CBS。

↑返回顶部

引用此电视台的附属网络（如果有）。例如，ABC、CBS。

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

↑返回顶部

包含可用的视频分辨率选项。

属性	详细信息
父元素	`ProgramOffer` `ProgramAiringOffer` `StationOffer` `Station`
数据类型	VideoResolutionList
子元素	描述
`VideoResolution` 必需	一种封闭枚举，表示提供的视频分辨率。有效值包括`SD`、`HD`、`FullHD`、`4K`和`8K`。

↑返回顶部

表示所提供的视频分辨率的封闭式枚举。有效值包括SD、HD、FullHD、4K和8K。

属性	详细信息
父元素	`VideoResolutions`
数据类型	ResolutionType

↑返回顶部

Rating元素列表。

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

↑返回顶部

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

特定于目录的条件：

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

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

↑返回顶部

Descriptor元素列表。

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

↑返回顶部

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

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

↑返回顶部

包含可用的音频语言选项。

属性	详细信息
父元素	`Airing` `ProgramOffer` `StationOffer` `Station`
数据类型	AudioLanguageList
子元素	描述
`AudioLanguage` 必需	节目或电视台的音频语言。

↑返回顶部

节目或电视台的音频语言。

属性	详细信息
父元素	`AudioLanguages`
数据类型	AudioLanguageType - 表示节目音频语言的string。
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`default`	表示默认音频语言。数据类型：boolean
`original`	指明这是否是内容的原始语言。对原始语言使用true，对配音内容使用false。数据类型：boolean

↑返回顶部

包含可用的字幕语言选项。

属性	详细信息
父元素	`Airing` `ProgramOffer` `StationOffer` `Station`
数据类型	SubtitleLanguageList
子元素	描述
`SubtitleLanguage` 必需	节目或电视台的字幕语言。

↑返回顶部

节目或电视台的字幕语言。

属性	详细信息
父元素	`SubtitleLanguages`
数据类型	SubtitleLanguageType - 表示节目字幕语言的string。
属性	描述
`language` 必需	包含此项目的语言数据。数据类型： LanguageType
`closed`	隐藏式字幕为True；录入字幕为false或省略。数据类型：boolean
`default`	表示`SubtitleLanguage`元素列表中的默认字幕语言。数据类型：boolean

↑返回顶部

StationCatalog

Delete

Station

ExternalStation

Titles

Title

Images

Image

ExternalIds

ExternalId

CallSign

Descriptions

描述

Genres

Genre

Tags

Tag

StationCategories

StationCategory

OriginalBroadcastType

AffiliatedNetworks

AffiliatedNetwork

VideoResolutions

VideoResolution

Ratings

Rating

Descriptors

Descriptor

AudioLanguages

AudioLanguage

SubtitleLanguages

SubtitleLanguage