schema.org 查詢模式類型

下表列出自訂裝置動作的 Schema.org 定義查詢模式類型。每種類型的名稱開頭都是 $SchemaOrg。這些類型對應於 Schema.org 中定義的標準類型。

其中有些類型會傳回結構化資料，而非單一值。表格會顯示這些類型。詳情請參閱結構化資料。

支援的 Schema.org 類型

類型	開發人員模式範例	使用者查詢範例	支援結構化資料
$SchemaOrg_Date	在簡訊 Pro 上讀取「`$SchemaOrg_Date:my_date`」的簡訊。	在 4 月 1 日傳簡訊給簡訊專家	是
$SchemaOrg_Number	閃爍手電筒 `$SchemaOrg_Number:number` 次	將手電筒閃爍五次	否
$SchemaOrg_Time	在簡訊 Pro 上讀取「`$SchemaOrg_Time:my_time`」的簡訊。	在下午 5 點傳簡訊給對方	是
$SchemaOrg_DateTime	在簡訊 Pro 上讀取「`$SchemaOrg_DateTime:my_time`」的簡訊。	唸出昨天中午的簡訊。	是
$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_Temperature:temp` `$SchemaOrg_Number:num` 度	將溫度設為華氏 21 度	否
$SchemaOrg_Organization	觀看「`$SchemaOrg_Organization:organization`」的精彩片段	觀看湖人隊精彩回顧	否
$SchemaOrg_Organization	顯示 `$SchemaOrg_Organization:organization`的股價	顯示 Google 的股價	否
$SchemaOrg_Person	顯示`$SchemaOrg_Person:musician`前 10 名歌曲	顯示前 10 名暴龍歌曲	否
$SchemaOrg_Person	顯示有關`$SchemaOrg_Person:person`的新聞	顯示帳單登機門相關新聞	否
$SchemaOrg_Place	撰寫「`$SchemaOrg_Place:place`」的評論	撰寫新約克人的評論	是
$SchemaOrg_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`	將 john@google.com 新增為聯絡人	否
$SchemaOrg_PhoneNumber	新增 `$SchemaOrg_PhoneNumber:phonenumber`	加 (777) 777-7777	否
$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
}

日期

詳情請參閱「日期」一節。

傳回的參數：

{
    "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
    }
}