開発者コンソール

CDFの全要素

CDFの全要素
AudioLanguage

複数の言語に吹き替えられた作品のオーディオオプション。AudioLanguage要素は、その作品で利用できる吹き替え版を指定するために、必要に応じていくつでも追加できます。AudioLanguageは省略可能ですが、吹き替えコンテンツではこの要素を指定することを強くお勧めします。AudioLanguageを使用すると、適切な言語の字幕がコンテンツに表示されるようになります。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 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要素は必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Credits
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Name(必須、無制限)
ExternalID(省略可能、無制限)
Role(省略可能、無制限)
属性 なし
<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要素が1つ必要で、この中にそのファイルの残りの要素が指定されます。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 なし
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Partner(必須、1つ指定可能)
Works(必須、1つ指定可能)
属性

xmlns: 必須。XML名前空間。


version: 省略可能。このカタログで使用されているCDFスキーマのバージョン。使用しているスキーマのバージョンは、スキーマの「id」を参照して確認できます。この属性は互換性の理由から省略できますが、バージョンは指定することをお勧めします。

データ型: 列挙型

列挙値: 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)の下で作品に与えられた証明(評価)。指定できるCertification要素は、ContentRatingごとに1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 ContentRating
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string
<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
<ContentRating>
↑先頭に戻る
Color

映画が主にカラーであるか白黒であるかを指定します。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 列挙型:colorblack_and_white
<Movie>
  ...
  <Color>black_and_white</Color>
  ...
</Movie>
↑先頭に戻る
ContentRating

レーティングシステム(評価機関)およびそのシステムで作品に与えられた評価を指定する要素を含んでいます。ContentRatings(省略可能)が存在する場合、ContentRatingを1つ以上指定する必要があります。ContentRating要素は必要に応じていくつでも追加できます(システム/評価の組み合わせごとに1つ)。

ContentRatingsは、 米国、ブラジル、オーストラリア、日本では必須となります。それ以外の国でも、ContentRatingsを指定することを強くお勧めします。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 ContentRatings
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 System(必須、1つ指定可能)
Certification(必須、1つ指定可能)
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 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要素は、作品ごとに1つのみ指定できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ContentRating(必須、無制限)
属性 なし
<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>
↑先頭に戻る

作品の著作権表示。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<Copyright locale="en-US">© 2014 Amazon Studios</Copyright>
↑先頭に戻る
Count

視聴者の評価スコア(Score)に寄与したユーザーの数。指定できるCountは、CustomerRatingごとに1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 CustomerRating
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 long(負数以外)
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑先頭に戻る
Credits

作品のキャストとクルーを表す要素を含んでいます。同じ人物をキャストまたはクルーとして複数回指定できます。指定できるCredits要素は各作品につき1つだけです。Creditsが存在する場合、CastMemberまたはCrewMemberが少なくとも1つ必要です。いずれの要素も必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – choice。いずれかの子要素が必要です(両方は指定できません)。
子要素 CastMember(必須、1つ指定可能)
CrewMember(必須、1つ指定可能)
属性 なし
<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>
↑先頭に戻る
CrewMember

作品の裏方のクルー(ディレクター、ライター、カメラマン、照明係第一助手、アニメーター、撮影助手など)に関する情報を表す要素を含んでいます。Credits(省略可能)が存在する場合、CastMemberまたはCrewMemberのいずれかの項目を指定する必要があります。CrewMember要素は必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Credits
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Name(必須、無制限)
ExternalID(省略可能、無制限)
Job(必須、無制限)
属性 なし
<Credits>
  <CrewMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Job locale="en-US">Director</Job>
  </CrewMember>
</Credits>
↑先頭に戻る
CustomerRating

作品に対する視聴者の評価の平均スコア、最大値、スコアに寄与した評価の数を表す要素を含んでいます。指定できるCustomerRating要素は各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Score(必須、1つ指定可能)
MaxValue(必須、1つ指定可能)
Count(省略可能、1つ指定可能)
子要素に関する注意事項 CountはCDF v1.2以降でのみ使用できます。
属性 なし
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑先頭に戻る
EpisodeInSeason

TV番組のシーズンに含まれているエピソードの連続番号。指定できるEpisodeInSeason要素は、TvEpisodeごとに1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvEpisode>
  ...
  <EpisodeInSeason>6</EpisodeInSeason>
  ...
</TvEpisode>
↑先頭に戻る
ExternalID

外部ソース(IMDbなど)の分類に基づく作品の識別子。この値は、コンテンツのマッチングに使用されます。別のカタログ内の対応する値と比較し、作品や人物が同一であるかどうかを判断します。画像など外部コンテンツのソースとしても使用できます。外部IDを格納するExternalID要素は、必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 CastMember
CrewMember
Extra
Movie
TvEpisode
TvSeason
TvShow
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

scheme: 必須。このIDの提供元となった外部ソース。

データ型: 列挙型

列挙値:

  • imdb: Internet Movie Database(IMDb)。IDは、特定のページのURLの構成要素として存在します。
  • tms: OnTVドメイン。以前のTribune Media Serviceですが、本質的には旧Gracenote ID空間の1つです。
  • isan: International Standard Audiovisual Number(ISAN)。26文字の英数字で、通常はダッシュ区切りで表示されます。
  • ean: EAN(European Article Number)はバーコード規格の1つで、12桁または13桁の商品識別コードです。各EANは、商品やメーカー、およびその属性を一意に識別します。
  • upc: UPC(Universal Product Code)は、米国の小売用パッケージに広く使用されている12桁のバーコードです。
  • asin: ASIN(Amazon Standard Identification Number)は、商品を識別するための英数字10桁で構成される一意のブロックです。
  • gvdGracenote Video DataGracenote IDはテレビ番組や映画を一意に識別するIDです。このIDにより、テレビ番組表データやオンデマンドカタログへの関連付けが可能になります。


region: 省略可能。externalIdに関連する地域(Amazon ASINSの場合はマーケットプレイス、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に収録されるボーナストラックに相当するものと考えてください。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、RelatesToIDRelatesToExternalIDは一方のみ必要で、両方は指定できません。
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Titles(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
IsAdultProducts(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescriptions(省略可能、1つ指定可能)
Synopses(省略可能、1つ指定可能)
MetadataAvailabilityDates(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
Runtimes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
IsOriginals(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
Type(必須、1つ指定可能)
RelatesToID(必須、1つ指定可能)
RelatesToExternalID(必須、無制限)
属性 なし
<Extra>
  <ID>EXTRA-11111</ID>
  ...
  <Type>clip</Type>
</Extra>
↑先頭に戻る
FreeOffer

作品をいつでも無料で視聴できます。無料で視聴できる期間を指定することもできます。必要に応じて、Offersに複数のFreeOffer要素を追加できます。重要: FreeOffer要素は省略可能ですが、Offersでは少なくとも1つの視聴方法タイプを指定する必要があります。FreeOfferは2つある視聴方法タイプのうちの1つです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Offers
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
属性 なし
<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

作品のジャンル(コメディー、ホラー、ドラマ、ドキュメンタリーなど)。必要に応じて、1つの作品に複数のGenre要素を指定できます。検索とマッチングの機能を最大限に活かすため、できる限り標準的なジャンル名を使用してください。複数の説明を組み合わせて1つの文字列にするのではなく複数のGenreタグを使用してください。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Movie
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>
↑先頭に戻る
Genres

作品のカテゴリー(コメディー、ホラー、ドキュメンタリーなど)を表す1つ以上のGenreタグを格納します。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Genre(必須、無制限)
属性 なし
<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>
↑先頭に戻る
Image

TV番組や映画のコンテンツを表す画像。画像はJPG形式またはPNG形式である必要があります(JPG推奨)。TV番組、シーズン、エピソードの場合、縦横比16:9、サイズが幅853ピクセル×高さ480ピクセル以上の画像を使用してください。できるだけ大きい画像を使用することをお勧めします(最適なサイズは幅1920ピクセル×高さ1080ピクセル)。画像は必要に応じて拡大縮小されます。幅853ピクセル×高さ480ピクセル未満の画像、または縦横比が16:9以外の画像は使用できません。そのような場合は、代わりに別の画像ソース(IMDbなど)やプレースホルダー画像が使用されます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Images
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Url(必須、1つ指定可能)
Locale(省略可能、無制限)
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

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

TV番組や映画のコンテンツを表す画像。画像サイズの詳細については、Imageを参照してください。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Image(必須、無制限)
属性 なし
<Movie>
  ...
  <Images>
    <Image>
      ...
    </Image>
  </Images>
  ...
 </Movie>
↑先頭に戻る
ID

作品の識別子となる文字列。この値は1文字以上とし、カタログに存在するすべてのIDにおいて一意である必要があります。同じIDの作品が2つ存在すると、統合システムによってカタログが却下されます。IDの決め方に方針を設け、重複を防ぐようにしてください。たとえば、パートナーID+作品タイプ+十分な長さを持った識別子(GUIDなど)をIDとして使用することが考えられます(例:AmazonStudios_ Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf)。カタログ内でIDの一意性を確保できれば、どのような方針でもかまいません。

IDを作成するときは、次の2点に注意してください。

  • 既存のカタログをアップデートする際、作品のIDは変更しないでください。カタログからIDが消えた場合、Amazonではその作品がサービス上で利用できなくなったものと判断し、Amazonのインデックスから削除します。後で作品を元に戻す場合は、以前と同じIDを使用する必要があります。統合後にIDの作成方針を変更すると、ユーザーエクスペリエンスに悪影響を及ぼす可能性があります。
  • IDで使用できる文字は、ピリオド(.)、ハイフン(-)、+、0~9、A~Z、a~zのみです。URIを使用してアプリを起動する場合は、LaunchDetailsブロック(Offersのプロパティ)の中でLaunchIDを使用してください。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 NonEmptyToken
<Movie>
  <ID>AmazonStudios_Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf</ID>
  ...
</Movie>
↑先頭に戻る
IsAdultProduct

成人向けコンテンツとして作品を識別します。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 IsAdultProducts
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryBooleanType - territories属性が追加されたboolean
<IsAdultProducts>
  <!-- 国や地域を指定しない場合、このフィールド値は全世界に適用されます。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>
↑先頭に戻る
IsAdultProducts

作品を成人向けコンテンツとして識別するための情報が含まれます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 IsAdultProduct(必須、無制限)
属性 なし
<IsAdultProducts>
  <!-- 国や地域を指定しない場合、このフィールド値は全世界に適用されます。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>
↑先頭に戻る
IsOriginal

アイテムがプロバイダーのオリジナルかどうかを表します。コンテンツのオリジナリティは国や地域によって異なります。たとえば、日本とカナダ以外では、Prime Videoオリジナルとして配信される映画などが考えられます。この要素を使用すると、全世界に適用される設定とはオリジナリティが異なる国/地域を指定できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 IsOriginals
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryBooleanType - territories属性が追加されたboolean
<IsOriginals>
  <!-- 全世界を対象にアイテムのオリジナリティを指定する場合は、territories属性なしでIsOriginal子要素を使用します。-->
  <IsOriginal>true</IsOriginal>
  <!-- 同じコンテンツが米国とカナダではプロバイダーのオリジナルでない場合は、次の要素を追加します。-->
  <IsOrignal territories="US,CA">false</IsOrignal>
</IsOriginals>
↑先頭に戻る
IsOriginals

アイテムがプロバイダーのオリジナルかどうかを指定します。コンテンツのオリジナリティは国や地域によって異なります。たとえば、日本とカナダ以外では、Prime Videoオリジナルとして配信される映画などが考えられます。この要素を使用すると、全世界に適用される設定とはオリジナリティが異なる国/地域を指定できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 IsOriginal(必須、無制限)
属性 なし
<IsOriginals>
  <!-- 全世界を対象にアイテムのオリジナリティを指定する場合は、territories属性なしでIsOriginal子要素を使用します。-->
  <IsOriginal>true</IsOriginal>
  <!-- 同じコンテンツが米国とカナダではプロバイダーのオリジナルでない場合は、次の要素を追加します。-->
  <IsOrignal territories="US,CA">false</IsOrignal>
</IsOriginals>
↑先頭に戻る
Job

作品のCrewMemberの職種(ディレクター、カメラマン、ライター、アニメーターなど)。CrewMemberには、Job要素を必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 CrewMember
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<CrewMember>
  <Name locale="en-US">Alan Smithee</Name>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <Job locale="en-US">Grip</Job>
</CrewMember>
↑先頭に戻る
Language

作品が最初に制作された言語。音声言語を指す場合と、サイレント作品の画面上に表示されるテキスト言語を指す場合とがあります。指定できるLanguage要素は各作品につき1つだけです。吹き替えオプションを指定する場合は、AudioLanguageも使用します。言語なしでカタログを申請することは可能ですが、特に複数の言語で利用できるコンテンツがある場合は、ベストプラクティスとしてコンテンツの言語を追加することを強くお勧めします。Amazon側でコンテンツを適切な言語にマッチングできるように、コンテンツの各バージョンの言語を指定する必要があります。

言語が異なる複数の地域でコンテンツを提供する場合は、言語ごとにローカライズされたコンテンツを提供する必要があります。たとえば、日本で英語の映画を提供する場合は、その日本語バージョンを提供する必要があります。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 language
<Movie>
  ...
  <Language>ja</Language>
  ...
</Movie>
↑先頭に戻る
LaunchDetails

作品の特定の視聴方法で利用できるビデオ画質、音声言語、字幕オプションを指定する要素を含んでいます。LaunchDetailsに含まれるLaunchIdという要素(省略可能)を使用すると、あらかじめ決まった画質、言語、字幕の構成で作品の再生を開始できます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 SubscriptionOffer
FreeOffer
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Quality(省略可能、無制限)
AudioLanguage(省略可能、無制限)
Subtitle(省略可能、無制限)
LaunchId(省略可能、1つ指定可能)
属性 なし
<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は1つだけです。複数のLaunchIdを指定するには、複数のLaunchDetails要素を追加する必要があります。

プロパティ 詳細
使用 省略可能
指定可能な数 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を参照してください。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 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

作品に対する視聴者の評価として指定できる最高スコア。指定できるMaxValueは、CustomerRatingごとに1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 decimal(正の値)
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑先頭に戻る
MetadataAvailabilityDate

視聴者がメタデータ情報を利用できるようになる日付。この情報を含めると、マッチングが向上します。MetadataAvailabilityDateWindowStartと同じですが、MetadataAvailabilityDateを指定すると、再生ボタンが非表示になると同時に、コンテンツに関連付けられたメタデータも指定の日付まで非表示になります。MetadataAvailabilityDateWindowStartを組み合わせて使用すると、プレミア時に情報が表示されます(「高い城の男」のプレミアなど)。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 MetadataAvailabilityDates
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryDateTimeType - territories属性が追加されたdateTime
<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が含まれます。国/地域の値を指定しないフィールドは、グローバルに適用されると見なされます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 MetadataAvailabilityDate(必須、1つ指定可能)
属性 なし
<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    ...
  </MetadataAvailabilityDates>
  ...
</Movie>
↑先頭に戻る
Movie

長編映画を表しますが、短編映画にも使用できます。作品は劇場向けの映画でも、テレビ用の映画でも構いません。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Titles(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
IsAdultProducts(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescriptions(省略可能、1つ指定可能)
Synopses(省略可能、1つ指定可能)
MetadataAvailabilityDates(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
Runtimes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
IsOriginals(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
ReleaseDates(省略可能、1つ指定可能)
属性 なし
<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

作品に関連付けられます。作品のキャストまたはクルーの名前です。キャストの場合は、役柄の名前ではなく、その俳優の名前です。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 CastMember
CrewMember
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>
↑先頭に戻る
Offers

視聴者が特定の作品を再生できる方法(無料、サービスの定期購入、レンタル、購入のいずれか)を表します。指定できるOffers要素は作品タイプごとに1つのみで、そのOffers要素には少なくとも1つの視聴方法タイプを追加する必要があります。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – choice。いずれかの子要素が必要です(両方は指定できません)。
子要素 SubscriptionOffer(必須、1つ指定可能)
FreeOffer(必須、1つ指定可能)
属性 なし
<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(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 OriginalAirDates
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryDateTimeType - territories属性が追加されたdateTime
<Movie>
...
  <OriginalAirDates>
    <OriginalAirDate territories="US,CA">2014-01-01T11:30:00+08:00</OriginalAirDate>
  </OriginalAirDates>
</Movie>
↑先頭に戻る
OriginalAirDates

該当するエピソードまたは特別番組の初回放映日のセット。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 OriginalAirDate(必須、無制限)
属性 なし
<Movie>
  ...
  <OriginalAirDates>
    ...
  </OriginalAirDate>
</Movie>
↑先頭に戻る
Partner

このカタログのプロバイダーを識別します。決められた形式はありませんが、人が判読できる形式にすることをお勧めします。たとえば、Amazonアプリストアに表示されるアプリ名をそのまま使用するのも1つの方法です。プロバイダーのフルネームを使用することもできます。個々のカタログファイルにPartner要素が1つ必要です。

プロパティ 詳細
使用 必須
指定可能な数 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)があります。1つの作品を複数の画質オプションで提供できます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 LaunchDetails
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 列挙型: SDHDUHD
<FreeOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
    <Quality>SD</Quality>
  </LaunchDetails>
  ...
</FreeOffer>
↑先頭に戻る
Rank

カタログ内のほかのアイテムに対する相対的な数値で人気を示したスコアです。最高ランクは1として定義されます。ランクの決め方は自由です。複数のアイテムに同じランクを割り当ててもかまいません。1つの作品に割り当てることのできるRank要素は1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvShow>
  ...
  <Rank>36</Rank>
  ...
</TvShow>
↑先頭に戻る
Regions

特定の視聴方法が利用できる国を表します。指定できるRegions要素は各視聴方法タイプにつき1つだけです。

⚠重要! 2021年8月31日以降、このフィールドの「US」には米国の海外領土は含まれなくなります。これらの海外領土で視聴方法を利用できるようにするには、対象とする地域を明示的に追加してください。実装については、以下の例を参照してください。

米国の海外領土コードの例:
米領ヴァージン諸島(USVI)=VI、グアム=GU、プエルトリコ=PR、マリアナ諸島=MP

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 SubscriptionOffer
FreeOffer
コンテンツモデル complexType – choice。いずれかの子要素が必要です(両方は指定できません)。
子要素 Territories(必須、1つ指定可能)
属性 なし
<FreeOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</FreeOffer>
↑先頭に戻る
RelatesToExternalID

Extra(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。外部ソース(IMDbなど)の分類に基づくほかの作品(映画など)を判別するための識別子は、RelatesToExternalIDで指定します。RelatesToExternalIDは、関連付けられている作品が同じカタログに存在しない場合に使用します。関連付けはRelatesToIDまたはRelatesToExternalIDを使用して指定できますが、両方を使用することはできません。RelatesToExternalIDは、RelatesToIDが存在しない場合にのみ使用します。

RelatesToExternalIDExternalIDを混同しないでください。ExternalIDExtraそのものを指すのに対し、RelatesToExternalIDはそれに関連付けられている作品を指します。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Extra
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

scheme: 必須。このIDの提供元となった外部ソース。

データ型: 列挙型

列挙値:

  • imdb: Internet Movie Database(IMDb)。IDは、特定のページのURLの構成要素として存在します。
  • tms: OnTVドメイン。以前のTribune Media Serviceですが、本質的には旧Gracenote ID空間の1つです。
  • isan: International Standard Audiovisual Number(ISAN)。26文字の英数字で、通常はダッシュ区切りで表示されます。
  • ean: EAN(European Article Number)はバーコード規格の1つで、12桁または13桁の商品識別コードです。各EANは、商品やメーカー、およびその属性を一意に識別します。
  • upc: UPC(Universal Product Code)は、米国の小売用パッケージに広く使用されている12桁のバーコードです。
  • asin: ASIN(Amazon Standard Identification Number)は、商品を識別するための英数字10桁で構成される一意のブロックです。
  • gvdGracenote Video DataGracenote IDはテレビ番組や映画を一意に識別するIDです。このIDにより、テレビ番組表データやオンデマンドカタログへの関連付けが可能になります。


region: 省略可能。externalIdに関連する地域(Amazon ASINSの場合はマーケットプレイス、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と同じカタログに存在している必要があります。関連付ける作品はRelatesToIDまたはRelatesToExternalIDを使用して指定できますが、両方を使用することはできません。関連付ける作品がカタログに存在する場合は、必ずRelatesToIDを使用します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 token
<TvShow>
  <ID>TV123456</ID>
  ...
</TvShow>
<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToID>TV123456</RelatesToID>
</Extra>
↑先頭に戻る
ReleaseDate

作品が最初に一般公開(テレビの場合は初回放映)された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 ReleaseDates
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryDateTimeType - territories属性が追加されたdateTime
<TvShow>
  ...
  <ReleaseDates>
    <ReleaseDate territories="US,CA">2012-05-13T00:00:00</ReleaseDate>
  </ReleaseDates>
</TvShow>
↑先頭に戻る
ReleaseDates

さまざまな国/地域でのコンテンツの公開日が含まれます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ReleaseDate(必須、無制限)
属性 なし
<TvShow>
  ...
  <ReleaseDates>
  ...
  </ReleaseDates>
</TvShow>
↑先頭に戻る
ReleaseYear

省略可能ですが、指定することを強く推奨します。作品が最初に一般公開(テレビの場合は初回放映)された年。この値は、同じ作品のReleaseDateまたはOriginalAirDate要素に指定されている年と一致している必要があります。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvEpisode>
  ...
  <ReleaseYear>1959</ReleaseYear>
  ...
</TvEpisode>
↑先頭に戻る
Role

作品の中でCastMemberが演じる役柄の名前。たとえば、ロビン・フッド、湖のランスロ、アテナ、セルフなどと指定します。この値に「actor」や「unknown」は使用しないでください。CastMember項目はすべて俳優(actor)です。1人で複数の役柄を演じている場合、CastMember要素に複数のRole要素を追加できます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 CastMember
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string


locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language

データ型 string(ローカライズ)
<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Robin Hood</Role>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>
↑先頭に戻る
RuntimeMinutes

コンテンツ全体の再生時間(分単位)。通常は、2880より小さい正の数です。まれに2880を超えることもあります。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Runtimes
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryInteger - territories属性が追加されたint
<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>
↑先頭に戻る
Runtimes

コンテンツ全体の再生時間を指定します。ロケールや国/地域によって異なります。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 RuntimeMinutes(必須、無制限)
属性 なし
<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>
↑先頭に戻る
Score

視聴者のフィードバックに基づく作品の平均スコア(評価)。この値の収集方法は自由です。レーティングシステムの尺度となるMaxValueに応じて決めてください。スコアに寄与した投票の数を表すCount(省略可能)を追加することもできます。CustomerRatingに指定できるScoreは1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 CustomerRating
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 decimal(正の値)
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑先頭に戻る
SeasonID

TVEpisodeを含んでいるシーズンのID。このIDTVSeasonが、このTvEpisodeと同じカタログに存在している必要があります。SeasonIDまたはSeasonInShowを使用してシーズンを指定できますが、両方を使用することはできません。該当するシーズンがカタログに存在する場合は、必ずSeasonIDを使用します。存在しない場合は、TvSeason項目の作成を検討してください。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 token
<TvSeason>
  <ID>SEA-2329880</ID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <SeasonID>SEA-2329880</SeasonID>
  ...
</TvEpisode>
↑先頭に戻る
SeasonInShow

TVEpisodeが属しているシーズンの番号。そのシーズンがカタログに含まれていない場合に使用します。SeasonInShowは単にUIで使用される番号です。何かと一致している必要はありません。SeasonIDまたはSeasonInShowを使用してシーズンを指定できますが、両方を使用することはできません。SeasonInShowSeasonIDが存在しない場合にのみ使用します(ごくまれなケースです)。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>
↑先頭に戻る
SeasonTitle

TvEpisodeが従属するシーズンのタイトル(「Season 2」など)。対応するTvSeason要素がカタログに含まれている場合、必ずしもこの値をそのTitleと一致させる必要はありません。指定できるSeasonTitleは、TvEpisodeごとに1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  <SeasonTitle locale="en-US">Season 2</SeasonTitle>
  ...
</TvEpisode>
↑先頭に戻る
ShortDescription

作品の内容についての2~3行の説明を指定します。ShortDescriptionには、ほかの場所で確認できる情報(作品のタイトルなど)を指定しないでください。ローカライズされた説明を提供するため、1つの作品に複数のShortDescription要素を追加できます。より長く詳しい説明を入力するには、Synopsis要素を使用してください。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 ShortDescriptions
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string


territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryStringType - localepronunciationterritoriesの各属性が追加されたstring
<Movie>
...
  <ShortDescriptions>
    <ShortDescription locale="en-US" territories="US">Alan shows us some trees and sings songs about them.</ShortDescription>
  </ShortDescriptions>
...
</Movie>
↑先頭に戻る
ShortDescriptions

ロケールや国/地域ごとに、作品の内容を2~3行で説明します。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ShortDescription(必須、無制限)
属性 なし
<Movie>
  ...
  <ShortDescriptions>
    ...
  </ShortDescriptions>
  ...
</Movie>
↑先頭に戻る
ShowID

TvEpisodeまたはTvSeasonをカタログのTvShowに関連付けるために使用します。この値は、TvShow要素のID値と一致している必要があります。ShowIDまたはShowTitleを使用して番組を指定できますが、両方を使用することはできません。カタログにTvShowが存在するときは、必ずShowIDを使用します。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvSeason
TvEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 token
<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>
↑先頭に戻る
ShowTitle

TvEpisodeまたはTvSeasonをカタログのTvShowに関連付けるために使用します。この値は単にUIで使用される文字列です。カタログ内のタイトルと一致している必要はありません。ShowIDまたはShowTitleを使用して番組を指定できますが、両方を使用することはできません。ShowTitleは、ShowIDが存在しない場合にのみ使用します。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvSeason
TvEpisode
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 string(ローカライズ)
<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>
↑先頭に戻る
Studio

作品が制作されたスタジオ。Studio項目は、1つの作品に複数割り当てることができます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Studios
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string
<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>
↑先頭に戻る
Studios

作品が制作されたスタジオを識別するStudio要素を含んでいます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Studio(省略可能、無制限)
属性 なし
<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>
↑先頭に戻る
SubscriptionOffer

プロバイダーのサービスの会員が作品を視聴できます。必要に応じて、Offersに複数のSubscriptionOffer要素を追加できます。SubscriptionOfferは2つある視聴方法タイプのうちの1つです。重要: SubscriptionOffer要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Offers
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
属性 なし
<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

作品の字幕の言語オプション。字幕オプションは、1つの作品に複数割り当てることができます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 LaunchDetails
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 language
<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>
↑先頭に戻る
Synopses

コンテンツの詳細な説明を指定します。ロケールや国/地域によって異なります。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 Synopsis(必須、無制限)
属性 なし
<Movie>
...
  <Synopses>
    ...
  </Synopses>
...
</Movie>
↑先頭に戻る
Synopsis

作品の内容に関する説明。Synopsisは、ShortDescriptionよりも詳しい情報を提供するための要素です。ShortDescriptionや作品のTitleSynopsisとして使用することは避けてください。ローカライズされた説明を提供するため、1つの作品に複数のSynopsis要素を追加できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Synopses
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string

データ型 TerritoryStringType - localepronunciationterritoriesの各属性が追加されたstring
<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は各評価につき1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 ContentRating
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string
<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>G</Certification>
  </ContentRating>
</ContentRatings>
↑先頭に戻る
Territories

特定の視聴方法が利用できる国、地域、または海外領土のコンマ区切りリスト。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Regions
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。
<SubscriptionOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</SubscriptionOffer>
↑先頭に戻る
Title

作品のタイトル。ローカライズされたタイトルを提供するため、1つの作品に複数のTitle要素を追加できます。

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Titles
コンテンツモデル complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素なし
属性

locale: 必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。

データ型:language


pronunciation: 省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。

データ型:string


territories: 省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。

データ型: TerritoriesType - 国や地域を表すstringISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。

データ型 TerritoryStringType - localepronunciationterritoriesの各属性が追加されたstring
<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要素を1つ含めることができます。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素 Title(必須、無制限)
データ型 string(ローカライズ)
<TvShow>
  <ID>TV123456</ID>
  <Titles>
    ...
  </Titles>
  ...
</TvShow>
↑先頭に戻る
TvEpisode

TvShowの単一のエピソード。通常、TvSeasonにも関連付けられます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、ShowIDShowTitleは一方のみ必要で、両方は指定できません。また、SeasonIDSeasonInShowも一方のみ必要で、両方は指定できません。
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Titles(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
IsAdultProducts(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescriptions(省略可能、1つ指定可能)
Synopses(省略可能、1つ指定可能)
MetadataAvailabilityDates(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
Runtimes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
IsOriginals(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
ShowID(必須、1つ指定可能)
ShowTitle(必須、1つ指定可能)
SeasonID(必須、1つ指定可能)
SeasonInShow(必須、1つ指定可能)
SeasonTitle(省略可能、1つ指定可能)
EpisodeInSeason(必須、1つ指定可能)
OriginalAirDates(省略可能、1つ指定可能)
属性 なし
<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は基本的な作品タイプの1つで、TvShowの単一のシーズンを表します。TvEpisodeSeasonIDTvSeasonIDと同じ値である場合、そのエピソードは当該シーズンに属していることを表します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、ShowIDShowTitleは一方のみ必要で、両方は指定できません。
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Titles(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
IsAdultProducts(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescriptions(省略可能、1つ指定可能)
Synopses(省略可能、1つ指定可能)
MetadataAvailabilityDates(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
Runtimes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
IsOriginals(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
ShowID(必須、1つ指定可能)
ShowTitle(必須、1つ指定可能)
SeasonInShow(必須、1つ指定可能)
属性 なし
<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  <ShowID>ABC-123457</ShowID>
  <SeasonInShow>5</SeasonInShow>
</TvSeason>
<TvEpisode>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>
↑先頭に戻る
TvShow

シーズンとエピソードから成るテレビシリーズ。TvSeasonまたはTvEpisodeShowIDTvShowのIDと同じ値である場合、そのシーズンまたはエピソードは当該番組に属していることを表します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Titles(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
IsAdultProducts(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescriptions(省略可能、1つ指定可能)
Synopses(省略可能、1つ指定可能)
MetadataAvailabilityDates(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
Runtimes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
IsOriginals(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
ReleaseDates(省略可能、1つ指定可能)
属性 なし
<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に関する長編メイキングドキュメンタリーでもかまいません。指定できるTypeは、Extraごとに1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 列挙型:clip
<Extra>
  ...
  <Type>clip</Type>
  ...
</Extra>
↑先頭に戻る
Url

画像のURL。画像サイズの詳細については、Imageを参照してください。

プロパティ 詳細
使用 必須
指定可能な数 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は各視聴方法につき1つだけです。WindowStartWindowEndを使用して、その視聴方法を利用できる期間を指定できます。WindowEndで指定した期限を過ぎると、対象の視聴者にはその視聴方法が表示されなくなります。すべての視聴方法の期限が切れると、作品そのものが表示されなくなります。

WindowStartWindowEndを個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。

  • WindowStartのみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。
  • WindowEndのみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。
  • WindowStartWindowEndの両方を指定した場合: 指定された期間のみ作品を視聴できます。
  • WindowStartWindowEndも指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。

プロパティ 詳細
使用 省略可能
指定可能な数 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は各視聴方法につき1つだけです。

WindowStartWindowEndを個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。

  • WindowStartのみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。
  • WindowEndのみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。
  • WindowStartWindowEndの両方を指定した場合: 指定された期間のみ作品を視聴できます。
  • WindowStartWindowEndも指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。

プロパティ 詳細
使用 省略可能
指定可能な数 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

カタログ内の個々の項目(映画、TV番組、シーズン、特別番組、ミニシリーズ、エピソード、トレーラーやクリップ)がすべて格納されます。個々のカタログファイルには、Works要素が1つ存在している必要があります。Works要素には、作品の項目を必要に応じていくつでも追加できます。また、各タイプも必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Catalog
コンテンツモデル contentType — sequenceおよびchoice。Works要素には任意の子要素を必要に応じて含めることができ、その子要素は任意の順序で複数回指定できます。
子要素 Movie(省略可能、無制限)
TvEpisode(省略可能、無制限)
TvSeason(省略可能、無制限)
TvShow(省略可能、無制限)
Extra(省略可能、無制限)
属性 なし
<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>
↑先頭に戻る

廃止された要素

以下の要素は廃止されました。廃止された要素がカタログデータファイルに含まれていても、カタログは却下されません。ただし、マッチングを改善するには、カタログファイルからこれらの要素を削除する必要があります。

AdultProduct

成人向けコンテンツとして作品を識別します。日本では、JP_Require18PlusAgeConfirmationを使用することもできます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 boolean
<Movie>false</Movie>
  ...
  <AdultProduct>false</AdultProduct>
  ...
</Movie>false</Movie>
↑先頭に戻る
Country

特定の視聴方法(定期購入、無料、購入、レンタル)の対象となる国または地域。各視聴方法には、必要に応じてCountry要素をいくつでも追加できます。

⚠重要! 2021年8月31日以降、このフィールドの「US」には米国の海外領土は含まれなくなります。これらの海外領土で視聴方法を利用できるようにするには、対象とする地域を明示的に追加してください。実装については、以下の例を参照してください。

米国の海外領土コードの例:
米領ヴァージン諸島(USVI)=VI、グアム=GU、プエルトリコ=PR、マリアナ諸島=MP

プロパティ 詳細
使用 必須
指定可能な数 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

作品のレンタル期間(時間単位)を定義します。指定できるDuration要素は、RentalOfferごとに1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 RentalOffer
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<RentalOffer>
  ...
  <Duration>120</Duration>
</RentalOffer>
↑先頭に戻る
EpisodeInSeries

シリーズに含まれているミニシリーズのエピソードの連続番号。指定できるEpisodeInSeries要素は、MiniSeriesEpisodeごとに1つだけです。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 MiniSeriesEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<MiniSeriesEpisode>
  ...
  <EpisodeInSeries>13</EpisodeInSeries>
  ...
</MiniSeriesEpisode>
↑先頭に戻る
ImageUrl

作品を表す画像のURL。「ボックスアート」とも呼ばれます。 指定できるImageUrl要素は各作品につき1つだけです。ImageUrlが指定されていない場合、ほかのソース(IMDbなど)の利用可能なアートや、汎用的なプレースホルダー画像を使用します。画像の要件については、ボックスアート画像(ImageUrl)の要件を参照してください。注: 作品のコンテンツに合った重複しない画像を作品ごとに指定してください。汎用的なプレースホルダー画像(ロゴなど)は使用しないでください。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 anyURI
<TvShow>
  ...
  <ImageUrl>http://amazon.com/images/01152ce2de7e44c1/image.jpg</ImageUrl>
  ...
</TvShow>
↑先頭に戻る
JP_Require18PlusAgeConfirmation

18歳以上の視聴者を対象とした、日本市場向けのコンテンツであることを示します。このフラグをtrueに設定した場合、日本の法的要件に従い、日本でそのコンテンツを視聴するユーザーが18歳以上であることを確認する必要があります。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 boolean
<Movie>
  ...
  <JP_Require18PlusAgeConfirmation>true</JP_Require18PlusAgeConfirmation>
</Movie>
↑先頭に戻る
MetadataAvailabilityDate(廃止)

視聴者がメタデータ情報を利用できるようになる日付。この情報を含めると、マッチングが向上します。MetadataAvailabilityDateWindowStartと同じですが、MetadataAvailabilityDateを指定すると、再生ボタンが非表示になると同時に、コンテンツに関連付けられたメタデータも指定の日付まで非表示になります。MetadataAvailabilityDateWindowStartを組み合わせて使用すると、プレミア時に情報が表示されます(「高い城の男」のプレミアなど)。

プロパティ 詳細
使用 省略可能
指定可能な数 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に指定できるエピソードの数に明示的な制限はありませんが、常識的な数のエピソードに限定してください。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Title(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescription(省略可能、無制限)
Synopsis(省略可能、無制限)
MetadataAvailabilityDate(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
RuntimeMinutes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
Source(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
JP_Require18PlusAgeConfirmation(省略可能、1つ指定可能)
ReleaseDate(省略可能、1つ指定可能)
属性 なし
<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は基本的な作品タイプの1つで、MiniSeries内の単一のエピソードを表します。このコンテンツはシーズンには関連付けられず、MiniSeriesとの関連で順序付けされます。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、ShowIDShowTitleは一方のみ必要で、両方は指定できません。MiniSeriesIDMiniSeriesTitleも一方のみ必要です。
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Title(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescription(省略可能、無制限)
Synopsis(省略可能、無制限)
MetadataAvailabilityDate(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
RuntimeMinutes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
Source(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
JP_Require18PlusAgeConfirmation(省略可能、1つ指定可能)
MiniSeriesID(必須、1つ指定可能)
MiniSeriesTitle(必須、1つ指定可能)
OriginalAirDate(省略可能、1つ指定可能)
属性 なし
<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と同じカタログに存在している必要があります。ミニシリーズはMiniSeriesIDまたはMiniSeriesTitleを使用して指定できますが、両方を使用することはできません。カタログにミニシリーズが存在する場合は、必ずMiniSeriesIDを使用します。カタログに存在しない場合は、MiniSeries項目を作成して使用することをお勧めします。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 MiniSeriesEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 token
<MiniSeries>
  <ID>MS-2329880</ID>
  ...
</MiniSeries>
</MiniSeriesEpisode>
  ...
  <MiniSeriesID>MS-2329880</MiniSeriesID>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
↑先頭に戻る
MiniSeriesTitle

ミニシリーズがカタログに含まれていない場合に、エピソードを含んでいるミニシリーズを指定します。MiniSeriesTitleは単にUIに使用される文字列であり、カタログ内の既存のタイトルと一致している必要はありません。ミニシリーズはMiniSeriesIDまたはMiniSeriesTitleを使用して指定できますが、両方を使用することはできません。MiniSeriesTitleMiniSeriesIDが存在しない場合にのみ使用します(ごくまれなケースです)。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 MiniSeriesEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<MiniSeriesEpisode>
  ...
  <MiniSeriesTitle>Cats, The Most Beautiful Creature</MiniSeriesTitle>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
↑先頭に戻る
OriginalAirDate(廃止)

作品が最初にテレビで放送された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 TvEpisode
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 dateTime
<TvEpisode>
  ...
  <OriginalAirDate>2012-05-13T00:00:00</OriginalAirDate>
</TvEpisode>
↑先頭に戻る
Price

作品のレンタルまたは購入にかかる費用。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 PurchaseOffer
RentalOffer
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 xsd:float
<PurchaseOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <Price currency="USD">1.99</Price>
</PurchaseOffer>
↑先頭に戻る
PurchaseOffer

作品を1回購入すれば、所有していつでも視聴できます。必要に応じて、Offersに複数のPurchaseOffer要素を追加できます。PurchaseOfferは2つある視聴方法タイプのうちの1つです。重要: PurchaseOffer要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。現時点では、Fire TVはディスプレイ内のPurchaseOffer情報に対して何も行いません。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Offers
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
Price(必須、1つ指定可能)
属性 なし
<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

プロパティ 詳細
使用 省略可能
指定可能な数 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(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 dateTime
<TvShow>
  ...
  <ReleaseDate>2012-05-13T00:00:00</ReleaseDate>
</TvShow>
↑先頭に戻る
ReleaseDate(リリース情報)

作品が最初に一般公開(テレビの場合は初回放映)された日付。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 ReleaseInfo
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 dateTime
<TvShow>
  ...
  <ReleaseInfo>
    <ReleaseDate>2012-05-13</ReleaseDate>
  </ReleaseInfo>
</TvShow>
↑先頭に戻る
ReleaseInfo

作品のリリース先となる国または地域とリリース日を指定する要素を含んでいます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル complexType – sequence;指定された順序で必要な子要素を含める必要があります
子要素 ReleaseDate(必須、1つ指定可能)
ReleaseCountry(省略可能、1つ指定可能)
属性 なし
<TvEpisode>
  ...
  <ReleaseInfo>
    <ReleaseDate>2002-02-20</ReleaseDate>
    <ReleaseCountry>BT</ReleaseCountry>
  </ReleaseInfo>
  ...
</TvEpisode>
↑先頭に戻る
RentalOffer

1回の支払いで限られた期間だけ作品を視聴できます。必要に応じて、Offersに複数のRentalOffer要素を追加することができます。RentalOfferは2つある視聴方法タイプのうちの1つです。重要: RentalOffer要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。現時点では、Fire TVはディスプレイ内のRentalOffer情報に対して何も行いません。

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 Offers
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
Price(必須、1つ指定可能)
Duration(必須、1つ指定可能)
属性 なし
<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より小さい正の数です。まれに2880を超えることもあります。指定できるRuntimeMinutes要素は各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvEpisode>
  ...
  <RuntimeMinutes>37</RuntimeMinutes>
  ...
</TvEpisode>
↑先頭に戻る
ShortDescription(廃止)

作品の内容についての2~3行の説明。ShortDescriptionには、ほかの場所で確認できる情報(作品のタイトルなど)を指定しないでください。ローカライズされた説明を提供するため、1つの作品に複数のShortDescription要素を追加できます。より長く詳しい説明を入力するには、Synopsis要素を使用してください。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan shows us some trees and sings songs about them.</ShortDescription>
  ...
</TvSpecial>
↑先頭に戻る
Source

作品の提供元。指定できるSourceは各作品につき1つだけです。オプションは次のとおりです。
  • original: このカタログのプロバイダーによって製作・制作されたコンテンツ。
  • licensed: このカタログのプロバイダーがサードパーティからライセンスを取得した作品。
  • unknown: 提供元が不明なコンテンツ。
  • other: 提供元は判明しているがoriginalにもlicensedにも該当しない作品。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 列挙型:originallicensedunknownother
<TvEpisode>
  ...
  <Source>licensed</Source>
  ...
</TvEpisode>
↑先頭に戻る
Synopsis(廃止)

作品の内容に関する説明。Synopsisは、ShortDescriptionよりも詳しい情報を提供するための要素です。ShortDescriptionや作品のTitleSynopsisとして使用することは避けてください。ローカライズされた説明を提供するため、1つの作品に複数のSynopsis要素を追加できます。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan shows us some trees and sings songs about them.</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(廃止)

作品のタイトル。ローカライズされたタイトルを提供するために、1つの作品に複数のTitle要素を指定できます。追加されたバージョン: CDF 1.0

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<TvShow>
  <ID>TV123456</ID>
  <Title locale="en-US">Office Factor</Title>
  ...
</TvShow>
↑先頭に戻る
TvSpecial

テレビで放送されるイベントのうち、番組-シーズン-エピソードという従来のテレビ階層には該当しないイベント。1回限りのイベント(休日特番など)のほか、各エピソードにエピソード番号ではなく一意の放映日が割り当てられている番組(ニュース番組など)が該当します。TvSpecialは、TvShowに関連付けることができるほか(ただしTvSeasonへの関連付けは不可)、単発の番組として存在する場合もあります。また、授賞式関連の番組や、テレビコンサート、回顧録も該当します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、ShowIDShowTitleは一方のみ必要で、両方は指定できません。
子要素 ID(必須、1つ指定可能)
ExternalID(省略可能、無制限)
Title(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescription(省略可能、無制限)
Synopsis(省略可能、無制限)
MetadataAvailabilityDate(省略可能、1つ指定可能)
Images(必須、1つ指定可能)
RuntimeMinutes(省略可能、1つ指定可能)
Color(省略可能、1つ指定可能)
Credits(省略可能、1つ指定可能)
Studios(省略可能、1つ指定可能)
Language(省略可能、1つ指定可能)
CustomerRating(省略可能、1つ指定可能)
Rank(省略可能、1つ指定可能)
Source(省略可能、1つ指定可能)
Genres(省略可能、1つ指定可能)
ContentRatings(省略可能、1つ指定可能)
JP_Require18PlusAgeConfirmation(省略可能、1つ指定可能)
ShowID(省略可能、1つ指定可能)
ShowTitle(省略可能、1つ指定可能)
OriginalAirDate(必須、1つ指定可能)
属性 なし
<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日