컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

유형 및 형식 요약

매개변수 및 스키마의 typeformat 속성을 사용하여 속성의 데이터 유형을 확인할 수 있습니다. type 속성은 JSON 요청 및 응답에서 전송될 때 속성 유형을 나타냅니다 (JSON은 작은 데이터 유형 집합을 지원합니다. 자세한 내용은 json.org 참고). format 속성은 기본 유형에 관한 추가 정보를 제공합니다. 속성에는 항상 type 속성이 있지만 일부 속성에는 format 속성도 있을 수 있습니다.

예를 들어 자바스크립트에서는 64비트 정수가 최대 2^53의 정수를 지원하므로 JSON으로 표현할 수 없습니다. 따라서 64비트 정수는 JSON 요청/응답에서 문자열로 표현되어야 합니다. 따라서 type 속성은 '문자열'로 설정되지만, 64비트 정수를 나타내기 위해 format 속성이 "int64"로 설정됩니다.

JSON 스키마 사양은 format 속성에 이미 일반 값 집합을 정의하고 있습니다. Google API 검색 서비스는 이러한 값 중 일부를 지원하고 다른 값도 정의합니다. Google API 검색 서비스에서 지원하는 typeformat 값의 전체 목록은 아래에 요약되어 있습니다.

값 입력 값 형식 의미
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 (포함)입니다.