Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Résumé du type et du format

Les propriétés type et format des paramètres et des schémas peuvent servir à déterminer le type de données de la propriété. La propriété type indique le type de la propriété lorsqu'elle est envoyée dans des requêtes et des réponses JSON. JSON accepte un petit ensemble de types de données. Pour en savoir plus, consultez json.org. La propriété format fournit des informations supplémentaires sur le type sous-jacent. Les propriétés auront toujours une propriété type, mais certaines peuvent aussi avoir une propriété format.

Par exemple, un entier de 64 bits ne peut pas être représenté au format JSON, car JavaScript et JSON acceptent les entiers jusqu'à 2^53. Par conséquent, un entier 64 bits doit être représenté sous forme de chaîne dans les requêtes/réponses JSON. Ainsi, la propriété type sera définie sur"string" (chaîne), mais la propriété format sera définie sur"int64"pour indiquer qu'il s'agit d'un entier 64 bits.

La spécification du schéma JSON définit déjà un ensemble de valeurs communes pour la propriété format. Le service de découverte des API Google accepte certaines de ces valeurs et en définit d'autres. Vous trouverez ci-dessous la liste complète des valeurs type et format acceptées par le service de découverte des API Google.

Valeur de type Valeur du format Signification
any La propriété peut avoir n'importe quel type. Défini par la spécification de schéma JSON.
array Tableau de valeurs JavaScript. La propriété items indique le schéma des valeurs du tableau. Défini par la spécification du schéma JSON.
boolean Valeur booléenne, "true" ou "false". Défini par la spécification du schéma JSON.
integer int32 Entier signé de 32 bits. Elle a une valeur minimale de -2 147 483 648 et une valeur maximale de 2 147 483 647 (inclus).
integer uint32 Entier non signé de 32 bits. Elle a une valeur minimale de 0 et une valeur maximale de 4 294 967 295 (inclus).
number double Point flottant IEEE 754 64 bits à double précision.
number float Un point flottant IEEE 754 32 bits de précision unique.
object Objet JavaScript. Défini par la spécification du schéma JSON.
string Chaîne arbitraire. Défini par la spécification du schéma JSON.
string byte Chaîne d'octets complétée et encodée en base64. Elle est encodée à l'aide d'un alphabet sûr pour les URL et les noms de fichiers (parfois appelé "Web-Safe" ou "base64url"). Définie par RFC4648.
string date Date RFC3339 au format AAAA-MM-JJ. Défini dans la spécification du schéma JSON.
string date-time Horodatage RFC3339 au format UTC. au format aaaa-MM-jjTHH:mm:ss.SSSZ. La partie millisecondes (&SST) est facultative. Défini dans la spécification du schéma JSON.
string google-datetime Horodatage RFC3339 au format UTC. au format aaaa-MM-jjTHH:mm:ss.SSSZ. La partie millisecondes (&SST) est facultative.
string google-duration Une chaîne se termine par le suffixe "s" (indiquant les secondes) et est précédée du nombre de secondes, les nanosecondes étant exprimées en fractions de secondes. Le point est toujours utilisé comme séparateur décimal, et non une virgule.
string google-fieldmask Chaîne dans laquelle les noms de champs sont séparés par une virgule. Les noms de champs sont représentés dans des conventions d'attribution de noms en bas de chameau.
string int64 Entier signé de 64 bits Elle a une valeur minimale de -9 223 372 036 854 775 808 et une valeur maximale de 9 223 372 036 854 775 807 (inclus).
string uint64 Entier non signé de 64 bits. Il a une valeur minimale de 0 et une valeur maximale de (2^64)-1 (incluse).