انواع الگوی پُرسمان Schema.org

جدول زیر انواع الگوهای پُرسمان تعریف‌شده در Schema.org را برای «کنش‌های سفارشی دستگاه» فهرست می‌کند. نام هر نوع با $SchemaOrg شروع می‌شود. این انواع با انواع استاندارد تعریف‌شده در Schema.org مطابقت دارند.

برخی‌از این انواع به‌جای یک مقدار، داده‌های ساختاریافته برمی‌گردانند. این انواع در جدول نشان داده شده است. برای اطلاعات بیشتر، داده‌های ساختاریافته را ببینید.

انواع Schema.org پشتیبانی‌شده

نوع	الگوی توسعه‌دهنده نمونه	نمونه پُرسمان کاربر	از داده‌های ساختاریافته پشتیبانی می‌کند
$SchemaOrg_Date	پیامک‌هایم از $SchemaOrg_Date:my_date را در sms pro بخوان	read my sms from april 1st on sms pro	بله
$SchemaOrg_Number	چراغ‌قوه $SchemaOrg_Number:number بار چشمک بزند	چراغ‌قوه پنج بار چشمک می‌زند	نه
$SchemaOrg_Time	پیامک‌هایم از $SchemaOrg_Time:my_time را در sms pro بخوان	read my sms from 5 pm on sms pro (پیامک‌هایم را از ساعت ۵ بعدازظهر در sms pro بخوان)	بله
$SchemaOrg_DateTime	پیامک‌هایم از $SchemaOrg_DateTime:my_time را در sms pro بخوان	read my sms from yesterday noon on sms pro (پیامک‌های دیروز ظهرم را در 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	دما را روی ۷۰ درجه فارنهایت تنظیم کن	نه
$SchemaOrg_Organization	تماشای لحظه‌های برگزیده $SchemaOrg_Organization:organization	watch lakers highlights (تماشای لحظه‌های برگزیده لیکرز)	نه
	قیمت سهام $SchemaOrg_Organization:organization را نشانم بده	قیمت سهام Google را نشانم بده	نه
$SchemaOrg_Person	۱۰ آهنگ برتر $SchemaOrg_Person:musician را نشان بده	show top 10 bruno mars songs (۱۰ آهنگ برتر برونو مارس را نشان بده)	نه
	اخبار مربوط به $SchemaOrg_Person:person را نشانم بده	اخبار مربوط به بیل گیتس را نشانم بده	نه
$SchemaOrg_Place	نوشتن مرور برای $SchemaOrg_Place:place	write review for new york (نوشتن مرور برای نیویورک)	بله
	ترافیک $SchemaOrg_Place:location را نشان بده	show traffic on mountain view (ترافیک را در ماونتین ویو نشان بده)	بله
$SchemaOrg_Product	نوشتن مرور برای $SchemaOrg_Product:product	write review for google glass (نوشتن نقد برای google glass)	نه
$SchemaOrg_Book	خواندن $SchemaOrg_Book:my_book	read great expectations	نه
$SchemaOrg_Movie	پخش کردن فیلم $SchemaOrg_Movie:my_movie	review the casablanca movie (فیلم کازابلانکا را نقد کن)	نه
$SchemaOrg_TVSeries	play next episode of $SchemaOrg_TVSeries:tv_series	play next episode of friends (قسمت بعدی «دوستان» را پخش کن)	نه
$SchemaOrg_servesCuisine	نمایش دادن $SchemaOrg_servesCuisine:my_cuisine رستوران	رستوران‌های ایتالیایی را نشان بده	نه
$SchemaOrg_MusicAlbum	‫$SchemaOrg_MusicAlbum:album را به صف پخش من اضافه کن.	add abbey road to my queue (ابی رود را به صف پخش من اضافه کن)	نه
$SchemaOrg_MusicRecording	$SchemaOrg_MusicRecording:song را به موارد دلخواهم اضافه کن.	add with or without you to my favorites (با یا بدون تو به موارد دلخواهم اضافه کن).	نه
$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 می‌بود.

تاریخ

برای اطلاعات بیشتر، تاریخ را ببینید.

پارامترهای برگردانده‌شده:

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