TvSeason要素
注: 説明図で要素のリンクをクリックすると、説明図の下にあるウィンドウがスクロールされ、その要素にフォーカスが移動します。
├── Partner └── Works ├── Movie ├── TvEpisode ├── TvSeason │ ├── ID │ ├── ExternalID │ ├── Titles │ │ └── Title │ ├── Copyright │ ├── Offers │ │ ├── SubscriptionOffer │ │ │ ├── Regions │ │ │ │ └── Territories │ │ │ ├── WindowStart │ │ │ ├── WindowEnd │ │ │ └── LaunchDetails │ │ │ ├── Quality │ │ │ ├── AudioLanguage │ │ │ ├── Subtitle │ │ │ └── LaunchId │ │ └── FreeOffer │ │ ├── Regions │ │ │ └── Territories │ │ ├── WindowStart │ │ ├── WindowEnd │ │ └── LaunchDetails │ │ ├── Quality │ │ ├── AudioLanguage │ │ ├── Subtitle │ │ └── LaunchId │ ├── IsAdultProducts │ │ └── IsAdultProduct │ ├── ReleaseYear │ ├── ShortDescriptions │ │ └── ShortDescription │ ├── Synopses │ │ └── Synopsis │ ├── MetadataAvailabilityDates │ │ └── MetadataAvailabilityDate │ ├── Images │ │ └── Image │ │ ├── Url │ │ └── Locale │ ├── Runtimes │ │ └── RuntimeMinutes │ ├── Color │ ├── Credits │ │ ├── CastMember │ │ │ ├── Name │ │ │ ├── ExternalID │ │ │ └── Role │ │ └── CrewMember │ │ ├── Name │ │ ├── ExternalID │ │ └── Job │ ├── Studio │ │ └── Studio │ ├── Language │ ├── CustomerRating │ │ ├── Score │ │ ├── MaxValue │ │ └── Count │ ├── Rank │ ├── IsOriginals │ │ └── IsOriginal │ ├── Genres │ │ └── Genre │ ├── ContentRatings │ │ └── ContentRating │ │ ├── System │ │ └── Certification │ ├── ShowID │ ├── ShowTitle │ └── SeasonInShow ├── TvShow └── Extra
<?xml version="1.0" encoding="utf-8" ?> <Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.11"> <!-- このAmazon Fire TVサンプルカタログでは、TvSeason作品タイプの使用方法を示します。例として、必要最小限の情報から省略可能なすべての要素の指定まで、さまざまなタグ付けを使用しています。最後の例には、どの要素が必須で、どの要素が省略可能であるかに関する情報が含まれています。--> <!-- ほとんどの要素はすべての作品タイプで同じですが、最後の1~3個の要素だけがタイプによって異なります。ここで適用される内容の多くは、ほかの作品タイプにも適用されます。--> <Partner>Everything Ever Made Filmworks</Partner> <Works> <!-- この例では、有効なエントリに必要な最小限の情報を提供します。有効であっても、ユーザーが検索や閲覧でこの作品を見つけるのは難しい場合があります。メタデータをより多く指定することで、見つけやすさが向上します。--> <TvSeason> <ID>TVS2329880</ID> <Title locale="en-US">Season Five</Title> <Offers> <SubscriptionOffer> <Regions> <Country>US</Country> </Regions> <WindowStart>2012-08-04T17:18:37-09:00</WindowStart> <Windowend>2018-06-09T06:15:04-09:00</WindowEnd> </SubscriptionOffer> </Offers> <ShowID>ABC-123457</ShowID> <SeasonInShow>5</SeasonInShow> </TvSeason> <!-- このエントリでは、省略可能な情報をいくつか追加して、作品の見つけやすさを向上させます。この場合、主役の名前を検索して作品を見つけることができるようになります。また、ユーザーは作品を見つけた後にその紹介文を読むことができます。--> <TvSeason> <ID>TVS234567</ID> <!-- 省略可能 --> <ExternalID scheme="imdb">tt0000000</ExternalID> <Title locale="en-US">Season Six</Title> <Offers> <SubscriptionOffer> <Regions> <Country>US</Country> <Country>FR</Country> <Country>BE</Country> </Regions> <!-- 省略可能 --> <LaunchDetails> <Quality>HD</Quality> </LaunchDetails> </SubscriptionOffer> </Offers> <!-- 省略可能 --> <ShortDescription locale="en-US">The family moves to the suburbs, trying to maintain their culture and traditions while assimilating into the new way of life.New friends are made and old friends come visiting.</ShortDescription> <!-- 省略可能 --> <RuntimeMinutes>390</RuntimeMinutes> <!-- 省略可能 --> <Credits> <CastMember> <Name locale="en-US">Alan Smithee</Name> <ExternalID scheme="imdb">nm0000000</ExternalID> <Role locale="en-US">Big Gus</Role> </CastMember> </Credits> <ShowID>ABC-123457</ShowID> <SeasonInShow>6</SeasonInShow> </TvSeason> <!-- このエントリでは、使用可能なすべての情報を提供します。各要素が必須か省略可能かのほか、特定の項目の有効な値や、使用上の注意事項についてのコメントが記載されています。--> <TvSeason> <!-- 必須。IDは1文字以上で、カタログ内で一意である必要があります。--> <ID>TVS123457</ID> <!-- 省略可能。複数のインスタンスを使用できます。存在する場合、scheme属性が必須です(有効な値:imdb、tms、isan、ean、upc)。--> <ExternalID scheme="imdb">tt3012532</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> <!-- 必須(locale属性も必須です)。複数のインスタンスを使用できますが、localeごとに1つだけです。--> <Title locale="en-US">Season 2</Title> <!-- 省略可能。1つのインスタンスのみ。存在する場合、locale属性が必須です。--> <Copyright locale="en-US">© 2015 Amazon Studios</Copyright> <!-- 必須。1つのインスタンスのみ。--> <Offers> <!-- 次の2つの視聴方法タイプから選択できます: FreeOfferまたはSubscriptionOffer。--> <!-- 少なくとも1つの視聴方法を指定する必要があります。--> <SubscriptionOffer> <!-- 必須。1つのインスタンスのみ。--> <Regions> <!-- 少なくとも1つのCountryが必須です。--> <Country>US</Country> <Country>CA</Country> </Regions> <!-- 省略可能。1つのインスタンスのみ。--> <WindowStart>2015-07-02T12:00:00</WindowStart> <!-- 省略可能。1つのインスタンスのみ。--> <WindowEnd>2020-07-02T12:00:00</WindowEnd> <!-- 省略可能。複数のインスタンスを使用して異なるLaunchIdを指定できます。--> <LaunchDetails> <!-- 省略可能。有効な値は、SD、HD、UHDです。複数のインスタンスを使用して異なる画質を指定できます。--> <Quality>HD</Quality> <!-- 省略可能。複数のインスタンスを使用して異なる音声言語を指定できます。--> <AudioLanguage>en-US</AudioLanguage> <!-- 省略可能。複数のインスタンスを使用して異なる字幕言語を指定できます。--> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <!-- 省略可能。各LaunchDetails要素で指定できるLaunchIdは1つだけです。--> <LaunchId>TVS123457_SD_en</LaunchId> </LaunchDetails> <LaunchDetails> <Quality>SD</Quality> <AudioLanguage>en-US</AudioLanguage> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <LaunchId>TVS123457_SD_en_es</LaunchId> </LaunchDetails> </SubscriptionOffer> <FreeOffer> <!-- 必須。1つのインスタンスのみ。--> <Regions> <!-- 少なくとも1つのCountryが必須です。--> <Country>AS</Country> <Country>GU</Country> <Country>MP</Country> <Country>UM</Country> </Regions> <!-- 省略可能。1つのインスタンスのみ。--> <WindowStart>2015-07-02T12:00:00</WindowStart> <!-- 省略可能。1つのインスタンスのみ。--> <WindowEnd>2020-07-02T12:00:00</WindowEnd> <!-- 省略可能。複数のインスタンスを使用して異なるLaunchIdを指定できます。--> <LaunchDetails> <!-- 省略可能。有効な値は、SD、HD、UHDです。複数のインスタンスを使用して異なる画質を指定できます。--> <Quality>SD</Quality> <!-- 省略可能。複数のインスタンスを使用して異なる音声言語を指定できます。--> <AudioLanguage>en-US</AudioLanguage> <!-- 省略可能。複数のインスタンスを使用して異なる字幕言語を指定できます。--> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <!-- 省略可能。各LaunchDetails要素で指定できるLaunchIdは1つだけです。--> <LaunchId>TVS123457_SD_en</LaunchId> </LaunchDetails> <LaunchDetails> <Quality>SD</Quality> <AudioLanguage>en-US</AudioLanguage> <Subtitle>fr</Subtitle> <Subtitle>es</Subtitle> <Subtitle>ja</Subtitle> <LaunchId>TVS123457_SD_en_es</LaunchId> </LaunchDetails> </FreeOffer> </Offers> <!-- 省略可能(指定することを強く推奨)。1つのインスタンスのみ。この要素は省略可能ですが、指定することを推奨します。この値は、この作品をほかのプロバイダーの同じ作品と一致させて、すべての視聴方法を1つの検索結果にまとめるために使用します。--> <ReleaseYear>2015</ReleaseYear> <!-- 省略可能。存在する場合、locale属性が必須です。複数のインスタンスを使用できますが、localeごとに1つだけです。--> <ShortDescription locale="en-US">Eleven-year old Anne builds androids.Nick discovers Anne's secret lab and, with Shania, befriends Anne.Together they solve scientific problems through real-life solutions.</ShortDescription> <!-- 省略可能。存在する場合、locale属性が必須です。複数のインスタンスを使用できますが、localeごとに1つだけです。--> <Synopsis locale="en-US">Eleven-year old genius and kid-scientist Anne has invented and built her own amazing androids.Nick discovers Anne's secret junkyard laboratory and enlists the help of Shania to befriend Anne and her mechanical companions.Together they help solve Anne's scientific problems through real-life solutions.</Synopsis> <!-- 省略可能(ただし推奨)。1つのインスタンスのみ。エントリの50%以上でこの要素を指定する必要があり、その参照先の画像が有効である必要があります。--> <Images> <Image> <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url> </Image> </Images> <!-- 省略可能。1つのインスタンスのみ。統合レポートに警告が表示されないようにするには、値を2880以下にする必要があります。--> <RuntimeMinutes>318</RuntimeMinutes> <!-- 省略可能。1つのインスタンスのみ。有効な値は、colorおよびblack_and_whiteです。--> <Color>color</Color> <!-- 省略可能。1つのインスタンスのみ。CastMemberまたはCrewMemberを少なくとも1つは指定する必要があります。--> <Credits> <!-- CrewMember要素が1つでも存在する場合は省略可能、それ以外の場合は必須。複数のインスタンスを使用できます。--> <CastMember> <!-- 必須。locale属性も必須です。複数のインスタンスを使用できます。--> <Name locale="en-US">Addison Holley</Name> <!-- 省略可能。複数のインスタンスを使用できます。存在する場合、scheme属性が必須です(有効な値:imdb、tms、isan、ean、upc)。--> <ExternalID scheme="imdb">nm3204147</ExternalID> <!-- 必須。locale属性も必須です。複数のインスタンスを使用できます。--> <Role locale="en-US">Anne</Role> </CastMember> <CastMember> <Name locale="en-US">Jadiel Dowlin</Name> <ExternalID scheme="imdb">nm6636855</ExternalID> <Role locale="en-US">Nick</Role> </CastMember> <!-- CastMember要素が1つでも存在する場合は省略可能、それ以外の場合は必須。複数のインスタンスを使用できます。--> <CrewMember> <!-- 必須。locale属性も必須です。複数のインスタンスを使用できます。--> <Name locale="en-US">J.J.Johnson</Name> <!-- 省略可能。複数のインスタンスを使用できます。存在する場合、scheme属性が必須です(有効な値:imdb、tms、isan、ean、upc)。--> <ExternalID scheme="imdb">nm1664945</ExternalID> <!-- 必須。locale属性も必須です。複数のインスタンスを使用できます。--> <Job locale="en-US">Writer</Job> <Job locale="en-US">Director</Job> </CrewMember> </Credits> <!-- 省略可能。1つのインスタンスのみ。--> <Studios> <!-- Studiosが存在する場合、Studioを1つ以上指定する必要があります。複数のインスタンスを使用できます。--> <Studio>Amazon Studios</Studio> <Studio>Sinking Ship Entertainment</Studio> </Studios> <!-- 省略可能。1つのインスタンスのみ。--> <Language>en</Language> <!-- 省略可能。1つのインスタンスのみ。--> <CustomerRating> <!-- 必須。1つのインスタンスのみ。--> <Score>7.3</Score> <!-- 必須。1つのインスタンスのみ。--> <MaxValue>10</MaxValue> <!-- 省略可能。1つのインスタンスのみ。--> <Count>135</Count> </CustomerRating> <!-- 省略可能。1つのインスタンスのみ。1が最上位のランクです。--> <Rank>3</Rank> <!-- 省略可能。1つのインスタンスのみ。有効な値は、original、licensed、unknown、otherです。--> <Source>original</Source> <!-- 省略可能。1つのインスタンスのみ。--> <Genres> <!-- Genresが存在する場合、Genreを1つ以上指定する必要があります。複数のインスタンスを使用できます。locale属性が必須です。--> <Genre locale="en-US">Family</Genre> </Genres> <!-- 省略可能。1つのインスタンスのみ。--> <ContentRatings> <!-- ContentRatingsが存在する場合、ContentRatingを1つ以上指定する必要があります。複数のインスタンスを使用できます。--> <ContentRating> <!-- 必須。1つのインスタンスのみ。--> <System>TV Parental Guidelines</System> <!-- 必須。1つのインスタンスのみ。--> <Certification>TV-G</Certification> </ContentRating> </ContentRatings> <!-- 省略可能。1つのインスタンスのみ。日本でのみ使用可能です。--> <JP_Require18PlusAgeConfirmation>false</JP_Require18PlusAgeConfirmation> <!-- ShowTitleが存在しない場合は必須。1つのインスタンスのみ。このタグはシーズンを指定の番組にリンクします。1つのインスタンスのみ。ShowIDまたはShowTitleのいずれかが存在する必要があります。このIDの番組が同じカタログに存在している必要があります。それ以外の場合は、ShowTitleを使用してください。--> <ShowID>TV098765</ShowID> <!-- 必須。1つのインスタンスのみ。--> <SeasonInShow>2</SeasonInShow> </TvSeason> </Works> </Catalog>
CDFファイルのルート要素。すべてのカタログファイルにはCatalog
要素が1つ必要で、この中にそのファイルの残りの要素が指定されます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 | なし |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 |
データ型: 列挙型。 列挙値: |
このカタログのプロバイダーを識別します。決められた形式はありませんが、人が判読できる形式にすることをお勧めします。たとえば、Amazonアプリストアに表示されるアプリ名をそのまま使用するのも1つの方法です。プロバイダーのフルネームを使用することもできます。個々のカタログファイルにPartner要素が1つ必要です。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Catalog |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
カタログ内の個々の項目(映画、TV番組、シーズン、特別番組、ミニシリーズ、エピソード、トレーラーやクリップ)がすべて格納されます。個々のカタログファイルには、Works
要素が1つ存在している必要があります。Works
要素には、作品の項目を必要に応じていくつでも追加できます。また、各タイプも必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Catalog |
コンテンツモデル | contentType — sequenceおよびchoice。Works 要素には任意の子要素を必要に応じて含めることができ、その子要素は任意の順序で複数回指定できます。
|
子要素 | (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) |
属性 | なし |
長編映画を表しますが、短編映画にも使用できます。作品は劇場向けの映画でも、テレビ用の映画でも構いません。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
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つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
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つ指定可能) (必須、1つ指定可能) (必須、1つ指定可能) |
属性 | なし |
シーズンとエピソードから成るテレビシリーズ。TvSeason
またはTvEpisode
のShowID
がTvShow
のIDと同じ値である場合、そのシーズンまたはエピソードは当該番組に属していることを表します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Works |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (省略可能、無制限) (必須、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
クリップ。単発の作品の場合もありますが、通常はほかの作品(外部の作品またはカタログ内の別の作品)に関連付けられます。一般に、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つ指定可能) (必須、1つ指定可能) (必須、無制限) |
属性 | なし |
作品の識別子となる文字列。この値は1文字以上とし、カタログに存在するすべてのIDにおいて一意である必要があります。同じIDの作品が2つ存在すると、統合システムによってカタログが却下されます。IDの決め方に方針を設け、重複を防ぐようにしてください。たとえば、パートナーID+作品タイプ+十分な長さを持った識別子(GUIDなど)をIDとして使用することが考えられます(例:AmazonStudios_ Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf
)。カタログ内でIDの一意性を確保できれば、どのような方針でもかまいません。
IDを作成するときは、次の2点に注意してください。
- 既存のカタログをアップデートする際、作品のIDは変更しないでください。カタログからIDが消えた場合、Amazonではその作品がサービス上で利用できなくなったものと判断し、Amazonのインデックスから削除します。後で作品を元に戻す場合は、以前と同じIDを使用する必要があります。統合後にIDの作成方針を変更すると、ユーザーエクスペリエンスに悪影響を及ぼす可能性があります。
- IDで使用できる文字は、ピリオド(.)、ハイフン(-)、+、0~9、A~Z、a~zのみです。URIを使用してアプリを起動する場合は、LaunchDetailsブロック(Offersのプロパティ)の中でLaunchIDを使用してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | NonEmptyToken |
外部ソース(IMDbなど)の分類に基づく作品の識別子。この値は、コンテンツのマッチングに使用されます。別のカタログ内の対応する値と比較し、作品や人物が同一であるかどうかを判断します。画像など外部コンテンツのソースとしても使用できます。外部IDを格納するExternalID
要素は、必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
CastMember CrewMember Extra Movie TvEpisode TvSeason TvShow |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: 列挙型。 列挙値:
データ型:string |
作品のタイトルが含まれます。各作品にTitles
要素を1つ含めることができます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | (必須、無制限) |
データ型 | string(ローカライズ) |
作品のタイトル。ローカライズされたタイトルを提供するため、1つの作品に複数のTitle
要素を追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Titles |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryStringType - locale 、pronunciation 、territories の各属性が追加されたstring。 |
作品の著作権表示。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
視聴者が特定の作品を再生できる方法(無料、サービスの定期購入、レンタル、購入のいずれか)を表します。指定できるOffers
要素は作品タイプごとに1つのみで、そのOffers
要素には少なくとも1つの視聴方法タイプを追加する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – choice。いずれかの子要素が必要です(両方は指定できません)。 |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 | なし |
プロバイダーのサービスの会員が作品を視聴できます。必要に応じて、Offers
に複数のSubscriptionOffer
要素を追加できます。SubscriptionOffer
は2つある視聴方法タイプのうちの1つです。重要: SubscriptionOffer
要素は省略可能ですが、Offersには少なくとも1つの視聴方法タイプが必要です。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
特定の視聴方法が利用できる国を表します。指定できるRegions
要素は各視聴方法タイプにつき1つだけです。
⚠重要! 2021年8月31日以降、このフィールドの「US」には米国の海外領土は含まれなくなります。これらの海外領土で視聴方法を利用できるようにするには、対象とする地域を明示的に追加してください。実装については、以下の例を参照してください。
米国の海外領土コードの例:
米領ヴァージン諸島(USVI)=VI、グアム=GU、プエルトリコ=PR、マリアナ諸島=MP
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | complexType – choice。いずれかの子要素が必要です(両方は指定できません)。 |
子要素 | (必須、1つ指定可能) |
属性 | なし |
特定の視聴方法が利用できる国、地域、または海外領土のコンマ区切りリスト。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Regions |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
特定の視聴方法で作品が視聴できるようになる日時。WindowStart
とWindowEnd
を使用して、その視聴方法を利用できる期間を指定できます。その期間の前後は、その視聴方法が視聴者に表示されません。その時点で利用できる視聴方法がなければ、作品そのものが表示されなくなります。指定できるWindowStartは各視聴方法につき1つだけです。WindowStart
とWindowEnd
を個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。
WindowStart
のみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。WindowEnd
のみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。WindowStart
とWindowEnd
の両方を指定した場合: 指定された期間のみ作品を視聴できます。WindowStart
もWindowEnd
も指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | dateTime |
特定の視聴方法で作品が視聴できなくなる日時。指定できるWindowEnd
は各視聴方法につき1つだけです。WindowStart
とWindowEnd
を使用して、その視聴方法を利用できる期間を指定できます。WindowEnd
で指定した期限を過ぎると、対象の視聴者にはその視聴方法が表示されなくなります。すべての視聴方法の期限が切れると、作品そのものが表示されなくなります。WindowStart
とWindowEnd
を個別に、または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。
WindowStart
のみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。WindowEnd
のみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。WindowStart
とWindowEnd
の両方を指定した場合: 指定された期間のみ作品を視聴できます。WindowStart
もWindowEnd
も指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | dateTime |
作品の特定の視聴方法で利用できるビデオ画質、音声言語、字幕オプションを指定する要素を含んでいます。LaunchDetails
に含まれるLaunchId
という要素(省略可能)を使用すると、あらかじめ決まった画質、言語、字幕の構成で作品の再生を開始できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
SubscriptionOffer FreeOffer |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (省略可能、無制限) (省略可能、無制限) (省略可能、無制限) (省略可能、1つ指定可能) |
属性 | なし |
作品の画質を表します。標準解像度(SD
)、高解像度(HD
)、超高解像度(UHD
)があります。1つの作品を複数の画質オプションで提供できます。
Quality
という名前の要素は2つ存在します。1つは各視聴方法タイプの直接の子要素で、これはCDF v1.2で廃止されました。もう1つはLaunchDetails
の子要素で、各視聴方法タイプの孫要素になります。ここで取り上げるのは、新しい(廃止されていない)方のQuality
要素です。ただし両者の違いは親要素のみで、形式と内容は同じです。プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
LaunchDetails |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型: SD 、HD 、UHD |
複数の言語に吹き替えられた作品のオーディオオプション。AudioLanguage
要素は、その作品で利用できる吹き替え版を指定するために、必要に応じていくつでも追加できます。AudioLanguage
は省略可能ですが、吹き替えコンテンツではこの要素を指定することを強くお勧めします。AudioLanguage
を使用すると、適切な言語の字幕がコンテンツに表示されるようになります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
LaunchDetails |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | language |
作品の字幕の言語オプション。字幕オプションは、1つの作品に複数割り当てることができます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
LaunchDetails |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | language |
あらかじめ決まった画質、音声言語、字幕の構成で(またはそれらを一部組み合わせて)作品を再生するための識別子。LaunchId
に決まった形式はありませんが、開発者のアプリのロジックで確実に認識できる形式にしてください。各LaunchDetails
要素に追加できるLaunchId
は1つだけです。複数のLaunchId
を指定するには、複数のLaunchDetails
要素を追加する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
LaunchDetails |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
プロパティ | 詳細 |
---|---|
使用 | |
指定可能な数 | |
親要素 | |
コンテンツモデル | |
子要素 | |
属性 | |
データ型 |
作品をいつでも無料で視聴できます。無料で視聴できる期間を指定することもできます。必要に応じて、Offers
に複数のFreeOffer
要素を追加できます。重要: FreeOffer
要素は省略可能ですが、Offers
では少なくとも1つの視聴方法タイプを指定する必要があります。FreeOffer
は2つある視聴方法タイプのうちの1つです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Offers |
コンテンツモデル | complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、1つ指定可能) (省略可能、1つ指定可能) |
属性 | なし |
作品を成人向けコンテンツとして識別するための情報が含まれます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
成人向けコンテンツとして作品を識別します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
IsAdultProducts |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryBooleanType - territories 属性が追加されたboolean。 |
省略可能ですが、指定することを強く推奨します。作品が最初に一般公開(テレビの場合は初回放映)された年。この値は、同じ作品のReleaseDate
またはOriginalAirDate
要素に指定されている年と一致している必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
ロケールや国/地域ごとに、作品の内容を2~3行で説明します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
作品の内容についての2~3行の説明を指定します。ShortDescription
には、ほかの場所で確認できる情報(作品のタイトルなど)を指定しないでください。ローカライズされた説明を提供するため、1つの作品に複数のShortDescription
要素を追加できます。より長く詳しい説明を入力するには、Synopsis
要素を使用してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
ShortDescriptions |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryStringType - locale 、pronunciation 、territories の各属性が追加されたstring。 |
コンテンツの詳細な説明を指定します。ロケールや国/地域によって異なります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
作品の内容に関する説明。Synopsis
は、ShortDescription
よりも詳しい情報を提供するための要素です。ShortDescription
や作品のTitle
をSynopsis
として使用することは避けてください。ローカライズされた説明を提供するため、1つの作品に複数のSynopsis
要素を追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Synopses |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | TerritoryStringType - locale 、pronunciation 、territories の各属性が追加されたstring。 |
国や地域によって異なるMetadataAvailabilityDateが含まれます。国/地域の値を指定しないフィールドは、グローバルに適用されると見なされます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) |
属性 | なし |
視聴者がメタデータ情報を利用できるようになる日付。この情報を含めると、マッチングが向上します。MetadataAvailabilityDate
はWindowStart
と同じですが、MetadataAvailabilityDate
を指定すると、再生ボタンが非表示になると同時に、コンテンツに関連付けられたメタデータも指定の日付まで非表示になります。MetadataAvailabilityDate
とWindowStart
を組み合わせて使用すると、プレミア時に情報が表示されます(「高い城の男」のプレミアなど)。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
MetadataAvailabilityDates |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryDateTimeType - territories 属性が追加されたdateTime。 |
TV番組や映画のコンテンツを表す画像。画像サイズの詳細については、Image
を参照してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
TV番組や映画のコンテンツを表す画像。画像はJPG形式またはPNG形式である必要があります(JPG推奨)。TV番組、シーズン、エピソードの場合、縦横比16:9、サイズが幅853ピクセル×高さ480ピクセル以上の画像を使用してください。できるだけ大きい画像を使用することをお勧めします(最適なサイズは幅1920ピクセル×高さ1080ピクセル)。画像は必要に応じて拡大縮小されます。幅853ピクセル×高さ480ピクセル未満の画像、または縦横比が16:9以外の画像は使用できません。そのような場合は、代わりに別の画像ソース(IMDbなど)やプレースホルダー画像が使用されます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Images |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (省略可能、無制限) |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
画像のURL。画像サイズの詳細については、Image
を参照してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Image |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | anyURI |
画像の言語。画像サイズの詳細については、Image
を参照してください。
locale
要素を追加すると、コンテンツが複数の言語や地域で適切にマッチングされます。プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Image |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | language |
コンテンツ全体の再生時間を指定します。ロケールや国/地域によって異なります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
コンテンツ全体の再生時間(分単位)。通常は、2880より小さい正の数です。まれに2880を超えることもあります。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Runtimes |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryInteger - territories 属性が追加されたint。 |
映画が主にカラーであるか白黒であるかを指定します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型:color 、black_and_white |
作品のキャストとクルーを表す要素を含んでいます。同じ人物をキャストまたはクルーとして複数回指定できます。指定できるCredits
要素は各作品につき1つだけです。Credits
が存在する場合、CastMember
またはCrewMember
が少なくとも1つ必要です。いずれの要素も必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – choice。いずれかの子要素が必要です(両方は指定できません)。 |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 | なし |
作品のキャスト(俳優、ホスト、ナレーター、声優など)についての情報を指定します。Credits
要素(省略可能)が存在する場合、CastMember
またはCrewMember
のいずれかの項目を指定する必要があります。CastMember
要素は必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Credits |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) (省略可能、無制限) (省略可能、無制限) |
属性 | なし |
作品に関連付けられます。作品のキャストまたはクルーの名前です。キャストの場合は、役柄の名前ではなく、その俳優の名前です。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
CastMember CrewMember |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
外部ソース(IMDbなど)の分類に基づく作品の識別子。この値は、コンテンツのマッチングに使用されます。別のカタログ内の対応する値と比較し、作品や人物が同一であるかどうかを判断します。画像など外部コンテンツのソースとしても使用できます。外部IDを格納するExternalID
要素は、必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
CastMember CrewMember Extra Movie TvEpisode TvSeason TvShow |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: 列挙型。 列挙値:
データ型:string |
作品の中でCastMember
が演じる役柄の名前。たとえば、ロビン・フッド、湖のランスロ、アテナ、セルフなどと指定します。この値に「actor」や「unknown」は使用しないでください。CastMember
項目はすべて俳優(actor)です。1人で複数の役柄を演じている場合、CastMember
要素に複数のRole
要素を追加できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
CastMember |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:string
データ型:language |
データ型 | string(ローカライズ) |
作品の裏方のクルー(ディレクター、ライター、カメラマン、照明係第一助手、アニメーター、撮影助手など)に関する情報を表す要素を含んでいます。Credits
(省略可能)が存在する場合、CastMember
またはCrewMember
のいずれかの項目を指定する必要があります。CrewMember
要素は必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Credits |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) (省略可能、無制限) (必須、無制限) |
属性 | なし |
作品のCrewMember
の職種(ディレクター、カメラマン、ライター、アニメーターなど)。CrewMember
には、Job
要素を必要に応じていくつでも追加できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
CrewMember |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
作品が制作されたスタジオを識別するStudio
要素を含んでいます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode TvSpecial Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (省略可能、無制限) |
属性 | なし |
作品が制作されたスタジオ。Studio
項目は、1つの作品に複数割り当てることができます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Studios |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
作品が最初に制作された言語。音声言語を指す場合と、サイレント作品の画面上に表示されるテキスト言語を指す場合とがあります。指定できるLanguage
要素は各作品につき1つだけです。吹き替えオプションを指定する場合は、AudioLanguage
も使用します。言語なしでカタログを申請することは可能ですが、特に複数の言語で利用できるコンテンツがある場合は、ベストプラクティスとしてコンテンツの言語を追加することを強くお勧めします。Amazon側でコンテンツを適切な言語にマッチングできるように、コンテンツの各バージョンの言語を指定する必要があります。
言語が異なる複数の地域でコンテンツを提供する場合は、言語ごとにローカライズされたコンテンツを提供する必要があります。たとえば、日本で英語の映画を提供する場合は、その日本語バージョンを提供する必要があります。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | language |
作品に対する視聴者の評価の平均スコア、最大値、スコアに寄与した評価の数を表す要素を含んでいます。指定できるCustomerRating
要素は各作品につき1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) (省略可能、1つ指定可能) |
子要素に関する注意事項 | Count はCDF v1.2以降でのみ使用できます。 |
属性 | なし |
視聴者のフィードバックに基づく作品の平均スコア(評価)。この値の収集方法は自由です。レーティングシステムの尺度となるMaxValue
に応じて決めてください。スコアに寄与した投票の数を表すCount
(省略可能)を追加することもできます。CustomerRating
に指定できるScore
は1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
CustomerRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | decimal(正の値) |
作品に対する視聴者の評価として指定できる最高スコア。指定できるMaxValue
は、CustomerRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | decimal(正の値) |
視聴者の評価スコア(Score
)に寄与したユーザーの数。指定できるCount
は、CustomerRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
CustomerRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | long(負数以外) |
カタログ内のほかのアイテムに対する相対的な数値で人気を示したスコアです。最高ランクは1として定義されます。ランクの決め方は自由です。複数のアイテムに同じランクを割り当ててもかまいません。1つの作品に割り当てることのできるRank
要素は1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
アイテムがプロバイダーのオリジナルかどうかを指定します。コンテンツのオリジナリティは国や地域によって異なります。たとえば、日本とカナダ以外では、Prime Videoオリジナルとして配信される映画などが考えられます。この要素を使用すると、全世界に適用される設定とはオリジナリティが異なる国/地域を指定できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
アイテムがプロバイダーのオリジナルかどうかを表します。コンテンツのオリジナリティは国や地域によって異なります。たとえば、日本とカナダ以外では、Prime Videoオリジナルとして配信される映画などが考えられます。この要素を使用すると、全世界に適用される設定とはオリジナリティが異なる国/地域を指定できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
IsOriginals |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryBooleanType - territories 属性が追加されたboolean。 |
作品のカテゴリー(コメディー、ホラー、ドキュメンタリーなど)を表す1つ以上のGenre
タグを格納します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
作品のジャンル(コメディー、ホラー、ドラマ、ドキュメンタリーなど)。必要に応じて、1つの作品に複数のGenre
要素を指定できます。検索とマッチングの機能を最大限に活かすため、できる限り標準的なジャンル名を使用してください。複数の説明を組み合わせて1つの文字列にするのではなく複数のGenre
タグを使用してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Movie |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
特定の認定機関によって作品に与えられた公式な評価が指定されます。ContentRatings
要素は、作品ごとに1つのみ指定できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow TvSeason TvEpisode Extra |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
レーティングシステム(評価機関)およびそのシステムで作品に与えられた評価を指定する要素を含んでいます。ContentRatings
(省略可能)が存在する場合、ContentRating
を1つ以上指定する必要があります。ContentRating
要素は必要に応じていくつでも追加できます(システム/評価の組み合わせごとに1つ)。ContentRatings
は、 米国、ブラジル、オーストラリア、日本では必須となります。それ以外の国でも、ContentRatings
を指定することを強くお勧めします。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
ContentRatings |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、1つ指定可能) (必須、1つ指定可能) |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
作品を評価したレーティングシステム(通常は公式の評価機関)。指定できるSystem
は各評価につき1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
ContentRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
特定の認定システム(System
)の下で作品に与えられた証明(評価)。指定できるCertification
要素は、ContentRating
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
ContentRating |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | string |
TvEpisode
またはTvSeason
をカタログのTvShow
に関連付けるために使用します。この値は、TvShow
要素のID値と一致している必要があります。ShowID
またはShowTitle
を使用して番組を指定できますが、両方を使用することはできません。カタログにTvShow
が存在するときは、必ずShowID
を使用します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvSeason TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
TvEpisode
またはTvSeason
をカタログのTvShow
に関連付けるために使用します。この値は単にUIで使用される文字列です。カタログ内のタイトルと一致している必要はありません。ShowID
またはShowTitle
を使用して番組を指定できますが、両方を使用することはできません。ShowTitle
は、ShowID
が存在しない場合にのみ使用します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvSeason TvEpisode |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
TVEpisode
が属しているシーズンの番号。そのシーズンがカタログに含まれていない場合に使用します。SeasonInShow
は単にUIで使用される番号です。何かと一致している必要はありません。SeasonID
またはSeasonInShow
を使用してシーズンを指定できますが、両方を使用することはできません。SeasonInShow
はSeasonID
が存在しない場合にのみ使用します(ごくまれなケースです)。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
TvEpisode
またはTvSeason
をカタログのTvShow
に関連付けるために使用します。この値は、TvShow
要素のID値と一致している必要があります。ShowID
またはShowTitle
を使用して番組を指定できますが、両方を使用することはできません。カタログにTvShow
が存在するときは、必ずShowID
を使用します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvSeason TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
TvEpisode
またはTvSeason
をカタログのTvShow
に関連付けるために使用します。この値は単にUIで使用される文字列です。カタログ内のタイトルと一致している必要はありません。ShowID
またはShowTitle
を使用して番組を指定できますが、両方を使用することはできません。ShowTitle
は、ShowID
が存在しない場合にのみ使用します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvSeason TvEpisode |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
TVEpisode
を含んでいるシーズンのID。このID
のTVSeason
が、このTvEpisode
と同じカタログに存在している必要があります。SeasonID
またはSeasonInShow
を使用してシーズンを指定できますが、両方を使用することはできません。該当するシーズンがカタログに存在する場合は、必ずSeasonID
を使用します。存在しない場合は、TvSeason
項目の作成を検討してください。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
TVEpisode
が属しているシーズンの番号。そのシーズンがカタログに含まれていない場合に使用します。SeasonInShow
は単にUIで使用される番号です。何かと一致している必要はありません。SeasonID
またはSeasonInShow
を使用してシーズンを指定できますが、両方を使用することはできません。SeasonInShow
はSeasonID
が存在しない場合にのみ使用します(ごくまれなケースです)。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
TvEpisode
が従属するシーズンのタイトル(「Season 2」など)。対応するTvSeason
要素がカタログに含まれている場合、必ずしもこの値をそのTitle
と一致させる必要はありません。指定できるSeasonTitle
は、TvEpisode
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型:language
データ型:string |
データ型 | string(ローカライズ) |
TV番組のシーズンに含まれているエピソードの連続番号。指定できるEpisodeInSeason
要素は、TvEpisode
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | int |
該当するエピソードまたは特別番組の初回放映日のセット。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
TvEpisode |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
作品が最初にテレビで放送された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYear
と一致している必要があります。この情報は、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
OriginalAirDates |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryDateTimeType - territories 属性が追加されたdateTime。 |
さまざまな国/地域でのコンテンツの公開日が含まれます。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 1つ |
親要素 |
Movie TvShow |
コンテンツモデル | complexType – sequence;指定された順序で必要な子要素を含める必要があります |
子要素 | (必須、無制限) |
属性 | なし |
作品が最初に一般公開(テレビの場合は初回放映)された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYear
と一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
ReleaseDates |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値(US、PR、VI、GB、DEなど)を使用します。 |
データ型 | TerritoryDateTimeType - territories 属性が追加されたdateTime。 |
Extra
をクリップとして指定します。クリップはトレーラーでも、Extra
に関連付けられたMovie
に関する長編メイキングドキュメンタリーでもかまいません。指定できるType
は、Extra
ごとに1つだけです。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | 列挙型:clip |
Extra
(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。このID
の作品が、このExtra
と同じカタログに存在している必要があります。関連付ける作品はRelatesToID
またはRelatesToExternalID
を使用して指定できますが、両方を使用することはできません。関連付ける作品がカタログに存在する場合は、必ずRelatesToID
を使用します。
プロパティ | 詳細 |
---|---|
使用 | 省略可能 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | simpleType(子要素なし) |
子要素 | なし |
データ型 | token |
Extra
(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。外部ソース(IMDbなど)の分類に基づくほかの作品(映画など)を判別するための識別子は、RelatesToExternalID
で指定します。RelatesToExternalID
は、関連付けられている作品が同じカタログに存在しない場合に使用します。関連付けはRelatesToID
またはRelatesToExternalID
を使用して指定できますが、両方を使用することはできません。RelatesToExternalID
は、RelatesToID
が存在しない場合にのみ使用します。
RelatesToExternalID
とExternalID
を混同しないでください。ExternalID
はExtra
そのものを指すのに対し、RelatesToExternalID
はそれに関連付けられている作品を指します。
プロパティ | 詳細 |
---|---|
使用 | 必須 |
指定可能な数 | 無制限 |
親要素 |
Extra |
コンテンツモデル | complexType – 属性のみ。子要素はありませんが、属性を使用できます。 |
子要素 | なし |
属性 |
データ型: 列挙型。 列挙値:
データ型:string |
データ型 | token |
Last updated: 2024年2月23日