Typ i podsumowanie formatu

Do określania typu danych usługi można używać właściwości type i format na podstawie parametrów i schematów. Właściwość type wskazuje typ usługi, gdy jest ona wysyłana w żądaniach i odpowiedziach JSON (JSON obsługuje niewielki zestaw typów danych – więcej informacji znajdziesz na json.org). Właściwość format zawiera dodatkowe informacje o podstawowym typie. Usługi zawsze będą miały właściwość type, ale niektóre mogą też mieć właściwość format.

Na przykład 64-bitowa liczba całkowita nie może być reprezentowana w formacie JSON (JavaScript i JSON obsługują liczby całkowite do 2^53). W związku z tym 64-bitowa liczba całkowita musi być reprezentowana jako ciąg tekstowy w żądaniach/odpowiedziach JSON. Dlatego właściwość type zostanie ustawiona na „"string"”, ale jako właściwość format zostanie ustawiona na 64-bitową liczbę całkowitą.

Specyfikacja schematu JSON definiuje zestaw wspólnych wartości dla właściwości format. Usługa wykrywania interfejsów API Google obsługuje niektóre z tych wartości i określa też inne. Poniżej podano pełną listę wartości type i format obsługiwanych przez usługę wykrywania interfejsów API Google.

Uwaga: biblioteki klienta, które są automatycznie generowane na podstawie dokumentu opisującego interfejs API, czasami używają typów identyfikacyjnych języków dla tych typów i formatów. Na przykład: 64-bitowa liczba całkowita jest reprezentowana jako typ string w żądaniach i odpowiedziach JSON, ale wygenerowana przez nas biblioteka klienta Java korzysta z typu long w języku Java.

Typ wartości	Format wartości	Znaczenie
any		Właściwość może mieć dowolny typ. Zdefiniowane przez specyfikację schematu JSON.
array		Tablica wartości w kodzie JavaScript. Właściwość items określa schemat wartości tablicy. Zdefiniowane przez specyfikację schematu JSON.
boolean		Wartość logiczna „"true"” i "false". Zdefiniowane przez specyfikację schematu JSON.
integer	int32	32-bitowa liczba całkowita ze znakiem. Minimalna wartość to -2 147 483 648, a maksymalna – 2 147 483 647 (włącznie).
integer	uint32	32-bitowa liczba całkowita bez znaku. Minimalna wartość to 0, a maksymalna – 4 294 967 295 (włącznie).
number	double	Liczba zmiennoprzecinkowa IEEE 754 z podwójną precyzją.
number	float	Liczba zmiennoprzecinkowa 12-bitowego IEEE 754.
object		Obiekt JavaScript. Zdefiniowane przez specyfikację schematu JSON.
string		Dowolne ciągi znaków. Zdefiniowane przez specyfikację schematu JSON.
string	byte	Wypełnione, zakodowane w standardzie base64 ciąg bajtów zakodowany przy użyciu adresu URL i alfabetu nazw plików (nazywanych też "web-safe" lub "base64url"). Zdefiniowane przez RFC4648.
string	date	Data w formacie RFC3339 w formacie RRRR-MM-DD. Zdefiniowane w specyfikacji schematu JSON.
string	date-time	Sygnatura czasowa RFC3339 w czasie UTC. Użyj formatu rrrr-MM-ddTHH:mm:ss.SSSZ. Część milisekund (".SSS") jest opcjonalna. Zdefiniowane w specyfikacji schematu JSON.
string	google-datetime	Sygnatura czasowa RFC3339 w czasie UTC. Użyj formatu rrrr-MM-ddTHH:mm:ss.SSSZ. Część milisekund (".SSS") jest opcjonalna.
string	google-duration	Ciąg kończy się sufiksem & (oznacza sekundy) i jest poprzedzony liczbą sekund, a nanosekundy wyrażone jako ułamki ułamkowe. Kropka jest zawsze używana jako separator dziesiętny, a nie przecinek.
string	google-fieldmask	Ciąg, w którym nazwy pól są rozdzielone przecinkami. Nazwy pól są przedstawione w konwencjach nazewnictwa używanych w okolicy.
string	int64	64-bitowa liczba całkowita ze znakiem. Minimalna wartość to -9 223 372 036 854 775 808, a maksymalna wartość to 9 223 372 036 854 775 807 (włącznie).
string	uint64	64-bitowa liczba całkowita bez znaku. Wartość minimalna to 0, a maksymalna – 2^64)-1 (włącznie).