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


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

entitiesオブジェクトは、オブジェクトのリストで構成されています。それぞれのオブジェクトには、タイプや値のほか、外部IDなどのその他のデータが含まれます。以降のセクションでは、有効な値について説明します。

MediaType

MediaTypeは、特定のコンテンツのメディアタイプカテゴリーを表します。たとえば、「マンチェスター・バイ・ザ・シー」という映画の場合、MediaTypeはMOVIEになります。

フィールド 説明
value メディアタイプです。有効な値は、MOVIEVIDEOTV_SHOWです。 列挙型 MOVIE

Actor

Actorは、ビデオメディアコンテンツに出演している俳優を表します。たとえば、女優の「ギャビー・ホフマン」の場合は、以下のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDにマッピングされるキー/値です。キーはプロバイダー、値はIDです。オブジェクト    
gracenote 俳優のGracenote IDです。 文字列 ST0000000666661
value 俳優の名前です。 文字列 ギャビー・ホフマン

Character

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

フィールド 説明
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つのタイトルだけでなく、MediaTypeが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は、スポーツのカテゴリー情報を表します。たとえば、フットボールの場合は、以下のようなフィールドが含まれます。

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

SportsTeam

SportsTeamは、プロスポーツチームのカテゴリー情報を表します。たとえば、「ワシントン大学ハスキーズ」というスポーツチームの場合は、以下のようなフィールドが含まれます。

フィールド 説明
externalIds このエンティティの外部IDにマッピングされるキー/値です。キーはプロバイダー、値はIDです。 オブジェクト  
gracenote このチームのGracenote 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"
      }
    }
  }
}