ビデオコンテンツのエンティティタイプ
エンティティオブジェクトはオブジェクトのリストで構成されています。それぞれにタイプと値、および外部IDなどのそのほかのデータが含まれます。タイプに有効な値は次のとおりです。
- MediaType
- Actor
- Character
- Event
- Franchise
- Genre
- League
- SeasonとEpisode
- Sport
- SportsTeam
- Video
- 例: エンティティを指定したSearchAndPlay
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"
}
}
}
}