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 для намерения actions.intent.SIGN_IN , то это расширение будет содержать значение SignInValue .

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

structuredValue

object ( Struct format)

Указывается, когда Google необходимо передать значение данных в формате JSON.

Положение дел

Тип Status определяет логическую модель ошибок, подходящую для различных сред программирования, включая API REST и API RPC. Он используется gRPC . Каждое сообщение Status содержит три части данных: код ошибки, сообщение об ошибке и сведения об ошибке.

Подробнее об этой модели ошибок и о том, как с ней работать, можно узнать в API Design Guide .

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, если указан год отдельно, или год и месяц, если день не имеет значения.

ВремяДня

Обозначает время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. 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.