نمایندگی JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
فیلدها | ||
---|---|---|
name | نام آرگومان ارائه شده برای ورودی. | |
rawText | متن خام، تایپ شده یا گفتاری، که مقدار آرگومان را ارائه می کند. | |
textValue | زمانی مشخص میشود که الگوی پرسوجو شامل یک | |
status | زمانی که هنگام محاسبه آرگومان با خطا مواجه شد مشخص شد. به عنوان مثال، اگر کاربر اجازه دسترسی به مکان دستگاه خود را رد کند، هدف داخلی "actions.intent.PLACE" می تواند وضعیت خطا را بازگرداند. | |
value فیلد اتحادیه یکی از موارد زیر مشخص شده است. value فقط می تواند یکی از موارد زیر باشد: | ||
intValue | زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع $org.schema.type.Number یا ورودی مورد انتظار دارای یک هدف داخلی باشد: "assistant.intent.action.NUMBER". | |
floatValue | برای هدف داخلی مشخص شده است: "actions.intent.NUMBER" | |
boolValue | زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع | |
datetimeValue | برای هدف داخلی مشخص شده است: | |
placeValue | زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع $org.schema.type.Location یا ورودی مورد انتظار دارای یک هدف داخلی باشد: "actions.intent.PLACE". | |
extension | پسوندی که نوع آن به آرگومان بستگی دارد. برای مثال، اگر نام آرگومان یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی | |
structuredValue | زمانی مشخص میشود که Google باید مقدار داده را در قالب JSON ارسال کند. |
وضعیت
نوع Status
یک مدل خطای منطقی را تعریف می کند که برای محیط های برنامه نویسی مختلف، از جمله REST API و RPC API مناسب است. توسط gRPC استفاده می شود. هر پیام Status
شامل سه داده است: کد خطا، پیام خطا و جزئیات خطا.
در راهنمای طراحی API میتوانید درباره این مدل خطا و نحوه کار با آن اطلاعات بیشتری کسب کنید.
نمایندگی JSON | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
فیلدها | |
---|---|
code | کد وضعیت، که باید مقداری از |
message | یک پیغام خطای برنامهنویس، که باید به زبان انگلیسی باشد. هر پیام خطای کاربر باید بومی سازی شده و در قسمت |
details[] | لیستی از پیام هایی که حاوی جزئیات خطا هستند. مجموعه ای متداول از انواع پیام ها برای استفاده API ها وجود دارد. یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی |
تاریخ زمان
مقدار آرگومان تاریخ و زمان از ورودی کاربر تجزیه شده است. اطلاعات منطقه زمانی را شامل نمی شود.
نمایندگی JSON | |
---|---|
{ "date": { object ( |
فیلدها | |
---|---|
date | مقدار تاریخ |
time | ارزش زمانی |
تاریخ
یک تاریخ تقویم کامل یا جزئی را نشان می دهد، به عنوان مثال تولد. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده اند یا مهم نیستند. تاریخ نسبت به تقویم گرگوری پرولپتیک است. این می تواند نشان دهنده:
- تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر
- مقدار یک ماه و روز، با سال صفر، به عنوان مثال یک سالگرد
- یک سال به تنهایی، با مقادیر ماه و روز صفر
- ارزش سال و ماه، با روز صفر، به عنوان مثال تاریخ انقضای کارت اعتباری
انواع مرتبط google.type.TimeOfDay
و google.protobuf.Timestamp
هستند.
نمایندگی JSON | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
فیلدها | |
---|---|
year | سال تاریخ. باید از 1 تا 9999 یا 0 در صورت تعیین تاریخ بدون سال باشد. |
month | ماه سال. باید از 1 تا 12 یا 0 در صورت مشخص کردن یک سال بدون ماه و روز باشد. |
day | روز ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا اگر یک سال به خودی خود یا سال و ماهی را مشخص کنید که روز مهم نیست، 0 باشد. |
TimeOfDay
یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date
و google.protobuf.Timestamp
.
نمایندگی JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
فیلدها | |
---|---|
hours | ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند. |
minutes | دقیقه از ساعت روز. باید از 0 تا 59 باشد. |
seconds | ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند. |
nanos | کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد. |