유형

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Open Cloud는 요청 및 응답 페이로드를 표준 JSON으로 표현합니다. 표준 JSON 유형에는 텍스트, 값, 객체, 배열, 숫자, 문자열이 포함됩니다. 특정 종류의 데이터를 표현하기 위해 특별한 고려 사항이 있는 일부 유형은 다음 섹션에서 설명합니다.

타임스탬프

RFC 3339를 사용하며, 생성된 출력은 항상 Z-정규화되며 0, 3, 6 또는 9의 소수 자릿수를 사용합니다. "Z" 이외의 오프셋도 허용됩니다.

예제 타임스탬프
{ "timestamp": "1972-01-01T10:00:20.021Z" }

지속 시간

생성된 출력은 항상 요구되는 정밀도에 따라 0, 3, 6 또는 9의 소수 자릿수를 포함하며, "s"라는 접미사가 붙습니다. nano-seconds 정밀도에 맞는 소수 자릿수(없어도 괜찮음)는 모두 허용되며 접미사 "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

Open Cloud에서는 필드 마스크를 지원하는 업데이트 메서드에 updateMask라는 매개변수가 있으며, 여기서 값을 필드 마스크로 지정할 수 있습니다.

화폐

일반적으로 가격을 정의하는 데 사용되는 Money 유형은 3자리 통화 코드(ISO 4217에 정의된 대로)와 수량을 가지고 있으며, 수량은 Decimal 유형을 사용합니다. 예를 들어, $17.99 가격을 다음과 같이 표현할 수 있습니다:


"myPrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 1799,
    "exponent": -2
  }
}

Creator Store 제품은 -9의 exponent가 필요하므로, 같은 가격은 다음과 같이 보입니다:


"myPrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 17990000000,
    "exponent": -9
  }
}

십진수

십진수는 유효 숫자와 지수를 사용하여 과학적 표기법과 유사한 형태로 표현됩니다.

예시:

17

{"significand": 17, "exponent": 0} 또는 단순히 {"significand": 17}
-0.005

{"significand": -5, "exponent": -3}
3,350만 (33,500,000)

{"significand": 335, "exponent": 5}
11/8 (1.375)

{"significand": 1375, "exponent": -3}

exponent가 0보다 크면 유효 숫자 후에 오는 0의 수를 나타냅니다. exponent가 0보다 작으면 소수점 뒤에 오는 유효 숫자의 수를 나타냅니다. exponent가 0일 때 Decimal의 값은 significand의 값입니다.

한국어