Argument

نمایندگی JSON
{
  "name": string,
  "rawText": string,
  "textValue": string,
  "status": {
    object (Status)
  },

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "boolValue": boolean,
  "datetimeValue": {
    object (DateTime)
  },
  "placeValue": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "structuredValue": {
    object
  }
  // End of list of possible types for union field value.
}
زمینه های
name

string

نام آرگومان ارائه شده برای ورودی.

rawText

string

متن خام، تایپ شده یا گفتاری، که مقدار آرگومان را ارائه می کند.

textValue

string

زمانی مشخص می‌شود که الگوی پرس‌وجو شامل یک $org.schema.type.Text نوع متن یا ورودی مورد انتظار دارای یک هدف داخلی باشد: actions.intent.TEXT یا actions.intent.OPTION . توجه داشته باشید که برای هدف OPTION ، textValue به‌عنوان کلید گزینه تنظیم می‌کنیم، rawText بالا دامنه خام را در کوئری کاربر نشان می‌دهد.

status

object ( Status )

زمانی که هنگام محاسبه آرگومان با خطا مواجه شد مشخص شد. به عنوان مثال، اگر کاربر اجازه دسترسی به مکان دستگاه خود را رد کند، هدف داخلی "actions.intent.PLACE" می تواند وضعیت خطا را بازگرداند.

value فیلد اتحادیه یکی از موارد زیر مشخص شده است. value فقط می تواند یکی از موارد زیر باشد:
intValue

string ( int64 format)

زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع $org.schema.type.Number یا ورودی مورد انتظار دارای یک هدف داخلی باشد: "assistant.intent.action.NUMBER".

floatValue

number

برای هدف داخلی مشخص شده است: "actions.intent.NUMBER"

boolValue

boolean

زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع $org.schema.type.YesNo باشد یا ورودی مورد انتظار دارای یک هدف داخلی باشد: actions.intent.CONFIRMATION . توجه: اگر مقدار بولی گم شده باشد، نشان دهنده false است.

datetimeValue

object ( DateTime )

برای هدف داخلی مشخص شده است: actions.intent.DATETIME .

placeValue

object ( Location )

زمانی مشخص می شود که الگوی پرس و جو شامل یک نوع $org.schema.type.Location یا ورودی مورد انتظار دارای یک هدف داخلی باشد: "actions.intent.PLACE".

extension

object

پسوندی که نوع آن به آرگومان بستگی دارد. برای مثال، اگر نام آرگومان SIGN_IN برای intent actions.intent.SIGN_IN باشد، این پسوند حاوی یک مقدار SignInValue خواهد بود.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

structuredValue

object ( Struct format)

زمانی مشخص می‌شود که Google باید مقدار داده را در قالب JSON ارسال کند.

وضعیت

نوع Status یک مدل خطای منطقی را تعریف می کند که برای محیط های برنامه نویسی مختلف، از جمله REST API و RPC API مناسب است. توسط gRPC استفاده می شود. هر پیام Status شامل سه داده است: کد خطا، پیام خطا و جزئیات خطا.

در راهنمای طراحی API می‌توانید درباره این مدل خطا و نحوه کار با آن اطلاعات بیشتری کسب کنید.

نمایندگی JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
زمینه های
code

integer

کد وضعیت، که باید مقداری از google.rpc.Code باشد.

message

string

یک پیغام خطای برنامه‌نویس، که باید به زبان انگلیسی باشد. هر پیام خطای کاربر باید بومی سازی شده و در قسمت google.rpc.Status.details ارسال شود یا توسط مشتری بومی سازی شود.

details[]

object

لیستی از پیام هایی که حاوی جزئیات خطا هستند. مجموعه ای متداول از انواع پیام ها برای استفاده API ها وجود دارد.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

زمان قرار

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
زمینه های
date

object ( Date )

مقدار تاریخ

time

object ( TimeOfDay )

ارزش زمانی

تاریخ

یک تاریخ تقویم کامل یا جزئی را نشان می دهد، به عنوان مثال تولد. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده اند یا مهم نیستند. تاریخ نسبت به تقویم گرگوری پرولپتیک است. این می تواند نشان دهنده:

  • تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر
  • مقدار یک ماه و روز، با سال صفر، به عنوان مثال یک سالگرد
  • یک سال به تنهایی، با مقادیر ماه و روز صفر
  • ارزش سال و ماه، با روز صفر، به عنوان مثال تاریخ انقضای کارت اعتباری

انواع مرتبط google.type.TimeOfDay و google.protobuf.Timestamp هستند.

نمایندگی JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
زمینه های
year

integer

سال تاریخ. باید از 1 تا 9999 یا 0 در صورت تعیین تاریخ بدون سال باشد.

month

integer

ماه سال. باید از 1 تا 12 یا 0 در صورت مشخص کردن یک سال بدون ماه و روز باشد.

day

integer

روز ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا اگر یک سال به خودی خود یا سال و ماهی را مشخص کنید که روز مهم نیست، 0 باشد.

TimeOfDay

یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date و google.protobuf.Timestamp .

نمایندگی JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
زمینه های
hours

integer

ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند.

minutes

integer

دقیقه از ساعت روز. باید از 0 تا 59 باشد.

seconds

integer

ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند.

nanos

integer

کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد.