Open Cloud repräsentiert Anforderungs- und Antwort-Payloads als Standard-JSON.Die Standard-JSON-Typen sind Text, Werte, Objekte, Arrays, Zahlen und Zeichenketten.Einige Arten haben spezielle Überlegungen für die Darstellung bestimmter Arten von Daten, die in den folgenden Abschnitten beschrieben werden.
Zeitmarke
Verwendet RFC 3339, bei dem immer generierter Ausgabe immer Z-normalisiert wird und 0, 3, 6 oder 9 Bruchteile verwendet werden. Auch andere als "Z" sind akzeptiert.
Beispielzeitmarke
{ "timestamp": "1972-01-01T10:00:20.021Z" }
Dauer
Die generierte Ausgabe enthält immer 0, 3, 6 oder 9 Bruchteile, abhängig von der erforderlichen Präzision, gefolgt vom Suffix "s".Akzeptiert werden alle Bruchzahlen (auch keine) solange sie in die Präzision von Nano-Sekunden passen und der Suffix "s" erforderlich ist.Die Reichweite muss von -315,576,000,000 bis 315,576,000,000 Sekunden betragen, einschließlich.
Beispiel-Dauern
{
"duration-9": "1.000340012s",
"duration-0": "1s"
}
Bytes
Byte-Daten werden als eine Zeichenkette mit Standard-Base64-Verschlüsselung mit Pufferungen kodiert.Entweder Standard oder URL-sichere base64-Kodierung mit oder ohne Pufferung wird unterstützt.
Beispielflächen
{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}
Feldmasken
Eine Feldmaske ist eine Zeichenkette, die die Felder beschreibt, auf die beim Senden einer Anfrage gehandelt werden soll.Um eine Feldmaske zu konstruieren, gibst du kommaseperierte JSON-Feldnamen in einer Stringan.Zum Beispiel, angesichts der folgenden Ressource:
Beispiel JSON-Ressource
{
"foo": {
"a": "c",
"b": "d"
},
"bar": "x",
"baz": "y"
}
Wenn du eine Feldmaske spezifizieren wolltest, um die Werte von nur foo.b und bar zu aktualisieren, würde die Feldmaske wie folgt aussehen: foo.b, bar
In der offenen Cloud aktualisieren Methoden, die eine Feldmaske unterstützen, einen Parameter namens updateMask, in dem Sie eine Feldmaske als Wert spezifizieren können.
Geld
Im Allgemeinen verwendet, um einen Preis zu definieren, hat der Typ Money einen dreistelligen Währungscode (wie in ISO 4217 definiert) und eine Menge, die den eingebenDecimal verwendet.Zum Beispiel könnten Sie einen Preis von $17.99 wie folgt darstellen:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 1799,
"exponent": -2
}
}
Creator-Store-Produkte benötigen eine exponent von -9, also sieht der gleiche Preis so aus:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 17990000000,
"exponent": -9
}
}
Zahlengroßschreibung
Repräsentiert eine Dezimalzahl in einer Form, die der wissenschaftlichen Notation ähnelt, mit bedeutungsvollen 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, repräsentiert es die Anzahl der folgenden Nullen nach den bedeutenden Zahlen.Wenn exponent weniger als 0 ist, repräsentiert es, wie viele der bedeutenden Zahlen nach dem Dekimalpunkt kommen.Wenn exponent 0 ist, ist der Wert des Decimal der Wert des significand.