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

유형이 인수에 따라 달라지는 확장 프로그램입니다. 예를 들어 actions.intent.SIGN_IN 인텐트의 인수 이름이 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 메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 3가지 데이터가 포함됩니다.

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)

시간 값

날짜

캘린더 날짜의 전체 또는 일부를 나타냅니다. 예: 생일 등입니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음을 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 연도가 0인 월, 일 값(예: 기념일
  • 월과 일 값이 0인 연도만
  • 일이 0인 연도 및 월 값(예: 신용카드 유효기간

관련된 유형은 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 사이의 값이어야 합니다.