GetDisplayableItemsディレクティブ

コンテンツの検索やコンテンツプロバイダーのランディングページへのアクセスなどを依頼する発話をユーザーが行うと、GetDisplayableItemsディレクティブがVideoContentProvider APIからLambdaに送信されます。

次の図は、Alexaディレクティブとそれに対するLambdaのレスポンスを示しています。

GetDisplayableItemsディレクティブとLambdaのGetDisplayableItemsResponse

GetDisplayableItemsの発話
GetDisplayableItemsディレクティブの処理
GetDisplayableItemsの例
GetDisplayableItemsの例（ランディングページ）
ペイロードの説明
- エンティティタイプ
- エクスペリエンスタイプ
レスポンスの例
ペイロードの説明
インターフェース機能に対するサポートの宣言

GetDisplayableItemsの発話

ユーザーが以下の発話を行うと、AlexaはLambdaにGetDisplayableItemsディレクティブを送信します。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	Search for breaking bad	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	Search for sean connery	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	Search for comedy	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	Search for star trek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	Search movies	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	Search breaking bad season two	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	Search for breaking bad episode five	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	Search for breaking bad season two episode five	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	Search for james bond	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	Search for quentin tarantino	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	Search for disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Search seahawks	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Search for soccer	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	Search for n. b. a. league	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Search for soccer game	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	Launch netflix app	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	Launch a. t. and t. u-verse app	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trouve / cherche / montre [VideoName] sur [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	recherche des films avec [ActorName] cherche des films avec [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	recherche un/une [GenreName] cherche un/une [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	recherche [VideoName] cherche [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	recherche [mediatype] cherche [mediatype]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	recherche la saison [number] de [title] cherche la saison [number] de [title]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	recherche la saison [number] de [title] cherche la saison [number] de [title]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	recherche/cherche la saison [SeasonNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName] recherche/cherchela saison [SeasonNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	recherche un film avec [charactername] cherche un film avec [charactername]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	recherche un film de [DirectorName] cherche un film de [DirectorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	recherche des films de disney cherche des films de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Not supported	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	recherche [league] cherche [league]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Not supported	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	pars [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	pars [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trouve / cherche / montre [VideoName] sur [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	cherche des films avec [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	cherche une comédie	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	cherche star trek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	Cherche [mediatype]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	cherche la saison [number] de [title]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	cherche l'épisode [number] de [title]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	cherche la saison [SeasonNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName] cherche la saison [SeasonNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	cherche un film avec [charactername]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	cherche un film de quentin tarantino	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	cherche des films de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Not supported	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	cherche [league]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Not supported	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lance [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	lance [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	such [ActorNameName] filme zeig filme mit [ActorNameName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	zeig [GenreNameName] filme auf [AppName] such nach [GenreName] [MediaType]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	find [MediaType] such/zeig/empfiehl [MediaType]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	spiel [VideoName] [Season] [Season_Numer] spiel [VideoName] [Season] [Season_Numer] auf [AppName]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	spiel die [Episode_Number] [Episode] von [VideoName] spiel [VideoName] [Episode_Number] spiel von [VideoName] [Episode] [Episode_Number]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	spiel [Season] [Season_Numer] [Episode] [Episode_Number] von [VideoName] spiel [VideoName] [Season] [Season_Numer] [Episode] [Episode_Number] spiel die [VideoName] [Season] [Season_Numer] [Episode] [Episode_Number] auf [AppName] ab	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	Not supported	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	such nach [MediaType] mit [ActorName] such [ActorName] [MediaType] zeig [MediaType] mit [ActorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	suche nach [ProductionCompany] filmenzeige mir [ProductionCompany] filme	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能		リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	such [Sport] [Event] find [Sport] [Event]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	Not supported	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	such [Sport] [Event] find [Sport] [Event]	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	starte [AppName] spiel/öffne [AppName] app starte [AppName] auf [DeviceBrand]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	starte [AppName] spiel/öffne [AppName] app starte AppName auf [DeviceBrand]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	[VideoName] खोजो/ढूँढो [AppName] पे/पर/में [VideoName] दिखा/खोज दो मुझे [VideoName] दिखाओ/खोजो/ढूँढो मुझे [AppName] पे/पर/में [VideoName] दिखाओ/खोजो/ढूँढो मुझे [VideoName] को [AppName] पे पर में दिखाओ/खोजो/ढूँढो खोजो [VideoName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	[ActorName] के/का/की/वाला movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो [ActorName] के/का/की/वाला [GenreName] movie [VideoName] दिखाओ/खोजो/ढूँढो दिखाओ/खोजो [ActorName] के/का/की/वाला [GenreName] movies	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	[GenreName] movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	start trek के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	[VideoName] movie दिखाओ/ढूँढो [AppName] पे/पर/में [MediaType] को खोजो [ChannelName] को खोजो/ढूँढो	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	breaking bad season दो ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	breaking bad episode पाँच के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	breaking bad season दो episode five के लिये ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	[CharacterName] movie दिखाओ/खोजो [CharacterName] के/का/की/वाला movie [VideoName] दिखाओ/खोजो/ढूँढो	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	quentin tarantino के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	disney के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	netflix launch करो/करना/कीजिए/करिएगा	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	facebook app launch करो/करना/कीजिए/करिएगा	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trova / cerca / mostra / dammi + VideoName (+ da/su ServiceName)?	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	cerca film con [ActorName] trova un film con [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	cerca [GenreName] trova [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	cerca [VideoName] trova [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	cerca [mediatype] trova mi un [mediatye]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	cerca la stagione due di [VideoName] trova la stagione due di [VideoName]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	cerca [VideoName] Episodio cinque trova [VideoName] Episodio cinque	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	cerca [VideoName] episodio [EpisodeNumber] trova [VideoName] episodio [EpisodeNumber] cerca [VideoName] stagione [SeasonNumber] trova [VideoName] stagione [SeasonNumber] cerca [VideoName] stagione [SeasonNumber] episodio [EpisodeNumber] trova [VideoName] stagione [SeasonNumber] episodio [EpisodeNumber]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	cerca un film con [CharacterName] trova un film con [CharacterName]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	cerca [DirectorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	cerca disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	cerca [Sport] trova [Sport]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	not supported	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	cerca partite di [SportName] trova partite di calcio	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lancia [AppName] apri [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	apri [special character AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	[VideoName]を探して[VideoName]を＜AppName]で探して	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	[ActorNameName]が出ている[MediaType]を探して	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	[GenreNameName]の[MediaType]を見つけて	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須		指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	[MediaType]を探して [AppName]で[MediaType]を探して [ChannelName]を検索	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能		一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能		ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	[title] シーズン[SeasonNumber] エピソード[EpisodeNumber] を探して	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	[CharacterNameName]が主人公の[MediaType]を探して	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能		リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	[ProductionCompany]を検索	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須		リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須		リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	procurar/buscar/mostrar [VideoName] no/na [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	procurar por [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	procurar por [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	procurar[VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	procurar [MediaType]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	procurar [VideoName] temporada [SeasonNumber]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	procurar por [title] episódio [EpisodeNumber]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	procurar por [VideoName]episódio [EpisodeNumber]procurar por [VideoName]temporada [SeasonNumber]procurar por [VideoNumber]temporada	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	not supported	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	not supported	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	Procurar/procura/procure por [ProductionCompany]	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	procurar por[SportTeam]	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	procurar por [Sport]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	procurar por [League]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	procurar por [SportName]	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	abrir [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	abrir [special character AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	muestra juego de tronos enséña me el efecto mariposa	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	busca películas con antonio banderas	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	busca comedias románticas	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	busca shrek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	busca películas enséña me las películas busca películas en netflix	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	enséña me la segunda temporada de friends	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	busca el capítulo final de los serrano^*	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	busca el segundo episodio de la primera temporada de anabel^*	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	busca películas de la pantera negra	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	busca las películas de alejandro lozano	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	busca películas de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	busca el partido del real madrid	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	enséña nos un vídeo de fútbol	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	busca el partido de la n. b. a.	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	busca el partido de fútbol	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lanza la app de netflix lanza netflix	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	lanza i. b. e. x. treinta y cinco	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

GetDisplayableItemsディレクティブの処理

VideoName、ActorName、GenreNameなどの条件を使用してユーザーがコンテンツを検索すると、Alexaは表示するコンテンツを取得するためにGetDisplayableItemsディレクティブを送信します。

Lambdaのレスポンス（GetDisplayableItemsResponse）には、ユーザーの検索リクエストと一致するコンテンツの基本的な識別情報を含める必要があります。その他のメタデータ（画像など）はレスポンスに含めないでください。

Alexaは、「アレクサ、＜ビデオプロバイダー＞でコメディを探して」や「アレクサ、＜ビデオプロバイダー＞でフットボールを探して」など、タイトル以外のリクエストもサポートしています。このようなリクエストを受け取った場合は、カタログ内で検索を行い、検索リクエストと一致するタイトルのリストを返すことが望ましい動作です。パーソナライゼーションアルゴリズムを活用して、ユーザーの好みに合った結果を返すようにしてください。

ユーザーのリクエストと一致する結果が見つからず、レスポンスで返した結果が0件だった場合は、2つ目のGetDisplayableItemsディレクティブがSORTTYPE = RECOMMENDEDに設定されて送信されます。これを受け取ったら、ユーザーへのおすすめビデオをレスポンスで返します。Alexaは、ユーザーに検索結果が0件であることを伝え、同時にこのおすすめコンテンツを提示します。

{
   "type": "SORTTYPE",
   "value": "RECOMMENDED"
}

GetDisplayableItemsの例

GetDisplayableItemsディレクティブの例を次に示します。

{
    "directive": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "9f4803ec-4c94-4fdf-89c2-d502d5e52bb4",
            "name": "GetDisplayableItems",
            "namespace": "Alexa.VideoContentProvider",
            "payloadVersion": "3"
        },
        "endpoint": {
            "scope": {
                "type": "BearerToken",
                "token": "access-token-from-skill"
            },
            "endpointId": "videoDevice-001",
            "cookie": {

            }
        },
        "payload": {
            "entities": [
                {
                    "type": "Video",
                    "value": "マンチェスター・バイ・ザ・シー",
                    "externalIds": {
                        "imdb": "tt4574334"
                    }
                }
            ],
            "contentType": "RECORDING",
            "locale": "ja-JP",
            "minResultLimit": 8,
            "maxResultLimit": 25,
            "timeWindow": {
                "start": "2016-09-01T00:00:00+00:00",
                "end": "2016-09-07T23:59:00+00:00"
            }
        }
    }
}

GetDisplayableItemsの例（ランディングページ）

ユーザーがプロバイダーのランディングページを開くと、Alexaは2つのGetDisplayableItemsディレクティブを送信します。

1つ目のディレクティブは、ランディングページのカテゴリーを取得するためのものです。itemTypeプロパティはCATEGORYで、SORTTYPEがRECOMMENDEDに設定されています。
2つ目のディレクティブは、ランディングページの注目ビデオを取得するためのものです。1つ目のディレクティブとは異なり、itemTypeがVIDEOに設定されています。

その後、AlexaはカテゴリーIDとビデオIDを組み合わせたリストを含むGetDisplayableItemsMetadata呼び出しを1回送信します。レスポンスには、カテゴリーとビデオに関するメタデータが含まれます。

ランディングページに使用されるGetDisplayableItemsディレクティブの例を次に示します。

{
   "directive": {
       "header": {
           "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
           "messageId": "9f4803ec-4c94-4fdf-89c2-d502d5e52bb4",
           "name": "GetDisplayableItems",
           "namespace": "Alexa.VideoContentProvider",
           "payloadVersion": "3"
        },
       "endpoint": {
           "scope": {
               "type": "BearerToken",
               "token": "access-token-from-skill"
            },
           "endpointId": "videoDevice-001",
           "cookie": {

            }
        },
       "payload": {
           "entities": [
                {
                   "type": "SORTTYPE",
                   "value": "RECOMMENDED"
                }
            ],
           "itemType" : "VIDEO",
           "locale": "ja-JP",
           "minResultLimit": 1,
           "maxResultLimit": 1
        }
    }
}

itemTypeは、検索するアイテムのタイプを指定します。値は、VIDEOまたはCATEGORYのいずれかになります。

ペイロードの説明

次の表は、GetDisplayableItemsディレクティブのpayloadフィールドを定義したものです。

ペイロードの説明
フィールド	説明	データ型
`entities` （必須）	検索するエンティティオブジェクトのリスト。通常、異なるエンティティタイプ間の関係は、AND演算と解釈されます。たとえば、`{genreName = "コメディ," actorName ="トム・ハンクス"}`を含むリクエストの場合、検索結果にはトム・ハンクスが出演するコメディの映画またはテレビ番組が含まれることになります。一方、`{videoName = "インターステラー," VideoName = "宇宙戦争"}`など、同じタイプの複数のエンティティがリクエストに含まれる場合は、OR演算と見なし、ディレクティブ内のすべてのエンティティを検索することができます。不確かな場合は、そのタイプ（このケースでは`videoName`）の先頭のエンティティを最も関連性が高いものと見なします。さらに、`{mediaType = "MOVIE', genreName = "コメディ," actorName ="トム・ハンクス," actorName = "トム・ハンクス}`というリクエストを考えてみましょう。これは、トム・ハンクスという名前の俳優が複数存在すると考えられます。このような場合は、リクエスト内のすべての俳優を含む映画を検索したうえで、コメディのジャンルでフィルタリングして、すべての検索結果を返すことができます。現時点では、一致するエンティティが複数ある場合にユーザーが何を再生したいかを知る方法がAlexaにはないため、エンティティのランク付けは行われません。 `type: Channel`を持つ`entities`には、テレビチャンネルの識別データが格納されます。以下に例を示します。 { "type": "Channel", "value": "PBS", "externalIds": { "imdb": "tt4574334" }, "entityMetadata": { "channelCallSign": "KBTC", "channelNumber": "123" } }	リスト
`type` （必須）	ビデオコンテンツのエンティティタイプ。ビデオコンテンツのエンティティタイプの一覧については、エンティティタイプを参照してください。例： `MediaType`、`video`、`Actor`、`Genre`、`Franchise`、`Season`、`Episode`	文字列
`value` （必須）	エンティティの値。チャンネルの場合は、チャンネル名。例： `インターステラー`、`PBS`	文字列
`itemType` （必須）	`itemType`は、検索するアイテムのタイプを指定します。`itemType`は、ランディングページテンプレートに関連した`GetDisplayableItems`ディレクティブに固有です。ユーザーが（「アレクサ、ACMEのビデオを開いて」と言うか、「ビデオホーム」と言った後でビデオスキルを選択することで）ランディングページを開くと、Alexaは次の2つの`GetDisplayableItems`ディレクティブを送信します。 1つ目の`GetDisplayableItems`ディレクティブは、ランディングページのカテゴリーを取得するためのものです。`itemType`プロパティは`CATEGORY`で、`sortType`が`RECOMMENDED`に設定されています。 2つ目の`GetDisplayableItems`ディレクティブは、ランディングページの注目ビデオを取得するためのものです。1つ目のディレクティブとは異なり、このリクエストでは`itemType`が`VIDEO`に設定されています。 Alexaは両方のディレクティブに対するレスポンス（`GetDisplayableItemsResponse`）を受信したら、カテゴリーIDとビデオIDを組み合わせたリストを含む`GetDisplayableItemsMetadata`呼び出しを1回送信します。レスポンスには、カテゴリーとビデオに関するメタデータが含まれます。例： `VIDEO`、`CATEGORY`	列挙型
`externalIds` （省略可能）	このエンティティの外部識別子のマップ。`key`はプロバイダー、`value`は`id`です。例：`key` = `gti`、`value` = `SH000000012`	オブジェクト
`imdb` （省略可能）	外部IMDB識別子です。例：`tt4574334`	文字列
`contentType` （必須）	`ContentType`は、検索結果で返されたビデオのコンテンツタイプを示します。録画された映画やテレビ番組を送信する場合、`contentType`は`RECORDING`に設定されます。ライブのテレビ番組に関する情報が結果に含まれる場合、`contentType`は`LIVE`に設定されます。オンデマンドコンテンツが結果に含まれる場合、`contentType`は`ON_DEMAND`に設定されます。 `contentType`は、ユーザーにプロンプトを提供する際にも使用されます。たとえば、`contentType`が`LIVE`の場合、「CBSで現在放送中のアカデミー賞はこちらです」などのプロンプトがAlexaから提供されます。 `contentType`が`RECORDING`の場合は、「アカデミー賞はこちらです」などのプロンプトが提供されます。例： `RECORDING`、`LIVE`、`ON_DEMAND`	列挙型
`locale` （必須）	ユーザーのロケール。検索結果に対応する表示可能な情報を取得するために必要となります。ロケールの形式は、Network Working Groupの「Best Current Practice 47（BCP-47）」（英語のみ）で規定されている言語の形式と同じです。認識されないロケールを受信した場合は、デフォルトで`en-US`になります。例：`en-US`、`en-GB`、`de-DE`	文字列
`minResultLimit` （必須）	この呼び出しで返される結果で`pageToken`が必要となる最小件数。`pageToken`は次の結果を取得するためのもので、新しいアイテムを取得する際にこれと一緒に返されたアイテムの件数が`minResultLimit`フィールドよりも少ない場合、Alexaは`pageToken`を無視し、受信したアイテムをそのまま表示します。 `pageToken`を使用して次の結果を取得するのは、アイテムの件数が`minResultLimit`の値以上である場合のみです。ただし、アイテムの件数が`minResultLimit`を超える場合は、`maxResultLimit`が上限となります。アイテムの件数が`maxResultLimit`を超えると、`maxResultLimit`を超えたアイテムはAlexaによって破棄されます。例： `8`	整数
`maxResultLimit` （必須）	返される結果の最大件数（上限）。詳細については、`minResultLimit`フィールドの説明を参照してください。例： `25`	整数
`timeWindow` 省略可能	リクエストされた処理の開始時刻と終了時刻を指定します。これは通常、ライブTVや録画にのみ使用され、オンデマンドコンテンツには使用されません。一般的に、タイムウィンドウが指定されており、それを使用して結果をフィルタリングできる場合は、タイムウィンドウを使用する必要があります。検索対象がオンデマンドコンテンツのみとなるプロバイダーの場合は、タイムウィンドウフィールドが通常nullに設定されているため、無視して構いません。ライブTVや録画でユーザーがタイムウィンドウを指定している場合（「午後4時から5時のテレビ番組を検索して」や「先週録画したテレビ番組を探して」など）、開始時刻と終了時刻が指定されていれば、それらを使用して結果をフィルタリングする必要があります。機能によって、`start`と`end`の両方のフィールドが存在する場合と、どちらか一方のフィールドしか存在しない場合とがあります。たとえば、「午後4時から5時のテレビ番組を検索して」の場合は両方のフィールドが存在しますが、「午後5時に始まるテレビ番組を見せて」の場合、設定されるのは`start`フィールドだけで、`end`フィールドはnullになります。	`start`と`end`の時間を含むオブジェクト
`start` （省略可能）	タイムウィンドウの開始時刻。例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601形式の文字列
`end` （省略可能）	タイムウィンドウの終了時刻。例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601形式の文字列

エンティティタイプ

entitiesオブジェクトは、オブジェクトのリストで構成されています。それぞれのオブジェクトには、タイプ（type）や値のほか、外部IDなどのその他のデータが含まれます。type値として使用できる値は、 Actor、App、Channel、Character、Director、Episode、Event、Franchise、Genre、League、MediaType、ProductionCompany、Season、Sport、SportsTeam、Video、Popularity、Recency、VideoResolutionです。以下のセクションでは、各エンティティタイプのペイロードの詳細について説明します。

Actor

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

Actorペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ASIN`	このエンティティの外部ASINです。	文字列	`B01LTHZVKG`
└─ `imdb`	俳優のIMDB識別子です。	文字列	`tt4034228`
`uri`	俳優／女優へのURIマッピングです。	URI	`entity://provider/actor/caseyaffleck`
`value`	俳優の名前です。	文字列	`ケイシー・アフレック`

App

Appは、ユーザーが発話で指定した明示的なアプリ名を表します。たとえば、「Amazonプライム・ビデオの『マンチェスター・バイ・ザ・シー』」の場合は、以下のようなフィールドが含まれます。

Appペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ENTITY_ID`	アプリのリストに含まれるアプリ識別子です。	文字列	`amzn1.alexa-ask-target.app.72095`
`value`	アプリの名前です。	文字列	`Amazonプライム・ビデオ`

Channel

Channelは、テレビチャンネルの識別データを表します。たとえば、「PBS」には以下のようなフィールドが含まれます。

Channelペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`entityMetadata`	チャンネルに関連付けられたメタデータのマップです。	オブジェクト	—
└─ `channelNumber`	チャンネル番号です。	整数	`1234`
└─ `channelCallSign`	チャンネルのコールサインです。	文字列	`KBTC`
`uri`	チャンネルのURIです。	URI	`entity://provider/channel/1234`
`value`	チャンネルの名前です。	文字列	`PBS`

Character

Characterは、ビデオメディアコンテンツのキャラクターを表します。

Characterペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ASIN`	このエンティティのASIN（Amazon Standard Identification Number）です。	文字列	`B00DT55P3K`
└─ `imdb`	キャラクターのIMDB識別子です。	文字列	`character id`
`uri`	キャラクターへのURIマッピングです。	URI	`entity://provider/character/snowwhite`
`value`	キャラクターの名前です。	文字列	`白雪姫`

Director

Directorは、ビデオメディアコンテンツの監督名を表します。たとえば、「ケネス・ロナーガン」の場合は、以下のようなフィールドが含まれます。

Directorペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	監督へのURIマッピングです。	URI	`entity://provider/director/kennethlonergan`
`value`	監督の名前です。	文字列	`ケネス・ロナーガン`

Episode

Episodeは、TV番組などの連続コンテンツのエピソード番号を表します。たとえば、「トランスペアレント」第8話のエピソード番号は「8」になります。

Episodeペイロードのフィールド	説明	型	例
`value`	エピソード番号です。	整数	`8`

Event

Eventは、イベントタイプへの参照です。これには、スポーツ、音楽、その他のタイプのイベントが含まれます。たとえば、「フットボールの試合」を検索する場合、「試合」というイベントエンティティと「フットボール」というスポーツエンティティが検索されます。

Eventペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	イベントのIMDB識別子です。	文字列	`tt4034228`
`uri`	イベントへのURIマッピングです。	URI	`entity://amazon/events/games`
`value`	イベントタイプの名前です。	文字列	`試合`

Franchise

Franchiseは、映画やTV番組など、複数のビデオエンティティを表すビデオエンティティです。たとえば、「宇宙大戦争」というSFシリーズの場合、映画シリーズのほか、アニメと実写のTV番組もあります。このエンティティタイプを使用すると、たとえばユーザーが「『宇宙大戦争』の映画を探して」とリクエストした場合、1つのタイトルだけでなく、MediaTypeがMOVIEである「宇宙大戦争」の全コンテンツを検索できます。

Franchiseペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	シリーズへのURIマッピングです。	イベントへのURIマッピングです。	`entity://amazon/franchise/intergalacticwars`
`value`	ジャンルの名前です。	文字列	`宇宙大戦争`

Genre

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

Genreペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	ジャンルへのURIマッピングです。	URI	`entity://provider/genre/action`
`value`	ジャンルの名前です。	文字列	`アクション`

League

Leagueは、スポーツリーグのカテゴリー情報を表します。たとえば、NCAAというリーグの場合は、以下のようなフィールドが含まれます。

Leagueペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	リーグのIMDB識別子です。	文字列	`tt4034228`
`uri`	リーグへのURIマッピングです。	URI	`entity://amazon/league/ncaa`
`value`	リーグの名前です。	文字列	`NCAA`

MediaType

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

MediaTypeペイロードのフィールド	説明	型	例
`value`	メディアタイプです。有効な値は、`MOVIE`、`VIDEO`、`TV_SHOW`です。	列挙型	`MOVIE`

ProductionCompany

ProductionCompanyは、ビデオメディアコンテンツの制作会社名を表します（例：Marvels、Disney）。

ProductionCompanyペイロードのフィールド	説明	型	例
`value`	制作会社の名前です。	文字列	`Marvel`

Season

Seasonは、TV番組などの連続コンテンツのシーズン番号を表します。たとえば、「トランスペアレント」シーズン2のシーズン番号は「2」になります。

Seasonペイロードのフィールド	説明	型	例
`value`	シーズン番号です。	整数	`2`

Sport

Sportは、スポーツのカテゴリー情報を表します。たとえば、フットボールの場合は、以下のようなフィールドが含まれます。

Sportペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	スポーツのIMDB識別子です。	文字列	`tt4034228`
`uri`	スポーツへのURIマッピングです。	URI	`entity://amazon/sport/football`
`value`	スポーツの名前です。	文字列	`フットボール`

SportsTeam

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

SportsTeamペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	このチームのIMDB識別子です。	文字列	`tt4034228`
`uri`	スポーツチームへのURIマッピングです。	URI	`entity://amazon/sportsteam/huskies`
`value`	スポーツチームの名前です。	文字列	`ワシントン大学ハスキーズ`

Video

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

Videoペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
`ASIN`	このエンティティの外部ASINです。	文字列	`B01LTHZVKG`
└─ `imdb`	IMDB識別子です。	文字列	`tt4034228`
`userConfirmations`	アイテムのユーザー確認に関する情報を含むオブジェクトです。	オブジェクト
└─ `entitlementVoiceActivation`	視聴期間または視聴権限の音声有効化に成功したかどうかをパートナーに通知するフラグです。有効な値 - `CONFIRMED`（省略可能）。	列挙型（デフォルトポリシー：認識されない値は無視）	`CONFIRMED`
`uri`	ビデオへのURIマッピングです。	URI	`entity://provider/movie/manchesterbythesea`
`value`	ビデオの名前です。	文字列	`マンチェスター・バイ・ザ・シー`

Popularity

Popularityは、ユーザーが人気コンテンツを求めているかどうかを示します。

Popularityペイロードのフィールド	説明	型	例
`value`	ユーザーが人気コンテンツを検索したことをプロバイダーに示します。	文字列	`TRUE`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "TRUE", "type": "Popularity" } ..], ```

Recency

Recencyの解決済みの値は、ユーザーが新しいコンテンツを求めているか、古いコンテンツを求めているかを示します。

Recencyペイロードのフィールド	説明	型	例
`value`	ユーザーが新しいコンテンツと古いコンテンツのどちらを検索するかを示します。有効な値は、`NEW`、`OLD`のいずれかです。	列挙型	`NEW`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "NEW", "type": "Recency" } ..], ```

VideoResolution

VideoResolutionは、リクエストされたビデオ解像度を次のいずれかの規格で表します。

SD (480p)
HD (720p-1080p)
4k (2160p)
8k (4320p)

VideoResolutionペイロードのフィールド	説明	型	例
`value`	ビデオ解像度です。有効な値は、`SD`、`HD`、`4k`、`8k`です。	列挙型	`HD`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "4k", "type": "VideoResolution" } ..], ```

マルチモーダルデバイスでは、追加のエンティティタイプとして、 LISTTYPEとSORTTYPEが用意されています。

LISTTYPEは、ユーザーがウォッチリストやライブラリの閲覧を希望した場合に設定されます。たとえば、「ウォッチリストを見せて」や「ビデオライブラリを見せて」といった発話が挙げられます。 LISTTYPEには、次の列挙値を設定できます。

WATCHLIST：「ウォッチリストを見せて」 - ユーザーのウォッチリストに追加されているビデオを表示する際に使用します。
LIBRARY：「ビデオライブラリを見せて」 - ユーザーのライブラリに存在するビデオを表示する際に使用します。通常、これにはユーザーが購入したビデオが該当します。

SORTTYPEは、検索時に使用するリクエストや、結果のソート方法に関して、追加情報を提供する際に使用されます。たとえば、「おすすめの映画を見せて」という発話の場合、Alexaはコンテンツプロバイダーからのおすすめコンテンツを取得する必要があります。SORTTYPEには、次の列挙値を設定できます。

RECOMMENDED：「おすすめの映画を見せて」や「おすすめのアクション映画を見せて」といった発話の場合、この値が設定されます。

エクスペリエンスタイプ

experienceオブジェクトを使用すると、検索に使用されたデバイスに基づいて、検索結果の表示を最適化できます。たとえば、ユーザーがFire TVリモコンを使用して検索した場合、ユーザーはリモコンを使用して結果を閲覧できるため、experienceオブジェクトによって多数の検索結果が表示されます。一方、Fire TVとペアリングされたEchoを使用して検索リクエストが行われた場合は、experienceオブジェクトによって表示される結果の数と表示方法が制限され、ユーザーはリモコンを使用せずに結果を確認できます。

experienceオブジェクトは、検索結果の表示方法を決定するmodeオブジェクトで構成されています。modeオブジェクトは、 VOICE_OPTIMIZEDとDEFAULTの2つの値を取ります。

VOICE_OPTIMIZED：音声専用デバイス向けに最適化された表示方法です。リモコンを使用せずに音声で操作できる検索結果のリストが表示されます。
DEFAULT：検索に使用されたデバイスに関係なく、すべての検索結果をリスト形式で表示する、デフォルトの表示方法です。

上位互換性を確保するため、modeで不明な値を受け取った場合は、失敗とするのではなく、DEFAULTにフォールバックするようにしてください。

レスポンスの例

GetDisplayableItemsディレクティブを受信したら、LambdaからGetDisplayableItemsResponseを送信する必要があります。レスポンスには、デバイスに表示するアイテムのid値のリストを含める必要があります。

LambdaからAlexaに返されるGetDisplayableItemsResponseの例を次に示します。

{
"directive": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "5f0a0546-caad-416f-a617-80cf083a05cd",
            "name": "GetDisplayableItemsResponse",
            "namespace": "Alexa.VideoContentProvider",
            "payloadVersion": "3"
        },
        "payload": {
            "nextToken": "fvkjbr20dvjbkwOpqStr",
            "mediaItems": [{
                    "mediaIdentifier": {
                        "id": "tt1254207"
                    }
                },
                {
                    "mediaIdentifier": {
                        "id": "tt0807840"
                    }
                },
                {
                    "mediaIdentifier": {
                        "id": "tt7993892"
                    }
                },
                {
                    "mediaIdentifier": {
                        "id": "tt4957236"
                    }
                },
                {
                    "mediaIdentifier": {
                        "id": "tt2285752"
                    }
                }
            ]
        }
    }
};

ペイロードの説明

次の表は、GetDisplayableItemsResponseのpayloadフィールドについて説明しています。

ペイロードの説明
フィールド	説明	データ型
`nextToken` 省略可能	次の結果セットを取得するためのトークン。プロバイダーから送信される不透明型の文字列で、後続の検索リクエストで返されます。	文字列
`mediaItems` （必須）	検索結果として画面に表示されるビデオの`mediaIdentifier`のリスト。	リスト
`mediaIdentifier` （必須）	`mediaItem`の識別子。mediaIdentifierオブジェクトからの画像サイズデータの取得を参照してください。	オブジェクト
`id` （必須）	ビデオアイテムの識別子。後続の`GetDisplayableItemsMetadata`または`GetPlayableItemsMetadata`の呼び出しで、表示または再生に関連したメタデータ情報を取得する目的で使用されます。この識別子は、Alexaからは認識できず、メタデータ情報を照会する際にそのまま使用されます。	文字列

インターフェース機能に対するサポートの宣言

ビデオスキルがAlexa.RemoteVideoPlayerインターフェースをサポートしていることを示すには、Alexa.Discoveryインターフェースを介して送信されたDiscoverディレクティブへのレスポンスで、そのサポートを明示する必要があります。詳細については、Discoveryインターフェースを参照してください。