Schema.org クエリパターン タイプ

次の表に、カスタム デバイス アクションの Schema.org で定義されているクエリパターン タイプを示します。各タイプの名前は $SchemaOrg で始まります。これらのタイプは、Schema.org で定義されている標準タイプに対応しています。

これらのタイプの中には、単一の値ではなく構造化データを返すものがあります。これらのタイプは表に示されています。詳しくは、構造化データをご覧ください。

サポートされている Schema.org タイプ

種類	デベロッパー パターンの例	ユーザークエリの例	構造化データのサポート
$SchemaOrg_Date	sms pro で $SchemaOrg_Date:my_date の SMS を読んで	sms pro で 4 月 1 日の SMS を読んで	はい
$SchemaOrg_Number	ライトを $SchemaOrg_Number:number 回点滅させて	ライトを 5 回点滅させて	×
$SchemaOrg_Time	sms pro で $SchemaOrg_Time:my_time の SMS を読んで	SMS プロで午後 5 時の SMS を読んで	はい
$SchemaOrg_DateTime	sms pro で $SchemaOrg_DateTime:my_time の SMS を読んで	sms Pro で昨日正午の SMS を読んで	はい
$SchemaOrg_DayOfWeek	$SchemaOrg_DayOfWeek:day_of_week の会議を表示して	火曜日のミーティングを見せて	×
$SchemaOrg_Color	$SchemaOrg_Color:my_color のストロボをつけて	赤いストロボをつけて	×
$SchemaOrg_priceCurrency	通貨アプリで $SchemaOrg_priceCurrency:cur の換算率を表示	通貨アプリで円の換算率を表示して	×
$SchemaOrg_Distance	$SchemaOrg_Distance:dist のコンバージョン グラフを表示	キロメートルの換算チャートを表示	×
$SchemaOrg_Temperature	温度を $SchemaOrg_Number:num 度に設定 $SchemaOrg_Temperature:temp	温度を華氏 20 度に設定して	×
$SchemaOrg_Organization	$SchemaOrg_Organization:organization のハイライトを見る	レイカーズ ハイライトを視聴する	×
	$SchemaOrg_Organization:organizationの株価を表示して	Google の株価を見せて	×
$SchemaOrg_Person	$SchemaOrg_Person:musician の上位 10 曲を表示	ブルーノ マーズの楽曲トップ 10 を表示して	×
	$SchemaOrg_Person:person に関するニュースを見せて	ビルゲートに関するニュースを見せて	×
$SchemaOrg_Place	$SchemaOrg_Place:place のクチコミを書く	ニューヨークのレビューを書く	はい
	$SchemaOrg_Place:location の交通状況を表示して	マウンテンビューで交通状況を表示して	はい
$SchemaOrg_Product	$SchemaOrg_Product:product のクチコミを書く	Google Glass のレビューを書く	×
$SchemaOrg_Book	$SchemaOrg_Book:my_book を読む	期待が高まっている	×
$SchemaOrg_Movie	$SchemaOrg_Movie:my_movieの映画を再生	カサブランカの映画を確認して	×
$SchemaOrg_TVSeries	「$SchemaOrg_TVSeries:tv_series」の次のエピソードを再生する	友だちの次のエピソードを再生する	×
$SchemaOrg_servesCuisine	$SchemaOrg_servesCuisine:my_cuisine 件のレストランを表示	イタリア料理レストランを表示	×
$SchemaOrg_MusicAlbum	$SchemaOrg_MusicAlbum:album をキューに追加して。	アビーロードをキューに追加して	×
$SchemaOrg_MusicRecording	$SchemaOrg_MusicRecording:song をお気に入りに追加。	いつでもお気に入りに登録できます	×
$SchemaOrg_YesNo	$SchemaOrg_YesNo:yesno	はい	×
$SchemaOrg_URL	$SchemaOrg_URL:url を追加します	google.com を追加する	×
$SchemaOrg_Email	$SchemaOrg_Email:email を追加します	[e-mail] を追加する	×
$SchemaOrg_PhoneNumber	$SchemaOrg_PhoneNumber:phonenumber を追加します	[phone] を追加	×
$SchemaOrg_Text	あの歌は何ていう？$SchemaOrg_Text:text	なんて曲で、君は私の太陽だって言ってるの？	×

構造化データ

型によっては、単一の値ではなく構造化データを返すことができます。deviceExecution セクションで、パラメータ名に .structured を追加して、これらのタイプの構造化データを受け取ります。

"my-param-name": "$parameter-name.structured"

ここで、my-param-name は params で返されるユーザー定義の名前、parameter-name はクエリパターンのパラメータです。

次の例をご覧ください。

場所

クエリ

ニューヨークに関するクチコミを書く

アクション パッケージ

...

"intent": {
    "name": "com.example.intents.Review",
    "parameters": [
        {
            "name": "place",
            "type": "SchemaOrg_Place"
        }
    ],
    "trigger": {
        "queryPatterns": [
            "write review for $SchemaOrg_Place:place"
        ]
    }
},

...

"deviceExecution": {
    "command": "com.example.commands.Review",
    "params": {
        "placeName": "$place.structured"
    }
}

...

返されるパラメータ

詳細については、LatLng をご覧ください。

"placeName": {
    "latitude": 40.7128,
    "longitude": 74.0060
}

注: .structured が追加されていない場合、placeName には New York が含まれます。

日付

詳細については、Date をご覧ください。

返されるパラメータ:

{
    "year": 2018,
    "month": 12,
    "day": 2
}

時間

詳細については、TimeOfDay をご覧ください。

返されるパラメータ:

{
    "hours": 12,
    "minutes": 0,
    "seconds": 0,
    "nanos": 0
}

DateTime

詳細については、DateTime をご覧ください。

返されるパラメータ:

{
    "date": {
      "year": 2018,
      "month": 11,
      "day": 30
    },
    "time": {
      "hours": 12,
      "minutes": 0,
      "seconds": 0,
      "nanos": 0
    }
}