유형 및 형식 요약
매개변수 및 스키마의 type 및 format 속성을 사용하여 속성의 데이터 유형을 확인할 수 있습니다. type 속성은 JSON 요청 및 응답에서 전송될 때 속성 유형을 나타냅니다 (JSON은 작은 데이터 유형 집합을 지원합니다. 자세한 내용은 json.org 참고). format 속성은 기본 유형에 관한 추가 정보를 제공합니다. 속성에는 항상 type 속성이 있지만 일부 속성에는 format 속성도 있을 수 있습니다.
예를 들어 자바스크립트에서는 64비트 정수가 최대 2^53의 정수를 지원하므로 JSON으로 표현할 수 없습니다. 따라서 64비트 정수는 JSON 요청/응답에서 문자열로 표현되어야 합니다. 따라서 type 속성은 '문자열'로 설정되지만, 64비트 정수를 나타내기 위해 format 속성이 "int64"로 설정됩니다.
JSON 스키마 사양은 format 속성에 이미 일반 값 집합을 정의하고 있습니다. Google API 검색 서비스는 이러한 값 중 일부를 지원하고 다른 값도 정의합니다. Google API 검색 서비스에서 지원하는 type 및 format 값의 전체 목록은 아래에 요약되어 있습니다.
| 값 입력 | 값 형식 | 의미 |
|---|---|---|
any |
|
속성에는 모든 유형이 있을 수 있습니다. JSON 스키마 사양으로 정의됩니다. |
array |
|
값의 자바스크립트 배열입니다. items 속성은 배열 값의 스키마를 나타냅니다. JSON 스키마 사양으로 정의됩니다. |
boolean |
|
불리언 값입니다. JSON 스키마 사양으로 정의됩니다. |
integer |
int32 |
부호 있는 32비트 정수입니다. 최솟값은 -2,147,483,648, 최댓값은 2,147,483,647입니다. |
integer |
uint32 |
부호 없는 32비트 정수입니다. 최솟값은 0, 최댓값은 4,294,967,295입니다 (해당 값 포함). |
number |
double |
배정밀도 64비트 IEEE 754 부동 소수점 |
number |
float |
단일 정밀도 32비트 IEEE 754 부동 소수점입니다. |
object |
|
자바스크립트 객체입니다. JSON 스키마 사양으로 정의됩니다. |
string |
|
임의의 문자열입니다. JSON 스키마 사양으로 정의됩니다. |
string |
byte |
패딩된 base64로 인코딩된 바이트 문자열로, URL 및 파일 이름 안전 알파벳 (또는 'web-safe' 또는 'base64url'이라고 함)으로 인코딩됩니다. RFC4648로 정의됩니다. |
string |
date |
YYYY-MM-DD 형식의 RFC3339 날짜입니다. JSON 스키마 사양에 정의되어 있습니다. |
string |
date-time |
UTC 시간의 RFC3339 타임스탬프입니다. yyyy-MM-ddTHH:mm:ss.SSSZ 형식입니다. 밀리초 부분 (&STM)은 선택사항입니다. JSON 스키마 사양에 정의되어 있습니다. |
string |
google-datetime |
UTC 시간의 RFC3339 타임스탬프입니다. yyyy-MM-ddTHH:mm:ss.SSSZ 형식입니다. 밀리초 부분 (&STM)은 선택사항입니다. |
string |
google-duration |
문자열은 접미사 초(색인을 나타냄)로 끝나며, 앞에는 초 수가 나노초 단위로 표시됩니다. 마침표는 항상 쉼표가 아닌 소수점으로 사용됩니다. |
string |
google-fieldmask |
필드 이름이 쉼표로 구분된 문자열입니다. 필드 이름은 카멜 표기법에 따라 표시됩니다. |
string |
int64 |
부호 있는 64비트 정수입니다. 최솟값은 -9,223,372,036,854,775,808, 최댓값은 9,223,372,036,854,775,807입니다. |
string |
uint64 |
부호 없는 64비트 정수입니다. 최솟값은 0, 최댓값은 (2^64)-1 (포함)입니다. |