ビデオコンテンツのエンティティタイプ



ビデオコンテンツのエンティティタイプ

エンティティオブジェクトはオブジェクトのリストで構成されています。それぞれにタイプと値、および外部IDなどのそのほかのデータが含まれます。タイプに有効な値は次のとおりです。

MediaType

MediaTypeは、コンテンツの特定部分のメディアの種類を表します。たとえば、「七人の侍」のMediaTypeはMOVIEです。

フィールド 説明
value メディアの種類です。有効な値は、MOVIE、VIDEO、TV_SHOWです。 Enum MOVIE

Actor

Actorは、ビデオメディアコンテンツの出演者を表します。たとえば、アメリカの女優であるギャビー・ホフマンの場合、次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。オブジェクト    
gracenote 出演者のgracenote IDです。 文字列 ST0000000666661
value 出演者名です。 文字列 ギャビー・ホフマン

Character

Characterは、ビデオメディアコンテンツのキャラクターを表します。たとえば、Snow White(白雪姫)の場合、次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
ASIN このエンティティのASIN(Amazon Standard Identification Number)です。 文字列 B00DT55P3K
gracenote キャラクターのgracenote IDです。 文字列 ST0000000123456
value キャラクター名です。 文字列 白雪姫

Event

Eventはイベントの種類を参照します。たとえば、スポーツ、音楽などです。たとえば、「サッカーの試合」では、「試合」というイベントエンティティと「サッカー」というスポーツエンティティが検索されます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote イベントのgracenote IDです。 文字列 100
value イベントの種類名です。 文字列 試合

Franchise

Franchiseは、映画やTV番組など、複数のビデオエンティティを表すビデオエンティティです。たとえば、「宇宙大戦争」というSFシリーズの場合、映画シリーズと、アニメ、実写のTV番組があります。このエンティティタイプをユーザーがリクエストする際、「宇宙大戦争の映画を探して」などと説明します。これにより、1つのタイトルに一致するコンテンツではなく、メディアの種類がMOVIEの、すべての「宇宙大戦争」を検索します。

フィールド 説明
value シリーズ名です。 文字列 宇宙大戦争

Genre

Genreは、アクション、ドラマ、コメディといったビデオメディアコンテンツのジャンルを表します。たとえば、アクションのジャンルには次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote ジャンルのgracenote IDです。 文字列 101
value ジャンル名です。 文字列 アクション

League

Leagueは、スポーツリーグの分類情報を表します。たとえば、「NCAA」リーグには次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote リーグのgracenote IDです。 文字列 L0000000666661
value リーグ名です。 文字列 NCAA

SeasonとEpisode

SeasonとEpisodeは、TV番組のような連続物のシーズンやエピソード番号を表します。たとえば、「コウノドリ」のシーズン2の第8話には、シーズン番号の2とエピソード番号の8が含まれます。

フィールド 説明
value シーズン番号です。 整数 2
value エピソード番号です。 整数 8

Sport

Sportは、スポーツの分類情報を表します。たとえば、Footballには次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote スポーツのgracenote IDです。 文字列 SP0000000666661
value スポーツ名です。 文字列 フットボール

SportsTeam

SportsTeamは、プロスポーツチームの分類情報を表します。たとえば、「University of Washington Huskies」(ワシントン大学ハスキーズ)のようなスポーツチームには次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote このチームのgracanote IDです。 文字列 100
value スポーツチーム名です。 文字列 ワシントン大学ハスキーズ

Video

Videoは、ビデオコンテンツの部分を識別するデータを表します。たとえば、映画「マンチェスター・バイ・ザ・シー」には次のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDに割り付けられるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
asin ビデオのASIN(Amazon Standard Identification Number)です。 文字列 B01M3X9T06
gracenote gracenote IDです。 文字列 MV0000000666661
value ビデオ名です。 文字列 マンチェスター・バイ・ザ・シー

例: エンティティを指定したSearchAndPlay

{
  "directive": {
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "some-access-token"
      },
      "endpointId": "appliance-001",
      "cookie": {}
    },
    "header": {
      "messageId": "5f2477e6-8f57-4606-af18-6990b8646794",
      "name": "SearchAndPlay",
      "namespace": "Alexa.RemoteVideoPlayer",
      "payloadVersion": "3"
    },
    "payload": {
      "entities": [{
        "externalIds": {
          "gracenote": "MV000000099001"
        },
        "name": "マンチェスター・バイ・ザ・シー",
        "type": "Video"
      }],
      "timeWindow": {
        "end": "2016-09-07T23:59:00+00:00",
        "start": "2016-09-01T00:00:00+00:00"
      }
    }
  }
}