Zwraca wszystkie ustawienia dla uwierzytelnionego użytkownika. Wypróbuj lub zobacz przykład.
Prośba
Żądanie HTTP
GET https://www.googleapis.com/calendar/v3/users/me/settings
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Opcjonalne parametry zapytania | ||
maxResults |
integer |
Maksymalna liczba wpisów zwróconych na jednej stronie wyników. Domyślnie jest to 100 wpisów. Rozmiar strony nigdy nie może przekraczać 250 wpisów. Opcjonalnie. |
pageToken |
string |
Token określający stronę wyników, która ma zostać zwrócona. Opcjonalnie. |
syncToken |
string |
Token uzyskany z pola nextSyncToken zwróconego na ostatniej stronie wyników z poprzedniego żądania listy. Dzięki temu wynik żądania listy zawiera tylko wpisy, które od tego czasu się zmieniły. Jeśli syncToken wygaśnie, serwer w odpowiedzi z kodem 410 GONE powinien wyczyścić pamięć i przeprowadzić pełną synchronizację bez żadnego syncToken . Dowiedz się więcej o synchronizacji przyrostowej. Opcjonalne. Domyślnie zwracane są wszystkie wpisy. |
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:
Zakres |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.settings.readonly |
Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.
Treść żądania
Nie podawaj treści żądania z tą metodą.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź w następującej strukturze:
{ "kind": "calendar#settings", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ settings Resource ] }
nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Typ kolekcji („calendar#settings ”). |
|
etag |
etag |
ETag kolekcji. | |
items[] |
list |
Lista ustawień użytkownika. | |
nextPageToken |
string |
Token używany do uzyskania dostępu do następnej strony tego wyniku. Pominięta, jeśli nie ma więcej wyników. W takim przypadku dostarczana jest wartość nextSyncToken . |
|
nextSyncToken |
string |
Token używany później do pobrania tylko tych wpisów, które zmieniły się od czasu zwrócenia tego wyniku. Pominięta, jeśli dostępne są dalsze wyniki. W takim przypadku dostarczana jest wartość nextPageToken . |
Przykłady
Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.
Java
Korzysta z biblioteki klienta Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Setting; import com.google.api.services.calendar.model.Settings; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over all user settings Settings settings = service.settings().list().execute(); for (Setting setting : settings.getItems()) { System.out.println(setting.getId() + ": " + setting.getValue()); }
Python
Używa biblioteki klienta dla języka Python.
settings = service.settings().list().execute() for setting in settings['items']: print '%s: %s' % (setting['id'], setting['value'])
PHP
Korzysta z biblioteki klienta PHP.
$settings = $service->settings->listSettings(); foreach ($settings->getItems() as $setting) { echo $setting->getId() . ': ' . $setting->getValue(); }
Ruby
Używa biblioteki klienta Ruby.
result = client.list_settings result.items.each do |e| print e.id + ": " + e.value + "\n" end
Wypróbuj
Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.