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
메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 3가지 데이터가 포함됩니다.
API 설계 가이드에서 이 오류 모델과 모델 작업 방법에 대해 자세히 알아볼 수 있습니다.
JSON 표현 | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
필드 | |
---|---|
code |
상태 코드로, |
message |
개발자에게 정보를 제공하는 오류 메시지로, 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 |
details[] |
오류 세부정보를 설명하는 메시지 목록입니다. API에서 사용할 일반적인 메시지 유형 집합이 있습니다. 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 |
DateTime
사용자 입력에서 파싱된 날짜 및 시간 인수 값 시간대 정보는 포함되지 않습니다.
JSON 표현 | |
---|---|
{ "date": { object ( |
필드 | |
---|---|
date |
날짜 값 |
time |
시간 값 |
날짜
캘린더 날짜 전체 또는 일부를 나타냅니다(예: 생일). 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음을 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 연도와 월 값(연도 0)(예: 기념일)
- 연도만, 월 및 일 값은 0임
- 0일인 연도 및 월 값(예: 신용카드 만료일)
관련된 유형은 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 사이의 값이어야 합니다. |