Tipos

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Open Cloud representa os payloads de solicitação e resposta como JSON padrão. Os tipos JSON padrão são texto, valores, objetos, arrays, números e strings. Alguns tipos têm considerações especiais para representar tipos específicos de dados, que são descritas nas seções a seguir.

Timestamp

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

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

Duração

A saída gerada sempre contém 0, 3, 6 ou 9 dígitos fracionários, dependendo da precisão exigida, seguida do sufixo "s". Aceitos são quaisquer dígitos fracionários (também nenhum), contanto que se encaixem na precisão de nanossegundos e o sufixo "s" é obrigatório. O intervalo deve ser de -315.576.000.000 a 315.576.000.000 segundos, inclusivo.

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

Bytes

Os dados de byte são codificados como uma string usando a codificação padrão base64 com preenchimentos. Tanto a codificação base64 padrão quanto a codificação base64 segura para URL, com ou sem preenchimentos, são suportadas.

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

FieldMask

Um FieldMask é uma string que descreve os campos a serem alterados ao fazer uma solicitação. Para construir um field mask, você especifica nomes de campos JSON delimitados por vírgulas em uma string. Por exemplo, dado o seguinte:

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

Se você quisesse especificar um field mask para atualizar os valores de apenas foo.b e bar, o campo mask ficaria assim: foo.b, bar

No Open Cloud, métodos de atualização que suportam um field mask têm um parâmetro chamado updateMask, onde você pode especificar um field mask como valor.

Dinheiro

Geralmente usado para definir um preço, o tipo Money tem um código de moeda de três letras (conforme definido no ISO 4217) e uma quantidade, que usa o tipo Decimal. Por exemplo, você poderia representar um preço de $17,99 assim:


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

Os produtos da Creator Store requerem um exponent de -9, então o mesmo preço ficaria assim:


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

Decimal

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

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, representa o número de zeros à direita após os dígitos significativos. Quando exponent é menor que 0, representa quantos dos dígitos significativos vêm após o ponto decimal. Quando exponent é 0, o valor do Decimal é o valor do significand.

Português (Brasil)