Diese Seite wurde von der Cloud Translation API übersetzt.

CalendarList: list

Gibt die Kalender in der Kalenderliste des Nutzers zurück. Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.

Anfrage

HTTP-Anfrage

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

Parameter

Parametername	Wert	Beschreibung
Optionale Abfrageparameter
`maxResults`	`integer`	Maximale Anzahl der auf einer Ergebnisseite zurückgegebenen Einträge. Standardmäßig beträgt der Wert 100 Einträge. Die Seitengröße darf nicht größer als 250 Einträge sein. Optional.
`minAccessRole`	`string`	Die minimale Zugriffsrolle für den Nutzer in den zurückgegebenen Einträgen. Optional. Die Standardeinstellung ist keine Einschränkung. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> "`freeBusyReader`": Der Nutzer kann Informationen zu Ihrem Verfügbarkeitsstatus lesen. „`owner`“: Der Nutzer kann Ereignisse und Access Control Lists lesen und ändern. "`reader`": Der Nutzer kann Termine lesen, die nicht privat sind. „`writer`“: Der Nutzer kann Ereignisse lesen und ändern.
`pageToken`	`string`	Token, das angibt, welche Ergebnisseite zurückgegeben werden soll. Optional.
`showDeleted`	`boolean`	Gibt an, ob gelöschte Kalendereinträge in das Ergebnis einbezogen werden sollen. Optional. Die Standardeinstellung ist "False".
`showHidden`	`boolean`	Legt fest, ob ausgeblendete Einträge angezeigt werden. Optional. Die Standardeinstellung ist "False".
`syncToken`	`string`	Token, das aus dem Feld `nextSyncToken` abgerufen wurde, das auf der letzten Seite der Ergebnisse der vorherigen Listenanfrage zurückgegeben wurde. Dadurch enthält das Ergebnis dieser Listenanfrage nur Einträge, die sich seitdem geändert haben. Falls sich nur schreibgeschützte Felder wie Kalendereigenschaften oder ACLs geändert haben, wird der Eintrag nicht zurückgegeben. Alle Einträge, die seit der vorherigen Listenanfrage gelöscht und ausgeblendet wurden, sind immer in der Ergebnismenge enthalten und es darf weder `showDeleted` noch `showHidden` auf „False“ gesetzt werden. Um eine Konsistenz des Clientstatus sicherzustellen, kann der `minAccessRole`-Abfrageparameter nicht zusammen mit `nextSyncToken` angegeben werden. Wenn `syncToken` abläuft, antwortet der Server mit dem Antwortcode 410 GONE und der Client sollte den 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 in mindestens einem der folgenden Bereiche erforderlich:

Umfang
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`

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#calendarList",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    calendarList Resource
  ]
}

Name der Eigenschaft	Wert	Beschreibung
`kind`	`string`	Typ der Sammlung ("`calendar#calendarList`")
`etag`	`etag`	Das ETag der Sammlung.
`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.
`items[]`	`list`	Kalender, die in der Kalenderliste des Nutzers vorhanden sind.
`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.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.CalendarList;
import com.google.api.services.calendar.model.CalendarListEntry;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Iterate through entries in calendar list
String pageToken = null;
do {
  CalendarList calendarList = service.calendarList().list().setPageToken(pageToken).execute();
  List<CalendarListEntry> items = calendarList.getItems();

  for (CalendarListEntry calendarListEntry : items) {
    System.out.println(calendarListEntry.getSummary());
  }
  pageToken = calendarList.getNextPageToken();
} while (pageToken != null);

Python

Verwendet die Python-Clientbibliothek.

page_token = None
while True:
  calendar_list = service.calendarList().list(pageToken=page_token).execute()
  for calendar_list_entry in calendar_list['items']:
    print calendar_list_entry['summary']
  page_token = calendar_list.get('nextPageToken')
  if not page_token:
    break

PHP

Verwendet die PHP-Clientbibliothek.

$calendarList = $service->calendarList->listCalendarList();

while(true) {
  foreach ($calendarList->getItems() as $calendarListEntry) {
    echo $calendarListEntry->getSummary();
  }
  $pageToken = $calendarList->getNextPageToken();
  if ($pageToken) {
    $optParams = array('pageToken' => $pageToken);
    $calendarList = $service->calendarList->listCalendarList($optParams);
  } else {
    break;
  }
}

Ruby

Verwendet die Ruby-Clientbibliothek.

page_token = nil
begin
  result = client.list_calendar_lists(page_token: page_token)
  result.items.each do |e|
    print e.summary + "\n"
  end
  if result.next_page_token != page_token
    page_token = result.next_page_token
  else
    page_token = nil
  end
end while !page_token.nil?

Testen!

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