형식

Open Cloud는 요청 및 응답 전체 크기를 표준 JSON으로 나타냅니다. 기본 JSON 형식은 텍스트, 값, 개체, 배열, 숫자 및 문자열입니다. 일부 형식에는 특정 유형의 데이터를 나타내는 특별한 고려 사항이 있습니다. 이 내용은 다음 섹션에서 설명합니다.

시간 표시

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

시간 표시 자 예시
{ "timestamp": "1972-01-01T10:00:20.021Z" }

지속 시간

생성된 출력에는 항상 0, 3, 6 또는 9 자릿수의 소수 자릿수가 포함되어 있습니다. 필요한 정확도에 따라 앞에 "s"가 붙습니다. 모든 소수 자릿수(또한 아무 자릿수도)는 nano-초 정확도에 ����

지속 시간 예시
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

바이트

바이트 데이터는 표준 base64 인코딩을 사용하여 문자열로 인코딩됩니다. 표준 또는 URL 안전한 base64 인코딩을 사용하여 패딩이 있거나 없는 경우 지원됩니다.

바이트 예시
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

필드 마스크

필드 마스크는 요청을 처리할 필드를 설명하는 문자열입니다. 필드 마스크를 구성하려면 문자열에 쉼표로 구분된 JSON 필드 이름을 지정합니다. 예를 들어 다음 리소스를 사용하여 필드 마스크를 생성합니다.

예시 JSON 리소스
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

bar 및 bar 값을 업데이트하는 필드 마스크를 지정하려면 필드 마스크는 다음과 같이 보입니다. foo.b, bar 및 1> oo.b1> 값을 업데이트하는 필드 마스크는 다음과 같이 보입니다.

In Open Cloud에서 필드 마스크를 지원하는 메서드를 업데이트하면 필드 마스크를 값으로 지정하는 매개 변수가 있습니다. 이 매개 변수는 필드 마스크를 지정하는 값을 지정합니다.

돈

일반적으로 가격을 정의하는 데 사용되는 Money 유형에는 세 글자 통화 코드(ISO 4217에 정의됨)와 수량이 있습니다. 예를 들어, Decimal 입력$17.99 크리에이터 스토어 제품은 다음과 같이 보입니다.

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

소수

과학 기호와 같은 형식의 소수 표시, 즉 큰 소수와 부호를 나타냅니다.Represents 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}number1 개의 부수 식별자

• 11/8 (1.375)

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

exponent 가 0보다 크면 나머지 자릿수 후의 0을 나타냅니다. exponent 가 0보다 작으면 소수 점 후의 0을 나타냅니다. exponent 가 0인 경우 1>Decimal1>