Settings: list

Gibt alle Nutzereinstellungen für den authentifizierten Nutzer zurück. Jetzt testen

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/calendar/v3/users/me/settings

Parameter

Parametername Wert Beschreibung
Optionale Abfrageparameter
maxResults integer Maximale Anzahl von Einträgen, die auf einer Ergebnisseite zurückgegeben werden. Der Standardwert ist 100 Einträge. Die Seitengröße darf maximal 250 Einträge betragen. Optional.
pageToken string Token, das angibt, welche Ergebnisseite zurückgegeben werden soll. Optional.
syncToken string Token, das aus dem Feld nextSyncToken abgerufen wurde, das auf der letzten Ergebnisseite der vorherigen Listenanfrage zurückgegeben wurde. Dadurch enthält das Ergebnis dieser Listenanfrage nur Einträge, die sich seitdem geändert haben.
Wenn der syncToken abläuft, antwortet der Server mit dem Antwortcode „410 GONE“. Der Client sollte dann seinen Speicher löschen und eine vollständige Synchronisierung ohne syncToken durchführen.
Weitere Informationen zur inkrementellen Synchronisierung
Optional. Standardmäßig werden alle Einträge zurückgegeben.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich:

Bereich
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly
https://www.googleapis.com/auth/calendar.settings

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string Typ der Sammlung („calendar#settings“).
etag etag Etag der Sammlung.
items[] list Liste der Nutzereinstellungen
nextPageToken string Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird. Wird weggelassen, wenn keine weiteren Ergebnisse verfügbar sind. In diesem Fall wird nextSyncToken angegeben.
nextSyncToken string Token, das zu einem späteren Zeitpunkt verwendet wird, um nur die Einträge abzurufen, die sich seit der Rückgabe dieses Ergebnisses geändert haben. Wird weggelassen, wenn weitere Ergebnisse verfügbar sind. In diesem Fall wird nextPageToken angegeben.

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.