Tipos

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

Open Cloud representa los datos de solicitud y respuesta como JSON estándar . Los tipos estándar de JSON son texto, valores, objetos, matrizes, números y cadenas. Algunos tipos tienen consideraciones especiales para representar tipos específicos de datos, que se describen en las siguientes secciones.

Tiempo de firma

Usa RFC 3339, donde el resultado generado siempre será Z-normalizado y usa 0, 3, 6 o 9 dígitos fraccionales. Los otros rangos no son aceptables.

Temporal de ejemplo

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

Duración

La salida generada siempre contiene 0, 3, 6 o 9 dígitos fraccionales, dependiendo de la precisión requerida, seguidos por el sufijo "s". Se aceptan cualquier dígito fraccional (también ninguno) siempre que encaje en la precisión de nano-segundos y el sufijo "s" se requiera. El rango debe ser desde -315,576,000,000

Duraciones de ejemplo

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

Por bytes

Los datos de bytes se codifican como una cadena usando la codificación estándar de base64 con pérdidas. Esto incluye tanto la codificación de base64 estándar como la codificación de base64 segura con o sin pérdidas.

Ejemplo de Bytes

{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Máscara de campo

Una FieldMask es una cadena que describe los campos para actuar cuando se hace una solicitud. Para construir una máscara de campo, especifica los nombres de los campos de JSON delimitados en una cadena. Por ejemplo, dado el siguiente recurso:

Ejemplo de recursos JSON

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

Si desea especificar una máscara de campo para actualizar los valores de solo foo.b y bar, la máscara de campo se vería así: foo.b, bar

En Open Cloud, actualice los métodos que admiten una máscara de campo con un parámetro llamado updateMask , donde puede especificar una máscara de campo como valor.

Dinero

Generalmente usado para definir un precio, el tipo Money tiene un código de moneda de tres letras (como se define en ISO 4217) y una cantidad, que usa el introducirDecimal. Por ejemplo, un producto de la Tienda del Creador de $ 17.99 se ve así:


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

Decimal

Representa un número decimal en una forma similar a la notación científica, con cifras significativas y un exponente.

Ejemplos:

  • 17

    {"significand": 17, "exponent": 0} o simplemente {"significand": 17}

  • 0.005

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

  • 33.5 millones (33,500,000)

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

  • 11/8 (1.375)

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

Cuando exponent es mayor que 0, representa el número de ceroes después de los significantes dígitos. Cuando exponent es menor que 0, representa la cantidad de significantes dígitos que vienen después del punto decimal. Cuando exponent es 0, el valor del 1> Decimal</