CDFの全要素
- AdultProduct
- AudioLanguage
- CastMember
- Catalog
- Certification
- Color
- ContentRating
- ContentRatings
- Copyright
- Count
- Country
- Credits
- CrewMember
- CustomerRating
- EpisodeInSeason
- ExternalID
- Extra
- FreeOffer
- Genre
- Genres
- Image
- Images
- ID
- Job
- JP_Require18PlusAgeConfirmation
- Language
- LaunchDetails
- LaunchId
- Locale
- MaxValue
- MetadataAvailabilityDate
- Movie
- Name
- Offers
- OriginalAirDate
- Partner
- Quality
- Rank
- Regions
- RelatesToExternalID
- RelatesToID
- ReleaseDate
- ReleaseYear
- Role
- RuntimeMinutes
- Score
- SeasonID
- SeasonInShow
- SeasonTitle
- ShortDescription
- ShowID
- ShowTitle
- Source
- Studio
- Studios
- SubscriptionOffer
- Subtitle
- Synopsis
- System
- Title
- TvEpisode
- TvSeason
- TvShow
- TvSpecial
- Type
- Url
- WindowEnd
- WindowStart
- Works
- 廃止された要素
成人向けコンテンツとして作品を識別します。日本では、JP_Require18PlusAgeConfirmation
を使用することもできます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | boolean |
<Movie>false</Movie>
...
<AdultProduct>false</AdultProduct>
...
</Movie>false</Movie>
複数の言語に吹き替えられた作品のオーディオオプション。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>
作品のキャスト(俳優、ホスト、ナレーター、声優など)についての情報を指定します。Credits
要素(省略可能)が存在する場合、CastMember
またはCrewMember
のいずれかの項目を指定する必要があります。CastMember
要素は必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Credits |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、無制限) |
属性 | なし |
<Credits>
<CastMember>
<Name locale="en-US">Alan Smithee</Name>
<ExternalID scheme="imdb">tt0000000</ExternalID>
<Role locale="en-US">Self</Role>
</CastMember>
</Credits>
CDFファイルのルート要素。すべてのカタログファイルにはCatalog
要素が1つ必要で、この中にそのファイルの残りの要素が指定されます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 | なし |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、無制限) |
属性 |
|
<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>
特定の認定システム(System
)の下で作品に与えられた証明(評価)。指定できるCertification
要素は、ContentRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
ContentRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
<ContentRating>
<System>MPAA</System>
<Certification>PG-13</Certification>
</ContentRating>
映画が主にカラーであるか白黒であるかを指定します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型:color 、black_and_white |
<Movie>
...
<Color>black_and_white</Color>
...
</Movie>
レーティングシステム(評価機関)およびそのシステムで作品に与えられた評価を指定する要素を含んでいます。ContentRatings
(省略可能)が存在する場合、ContentRating
を1つ以上指定する必要があります。ContentRating
要素は必要に応じていくつでも追加できます(システム/評価の組み合わせごとに1つ)。ContentRatings
は、 米国、ブラジル、オーストラリア、日本では必須となります。それ以外の国でも、ContentRatings
を指定することを強くお勧めします。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
ContentRatings |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 | なし |
<ContentRatings>
<ContentRating>
<System>MPAA</System>
<Certification>PG-13</Certification>
</ContentRating>
</ContentRatings>
特定の認定機関によって作品に与えられた公式な評価が指定されます。ContentRatings
要素は、作品ごとに1つのみ指定できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) |
属性 | なし |
<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>
視聴者の評価スコア(Score
)に寄与したユーザーの数。指定できるCount
は、CustomerRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
CustomerRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | long(負数以外) |
<CustomerRating>
<Score>8.2</Score>
<MaxValue>10</MaxValue>
<Count>512</Count>
</CustomerRating>
特定の視聴方法(定期購入、無料、購入、レンタル)の対象となる国または地域。各視聴方法には、必要に応じて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
要素は各作品につき1つだけです。Credits
が存在する場合、CastMember
またはCrewMember
が少なくとも1つ必要です。いずれの要素も必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – choice。いずれかの子要素が必要です(両方は指定できません)。 |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 | なし |
<Credits>
<CastMember>
<Name locale="en-US">Alan Smithee</Name>
<Role locale="en-US">Self</Role>
</CastMember>
</Credits>
作品の裏方のクルー(ディレクター、ライター、カメラマン、照明係第一助手、アニメーター、撮影助手など)に関する情報を表す要素を含んでいます。Credits
(省略可能)が存在する場合、CastMember
またはCrewMember
のいずれかの項目を指定する必要があります。CrewMember
要素は必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Credits |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (必須、無制限) |
属性 | なし |
<Credits>
<CrewMember>
<Name locale="en-US">Alan Smithee</Name>
<ExternalID scheme="imdb">tt0000000</ExternalID>
<Job locale="en-US">Director</Job>
</CrewMember>
</Credits>
作品に対する視聴者の評価の平均スコア、最大値、スコアに寄与した評価の数を表す要素を含んでいます。指定できるCustomerRating
要素は各作品につき1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) |
子要素に関する注意事項 | Count はCDF v1.2以降でのみ使用できます。 |
属性 | なし |
<CustomerRating>
<Score>8.2</Score>
<MaxValue>10</MaxValue>
<Count>512</Count>
</CustomerRating>
TV番組のシーズンに含まれているエピソードの連続番号。指定できるEpisodeInSeason
要素は、TvEpisode
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<TvEpisode>
...
<EpisodeInSeason>6</EpisodeInSeason>
...
</TvEpisode>
外部ソース(IMDbなど)の分類に基づく作品の識別子。この値は、コンテンツのマッチングに使用されます。別のカタログ内の対応する値と比較し、作品や人物が同一であるかどうかを判断します。画像など外部コンテンツのソースとしても使用できます。外部IDを格納するExternalID
要素は、必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
CastMember CrewMember Extra Movie TvEpisode TvSeason TvShow TvSpecial |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
|
<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>
クリップまたはトレーラー。単発の作品の場合もありますが、通常はほかの作品(外部の作品またはカタログ内の別の作品)に関連付けられます。一般に、DVDに収録されるボーナストラックに相当するものと考えてください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Works |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、RelatesToID とRelatesToExternalID は一方のみ必要で、両方は指定できません。
|
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (必須、無制限) |
属性 | なし |
<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>
作品をいつでも無料で視聴できます。視聴できる期間を指定することもできます。必要に応じて、Offers
に複数のFreeOffer
要素を追加できます。重要: FreeOffer
要素は省略可能ですが、Offers
には少なくとも1つの視聴方法タイプが必要です。FreeOffer
は2つある視聴方法タイプのうちの1つです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、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>
作品のジャンル(コメディー、ホラー、ドラマ、ドキュメンタリーなど)。必要に応じて、1つの作品に複数のGenre
要素を指定できます。検索とマッチングの機能を最大限に活かすため、できる限り標準的なジャンル名を使用してください。複数の説明を組み合わせて1つの文字列にするのではなく複数のGenre
タグを使用してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Movie |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string(ローカライズ) |
<Genres>
<Genre locale="en-US">horror</Genre>
<Genre locale="en-US">sci-fi</Genre>
</Genres>
作品のカテゴリー(コメディー、ホラー、ドキュメンタリーなど)を表す1つ以上のGenre
タグを格納します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) |
属性 | なし |
<Genres>
<Genre locale="en-US">horror</Genre>
<Genre locale="en-US">sci-fi</Genre>
</Genres>
TV番組や映画のコンテンツを表す画像。画像はJPG形式またはPNG形式である必要があります(JPG推奨)。TV番組、シーズン、エピソードの場合、サイズは幅853ピクセル×高さ480ピクセル以上、縦横比は16:9の画像を使用してください。必要に応じてサイズ変更できるよう、大きいサイズの画像をお勧めします。幅853ピクセル×高さ480ピクセル未満の画像、または縦横比が16:9以外の画像は使用されません。そのような場合は、代わりに別の画像ソース(IMDbなど)やプレースホルダー画像が使用されます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Images |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、無制限) |
属性 | なし |
<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>
TV番組や映画のコンテンツを表す画像。画像サイズの詳細については、Image
を参照してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) |
属性 | なし |
<Movie>
...
<Images>
<Image>
<Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url>
</Image>
</Images>
...
</Movie>
作品の識別子となる文字列。この値は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>
作品の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>
18歳以上の視聴者を対象とした、日本市場向けのコンテンツとしてマークします。このフラグをtrueに設定した場合、日本におけるそのコンテンツの視聴者は、日本の法的要件に従って18歳以上であることを確認する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | boolean |
<Movie>
...
<JP_Require18PlusAgeConfirmation>true</JP_Require18PlusAgeConfirmation>
</Movie>
作品が最初に制作された言語。音声言語を指す場合と、サイレント作品の画面上に表示されるテキスト言語を指す場合とがあります。指定できるLanguage
要素は各作品につき1つだけです。吹き替えオプションを指定する場合は、AudioLanguage
も使用します。言語なしでカタログを申請することは可能ですが、特に複数の言語で利用できるコンテンツがある場合は、ベストプラクティスとしてコンテンツの言語を追加することを強くお勧めします。Amazon側でコンテンツを適切な言語にマッチングできるように、コンテンツの各バージョンの言語を指定する必要があります。
言語が異なる複数の地域でコンテンツを提供する場合は、言語ごとにローカライズされたコンテンツを提供する必要があります。たとえば、日本で英語の映画を提供する場合は、その日本語バージョンを提供する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | language |
<Movie>
...
<Language>ja</Language>
...
</Movie>
作品の特定の視聴方法で利用できるビデオ画質、音声言語、字幕オプションを指定する要素を含んでいます。LaunchDetails
に含まれるLaunchId
という要素(省略可能)を使用すると、あらかじめ決まった画質、言語、字幕の構成で作品の再生を開始できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、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
に決まった形式はありませんが、開発者のアプリのロジックで確実に認識できる形式にしてください。各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>
画像の言語。画像サイズの詳細については、Image
を参照してください。
locale
要素を追加すると、コンテンツが複数の言語や地域で適切にマッチングされます。プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
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
は、CustomerRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | decimal(正の値) |
<CustomerRating>
<Score>8.2</Score>
<MaxValue>10</MaxValue>
<Count>512</Count>
</CustomerRating>
視聴者がメタデータ情報を利用できるようになる日付。この情報を含めると、マッチングが向上します。MetadataAvailabilityDate
はWindowStart
と同じですが、MetadataAvailabilityDate
を指定すると、再生ボタンが非表示になると同時に、コンテンツに関連付けられたメタデータも指定の日付まで非表示になります。MetadataAvailabilityDate
とWindowStart
を組み合わせて使用すると、プレミア時に情報が表示されます(「高い城の男」のプレミアなど)。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 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>
長編映画を表しますが、短編映画にも使用できます。作品は劇場向けの映画でも、テレビ用の映画でも構いません。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、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>
作品に関連付けられます。作品のキャストまたはクルーの名前です。キャストの場合は、役柄の名前ではなく、その俳優の名前です。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
CastMember CrewMember |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string(ローカライズ) |
<CastMember>
<Name locale="en-US">Alan Smithee</Name>
...
</CastMember>
視聴者が特定の作品を再生できる方法(無料、サービスの定期購入、レンタル、購入のいずれか)を表します。指定できるOffers
要素は作品タイプごとに1つのみで、そのOffers
要素には少なくとも1つの視聴方法タイプを追加する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – choice。いずれかの子要素が必要です(両方は指定できません)。 |
子要素 | (必須、1つ指定可能) (必須、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>
作品が最初にテレビで放送された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYear
と一致している必要があります。この情報は、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
TvEpisode TvSpecial |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | dateTime |
<TvSpecial>
...
<OriginalAirDate>2012-05-13T00:00:00</OriginalAirDate>
</TvSpecial>
このカタログのプロバイダーを識別します。決められた形式はありませんが、人が判読できる形式にすることをお勧めします。たとえば、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>
作品の画質を表します。標準解像度(SD
)、高解像度(HD
)、超高解像度(UHD
)があります。1つの作品を複数の画質オプションで提供できます。
Quality
という名前の要素は2つ存在します。1つは各視聴方法タイプの直接の子要素で、これはCDF v1.2で廃止されました。もう1つはLaunchDetails
の子要素で、各視聴方法タイプの孫要素になります。ここで取り上げるのは、新しい(廃止されていない)方のQuality
要素です。ただし両者の違いは親要素のみで、形式と内容は同じです。プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
LaunchDetails |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型: SD 、HD 、UHD |
<FreeOffer>
<Regions>
<Country>US</Country>
</Regions>
<LaunchDetails>
<Quality>HD</Quality>
<Quality>UHD</Quality>
</LaunchDetails>
</FreeOffer>
カタログ内のほかのアイテムに対する相対的な数値で人気を示したスコアです。最高ランクは1として定義されます。ランクの決め方は自由です。複数のアイテムに同じランクを割り当ててもかまいません。1つの作品に割り当てることのできるRank
要素は1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<TvShow>
...
<Rank>36</Rank>
...
</TvShow>
特定の視聴方法が利用できる国を表します。指定できるRegions
要素は各視聴方法タイプにつき1つだけです。
⚠重要! 2021年8月31日以降、このフィールドの「US」には米国の海外領土は含まれなくなります。これらの海外領土で視聴方法を利用できるようにするには、対象とする地域を明示的に追加してください。実装については、以下の例を参照してください。
米国の海外領土コードの例:
米領ヴァージン諸島(USVI)=VI、グアム=GU、プエルトリコ=PR、マリアナ諸島=MP
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) |
属性 | なし |
<FreeOffer>
<Regions>
<Country>US</Country>
<Country>CA</Country>
<Country>MX</Country>
</Regions>
</FreeOffer>
Extra
(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。外部ソース(IMDbなど)の分類に基づくほかの作品(映画など)を判別するための識別子は、RelatesToExternalID
で指定します。RelatesToExternalID
は、関連付けられている作品が同じカタログに存在しない場合に使用します。関連付けはRelatesToID
またはRelatesToExternalID
を使用して指定できますが、両方を使用することはできません。RelatesToExternalID
は、RelatesToID
が存在しない場合にのみ使用します。
RelatesToExternalID
とExternalID
を混同しないでください。ExternalID
はExtra
そのものを指すのに対し、RelatesToExternalID
はそれに関連付けられている作品を指します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
|
データ型 | 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>
Extra
(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。このID
の作品が、このExtra
と同じカタログに存在している必要があります。関連付ける作品はRelatesToID
またはRelatesToExternalID
を使用して指定できますが、両方を使用することはできません。関連付ける作品がカタログに存在する場合は、必ずRelatesToID
を使用します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
<TvShow>
<ID>TV123456</ID>
...
</TvShow>
<Extra>
...
<Type>trailer</Type>
<RelatesToID>TV123456</RelatesToID>
</Extra>
作品が最初に一般公開(テレビの場合は初回放映)された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYear
と一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | dateTime |
<TvShow>
...
<ReleaseDate>2012-05-13T00:00:00</ReleaseDate>
</TvShow>
省略可能ですが、指定することを強く推奨します。作品が最初に一般公開(テレビの場合は初回放映)された年。この値は、同じ作品のReleaseDate
またはOriginalAirDate
要素に指定されている年と一致している必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<TvEpisode>
...
<ReleaseYear>1959</Releaseyear>
...
</TvEpisode>
作品の中で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>
コンテンツ全体の実行時間(分単位)。通常は、2880よりも小さい正の数です。まれに2880を超えることもあります。指定できるRuntimeMinutes
要素は各作品につき1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<TvEpisode>
...
<RuntimeMinutes>37</RuntimeMinutes>
...
</TvEpisode>
視聴者のフィードバックに基づく作品の平均スコア(評価)。この値の収集方法は自由です。レーティングシステムの尺度となるMaxValue
に応じて決めてください。スコアに寄与した投票の数を表すCount
(省略可能)を追加することもできます。CustomerRating
に指定できるScore
は1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
CustomerRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | decimal(正の値) |
<CustomerRating>
<Score>8.2</Score>
<MaxValue>10</MaxValue>
<Count>512</Count>
</CustomerRating>
TVEpisode
を含んでいるシーズンのID。このID
のTVSeason
が、このTvEpisode
と同じカタログに存在している必要があります。シーズンはSeasonID
またはSeasonInShow
を使用して指定できますが、両方を使用することはできません。該当するシーズンがカタログに存在する場合は、必ずSeasonID
を使用します。存在しない場合は、TvSeason
項目の作成を検討してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
<TvSeason>
<ID>SEA-2329880</ID>
...
</TvSeason>
<TvEpisode>
...
<SeasonID>SEA-2329880</SeasonID>
...
</TvEpisode>
TVEpisodeを含んでいるシーズンの番号。そのシーズンがカタログに含まれていない場合に使用されます。SeasonInShow
は単にUIで使用される番号であり、何かと一致している必要はありません。シーズンはSeasonID
またはSeasonInShow
を使用して指定できますが、両方を使用することはできません。SeasonInShow
はSeasonID
が存在しない場合にのみ使用します(ごくまれなケースです)。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<TvEpisode>
...
<SeasonInShow>2</SeasonInShow>
...
</TvEpisode>
TvEpisode
が従属するシーズンのタイトル(「Season 2」など)。対応するTvSeason
要素がカタログに含まれている場合、必ずしもこの値をそのTitle
と一致させる必要はありません。指定できるSeasonTitle
は、TvEpisode
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string(ローカライズ) |
<TvEpisode>
...
<SeasonInShow>2</SeasonInShow>
<SeasonTitle locale="en-US">Season 2</SeasonTitle>
...
</TvEpisode>
作品の内容についての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>
TvEpisode
、TvSeason
、TvSpecial
をカタログ内の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>
TvEpisode
、TvSeason
、TvSpecial
をカタログ内のTvShow
に関連付けるために使用します。この値は単にUIで使用される文字列であり、カタログ内のタイトルと一致している必要はありません。番組はShowID
またはShowTitle
を使用して指定できますが、両方を使用することはできません。ShowTitle
は、ShowID
が存在しない場合にのみ使用します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvSeason TvEpisode TvSpecial |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string(ローカライズ) |
<TvSeason>
...
<ShowTitle locale="en-US">Depth of Field</ShowTitle>
...
</TvSeason>
作品の提供元。指定できるSource
は各作品につき1つだけです。オプションは次のとおりです。
original
: このカタログのプロバイダーによって製作・制作されたコンテンツ。licensed
: このカタログのプロバイダーがサードパーティからライセンスを取得した作品。unknown
: 提供元が不明なコンテンツ。other
: 提供元は判明しているがoriginalにもlicensedにも該当しない作品。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型:original 、licensed 、unknown 、other |
<TvEpisode>
...
<Source>licensed</Source>
...
</TvEpisode>
作品が制作されたスタジオ。Studio
項目は、1つの作品に複数割り当てることができます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Studios |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
<TvEpisode>
...
<Studios>
<Studio>Amazon Studios</Studio>
<Studio>Another Production Company</Studio>
</Studios>
...
</TvEpisode>
作品が制作されたスタジオを識別するStudio
要素を含んでいます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (省略可能、無制限) |
属性 | なし |
<TvEpisode>
...
<Studios>
<Studio>Amazon Studios</Studio>
<Studio>Another Production Company</Studio>
</Studios>
...
</TvEpisode>
プロバイダーのサービスの会員が作品を視聴できます。必要に応じて、Offers
に複数のSubscriptionOffer
要素を追加できます。SubscriptionOffer
は2つある視聴方法タイプのうちの1つです。重要: SubscriptionOffer
要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、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>
作品の字幕の言語オプション。字幕オプションは、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
は、ShortDescription
よりも詳しい情報を提供するための要素です。ShortDescription
や作品のTitle
をSynopsis
として使用することは避けてください。ローカライズされた説明を提供するため、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
は各評価につき1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
ContentRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
<ContentRatings>
<ContentRating>
<System>MPAA</System>
<Certification>G</Certification>
</ContentRating>
</ContentRatings>
作品のタイトル。ローカライズされたタイトルを提供するために、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>
TvShow
の単一のエピソード。通常、TvSeason
にも関連付けられます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、ShowID とShowTitle は一方のみ必要で、両方は指定できません。また、SeasonID とSeasonInShow も一方のみ必要で、両方は指定できません。
|
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、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
は基本的な作品タイプの1つで、TvShow
の単一のシーズンを表します。TvEpisode
のSeasonID
値がそのTvSeason
のID
と同じである場合、そのエピソードがそのシーズンに属していることを表します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、ShowID とShowTitle は一方のみ必要で、両方は指定できません。
|
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (必須、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>
シーズンとエピソードから成るテレビシリーズ。通常の一連のエピソードとは別に特別番組に関連付けられる場合もあります。TvSeason
、TvEpisode
、TvSpecial
のShowID
値がそのTvShow
のIDと同じである場合、そのシーズン、エピソード、特別番組はそのTvShowに属していることを表します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、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>
テレビで放送されるイベントのうち、番組-シーズン-エピソードという従来のテレビ階層には該当しないイベント。1回限りのイベント(休日特番など)のほか、各エピソードにエピソード番号ではなく一意の放映日が割り当てられている番組(ニュース番組など)が該当します。TvSpecial
は、TvShow
に関連付けることができるほか(ただしTvSeason
への関連付けは不可)、単発の番組として存在する場合もあります。また、授賞式関連の番組や、テレビコンサート、回顧録も該当します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、ShowID とShowTitle は一方のみ必要で、両方は指定できません。
|
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、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>
Extra
をトレーラー(プレビュー)またはクリップとして指定します。Extra
が関連付けられているMovie
のメイキングドキュメンタリーのように大規模なものもありますが、トレーラー以外はすべてクリップと見なして構いません。指定できるType
は、Extra
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型:clip 、trailer |
<Extra>
...
<Type>trailer</Type>
...
</Extra>
画像の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
は各視聴方法につき1つだけです。WindowStart
とWindowEnd
を使用して、その視聴方法を利用できる期間を指定できます。WindowEnd
で指定した期限を過ぎると、対象の視聴者にはその視聴方法が表示されなくなります。すべての視聴方法の期限が切れると、作品そのものが表示されなくなります。WindowStart
とWindowEnd
を個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。
WindowStart
のみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。WindowEnd
のみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。WindowStart
とWindowEnd
の両方を指定した場合: 指定された期間のみ作品を視聴できます。WindowStart
もWindowEnd
も指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 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
とWindowEnd
を使用して、その視聴方法を利用できる期間を指定できます。その期間の前後は、その視聴方法が視聴者に表示されません。その時点で利用できる視聴方法がなければ、作品そのものが表示されなくなります。指定できるWindowStartは各視聴方法につき1つだけです。WindowStart
とWindowEnd
を個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。
WindowStart
のみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。WindowEnd
のみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。WindowStart
とWindowEnd
の両方を指定した場合: 指定された期間のみ作品を視聴できます。WindowStart
もWindowEnd
も指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 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>
カタログ内の個々の項目(映画、TV番組、シーズン、特別番組、ミニシリーズ、エピソード、トレーラーやクリップ)がすべて格納されます。個々のカタログファイルには、Works
要素が1つ存在している必要があります。Works
要素には、作品の項目を必要に応じていくつでも追加できます。また、各タイプも必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Catalog |
コンテンツモデル | contentType — sequenceおよびchoice。Works 要素には任意の子要素を必要に応じて含めることができ、その子要素は任意の順序で複数回指定できます。
|
子要素 | (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) |
属性 | なし |
<Catalog>
<Partner>Everything Ever Made Filmworks</Partner>
<Works>
...
</Works>
</Catalog>
廃止された要素
以下の要素は廃止されました。廃止された要素がカタログデータファイルに含まれていても、カタログは却下されません。ただし、マッチングを改善するには、カタログファイルからこれらの要素を削除する必要があります。
- Duration
- ImageUrl
- EpisodeInSeries
- MiniSeries
- MiniSeriesEpisode
- MiniSeriesID
- MiniSeriesTitle
- PurchaseOffer
Duration
要素は、RentalOffer
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
RentalOffer |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<RentalOffer>
...
<Duration>120</Duration>
</RentalOffer>
Images
を使用してください。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>
MiniSeries
の説明を参照してください。EpisodeInSeries
要素は、MiniSeriesEpisode
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
MiniSeriesEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
<MiniSeriesEpisode>
...
<EpisodeInSeries>13</EpisodeInSeries>
...
</MiniSeriesEpisode>
TvEpisode
を使用してください。MiniSeries
内でシーズンを宣言していない場合は、SeasonID
またはSeasonInShow
を追加して、このシーズン情報を含める必要があります。MiniSeries
に指定できるエピソードの数に明示的な制限はありませんが、常識的な数のエピソードに限定してください。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、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>
MiniSeries
の説明を参照してください。MiniSeriesEpisode
は基本的な作品タイプの1つで、MiniSeries
内の単一のエピソードを表します。このコンテンツはシーズンには関連付けられず、MiniSeries
との関連で順序付けされます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。ただし、ShowID とShowTitle は一方のみ必要で、両方は指定できません。MiniSeriesIDとMiniSeriesTitle も一方のみ必要です。
|
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) (省略可能、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>
MiniSeries
の説明を参照してください。ID
のMiniSeries
が、このMiniSeriesEpisode
と同じカタログに存在している必要があります。ミニシリーズはMiniSeriesID
またはMiniSeriesTitle
を使用して指定できますが、両方を使用することはできません。カタログにミニシリーズが存在する場合は、必ずMiniSeriesID
を使用します。カタログに存在しない場合は、MiniSeries
項目を作成して使用することをお勧めします。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
MiniSeriesEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
<MiniSeries>
<ID>MS-2329880</ID>
...
</MiniSeries>
</MiniSeriesEpisode>
...
<MiniSeriesID>MS-2329880</MiniSeriesID>
<EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
MiniSeries
の説明を参照してください。MiniSeriesTitle
は単にUIに使用される文字列であり、カタログ内の既存のタイトルと一致している必要はありません。ミニシリーズはMiniSeriesID
またはMiniSeriesTitle
を使用して指定できますが、両方を使用することはできません。MiniSeriesTitle
はMiniSeriesID
が存在しない場合にのみ使用します(ごくまれなケースです)。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
MiniSeriesEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string(ローカライズ) |
<MiniSeriesEpisode>
...
<MiniSeriesTitle>Cats, The Most Beautiful Creature</MiniSeriesTitle>
<EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>
Offers
に複数のPurchaseOffer
要素を追加できます。PurchaseOffer
は2つある視聴方法タイプのうちの1つです。重要: PurchaseOffer
要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。現時点では、Fire TVはディスプレイ内のPurchaseOffer情報に対して何も行いません。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、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>
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
PurchaseOffer RentalOffer |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | xsd:float |
<PurchaseOffer>
<Regions>
<Country>US</Country>
</Regions>
<Price currency="USD">1.99</Price>
</PurchaseOffer>
ReleaseDate
またはOriginalAirDate
を使用します。今後ReleaseCountryの情報は使用されません。作品のリリース先となる国または地域とリリース日を指定する要素を含んでいます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
<TvEpisode>
...
<ReleaseInfo>
<ReleaseDate>2002-02-20</ReleaseDate>
<ReleaseCountry>BT</ReleaseCountry>
</ReleaseInfo>
...
</TvEpisode>
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 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
(名前は同じですが、位置とデータ型が異なります)またはOriginalAirDate
を使用してください。作品が最初に一般公開(テレビの場合は初回放映)された日付。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYear
と一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
ReleaseInfo |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | dateTime |
<TvShow>
...
<ReleaseInfo>
<ReleaseDate>2012-05-13</ReleaseDate>
</ReleaseInfo>
</TvShow>
Offers
に複数のRentalOffer
要素を追加することができます。RentalOffer
は2つある視聴方法タイプのうちの1つです。重要: RentalOffer
要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。現時点では、Fire TVはディスプレイ内のRentalOffer
情報に対して何も行いません。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります。 |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (必須、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>