오픈 클라우드는 요청과 응답 페이로드를 표준 JSON으로 나타냅니다.표준 JSON 유형은 텍스트, 값, 개체, 배열, 숫자 및 문자열입니다.일부 유형에는 다음 섹션에 설명된 특정 유형의 데이터를 나타내기 위한 특별한 고려 사항이 있습니다.
타임스탬프
RFC 3339를 사용하여 생성된 출력이 항상 Z-정규화되고 0, 3, 6 또는 9 소수 자릿수를 사용합니다. "Z" 이외의 오프셋도 허용됩니다.
예시 타임스탬프
{ "timestamp": "1972-01-01T10:00:20.021Z" }
기간
생성된 출력은 항상 필요한 전체 자릿수에 따라 0, 3, 6 또는 9 소수 자릿수를 포함하며, "s" 접미사가 뒤따릅니다.소수 자릿수(또한 없음)가 나노초 전체에 들어가고 "s" 접미사가 필요한 경우 허용됩니다.범위는 -315,576,000,000에서 315,576,000,000초 사이여야 합니다.
예시 기간
{
"duration-9": "1.000340012s",
"duration-0": "1s"
}
바이트
바이트 데이터는 패딩을 사용하여 표준 base64 인코딩으로 문자열로 인코딩됩니다.공백이 있든 없든 표준이나 URL에서 안전한 base64 인코딩이 지원됩니다.
예시 바이트
{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}
필드 마스크
필드 마스크는 요청을 만들 때 작업할 필드를 설명하는 문자열입니다.필드 마스크를 생성하려면 문자로 구분된 JSON 필드 이름을 문자열에 지정합니다.예를 들어 다음 리소스가 제공되는 경우:
예시 JSON 리소스
{
"foo": {
"a": "c",
"b": "d"
},
"bar": "x",
"baz": "y"
}
필드 마스크를 사용하여 오직 foo.b 및 bar 의 값을 업데이트하려는 경우, 필드 마스크는 다음과 같이 보입니다: foo.b, bar
오픈 클라우드에서 필드 마스크를 지원하는 업데이트 방법에는 updateMask라는 매개 변수가 있으며, 필드 마스크를 값으로 지정할 수 있습니다.
돈
일반적으로 가격을 정의하는 데 사용되는 Money 유형은 ISO 4217에서 정의된 3자리 통화 코드(Decimal 입력사용)와 수량을 사용합니다.예를 들어, 다음과 같이 $17.99의 가격을 나타낼 수 있습니다:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 1799,
"exponent": -2
}
}
크리에이터 스토어 제품은 -9의 exponent가 필요하므로 동일한 가격은 다음과 같습니다:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 17990000000,
"exponent": -9
}
}
10진수
유효 자릿수와 지수가 있는 과학 표기와 유사한 형식의 10진수를 나타냅니다. Represent a decimal number in a form similar to scientific notation, with significant digits and an exponent.
예시:
17
{"significand": 17, "exponent": 0} 또는 단순히 {"significand": 17}
-0.005
{"significand": -5, "exponent": -3}
33.5 백만(33,500,000
{"significand": 335, "exponent": 5}
11/8 (1.375)
{"significand": 1375, "exponent": -3}
When exponent 가 0보다 크면 중요한 숫자 뒤에 오는 0의 수를 나타냅니다.When exponent 가 0보다 작으면 소수 자릿수가 소수점 뒤에 나오는 횟수를 나타냅니다.When exponent가 0이면 Decimal의 값은 significand의 값입니다.