Typen

Open Cloud stellt Anfrage- und Antwort-Payloads als Standard-JSON dar. Die Standard-JSON-Typen sind Text, Werte, Objekte, Arrays, Zahlen und Strings. Einige Typen haben spezielle Anforderungen für die Repräsentation bestimmter Arten von Daten, die in den folgenden Abschnitten beschrieben sind.

Zeitmarke

Verwendet RFC 3339, bei dem generierte Ausgaben immer Z-normalisiert sind und 0, 3, 6 oder 9 Fraktionszahlen verwendet werden. Offsets außer "Z" sind auch akzeptiert.

Zeitmarke Beispiel
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Dauer

Generierte Ausgaben enthalten immer 0, 3, 6 oder 9 fractional Zahlen, abhängig von der benötigten Genauigkeit, gefolgt von der Präfix "s". Alle fractional Zahlen (einschließlich) sind akzeptiert, solange sie in Nano-Sekunden Genauigkeit passen und das Präfix "s" erforderlich ist. Die Reichweite muss von -315,576,000,000 bis 3

Beispielfarben
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Bytes

Byte-Daten werden als Zeichenfolge mit Standard-Base64-Verschlüsselung mit Puffer unterstützt. Standard- oder URL-sichere Base64-Verschlüsselung mit oder ohne Puffer werden unterstützt.

Beispiele Bytes
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Feld-Maske

Eine FieldMask ist eine string, die die Felder beschreibt, auf die sie beim Erstellen einer Anfrage reagieren. Um eine FieldMask zu erstellen, geben Sie die Komma getrennten JSON-Feldnamen in einer Stringan. Zum Beispiel, basierend auf der folgenden Ressource:

Beispiel JSON-Ressource
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Wenn Sie ein Feld-Masken spezifizieren möchten, um die Werte von nur foo.b und bar zu aktualisieren, würde die Feld-Masken wie folgt aussehen: foo.b, bar

In Open Cloud aktualisieren Sie Methoden, die eine Feldmaske unterstützen, mit einem Parameter namens updateMask, bei dem Sie eine Feldmaske als Wert angeben können.

Geld

Wird normalerweise verwendet, um einen Preis zu definieren, hat die Money -Typ-Reihe eine drei Buchstaben lange Währungscode (wie in ISO 4217 definiert) und eine Menge, die die Decimal eingebenverwendet. Zum Beispiel sieht ein $17.99 Creator Store-Produkt wie folgt aus:

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

Dekimal

Repräsentiert einen decimal number in einer Form, die der Wissenschaftliche Notation ähnelt, mit großen Zahlen und einem Exponenten.

Beispiele:

• 17

  {"significand": 17, "exponent": 0} oder einfach {"significand": 17}

• 0.005

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

• 33,5 millionen (33,500,000)

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

• 11/8 (1.375)

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

Wenn exponent größer als 0 ist, stellt es die Anzahl der folgenden Nullen nach den wichtigen Zahlen dar. Wenn exponent weniger als 0 ist, stellt es dar, wie viele der wichtigen Zahlen nach dem Kommapunkt kommen. Wenn exponent 0 ist, ist der Wert des