Tipos

O Open Cloud representa pedidos e respostas como JSON padrão . Os tipos padrão do JSON são texto, valores, objetos, arranjos, números e cadeias. Alguns tipos têm considerações especiais para representar tipos específicos de dados, que são descritos nas seções a seguir.

Tempo de Atraso

Usa o RFC 3339, onde a saída gerada sempre será Z-normalizada e usa 0, 3, 6 ou 9 dígitos fracionais. Deslocamentos diferentes de "Z" também são aceitos.

Exemplo de Data de Timbre
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Duração

A saída gerada sempre contém 0, 3, 6 ou 9 dígitos fracionais, dependendo da precisão necessária, seguidos por um sufixo "s". Aceita qualquer dígito fracionário (também nenhum) desde que eles se encaixem na precisão de nano-segundos e o sufixo "s" seja necessário. A faixa deve ser de -315,576,000,0

Durações de Exemplo
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Por bytes

Dados de bytes são codificados como uma string usando o padrão de codificação base64 com pads. Seja o padrão ou o padrão de codificação base64 com ou sem pads suportados.

Exemplos de Bytes
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Máscara de Campo

Uma FieldMask é uma string que descreve os campos para agir quando faz uma solicitar / pedir. Para construir uma FieldMask, você especifica nomes de campo delimitados em uma string / cadeia / texto. Por exemplo, dado o seguinte recurso:

Exemplo de recursos JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Se você quisesse especificar uma máscara de campo para atualizar os valores apenas de foo.b e bar, a máscara de campo ficaria assim: foo.b, bar

In Open Cloud, update methods that support a field mask have a parameter named updateMask , where you can specify a field mask as a value.

Dinheiro

Geralmente usado para definir um preço, o tipo Money tem um código de moeda de três letras (como definido no ISO 4217) e uma quantidade, que usa o digitarDecimal. Por exemplo, um produto da Loja do Criador de US $17.99 parece com isso:

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

Dêcima

Representa um número decimal em uma forma semelhante à notação científica, com dígitos significativos e um exponente.

Exemplos:

• 17

  {"significand": 17, "exponent": 0} ou apenas {"significand": 17}

• 0.005

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

• 33,5 milhões (33,500,000)

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

• 11/8 (1.375)

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

Quando exponent é maior que 0, ele representa o número de zeros após os dígitos significativos. Quando exponent é menor que 0, ele representa quantos dos dígitos significativos vêm depois do ponto decimal. Quando exponent é 0, o valor do 1> Decimal