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.

Remarque : Les bibliothèques clientes que nous générons automatiquement à partir d'un document de découverte d'API utilisent parfois des types idiomatiques linguistiques pour ces types et ces formats. Par exemple, un entier de 64 bits est représenté par le type string dans les requêtes et les réponses JSON, mais la bibliothèque cliente Java générée utilise le type Java long.

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).