開発者コンソール

CDFの全要素

CDFの全要素
AdultProduct

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

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

xmlns XML名前空間。

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

<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
<ContentRating>
  <System>MPAA</System>
  <Certification>PG-13</Certification>
</ContentRating>
↑先頭に戻る
Color

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

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
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つ指定可能)
属性 なし
<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
</ContentRatings>
↑先頭に戻る
ContentRatings

特定の認定機関によって作品に与えられた公式な評価が指定されます。ContentRatings要素は、作品ごとに1つのみ指定できます。

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

作品の著作権表示。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 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>
↑先頭に戻る
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>
↑先頭に戻る
Credits

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
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
TvSpecial
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
TvSpecial
コンテンツモデル 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は、商品やメーカー、およびその属性を一意に識別します。詳細については、JAN(EAN)、UPC、ISBN、またはASINとは何ですか?を参照してください。
  • upc: UPC(Universal Product Code)は、米国の小売用パッケージに広く使用されている12桁のバーコードです。
  • asin: ASIN(Amazon Standard Identification Number)は、商品を識別するための英数字10桁で構成される一意のブロックです。詳細については、JAN(EAN)、UPC、ISBN、またはASINとは何ですか?を参照してください。
  • gvdGracenote Video DataGracenote IDによってTV番組や映画の一意の識別子が提供され、TV番組表データやオンデマンドカタログへの関連付けが可能になります。

region externalIdに関連する省略可能な地域(Amazon ASINSの場合はマーケットプレイス、TMS IDの場合は国)。必須ではありません。 データ型はstringです。たとえば、スキームがTMSの場合は国(USなど)になります。

<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(省略可能、無制限)
Title(必須、無制限)
Copyright(省略可能、1つ指定可能)
Offers(省略可能、1つ指定可能)
ReleaseYear(省略可能、1つ指定可能)
ShortDescription(省略可能、無制限)
Synopsis(省略可能、無制限)
MetadataAvailabilityDate(省略可能、1つ指定可能)
Images(必須、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つ指定可能)
Type(必須、1つ指定可能)
RelatesToID(必須、1つ指定可能)
RelatesToExternalID(必須、無制限)
属性 なし
<Extra>
  <ID>EXTRA-11111</ID>
  <Title locale="en-US">Wishenpoof! Trailer</Title>
  <Offers>
    <FreeOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </FreeOffer>
  </Offers>
  <Type>trailer</Type>
</Extra>
↑先頭に戻る
FreeOffer

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

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 オファー
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
属性 なし
<FreeOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </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
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>
↑先頭に戻る
Genres

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

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
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番組、シーズン、エピソードの場合、サイズは幅853ピクセル×高さ480ピクセル以上、縦横比は16:9の画像を使用してください。必要に応じてサイズ変更できるよう、大きいサイズの画像をお勧めします。幅853ピクセル×高さ480ピクセル未満の画像、または縦横比が16:9以外の画像は使用されません。そのような場合は、代わりに別の画像ソース(IMDbなど)やプレースホルダー画像が使用されます。

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

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

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

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

既存のカタログをアップデートするときに作品のIDを変更しないようご注意ください。カタログからIDが消えた場合、Amazonではその作品がサービス上で利用できなくなったものと判断し、Amazonのインデックスから削除します。後で作品を元に戻す場合は、以前と同じIDを使用する必要があります。統合後にIDスキームを変更すると、ユーザーエクスペリエンスに悪影響を及ぼす可能性があります。

IDに使用できるのは次の文字だけです。 0~9、A~Z、a~z、-、+、.

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

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

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 CrewMember
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<CrewMember>
  <Name locale="en-US">Alan Smithee</Name>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <Job locale="en-US">Grip</Job>
</CrewMember>
↑先頭に戻る
JP_Require18PlusAgeConfirmation

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

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

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

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

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

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 SubscriptionOffer
FreeOffer
コンテンツモデル complexType – sequence。指定された順序で必要な子要素を含める必要があります。
子要素 Quality(省略可能、無制限)
AudioLanguage(省略可能、無制限)
Subtitle(省略可能、無制限)
LaunchId(省略可能、1つ指定可能)
属性 なし
<FreeOffer>
  <Regions>
    <Country>US</Country>
  </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(子要素なし)
子要素なし
データ型 xsd:token
<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <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
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 decimal(正の値)
<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>
↑先頭に戻る
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>
↑先頭に戻る
Movie

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 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つ指定可能)
属性 なし
<Movie>
  <ID>MV-123456</ID>
  <Title locale="en-US">Chase the Prawns</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ReleaseDate>2013-10-04T00:00:00</ReleaseDate>
</Movie>
↑先頭に戻る
Name

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

プロパティ 詳細
使用 必須
指定可能な数 無制限
親要素 CastMember
CrewMember
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>
↑先頭に戻る
Offers

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル complexType – choice。いずれかの子要素が必要です(両方は指定できません)。
子要素 SubscriptionOffer(必須、1つ指定可能)
FreeOffer(必須、1つ指定可能)
属性 なし
<Offers>
  <FreeOffer>
    <Regions>
      <Country>CA</Country>
    </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>
      <Country>CA</Country>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>
↑先頭に戻る
OriginalAirDate

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

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 TvEpisode
TvSpecial
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 dateTime
<TvSpecial>
  ...
  <OriginalAirDate>2012-05-13T00:00:00</OriginalAirDate>
</TvSpecial>
↑先頭に戻る
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>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
  </LaunchDetails>
</FreeOffer>
↑先頭に戻る
Rank

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

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

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

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

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

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 SubscriptionOffer
FreeOffer
コンテンツモデル complexType – sequence。指定された順序で必要な子要素を含める必要があります。
子要素 Country(必須、無制限)
属性 なし
<FreeOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
    <Country>MX</Country>
  </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は、商品やメーカー、およびその属性を一意に識別します。詳細については、JAN(EAN)、UPC、ISBN、またはASINとは何ですか?を参照してください。
  • upc: UPC(Universal Product Code)は、米国の小売用パッケージに広く使用されている12桁のバーコードです。
  • asin: ASIN(Amazon Standard Identification Number)は、商品を識別するための英数字10桁で構成される一意のブロックです。詳細については、JAN(EAN)、UPC、ISBN、またはASINとは何ですか?を参照してください。
  • gvdGracenote Video DataGracenote IDによってTV番組や映画の一意の識別子が提供され、TV番組表データやオンデマンドカタログへの関連付けが可能になります。

region externalIdに関連する省略可能な地域(Amazon ASINSの場合はマーケットプレイス、TMS IDの場合は国)。必須ではありません。 データ型はstringです。たとえば、スキームがTMSの場合は国(USなど)になります。

データ型 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と一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

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

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

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

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 CastMember
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 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を超えることもあります。指定できるRuntimeMinutes要素は各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 1つ
親要素 Movie
TvShow
TvSeason
TvEpisode
TvSpecial
Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 int
<TvEpisode>
  ...
  <RuntimeMinutes>37</RuntimeMinutes>
  ...
</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
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  <SeasonTitle locale="en-US">Season 2</SeasonTitle>
  ...
</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>
↑先頭に戻る
ShowID

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

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

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

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 TvSeason
TvEpisode
TvSpecial
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string(ローカライズ)
<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>
↑先頭に戻る
Source

作品の提供元。指定できるSourceは各作品につき1つだけです。オプションは次のとおりです。

  • original: このカタログのプロバイダーによって製作・制作されたコンテンツ。
  • licensed: このカタログのプロバイダーがサードパーティからライセンスを取得した作品。
  • unknown: 提供元が不明なコンテンツ。
  • other: 提供元は判明しているがoriginalにもlicensedにも該当しない作品。

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

視聴者が特定の作品を再生するためのサブスクリプションの識別子。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 SubscriptionIds
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 string
<TvShow>
    ...
    <Offers>
        <SubscriptionOffer>
            ...
            <SubscriptionIds>
                <SubscriptionId>bronze</SubscriptionId>
                <SubscriptionId>silver</SubscriptionId>
                <SubscriptionId>gold</SubscriptionId>
            </SubscriptionIds>
        </SubscriptionOffer>
    </Offers>
    ...
</TvShow>
↑先頭に戻る
SubscriptionIds

視聴者が特定の作品を再生するためのサブスクリプションが含まれます。

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

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

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 オファー
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。
子要素 Regions(必須、無制限)
LaunchDetails(省略可能、無制限)
WindowStart(省略可能、1つ指定可能)
WindowEnd(省略可能、1つ指定可能)
SubscriptionIds (省略可能、1つ指定可能)
属性 なし
<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </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>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>
↑先頭に戻る
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>
↑先頭に戻る
System

作品を評価したレーティングシステム(通常は公式の評価機関)。指定できるSystemは各評価につき1つだけです。

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

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

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Works
コンテンツモデル complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、ShowIDShowTitleは一方のみ必要で、両方は指定できません。また、SeasonIDSeasonInShowも一方のみ必要で、両方は指定できません。
子要素 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つ指定可能)
SeasonID(必須、1つ指定可能)
SeasonInShow(必須、1つ指定可能)
SeasonTitle(省略可能、1つ指定可能)
EpisodeInSeason(必須、1つ指定可能)
OriginalAirDate(省略可能、1つ指定可能)
属性 なし
<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS-987654</ID>
  ...
</TvSeason>
<TvEpisode>
  <ID>TVE2329880</ID>
  <Title locale="en-US">What's in a Name?</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS-987654</SeasonInShow>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>
↑先頭に戻る
TvSeason

TvSeasonは基本的な作品タイプの1つで、TvShowの単一のシーズンを表します。TvEpisodeSeasonID値がそのTvSeasonIDと同じである場合、そのエピソードがそのシーズンに属していることを表します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 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つ指定可能)
SeasonInShow(必須、1つ指定可能)
属性 なし
<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  <Title locale="en-US">Season Five</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ShowID>ABC-123457</ShowID>
  <SeasonInShow>5</SeasonInShow>
</TvSeason>
<TvEpisode>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>
↑先頭に戻る
TvShow

シーズンとエピソードから成るテレビシリーズ。通常の一連のエピソードとは別に特別番組に関連付けられる場合もあります。TvSeasonTvEpisodeTvSpecialShowID値がそのTvShowのIDと同じである場合、そのシーズン、エピソード、特別番組はそのTvShowに属していることを表します。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 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つ指定可能)
属性 なし
<TvShow>
  <ID>RS-2329880</ID>
  <Title locale="en-US">Office Factor</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  ...
  <ShowID>RS-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>RS-2329880</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>
↑先頭に戻る
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>
↑先頭に戻る
Type

Extraをトレーラー(プレビュー)またはクリップとして指定します。Extraが関連付けられているMovieのメイキングドキュメンタリーのように大規模なものもありますが、トレーラー以外はすべてクリップと見なして構いません。指定できるTypeは、Extraごとに1つだけです。

プロパティ 詳細
使用 省略可能
指定可能な数 無制限
親要素 Extra
コンテンツモデル simpleType(子要素なし)
子要素なし
データ型 列挙型:cliptrailer
<Extra>
  ...
  <Type>trailer</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(省略可能、無制限)
TvSpecial(省略可能、無制限)
Extra(省略可能、無制限)
属性 なし
<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>
↑先頭に戻る

廃止された要素

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

Duration

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

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

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

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

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

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 オファー
コンテンツモデル 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>
↑先頭に戻る
Price

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

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

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

プロパティ 詳細
使用 必須
指定可能な数 1つ
親要素 オファー
コンテンツモデル 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>
↑先頭に戻る

Last updated: 2021年1月22日