開発者コンソール

GetDisplayableItemsディレクティブ


GetDisplayableItemsディレクティブ

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

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

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

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ディレクティブの処理

VideoNameActorNameGenreNameなどの条件を使用してユーザーがコンテンツを検索すると、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": {
                        "gracenote": "MV000000099001"
                    }
                }
            ],
            "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で、SORTTYPERECOMMENDEDに設定されています。
  • 2つ目のディレクティブは、ランディングページの注目ビデオを取得するためのものです。1つ目のディレクティブとは異なり、itemTypeVIDEOに設定されています。

その後、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": {
      "gracenote": "MV000000099001"
  },
  "entityMetadata": {
      "channelCallSign": "KBTC",
      "channelNumber": "123"
  }
} 

リスト
type
(必須)

ビデオコンテンツのエンティティタイプ。ビデオコンテンツのエンティティタイプの一覧については、エンティティタイプを参照してください。



例: MediaTypevideoActorGenreFranchiseSeasonEpisode

文字列
value
(必須)

エンティティの値。チャンネルの場合は、チャンネル名。



例: インターステラーPBS

文字列
itemType
(必須)

itemTypeは、検索するアイテムのタイプを指定します。itemTypeは、ランディングページテンプレートに関連したGetDisplayableItemsディレクティブに固有です。ユーザーが(「アレクサ、ACMEのビデオを開いて」と言うか、「ビデオホーム」と言った後でビデオスキルを選択することで)ランディングページを開くと、Alexaは次の2つのGetDisplayableItemsディレクティブを送信します。

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

Alexaは両方のディレクティブに対するレスポンス(GetDisplayableItemsResponse)を受信したら、カテゴリーIDとビデオIDを組み合わせたリストを含むGetDisplayableItemsMetadata呼び出しを1回送信します。レスポンスには、カテゴリーとビデオに関するメタデータが含まれます。



例: VIDEOCATEGORY

列挙型
externalIds
(省略可能)
このエンティティの外部識別子のマップ。keyはプロバイダー、valueidです。

例:key = gtivalue = SH000000012

オブジェクト
Gracenote
(省略可能)

外部Gracenote IDです。



例: SP0000000666661

文字列
contentType
(必須)

ContentTypeは、検索結果で返されたビデオのコンテンツタイプを示します。録画された映画やテレビ番組を送信する場合、contentTypeRECORDINGに設定されます。ライブのテレビ番組に関する情報が結果に含まれる場合、contentTypeLIVEに設定されます。オンデマンドコンテンツが結果に含まれる場合、contentTypeON_DEMANDに設定されます。

contentTypeは、ユーザーにプロンプトを提供する際にも使用されます。たとえば、contentTypeLIVEの場合、「CBSで現在放送中のアカデミー賞はこちらです」などのプロンプトがAlexaから提供されます。 contentTypeRECORDINGの場合は、「アカデミー賞はこちらです」などのプロンプトが提供されます。



例: RECORDINGLIVEON_DEMAND

列挙型
locale
(必須)

ユーザーのロケール。検索結果に対応する表示可能な情報を取得するために必要となります。ロケールの形式は、Network Working Groupの「Best Current Practice 47(BCP-47)」(英語のみ)で規定されている言語の形式と同じです。認識されないロケールを受信した場合は、デフォルトでen-USになります。



例:en-USen-GBde-DE

文字列
minResultLimit
(必須)

この呼び出しで返される結果でpageTokenが必要となる最小件数。pageTokenは次の結果を取得するためのもので、新しいアイテムを取得する際にこれと一緒に返されたアイテムの件数がminResultLimitフィールドよりも少ない場合、AlexaはpageTokenを無視し、受信したアイテムをそのまま表示します。

pageTokenを使用して次の結果を取得するのは、アイテムの件数がminResultLimitの値以上である場合のみです。ただし、アイテムの件数がminResultLimitを超える場合は、maxResultLimitが上限となります。アイテムの件数がmaxResultLimitを超えると、maxResultLimitを超えたアイテムはAlexaによって破棄されます。



例: 8

整数
maxResultLimit
(必須)

返される結果の最大件数(上限)。詳細については、minResultLimitフィールドの説明を参照してください。



例: 25

整数
timeWindow
(省略可能)

リクエストされた処理の開始時刻と終了時刻を指定します。これは通常、ライブTVや録画にのみ使用され、オンデマンドコンテンツには使用されません。一般的に、タイムウィンドウが指定されており、それを使用して結果をフィルタリングできる場合は、タイムウィンドウを使用する必要があります。

検索対象がオンデマンドコンテンツのみとなるプロバイダーの場合は、タイムウィンドウフィールドが通常nullに設定されているため、無視して構いません。

ライブTVや録画でユーザーがタイムウィンドウを指定している場合(「午後4時から5時のテレビ番組を検索して」や「先週録画したテレビ番組を探して」など)、開始時刻と終了時刻が指定されていれば、それらを使用して結果をフィルタリングする必要があります。

機能によって、startendの両方のフィールドが存在する場合と、どちらか一方のフィールドしか存在しない場合とがあります。たとえば、「午後4時から5時のテレビ番組を検索して」の場合は両方のフィールドが存在しますが、「午後5時に始まるテレビ番組を見せて」の場合、設定されるのはstartフィールドだけで、endフィールドはnullになります。

startendの時間を含むオブジェクト
start
(省略可能)

タイムウィンドウの開始時刻。



例: 2016-09-07T23:59:00+00:002018-01-24T02:30:00Z

ISO 8601形式の文字列
end
(省略可能)

タイムウィンドウの終了時刻。



例: 2016-09-07T23:59:00+00:002018-01-24T02:30:00Z

ISO 8601形式の文字列

エンティティタイプ

entitiesオブジェクトは、オブジェクトのリストで構成されています。それぞれのオブジェクトには、タイプ(type)や値のほか、外部IDなどのその他のデータが含まれます。type値として使用できる値は、 ActorAppChannelCharacterDirectorEpisodeEventFranchiseGenreLeagueMediaTypeProductionCompanySeasonSportSportsTeamVideoPopularityRecencyVideoResolutionです。以下のセクションでは、各エンティティタイプのペイロードの詳細について説明します。

Actor

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

Actorペイロードのフィールド 説明
externalIds このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。 オブジェクト
└─ ASIN このエンティティの外部ASINです。 文字列 B01M3X9T06
└─ gracenote 俳優のGracenote IDです。 文字列 SP0000000666661
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です。 オブジェクト
└─ gracenote 外部Gracenote IDです。 文字列 SP0000000666661
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
└─ gracenote キャラクターのGracenote IDです。 文字列 ST0000000123456
uri キャラクターへのURIマッピングです。 URI entity://provider/character/snowwhite
value キャラクターの名前です。 文字列 白雪姫

Director

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

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

Episode

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

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

Event

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

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

Franchise

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

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

Genre

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

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

League

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

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

MediaType

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

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

ProductionCompany

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

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

Season

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

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

Sport

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

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

SportsTeam

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

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

Video

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

Videoペイロードのフィールド 説明
externalIds このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。 オブジェクト
ASIN このエンティティの外部ASINです。 文字列 B01M3X9T06
└─ gracenote Gracenote IDです。 文字列 MV0000000666661
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 ユーザーが新しいコンテンツと古いコンテンツのどちらを検索するかを示します。有効な値は、NEWOLDのいずれかです。 列挙型 NEW
このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例(関連する値のみ抜粋)は次のようになります。```json "entities": [..{ "value": "NEW", "type": "Recency" } ..], ```

VideoResolution

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

  • SD (480p)
  • HD (720p-1080p)
  • 4k (2160p)
  • 8k (4320p)
VideoResolutionペイロードのフィールド 説明
value ビデオ解像度です。有効な値は、SDHD4k8kです。 列挙型 HD
このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例(関連する値のみ抜粋)は次のようになります。```json "entities": [..{ "value": "4k", "type": "VideoResolution" } ..], ```

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

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

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

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

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

レスポンスの例

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"
                    }
                }
            ]
        }
    }
};

ペイロードの説明

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

ペイロードの説明
フィールド 説明 データ型
nextToken
(省略可能)

次の結果セットを取得するためのトークン。プロバイダーから送信される不透明型の文字列で、後続の検索リクエストで返されます。

文字列
mediaItems
(必須)

検索結果として画面に表示されるビデオのmediaIdentifierのリスト。

リスト
mediaIdentifier
(必須)

mediaItemの識別子。mediaIdentifierオブジェクトからの画像サイズデータの取得を参照してください。

オブジェクト
id
(必須)

ビデオアイテムの識別子。後続のGetDisplayableItemsMetadataまたはGetPlayableItemsMetadataの呼び出しで、表示または再生に関連したメタデータ情報を取得する目的で使用されます。この識別子は、Alexaからは認識できず、メタデータ情報を照会する際にそのまま使用されます。

文字列

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

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