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.

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