Typy

Open Cloud reprezentuje wnioski i odpowiedzi jako normalny JSON . Standardowe wersje JSON są tekstem, wartościami, obiektami, listami i liczbami. Niektóre wersje mają specjalne rozważania dotyczące przedstawianie konkretnych rodzajów danych, które są opisane w następujących sekcjach.

Czas odtwarzania

Używa RFC 3339, gdzie generowane wyniki zawsze będą Z-normalizowane i używa 0, 3, 6 lub 9 liczb dziesięciu. Offsety poza "Z" są również akceptowane.

Czas odtwarzania przykładu
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Czas trwania

Generowane wyniki zawsze zawierają 0, 3, 6 lub 9 liczb dziesięciu znaków, w zależności od wymaganej precyzji, następnie odpowiednią zapisem jest „s”. Akceptowane są wszystkie licby dziesięciu znaków (również żadne), o ile pasuje do nano-sekundowej precyzji i zapisu „s”. Zakres musi być od

Długości przykładów
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Bajty

Dane bajtowe są zapisane jako strumień używając standardowego kodu szyfrowania z paskami. Standard lub bezpieczny kod szyfrowania z paskami jest wspierany.

Przykłady bajtów
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Maska pola

Maska pola to strunga, która opisuje pola do działania podczas wysyłania prośba. Aby zbudować maszę pola, określasz imię pola JSON w ciągu strungi. Na przykład, dla zdefiniowanego zasobu:

Przykład zasobu JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Jeśli chcesz określić maskę pola, aby aktualizować wartości tylko foo.b i bar, maska pola będzie wyglądać tak: foo.b, bar

W Open Cloud aktualizuj metody, które wspierają maskę pola, mająca parametr nazyający się updateMask, gdzie możesz określić maskę pola jako wartość.

Pieniądze

Zwykle używany do określenia ceny, Money typ ma trzy znaków waluty (jak zdefiniowano w ISO 4217) i ilość, która używa Decimal wpisywać. Na przykład produkt $17.99 Creator Store wygląda następująco:

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

Dziesięć złotych

Reprezentuje dziesięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesiąt dziewięćdziesią

Przykłady:

• 17

  {"significand": 17, "exponent": 0} lub po prostu {"significand": 17}

• 0.005

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

• 33,500,000 (33,500,000)

  {"significand": 335, "exponent": 5}

• 11/8 (1.375)

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

Gdy exponent jest większy niż 0, reprezentuje liczbę przyjaznych zer po znacznych liczbach. Gdy exponent jest mniejszy niż 0, reprezentuje liczbę znacznych cyfr po punktach dziesięciu. Gdy exponent jest 0, wartość 1>Decymał1> jest w