Tipi

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Open Cloud rappresenta i payload di richiesta e risposta come JSON standard. I tipi di JSON standard sono testo, valori, oggetti, array, numeri e stringhe. Alcuni tipi hanno considerazioni speciali per rappresentare specifici tipi di dati, che sono descritti nelle sezioni seguenti.

Timestamp

Utilizza RFC 3339, dove l'output generato sarà sempre normalizzato in Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Gli offset diversi da "Z" sono accettati.

Esempio di Timestamp
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Durata

L'output generato contiene sempre 0, 3, 6 o 9 cifre frazionarie, a seconda della precisione richiesta, seguito dal suffisso "s". Sono accettate tutte le cifre frazionarie (pure non nessuna) purché rientrino nella precisione dei nano-secondi e il suffisso "s" è richiesto. L'intervallo deve essere da -315.576.000.000 a 315.576.000.000 secondi, inclusi.

Esempi di Durate
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Byte

I dati byte sono codificati come una stringa utilizzando la codifica base64 standard con padding. Sono supportate la codifica base64 standard o sicura per URL con o senza padding.

Esempio di Byte
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

FieldMask

Un FieldMask è una stringa che descrive i campi su cui agire quando si effettua una richiesta. Per costruire una maschera di campo, si specificano nomi di campi JSON delimitati da virgola in una stringa. Ad esempio, data la seguente struttura:

Esempio JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Se si desidera specificare una maschera di campo per aggiornare i valori solo di foo.b e bar, la maschera di campo apparirebbe così: foo.b, bar

In Open Cloud, i metodi di aggiornamento che supportano una maschera di campo hanno un parametro chiamato updateMask, dove è possibile specificare una maschera di campo come valore.

Denaro

Generalmente utilizzato per definire un prezzo, il tipo Money ha un codice valuta di tre lettere (come definito in ISO 4217) e una quantità, che utilizza il tipo Decimal. Ad esempio, si potrebbe rappresentare un prezzo di $17.99 in questo modo:


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

I prodotti del Creator Store richiedono un exponent di -9, quindi lo stesso prezzo appare così:


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

Decimale

Rappresenta un numero decimale in una forma simile alla notazione scientifica, con cifre significative e un esponente.

Esempi:

17

{"significand": 17, "exponent": 0} oppure solo {"significand": 17}
-0.005

{"significand": -5, "exponent": -3}
33,5 milioni (33.500.000)

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

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

Quando exponent è maggiore di 0, rappresenta il numero di zeri finali dopo le cifre significative. Quando exponent è minore di 0, rappresenta quante delle cifre significative vengono dopo il punto decimale. Quando exponent è 0, il valore del Decimal è il valore del significand.

Italiano