В таблице ниже перечислены типы шаблонов запросов, определенных в Schema.org, для специальных действий на устройстве. Название каждого типа начинается с $SchemaOrg. Эти типы соответствуют стандартным типам, определенным в Schema.org.
Некоторые из этих типов возвращают структурированные данные, а не одно значение. Эти типы указаны в таблице. Подробнее о структурированных данных…
Поддерживаемые типы schema.org
| Тип | Пример шаблона для разработчиков | Пример запроса пользователя | Поддержка структурированных данных |
|---|---|---|---|
| $SchemaOrg_Date | Прочитай SMS от пользователя $SchemaOrg_Date:my_date в SMS Pro. |
Прочитай SMS за 1 апреля в SMS Pro. | Да |
| $SchemaOrg_Number | мигать фонариком $SchemaOrg_Number:number раз |
мигать фонариком пять раз; | Нет |
| $SchemaOrg_Time | Прочитай SMS от пользователя $SchemaOrg_Time:my_time в SMS Pro. |
Прочитай мои SMS, полученные после 17:00, в SMS Pro. | Да |
| $SchemaOrg_DateTime | Прочитай SMS от пользователя $SchemaOrg_DateTime:my_time в SMS Pro. |
Прочитай SMS, полученные вчера в полдень, в SMS Pro. | Да |
| $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 |
Установи температуру 21 градус Цельсия. | Нет |
| $SchemaOrg_Organization | Смотрите лучшие моменты матча "$SchemaOrg_Organization:organization" |
Покажи лучшие моменты матчей Лейкерс | Нет |
Покажи курс акций $SchemaOrg_Organization:organization |
Покажи мне курс акций Google. | Нет | |
| $SchemaOrg_Person | Покажи топ-10 песен $SchemaOrg_Person:musician |
покажи 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 в очередь. |
Добавь альбом Abbey Road в очередь. | Нет |
| $SchemaOrg_MusicRecording | Добавь $SchemaOrg_MusicRecording:song в избранное. |
Добавь песню With or Without You в избранное. | Нет |
| $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? |
Что это за песня, в которой поется "you are my sunshine"? | Нет |
Структурированные данные
Некоторые типы поддерживают передачу структурированных данных вместо одного значения.
В разделе deviceExecution добавьте .structured к названию параметра, чтобы получать структурированные данные для следующих типов:
"my-param-name": "$parameter-name.structured"
где my-param-name – заданное пользователем название, которое возвращается в params, а parameter-name – идентификатор параметра в шаблоне запроса.
Вот пример:
Место
Запрос
Написать отзыв о Нью-Йорке
Пакет Action
...
"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
}
}