Events: get

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Gibt einen Termin basierend auf seiner Google Kalender-ID zurück. Wenn Sie einen Termin mit seiner iCalendar-ID abrufen möchten, rufen Sie die events.list-Methode mit dem Parameter iCalUID auf. Jetzt testen oder Beispiel ansehen

Anfragen

HTTP-Anfrage

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.
eventId string Ereignis-ID.
Optionale Suchparameter
alwaysIncludeEmail boolean Eingestellt und ignoriert. Es wird immer ein Wert im Feld email für den Organisator, den Ersteller und die Gäste zurückgegeben, auch wenn keine echte E-Mail-Adresse verfügbar ist.
maxAttendees integer Die maximale Anzahl von Teilnehmern, die in die Antwort aufgenommen werden sollen. Wenn es mehr als die angegebene Anzahl von Teilnehmern gibt, wird nur der Teilnehmer zurückgegeben. Optional.
timeZone string Zeitzone, die in der Antwort verwendet wird. Optional. Standardmäßig wird die Zeitzone des Kalenders verwendet.

Autorisierung

Diese Anfrage ermöglicht die Autorisierung mit mindestens einem der folgenden Bereiche:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ „Ereignisse“ im Antworttext zurückgegeben.

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.Event;

// ...

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

// Retrieve an event
Event event = service.events().get('primary', "eventId").execute();

System.out.println(event.getSummary());

Python

Verwendet die Python-Clientbibliothek.

event = service.events().get(calendarId='primary', eventId='eventId').execute()

print event['summary']

PHP

Verwendet die PHP-Clientbibliothek.

$event = $service->events->get('primary', "eventId");

echo $event->getSummary();

Ruby

Verwendet die Ruby-Clientbibliothek.

result = client.get_event('primary', 'eventId')
print result.summary

Testen!

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