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

DateTime

사용자 입력에서 파싱된 날짜 및 시간 인수 값 시간대 정보는 포함되지 않습니다.

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 사이의 값이어야 합니다.