매개변수 및 스키마의 type 및 format 속성을 사용하여 속성의 데이터 유형을 확인할 수 있습니다. type 속성은 JSON 요청 및 응답으로 전송될 때 속성 유형을 나타냅니다(JSON은 소규모 데이터 유형 집합을 지원합니다. 자세한 내용은 json.org를 참조하세요). format 속성은 기본 유형에 대한 추가 정보를 제공합니다. 속성에는 항상 type 속성이 있지만 일부 속성에는 format 속성이 있을 수도 있습니다.
예를 들어 JavaScript 및 JSON은 최대 2^53의 정수를 지원하므로 64비트 정수는 JSON으로 표현할 수 없습니다. 따라서 64비트 정수는 JSON 요청/응답에서 문자열로 표현되어야 합니다. 따라서 type 속성은 'string'으로 설정되지만, format 속성은 'int64'로 설정되어 64비트 정수임을 나타냅니다.
JSON 스키마 사양은 이미 format 속성에 대해 공통 값 집합을 정의합니다. Google API 탐색 서비스는 이러한 값 중 일부를 지원하고 다른 값도 정의합니다. Google API 탐색 서비스에서 지원하는 type 및 format 값의 전체 목록은 아래에 요약되어 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-29(UTC)"],[[["\u003cp\u003eThe \u003ccode\u003etype\u003c/code\u003e property in parameters and schemas indicates the data type as represented in JSON requests and responses.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eformat\u003c/code\u003e property provides further detail about the underlying data type, complementing the \u003ccode\u003etype\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eCertain data types, like 64-bit integers, are represented as strings in JSON, where \u003ccode\u003etype\u003c/code\u003e is "string" and \u003ccode\u003eformat\u003c/code\u003e is "int64".\u003c/p\u003e\n"],["\u003cp\u003eThe Google APIs Discovery Service supports several \u003ccode\u003eformat\u003c/code\u003e values, some defined by the JSON Schema specification and others specifically by Google.\u003c/p\u003e\n"],["\u003cp\u003eThe client libraries may use language-specific types, rather than the type and format values present in the JSON, such as representing a 64-bit integer with a type \u003ccode\u003elong\u003c/code\u003e in Java, instead of a string.\u003c/p\u003e\n"]]],[],null,["# Type and format\n\nThe `type` and `format` properties on parameters and schemas can be used\nto determine the data type of the property. The `type` property indicates the type of\nthe property when its sent in JSON requests and responses (JSON supports a small set of data\ntypes, see [json.org](https://json.org) for details). The `format`\nproperty provides additional information about the underlying type. Properties will always have\na `type` property, but some may also have a `format` property.\n\n\nFor example, a 64-bit integer cannot be represented in JSON (since JavaScript and JSON support\nintegers up to 2\\^53). Therefore, a 64-bit integer must be represented as a string in JSON\nrequests/responses. So the `type` property will be set to \"string\", but the\n`format` property will be set to \"int64\" to indicate that it is a 64-bit integer.\n\n\nThe JSON Schema spec already [defines a set of common\nvalues](https://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.23) for the `format` property. The Google APIs Discovery Service supports some\nof these values, and defines others as well. The full list of `type` and\n`format` values supported by Google APIs Discovery Service is summarized below.\n| **Note:** The [client libraries](https://developers.google.com/api-client-library/) that we automatically generate from an API's discovery document sometimes use language-idiomatic types for these types and formats. For example: A 64-bit integer is represented as type `string` in JSON requests and responses, but our generated Java client library uses the Java `long` type."]]
