Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As properties type e format em parâmetros e esquemas podem ser usadas para determinar o tipo de dados da property. A property type indica o tipo da property quando ela é enviada em solicitações e respostas JSON. O JSON aceita um conjunto pequeno de tipos de dados. Consulte json.org (em inglês) para ver detalhes. A property format contém mais informações sobre o tipo subjacente. As properties sempre terão uma property type, mas algumas também podem ter uma property format.
Por exemplo, um número inteiro de 64 bits não pode ser representado em JSON (já que JavaScript e JSON aceitam números inteiros até 2^53). Portanto, um número inteiro de 64 bits precisa ser representado como uma string nas solicitações/respostas JSON. Portanto, a property type será definida como "string", mas a property format será definida como "int64" para indicar que é um número inteiro de 64 bits.
A especificação do esquema JSON já define um conjunto de valores comuns para a property format. O serviço de descoberta de APIs do Google aceita alguns desses valores e também define outros. A lista completa dos valores type e format aceitos pelo serviço de descoberta de APIs do Google está resumida abaixo.
Uma string arbitrária. Definido pela especificação do esquema JSON.
string
byte
Uma string de bytes codificada em base64 com padding, codificada com um URL e alfabeto seguro de nome de arquivo (às vezes chamado de "seguro para Web" ou "base64url"). Definido por RFC 4648.
string
date
Uma data RFC 3339 no formato AAAA-MM-DD. Definido na especificação do Esquema JSON.
string
date-time
Um carimbo de data/hora RFC 3339 no horário UTC. Isso está no formato aaaa-MM-ddTHH:mm:ss.SSSZ. A parte de milissegundos (".SSS") é opcional. Definido na especificação do Esquema JSON.
string
google-datetime
Um carimbo de data/hora RFC 3339 no horário UTC. Isso está no formato aaaa-MM-ddTHH:mm:ss.SSSZ. A parte de milissegundos (".SSS") é opcional.
string
google-duration
Uma string termina com o sufixo "s" (indicando segundos) e é precedida pelo número de segundos, com nanossegundos expressos como segundos fracionários. O ponto é sempre usado como um separador decimal, não uma vírgula.
string
google-fieldmask
Uma string em que os nomes de campos são separados por uma vírgula. Os nomes dos campos são representados em convenções de nomenclatura de letras minúsculas.
string
int64
Um número inteiro assinado de 64 bits Ele tem um valor mínimo de -9.223.372.036.854.775.808 e um valor máximo de 9.223.372.036.854.775.807 (incluso).
string
uint64
Um número inteiro sem assinatura de 64 bits. Ele tem um valor mínimo de 0 e um valor máximo de (2^64)-1 (incluso).
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThe \u003ccode\u003etype\u003c/code\u003e property defines the data type in JSON, while the \u003ccode\u003eformat\u003c/code\u003e property provides additional context about the underlying type.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etype\u003c/code\u003e is always present, but \u003ccode\u003eformat\u003c/code\u003e is optional and offers further data type details.\u003c/p\u003e\n"],["\u003cp\u003eGoogle APIs Discovery Service supports standard JSON Schema formats and defines its own for specific Google data types.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries may use language-specific types to represent these types and formats for better integration.\u003c/p\u003e\n"],["\u003cp\u003eThe table comprehensively lists all supported \u003ccode\u003etype\u003c/code\u003e and \u003ccode\u003eformat\u003c/code\u003e values used by the Google APIs Discovery Service.\u003c/p\u003e\n"]]],[],null,["# Type and format\n\nThe `type` and `format` properties on parameters and schemas can be used\nto determine the data type of the property. The `type` property indicates the type of\nthe property when its sent in JSON requests and responses (JSON supports a small set of data\ntypes, see [json.org](https://json.org) for details). The `format`\nproperty provides additional information about the underlying type. Properties will always have\na `type` property, but some may also have a `format` property.\n\n\nFor example, a 64-bit integer cannot be represented in JSON (since JavaScript and JSON support\nintegers up to 2\\^53). Therefore, a 64-bit integer must be represented as a string in JSON\nrequests/responses. So the `type` property will be set to \"string\", but the\n`format` property will be set to \"int64\" to indicate that it is a 64-bit integer.\n\n\nThe JSON Schema spec already [defines a set of common\nvalues](https://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.23) for the `format` property. The Google APIs Discovery Service supports some\nof these values, and defines others as well. The full list of `type` and\n`format` values supported by Google APIs Discovery Service is summarized below.\n| **Note:** The [client libraries](https://developers.google.com/api-client-library/) that we automatically generate from an API's discovery document sometimes use language-idiomatic types for these types and formats. For example: A 64-bit integer is represented as type `string` in JSON requests and responses, but our generated Java client library uses the Java `long` type.\n\n| Type value | Format value | Meaning |\n| `any` | | The property may have any type. Defined by the [JSON Schema spec](https://tools.ietf.org/html/draft-zyp-json-schema-03). |\n| `any` | `google.protobuf.Value` | The property has the JSON representation of the type of [google.protobuf.Value](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `array` | | A JavaScript array of values. The `items` property indicates the schema for the array values. Defined by the JSON Schema spec. |\n| `array` | `google.protobuf.ListValue` | The property has the JSON representation of the type of [google.protobuf.ListValue](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `boolean` | | A boolean value, either \"true\" or \"false\". Defined by the JSON Schema spec. |\n| `integer` | `int32` | A 32-bit signed integer. It has a minimum value of -2,147,483,648 and a maximum value of 2,147,483,647 (inclusive). |\n| `integer` | `uint32` | A 32-bit unsigned integer. It has a minimum value of 0 and a maximum value of 4,294,967,295 (inclusive). |\n| `number` | `double` | A double-precision 64-bit IEEE 754 floating point. |\n| `number` | `float` | A single-precision 32-bit IEEE 754 floating point. |\n| `object` | | A JavaScript object. Defined by the JSON Schema spec. |\n| `object` | `google.protobuf.Struct` | The property has the JSON representation of the type of [google.protobuf.Struct](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `object` | `google.protobuf.Any` | The property has the JSON representation of the type of [google.protobuf.Any](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/any.proto). |\n| `string` | | An arbitrary string. Defined by the JSON Schema spec. |\n| `string` | `byte` | A padded, base64-encoded string of bytes, encoded with a URL and filename safe alphabet (sometimes referred to as \"web-safe\" or \"base64url\"). Defined by [RFC4648](https://tools.ietf.org/html/rfc4648). |\n| `string` | `date` | An RFC3339 date in the format YYYY-MM-DD. Defined in the JSON Schema spec. |\n| `string` | `date-time` | An RFC3339 timestamp in UTC time. This in the format of yyyy-MM-ddTHH:mm:ss.SSSZ. The milliseconds portion (\".SSS\") is optional. Defined in the JSON Schema spec. |\n| `string` | `google-datetime` | An RFC3339 timestamp in UTC time. This in the format of yyyy-MM-ddTHH:mm:ss.SSSZ. The milliseconds portion (\".SSS\") is optional. |\n| `string` | `google-duration` | A string ends in the suffix \"s\" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. The period is always used as the decimal point, not a comma. |\n| `string` | `google-fieldmask` | A string where field names are separated by a comma. Field names are represented in lower-camel naming conventions. |\n| `string` | `int64` | A 64-bit signed integer. It has a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807 (inclusive). |\n| `string` | `uint64` | A 64-bit unsigned integer. It has a minimum value of 0 and a maximum value of (2\\^64)-1 (inclusive). |\n|------------|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
