Gibt einen Termin basierend auf seiner Google Kalender-ID zurück. Wenn Sie einen Termin über seine iCalendar-ID abrufen möchten, rufen Sie die events.list-Methode mit dem iCalUID
-Parameter auf.
Probieren Sie es aus oder sehen Sie sich ein Beispiel an.
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 Schlüsselwort „primary “.
|
eventId |
string |
Ereignis-ID. |
Optionale Abfrageparameter | ||
alwaysIncludeEmail |
boolean |
Eingestellt und ignoriert. Im Feld email wird für den Organisator, den Ersteller und die Teilnehmer immer ein Wert zurückgegeben, auch wenn keine echte E-Mail-Adresse verfügbar ist. Es wird also ein generierter, nicht funktionierender Wert angegeben.
|
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 |
Die in der Antwort verwendete Zeitzone. Optional. Die Standardeinstellung ist die Zeitzone des Kalenders. |
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 Ereignisressource 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
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.