TvEpisode要素

注：説明図で要素のリンクをクリックすると、説明図の下にあるウィンドウがスクロールされ、その要素にフォーカスが移動します。

説明図

├── Partner
└── Works
    ├── Movie
    ├── TvEpisode
    │   ├── 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
    │   ├── SeasonID
    │   ├── SeasonInShow
    │   ├── SeasonTitle
    │   ├── EpisodeInSeason
    │   └── OriginalAirDates
    │   │   └── OriginalAirDate
    ├── TvSeason
    ├── 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サンプルカタログでは、
  TvEpisode作品タイプの使用方法を示します。例として、必要最小限の情報から省略可能な
  すべての要素の指定まで、さまざまなタグ付けを使用しています。この
  最後の例には、どの要素が必須で、どの要素が省略可能であるかに関する情報が
  含まれています。-->
  <! ほとんどの要素はすべての作品タイプで同じですが、
  最後の1～3個の要素だけがタイプによって異なります。この
  例で適用される内容の多くは、ほかの作品タイプにも適用されます。-->

  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>

    <! この例では、有効なエントリに必要な
    最小限の情報を提供します。有効であっても、ユーザーが検索や閲覧で
    この作品を見つけるのは難しい場合があります。メタデータをより多く指定することで、
    見つけやすさが向上します。-->
    <TvEpisode>
      <ID>TVE2329880</ID>
      <Title locale="en-US">What's in a Name?</Title>
      <Offers>
        <SubscriptionOffer>
          <Quality>SD</Quality>
          <Regions>
            <Country>US</Country>
            <Country>GB</Country>
          </Regions>
          <WindowStart>2003-08-08T17:18:37-07:00</WindowStart>
          <Windowend>2014-06-09T08:15:04-07:00</WindowEnd>
        </SubscriptionOffer>
      </Offers>
      <ShowID>ABC-123457</ShowID>
      <SeasonInShow>5</SeasonInShow>
      <EpisodeInSeason>5</EpisodeInSeason>
    </TvEpisode>

    <! このエントリでは、省略可能な情報をいくつか追加して、
    作品の見つけやすさを向上させます。この場合、主役の名前を検索して作品を
    見つけることができるようになります。また、ユーザーは作品を見つけた後に
    その紹介文を読むことができます。-->
    <TvEpisode>
      <ID>TVE234567</ID>
      <!-- 省略可能 -->
      <ExternalID scheme="imdb">tt0000000</ExternalID>
      <Title locale="en-US">Go for the Moon</Title>
      <Offers>
        <SubscriptionOffer>
          <Regions>
            <Country>US</Country>
            <Country>FR</Country>
            <Country>BE</Country>
          </Regions>
          <!-- 省略可能 -->
            <LaunchDetails>
              <Quality>SD</Quality>
            </LaunchDetails>
        </SubscriptionOffer>
      </Offers>
      <!-- 省略可能 -->
      <ShortDescription
      locale="en-US">Lily goes onto a TV game show and must answer
      questions in her ideal category - cooking!.</ShortDescription>
      <!-- 省略可能 -->
      <RuntimeMinutes>30</RuntimeMinutes>
      <!-- 省略可能 -->
      <Credits>
        <CastMember>
          <Name locale="en-US">Alan Smithee</Name>
          <ExternalID scheme="imdb">nm0000000</ExternalID>
          <Role locale="en-US">Lily</Role>
        </CastMember>
      </Credits>
      <ShowID>ABC-123457</ShowID>
      <SeasonInShow>6</SeasonInShow>
      <EpisodeInSeason>3</EpisodeInSeason>
      <!-- 省略可能 -->
      <OriginalAirDate>2013-05-13T00:00:00</OriginalAirDate>
    </TvEpisode>

    <! このエントリでは、使用可能なすべての情報を
    提供します。各要素が必須か省略可能かのほか、特定の項目の有効な値や、
    使用上の注意事項についてのコメントが記載されています。
    -->
    <TvEpisode>
      <!-- 必須。IDは1文字以上で、カタログ内で一意である必要があります。-->
      <ID>TVE123456</ID>

      <! 省略可能。複数のインスタンスを使用できます。存在する場合、
      scheme属性が必須です（有効な値：imdb、tms、isan、
      ean、upc）。-->
      <ExternalID scheme="imdb">tt4795354</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">Undercover Pigeon</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>es</Subtitle>
            <Subtitle>ja</Subtitle>

            <!-- 省略可能。各LaunchDetails要素で
            指定できるLaunchIdは1つだけです。-->
            <LaunchId>TVE123456_SD_en</LaunchId>
          </LaunchDetails>

          <LaunchDetails>
            <Quality>SD</Quality>
            <AudioLanguage>en-US</AudioLanguage>
            <Subtitle>fr</Subtitle>
            <Subtitle>es</Subtitle>
            <Subtitle>ja</Subtitle>
            <LaunchId>TVE123456_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>TVE123456_SD_en</LaunchId>
          </LaunchDetails>

          <LaunchDetails>
            <Quality>SD</Quality>
            <AudioLanguage>en-US</AudioLanguage>
            <Subtitle>fr</Subtitle>
            <Subtitle>es</Subtitle>
            <Subtitle>ja</Subtitle>
            <LaunchId>TVE123456_SD_en_es</LaunchId>
          </LaunchDetails>
        </FreeOffer>

      </Offers>

      <! 省略可能（ただし指定することを強く推奨）。1つのインスタンスのみ。ReleaseDate要素（存在する場合）の
      年と一致している必要があります。この要素は省略可能ですが、指定することを
      推奨します。この値は、この作品をほかのプロバイダーの同じ作品と一致させて、
      すべての視聴方法を1つの検索結果にまとめるために使用します。
      -->
      <ReleaseYear>2015</ReleaseYear>

      <! 省略可能。存在する場合、locale属性が必須です。複数のインスタンスを使用できますが、
      localeごとに1つだけです。
      -->
      <ShortDescription locale="en-US">Nick meets a girl named Charlie who shares his
      love of science.Pidgely is on a mission to deliver a message, but he has
      to get resourceful.</ShortDescription>

      <! 省略可能。存在する場合、locale属性が必須です。複数のインスタンスを使用できますが、
      localeごとに1つだけです。
      -->
      <Synopsis locale="en-US">It's the first day of school and
       Nick is nervous about making new friends.Luckily he meets a girl named Charlie who shares his
       love of science.Meanwhile, Pidgely is on his first "Harrier Pigeon" mission to
       deliver a message to Nick and Shania, but when he misses the designated time to meet up with
       them, he has to get resourceful.</Synopsis>

      <! 省略可能。1つのインスタンスのみ。エントリの50%以上で
      この要素を指定する必要があり、その参照先の画像が有効である必要が
      あります。シリーズのエピソードごとに異なる画像を使用してください。
      -->
      <Images>
        <Image>
          <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url>
        </Image>
      </Images>

      <! 省略可能。1つのインスタンスのみ。統合レポートに
      警告が表示されないようにするには、値を2880以下にする必要があります。-->
      <RuntimeMinutes>24</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>4</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つのインスタンスのみ。このタグはエピソードを指定の番組にリンクします。
      ShowIDまたはShowTitleのいずれかが存在する必要があります。このIDの番組が同じカタログに存在している
      必要があります。それ以外の場合は、ShowTitleを使用してください。-->
      <ShowID>TV098765</ShowID>

      <!-- SeasonInShowが存在しない場合は
      必須。1つのインスタンスのみ。このタグはエピソードを
      指定のシーズンにリンクします。SeasonIDまたはSeasonInShowのいずれかが存在している必要があります。この
      IDのシーズンが同じカタログに存在している必要があります。それ以外の場合は、
      SeasonInShowを使用してください。-->
      <<SeasonID>TVS123457</SeasonID>

      <!-- 省略可能。1つのインスタンスのみ。必ずしも
      TvSeason.Titleの値と一致する必要はありませんが、存在する場合は、
      一致させます。->
      <SeasonTitle locale="en-US">Season 2</SeasonTitle>

      <!-- 必須。1つのインスタンスのみ。-->
      <EpisodeInSeason>2</EpisodeInSeason>

      <!-- 省略可能。1つのインスタンスのみ。年は
      ReleaseYear要素（存在する場合）の値と一致している必要があります。
      -->
      <OriginalAirDate>2015-07-02T00:00:00</OriginalAirDate>
    </TvEpisode>
  </Works>
</Catalog>

Catalog

CDFファイルのルート要素。すべてのカタログファイルにはCatalog要素が1つ必要で、この中にそのファイルの残りの要素が指定されます。

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	なし
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Partner`（必須、1つ指定可能） `Works`（必須、1つ指定可能）
属性	`xmlns`：必須。XML名前空間。 `version`：省略可能。このカタログで使用されているCDFスキーマのバージョン。使用しているスキーマのバージョンは、スキーマの「id」を参照して確認できます。この属性は互換性の理由から省略できますが、バージョンは指定することをお勧めします。データ型：列挙型。列挙値： `FireTv-v1.2`、`FireTv-v1.3`、`FireTv-v1.4`、`FireTv-v1.5`、`FireTv-v1.6`、`FireTv-v1.7`、`FireTv-v1.8`、`FireTv-v1.9`、`FireTv-v1.10`、`FireTv-v1.11`、`FireTv-v2.0`

例：

<xml version="1.0" encoding="utf-8" ?>
<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.3">
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
<Catalog>

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>

Works

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

注： CDF v1.0～v1.2では、Works要素に少なくとも1つの作品が指定されている必要がありました。CDF v1.3では、空にすることができます。空にした場合、Amazon Fire TVのユニバーサル閲覧・検索から対象カタログのコンテンツが削除されます。

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

例：

<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>

Movie

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

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

例：

<Movie>
    <ID>AMZN-0011</ID>
    <ExternalID scheme="imdb">tt0000008</ExternalID>
    <Titles>
        <!-- 以下に示すようにterritories属性を省略した場合、指定したタイトルはグローバルに適用されます。-->
        <Title locale="en-US">Global English Movie Title</Title>
        <!-- 以下のタイトルは米国でのみ使用されます。-->
        <Title locale="es" territories="US">Spanish US Movie Title</Title>
    </Titles>
    <Copyright locale="en-US">Amazon 2021</Copyright>
    <Offers>
        <FreeOffer>
            <Regions>
                <Territories>GB, DE</Territories>
            </Regions>
            <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
            <WindowEnd>2030-01-01T07:00:00-07:00</WindowEnd>
            <LaunchDetails>
                <Quality>SD</Quality>
                <AudioLanguage>en-US</AudioLanguage>
                <Subtitle>en-US</Subtitle>
                <Subtitle>es</Subtitle>
                <LaunchId>AMZN-0011-enUS-SD</LaunchId>
            </LaunchDetails>
        </FreeOffer>
        <SubscriptionOffer>
            <Regions>
                <Territories>US, CA</Territories>
            </Regions>
            <WindowStart>2021-02-06T12:00:00-07:00</WindowStart>
            <WindowEnd>2022-01-01T07:00:00-07:00</WindowEnd>
            <LaunchDetails>
                <Quality>HD</Quality>
                <AudioLanguage>en-US</AudioLanguage>
                <Subtitle>en-US</Subtitle>
                <Subtitle>es</Subtitle>
                <LaunchId>AMZN-0011-enUS-HD</LaunchId>
            </LaunchDetails>
        </SubscriptionOffer>
    </Offers>
    <IsAdultProducts>
        <!-- 国や地域を指定しない場合、このフィールド値は全世界に適用されます。-->
        <IsAdultProduct>false</IsAdultProduct>
        <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
    </IsAdultProducts>
    <ReleaseYear>1959</Releaseyear>
    <ShortDescriptions>
        <ShortDescription locale="en-US" territories="US">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</ShortDescription>
    </ShortDescriptions>
    <Synopses>
        <Synopsis locale="en-US" territories="US, GB">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</Synopsis>
        <Synopsis locale="es" territories="MX">Nulla pellentesque dignissim enim sit amet venenatis urna cursus.Metus vulputate eu scelerisque felis imperdiet.Ullamcorper a lacus vestibulum sed.Sed ullamcorper morbi tincidunt ornare.Odio aenean sed adipiscing diam donec adipiscing tristique risus.Sed vulputate mi sit amet mauris commodo quis.Ac tortor dignissim convallis aenean et tortor at risus.Turpis tincidunt id aliquet risus feugiat in.A scelerisque purus semper eget duis at tellus at.Volutpat ac tincidunt vitae semper.</Synopsis>
        <Synopsis locale="en">Arcu odio ut sem nulla pharetra.Lobortis scelerisque fermentum dui faucibus in.Netus et malesuada fames ac turpis.Aenean sed adipiscing diam donec adipiscing.Egestas egestas fringilla phasellus faucibus scelerisque eleifend donec.Lectus magna fringilla urna porttitor rhoncus dolor purus non.Nibh ipsum consequat nisl vel pretium lectus quam id.Eu consequat ac felis donec et odio pellentesque diam.Lorem ipsum dolor sit amet consectetur adipiscing elit.Quisque egestas diam in arcu cursus.Tristique sollicitudin nibh sit amet.Eleifend quam adipiscing vitae proin sagittis nisl rhoncus mattis rhoncus.</Synopsis>
    </Synopses>
    <MetadataAvailabilityDates>
        <MetadataAvailabilityDate>2021-08-01T12:00:00Z</MetadataAvailabilityDate>
        <MetadataAvailabilityDate territories="US,CA,GB">2021-09-01T12:00:00Z</MetadataAvailabilityDate>
    </MetadataAvailabilityDates>
    ...
    ...
</Movie>

TvEpisode

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Works`
コンテンツモデル	complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、`ShowID`と`ShowTitle`は一方のみ必要で、両方は指定できません。また、`SeasonID`と`SeasonInShow`も一方のみ必要で、両方は指定できません。
子要素	`ID`（必須、1つ指定可能） `ExternalID`（省略可能、無制限） `Titles`（必須、無制限） `Copyright`（省略可能、1つ指定可能） `Offers`（省略可能、1つ指定可能） `IsAdultProducts`（省略可能、1つ指定可能） `ReleaseYear`（省略可能、1つ指定可能） `ShortDescriptions`（省略可能、1つ指定可能） `Synopses`（省略可能、1つ指定可能） `MetadataAvailabilityDates`（省略可能、1つ指定可能） `Images`（必須、1つ指定可能） `Runtimes`（省略可能、1つ指定可能） `Color`（省略可能、1つ指定可能） `Credits`（省略可能、1つ指定可能） `Studios`（省略可能、1つ指定可能） `Language`（省略可能、1つ指定可能） `CustomerRating`（省略可能、1つ指定可能） `Rank`（省略可能、1つ指定可能） `IsOriginals`（省略可能、1つ指定可能） `Genres`（省略可能、1つ指定可能） `ContentRatings`（省略可能、1つ指定可能） `ShowID`（必須、1つ指定可能） `ShowTitle`（必須、1つ指定可能） `SeasonID`（必須、1つ指定可能） `SeasonInShow`（必須、1つ指定可能） `SeasonTitle`（省略可能、1つ指定可能） `EpisodeInSeason`（必須、1つ指定可能） `OriginalAirDates`（省略可能、1つ指定可能）
属性	なし

例：

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS-987654</ID>
  ...
</TvSeason>
<TvEpisode>
  <ID>TVE2329880</ID>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS-987654</SeasonInShow>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>

TvSeason

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Works`
コンテンツモデル	complexType – choiceを含むsequence。指定された順序で必要な子要素を含める必要がありますただし、`ShowID`と`ShowTitle`は一方のみ必要で、両方は指定できません。
子要素	`ID`（必須、1つ指定可能） `ExternalID`（省略可能、無制限） `Titles`（必須、無制限） `Copyright`（省略可能、1つ指定可能） `Offers`（省略可能、1つ指定可能） `IsAdultProducts`（省略可能、1つ指定可能） `ReleaseYear`（省略可能、1つ指定可能） `ShortDescriptions`（省略可能、1つ指定可能） `Synopses`（省略可能、1つ指定可能） `MetadataAvailabilityDates`（省略可能、1つ指定可能） `Images`（必須、1つ指定可能） `Runtimes`（省略可能、1つ指定可能） `Color`（省略可能、1つ指定可能） `Credits`（省略可能、1つ指定可能） `Studios`（省略可能、1つ指定可能） `Language`（省略可能、1つ指定可能） `CustomerRating`（省略可能、1つ指定可能） `Rank`（省略可能、1つ指定可能） `IsOriginals`（省略可能、1つ指定可能） `Genres`（省略可能、1つ指定可能） `ContentRatings`（省略可能、1つ指定可能） `ShowID`（必須、1つ指定可能） `ShowTitle`（必須、1つ指定可能） `SeasonInShow`（必須、1つ指定可能）
属性	なし

例：

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  <ShowID>ABC-123457</ShowID>
  <SeasonInShow>5</SeasonInShow>
</TvSeason>
<TvEpisode>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

TvShow

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

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

例：

<TvShow>
  <ID>RS-2329880</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  ...
  <ShowID>RS-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>RS-2329880</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

Extra

クリップ。単発の作品の場合もありますが、通常はほかの作品（外部の作品またはカタログ内の別の作品）に関連付けられます。一般に、DVDに収録されるボーナストラックに相当するものと考えてください。

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

例：

<Extra>
  <ID>EXTRA-11111</ID>
  ...
  <Type>clip</Type>
</Extra>

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

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

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	NonEmptyToken

例：

<Movie>
  <ID>AmazonStudios_Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf</ID>
  ...
</Movie>

ExternalID

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`CastMember` `CrewMember` `Extra` `Movie` `TvEpisode` `TvSeason` `TvShow`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`scheme`：必須。このIDの提供元となった外部ソース。データ型：列挙型。列挙値： `imdb`： Internet Movie Database（IMDb）。IDは、特定のページのURLの構成要素として存在します。 `tms`： OnTVドメイン。以前のTribune Media Serviceですが、本質的には旧Gracenote ID空間の1つです。 `isan`： International Standard Audiovisual Number（ISAN）。26文字の英数字で、通常はダッシュ区切りで表示されます。 `ean`： EAN（European Article Number）はバーコード規格の1つで、12桁または13桁の商品識別コードです。各EANは、商品やメーカー、およびその属性を一意に識別します。 `upc`： UPC（Universal Product Code）は、米国の小売用パッケージに広く使用されている12桁のバーコードです。 `asin`： ASIN（Amazon Standard Identification Number）は、商品を識別するための英数字10桁で構成される一意のブロックです。 `gvd`： Gracenote Video Data。Gracenote IDはテレビ番組や映画を一意に識別するIDです。このIDにより、テレビ番組表データやオンデマンドカタログへの関連付けが可能になります。 `region`：省略可能。`externalId`に関連する地域（Amazon ASINSの場合はマーケットプレイス、TMS IDの場合は国）。たとえば、TMSスキームでは`US`になります。データ型：string

例：

<Movie>
  <ID>MV123456</ID>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <ExternalID scheme="tms">MV000000000000</ExternalID>
  <ExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</ExternalID>
  <ExternalID scheme="ean">0011559514120</ExternalID>
  <ExternalID scheme="upc">123456789990</ExternalID>
  ...
</Movie>

Titles

作品のタイトルが含まれます。各作品にTitles要素を1つ含めることができます。

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	`Title`（必須、無制限）
データ型	string（ローカライズ）

例：

<TvShow>
  <ID>TV123456</ID>
  <Titles>
    ...
  </Titles>
  ...
</TvShow>

Title

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Titles`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string `territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryStringType - `locale`、`pronunciation`、`territories`の各属性が追加されたstring。

例：

<TvShow>
  <ID>TV123456</ID>
  <Titles>
    <!-- 以下に示すようにterritories属性を省略した場合、指定したタイトルはグローバルに適用されます。-->
    <Title locale="en-US">Global English Movie Title</Title>
    <!-- 以下のタイトルは米国でのみ使用されます。-->
    <Title locale="es" territories="US">Spanish US Movie Title</Title>
  </Titles>
  ...
</TvShow>

作品の著作権表示。

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<Copyright locale="en-US">© 2014 Amazon Studios</Copyright>

Offers

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – choice。いずれかの子要素が必要です（両方は指定できません）。
子要素	`SubscriptionOffer`（必須、1つ指定可能） `FreeOffer`（必須、1つ指定可能）
属性	なし

例：

<Offers>
  <FreeOffer>
    <Regions>
      <Territories>US, PR, VI, GB, DE</Territories>
    </Regions>
    <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
    <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
    <LaunchDetails>
      <Quality>SD</Quality>
    </LaunchDetails>
  </FreeOffer>
  <SubscriptionOffer>
    <Regions>
      <Territories>CA</Territories>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>

SubscriptionOffer

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

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

例：

<SubscriptionOffer>
  <Regions>
    <Territories>US, CA</Territories>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

Regions

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

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

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`SubscriptionOffer` `FreeOffer`
コンテンツモデル	complexType – choice。いずれかの子要素が必要です（両方は指定できません）。
子要素	`Territories`（必須、1つ指定可能）
属性	なし

例：

<FreeOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</FreeOffer>

Territories

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`Regions`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。

例：

<SubscriptionOffer>
  <Regions>
    <Territories>US, PR, VI, GB, DE, AT</Territories>
  </Regions>
  ...
</SubscriptionOffer>

WindowStart

特定の視聴方法で作品が視聴できるようになる日時。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>

WindowEnd

特定の視聴方法で作品が視聴できなくなる日時。指定できる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>

LaunchDetails

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`SubscriptionOffer` `FreeOffer`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Quality`（省略可能、無制限） `AudioLanguage`（省略可能、無制限） `Subtitle`（省略可能、無制限） `LaunchId`（省略可能、1つ指定可能）
属性	なし

例：

<FreeOffer>
  <Regions>
    <Territories>US, CA</Territories>
  </Regions>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

Quality

作品の画質を表します。標準解像度（SD）、高解像度（HD）、超高解像度（UHD）があります。1つの作品を複数の画質オプションで提供できます。

注： Qualityという名前の要素は2つ存在します。1つは各視聴方法タイプの直接の子要素で、これはCDF v1.2で廃止されました。もう1つはLaunchDetailsの子要素で、各視聴方法タイプの孫要素になります。ここで取り上げるのは、新しい（廃止されていない）方のQuality要素です。ただし両者の違いは親要素のみで、形式と内容は同じです。

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`LaunchDetails`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	列挙型： `SD`、`HD`、`UHD`

例：

<FreeOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
    <Quality>SD</Quality>
  </LaunchDetails>
  ...
</FreeOffer>

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>

Subtitle

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`LaunchDetails`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	language

例：

<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>

LaunchId

あらかじめ決まった画質、音声言語、字幕の構成で（またはそれらを一部組み合わせて）作品を再生するための識別子。LaunchIdに決まった形式はありませんが、開発者のアプリのロジックで確実に認識できる形式にしてください。各LaunchDetails要素に追加できるLaunchIdは1つだけです。複数のLaunchIdを指定するには、複数のLaunchDetails要素を追加する必要があります。

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`LaunchDetails`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	token

例：

<SubscriptionOffer>
  ...
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_SD_fr-FR_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

プロパティ	詳細
使用
指定可能な数
親要素
コンテンツモデル
子要素
属性
データ型

FreeOffer

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

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

例：

<FreeOffer>
  <Regions>
    <Territories>US, GB, DE</Territories>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

IsAdultProducts

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`IsAdultProduct`（必須、無制限）
属性	なし

例：

<IsAdultProducts>
  <!-- 国や地域を指定しない場合、このフィールド値は全世界に適用されます。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>

IsAdultProduct

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`IsAdultProducts`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryBooleanType - `territories`属性が追加されたboolean。

例：

<IsAdultProducts>
  <!-- 国や地域を指定しない場合、このフィールド値は全世界に適用されます。-->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>

ReleaseYear

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

注：この要素は省略可能ですが、指定することを推奨します。複数のプロバイダーが同じ作品を配信している場合、それらすべての作品を1つの検索結果にまとめることで、検索に対する顧客満足度を高めています。この値は、そのマッチング作業で特に重要となります。最終的には作品の見つけやすさにもつながります。

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	int

例：

<TvEpisode>
  ...
  <ReleaseYear>1959</ReleaseYear>
  ...
</TvEpisode>

ShortDescriptions

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`ShortDescription`（必須、無制限）
属性	なし

例：

<Movie>
  ...
  <ShortDescriptions>
    ...
  </ShortDescriptions>
  ...
</Movie>

ShortDescription

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`ShortDescriptions`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string `territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryStringType - `locale`、`pronunciation`、`territories`の各属性が追加されたstring。

例：

<Movie>
...
  <ShortDescriptions>
    <ShortDescription locale="en-US" territories="US">Alan shows us some trees and sings songs about them.</ShortDescription>
  </ShortDescriptions>
...
</Movie>

Synopses

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Synopsis`（必須、無制限）
属性	なし

例：

<Movie>
...
  <Synopses>
    ...
  </Synopses>
...
</Movie>

Synopsis

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Synopses`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	TerritoryStringType - `locale`、`pronunciation`、`territories`の各属性が追加されたstring。

例：

<Movie>
...
  <Synopses>
    <Synopsis locale="en-US" territories="US, CA">Alan Smithee, man about town and fervent urban arborist, takes us on a musical journey around his home town, stopping by some favorite trees to sing about them.As expected from Mr. Smithee, no path runs straight and his plans meander as he encounters guest stars and battles a lumberjack with a literal ax to grind.</Synopsis>
  </Synopses>
...
</Movie>

MetadataAvailabilityDates

国や地域によって異なるMetadataAvailabilityDateが含まれます。国／地域の値を指定しないフィールドは、グローバルに適用されると見なされます。

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`MetadataAvailabilityDate`（必須、1つ指定可能）
属性	なし

例：

<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    ...
  </MetadataAvailabilityDates>
  ...
</Movie>

MetadataAvailabilityDate

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`MetadataAvailabilityDates`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryDateTimeType - `territories`属性が追加されたdateTime。

例：

<Movie>
  <ID>MV-123456</ID>
  ...
  <MetadataAvailabilityDates>
    // この映画は、米国、カナダ、英国では9月1日に公開され、その他の国／地域では
    // 9月15日に公開されます。
    <MetadataAvailabilityDate>2021-09-15T12:00:00Z</MetadataAvailabilityDate>
    <MetadataAvailabilityDate territories="US,CA,GB">2021-09-01T12:00:00Z</MetadataAvailabilityDate>
  </MetadataAvailabilityDates>
  ...
</Movie>

Images

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Image`（必須、無制限）
属性	なし

例：

<Movie>
  ...
  <Images>
    <Image>
      ...
    </Image>
  </Images>
  ...
 </Movie>

Image

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Images`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Url`（必須、1つ指定可能） `Locale`（省略可能、無制限）
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。

例：

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

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>

Locale

画像の言語。画像サイズの詳細については、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>

Runtimes

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`RuntimeMinutes`（必須、無制限）
属性	なし

例：

<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>

RuntimeMinutes

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Runtimes`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryInteger - `territories`属性が追加されたint。

例：

<TvEpisode>
  ...
  <Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
  </Runtimes>
  ...
</TvEpisode>

Color

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	列挙型：`color`、`black_and_white`

例：

<Movie>
  ...
  <Color>black_and_white</Color>
  ...
</Movie>

Credits

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – choice。いずれかの子要素が必要です（両方は指定できません）。
子要素	`CastMember`（必須、1つ指定可能） `CrewMember`（必須、1つ指定可能）
属性	なし

例：

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

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>

Name

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`CastMember` `CrewMember`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>

ExternalID

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`CastMember` `CrewMember` `Extra` `Movie` `TvEpisode` `TvSeason` `TvShow`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`scheme`：必須。このIDの提供元となった外部ソース。データ型：列挙型。列挙値： `imdb`： Internet Movie Database（IMDb）。IDは、特定のページのURLの構成要素として存在します。 `tms`： OnTVドメイン。以前のTribune Media Serviceですが、本質的には旧Gracenote ID空間の1つです。 `isan`： International Standard Audiovisual Number（ISAN）。26文字の英数字で、通常はダッシュ区切りで表示されます。 `ean`： EAN（European Article Number）はバーコード規格の1つで、12桁または13桁の商品識別コードです。各EANは、商品やメーカー、およびその属性を一意に識別します。 `upc`： UPC（Universal Product Code）は、米国の小売用パッケージに広く使用されている12桁のバーコードです。 `asin`： ASIN（Amazon Standard Identification Number）は、商品を識別するための英数字10桁で構成される一意のブロックです。 `gvd`： Gracenote Video Data。Gracenote IDはテレビ番組や映画を一意に識別するIDです。このIDにより、テレビ番組表データやオンデマンドカタログへの関連付けが可能になります。 `region`：省略可能。`externalId`に関連する地域（Amazon ASINSの場合はマーケットプレイス、TMS IDの場合は国）。たとえば、TMSスキームでは`US`になります。データ型：string

例：

<Movie>
  <ID>MV123456</ID>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <ExternalID scheme="tms">MV000000000000</ExternalID>
  <ExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</ExternalID>
  <ExternalID scheme="ean">0011559514120</ExternalID>
  <ExternalID scheme="upc">123456789990</ExternalID>
  ...
</Movie>

Role

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

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`CastMember`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string `locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language
データ型	string（ローカライズ）

例：

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Robin Hood</Role>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

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>

Job

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`CrewMember`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<CrewMember>
  <Name locale="en-US">Alan Smithee</Name>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <Job locale="en-US">Grip</Job>
</CrewMember>

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>

Studio

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Studios`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	string

例：

<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>

Language

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

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	language

例：

<Movie>
  ...
  <Language>ja</Language>
  ...
</Movie>

CustomerRating

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

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

例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Score

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`CustomerRating`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	decimal（正の値）

例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

MaxValue

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	decimal（正の値）

例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Count

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`CustomerRating`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	long（負数以外）

例：

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

Rank

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	int

例：

<TvShow>
  ...
  <Rank>36</Rank>
  ...
</TvShow>

IsOriginals

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`IsOriginal`（必須、無制限）
属性	なし

例：

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

IsOriginal

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`IsOriginals`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryBooleanType - `territories`属性が追加されたboolean。

例：

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

Genres

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`Genre`（必須、無制限）
属性	なし

例：

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

Genre

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Movie`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

ContentRatings

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow` `TvSeason` `TvEpisode` `Extra`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`ContentRating`（必須、無制限）
属性	なし

例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

ContentRating

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

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`ContentRatings`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`System`（必須、1つ指定可能） `Certification`（必須、1つ指定可能）
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。

例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

System

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`ContentRating`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	string

例：

<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>G</Certification>
  </ContentRating>
</ContentRatings>

Certification

特定の認定システム（System）の下で作品に与えられた証明（評価）。指定できるCertification要素は、ContentRatingごとに1つだけです。

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`ContentRating`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	string

例：

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
<ContentRating>

ShowID

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvSeason` `TvEpisode`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	token

例：

<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>

ShowTitle

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvSeason` `TvEpisode`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>

SeasonInShow

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvEpisode`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	int

例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>

ShowID

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvSeason` `TvEpisode`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	token

例：

<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>

ShowTitle

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvSeason` `TvEpisode`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>

SeasonID

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>

SeasonInShow

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvEpisode`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	int

例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>

SeasonTitle

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`TvEpisode`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`locale`：必須。この文字列を使用するデバイスまたはソフトウェアの言語設定。データ型：language `pronunciation`：省略可能。この要素のテキストが漢字で表記される場合に使用します。日本語のソート順は、文字ではなく発音（漢字からは特定不可能）に基づいて決まります。pronunciation属性には、通常、発音の情報をひらがなで指定します。データ型：string
データ型	string（ローカライズ）

例：

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  <SeasonTitle locale="en-US">Season 2</SeasonTitle>
  ...
</TvEpisode>

EpisodeInSeason

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

プロパティ	詳細
使用	必須
指定可能な数	1つ
親要素	`TvEpisode`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	int

例：

<TvEpisode>
  ...
  <EpisodeInSeason>6</EpisodeInSeason>
  ...
</TvEpisode>

OriginalAirDates

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

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

例：

<Movie>
  ...
  <OriginalAirDates>
    ...
  </OriginalAirDate>
</Movie>

OriginalAirDate

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`OriginalAirDates`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryDateTimeType - `territories`属性が追加されたdateTime。

例：

<Movie>
...
  <OriginalAirDates>
    <OriginalAirDate territories="US,CA">2014-01-01T11:30:00+08:00</OriginalAirDate>
  </OriginalAirDates>
</Movie>

ReleaseDates

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

プロパティ	詳細
使用	省略可能
指定可能な数	1つ
親要素	`Movie` `TvShow`
コンテンツモデル	complexType – sequence；指定された順序で必要な子要素を含める必要があります
子要素	`ReleaseDate`（必須、無制限）
属性	なし

例：

<TvShow>
  ...
  <ReleaseDates>
  ...
  </ReleaseDates>
</TvShow>

ReleaseDate

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`ReleaseDates`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`territories`：省略可能。この要素が適用される場所を示す国や地域のコンマ区切りリスト。全世界を指定する場合は空のままにします。データ型： TerritoriesType - 国や地域を表すstring。ISO 3166-1 alpha-2の国コード値（US、PR、VI、GB、DEなど）を使用します。
データ型	TerritoryDateTimeType - `territories`属性が追加されたdateTime。

例：

<TvShow>
  ...
  <ReleaseDates>
    <ReleaseDate territories="US,CA">2012-05-13T00:00:00</ReleaseDate>
  </ReleaseDates>
</TvShow>

Type

Extraをクリップとして指定します。クリップはトレーラーでも、Extraに関連付けられたMovieに関する長編メイキングドキュメンタリーでもかまいません。指定できるTypeは、Extraごとに1つだけです。

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	列挙型：`clip`

例：

<Extra>
  ...
  <Type>clip</Type>
  ...
</Extra>

RelatesToID

Extra（映画のトレーラーなど）が関連付けられているほかの作品（そのトレーラーの本編となる映画など）を指定するために使用します。このIDの作品が、このExtraと同じカタログに存在している必要があります。関連付ける作品はRelatesToIDまたはRelatesToExternalIDを使用して指定できますが、両方を使用することはできません。関連付ける作品がカタログに存在する場合は、必ずRelatesToIDを使用します。

プロパティ	詳細
使用	省略可能
指定可能な数	無制限
親要素	`Extra`
コンテンツモデル	simpleType（子要素なし）
子要素	なし
データ型	token

例：

<TvShow>
  <ID>TV123456</ID>
  ...
</TvShow>
<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToID>TV123456</RelatesToID>
</Extra>

RelatesToExternalID

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

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

プロパティ	詳細
使用	必須
指定可能な数	無制限
親要素	`Extra`
コンテンツモデル	complexType – 属性のみ。子要素はありませんが、属性を使用できます。
子要素	なし
属性	`scheme`：必須。このIDの提供元となった外部ソース。データ型：列挙型。列挙値： `imdb`： Internet Movie Database（IMDb）。IDは、特定のページのURLの構成要素として存在します。 `tms`： OnTVドメイン。以前のTribune Media Serviceですが、本質的には旧Gracenote ID空間の1つです。 `isan`： International Standard Audiovisual Number（ISAN）。26文字の英数字で、通常はダッシュ区切りで表示されます。 `ean`： EAN（European Article Number）はバーコード規格の1つで、12桁または13桁の商品識別コードです。各EANは、商品やメーカー、およびその属性を一意に識別します。 `upc`： UPC（Universal Product Code）は、米国の小売用パッケージに広く使用されている12桁のバーコードです。 `asin`： ASIN（Amazon Standard Identification Number）は、商品を識別するための英数字10桁で構成される一意のブロックです。 `gvd`： Gracenote Video Data。Gracenote IDはテレビ番組や映画を一意に識別するIDです。このIDにより、テレビ番組表データやオンデマンドカタログへの関連付けが可能になります。 `region`：省略可能。`externalId`に関連する地域（Amazon ASINSの場合はマーケットプレイス、TMS IDの場合は国）。たとえば、TMSスキームでは`US`になります。データ型：string
データ型	token

例：

<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToExternalID scheme="imdb">tt0000000</RelatesToExternalID>
  <RelatesToExternalID scheme="tms">MV000000000000</RelatesToExternalID>
  <RelatesToExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</RelatesToExternalID>
  <RelatesToExternalID scheme="ean">0011559514120</RelatesToExternalID>
  <RelatesToExternalID scheme="upc">123456789990</RelatesToExternalID>
</Extra>

Last updated: 2024年2月23日