Kalenderereignisse erstellen und abfragen
Google Calendar API: Ereignisse auflisten, Besprechungen erstellen und Erinnerungen festlegen.
Kalenderereignisse erstellen und abfragen ist eine kostenlose AI Agents-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des AI Agents-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der AI Agents-Kurs umfasst insgesamt 4 Lektionen.
Überblick über die Google Calendar API
Mit der Google Calendar API können Agenten Kalenderereignisse lesen, erstellen, aktualisieren und löschen. Sie verwendet dieselbe Google-OAuth-Authentifizierung wie Gmail. Die wichtigste Ressource ist das Objekt Event, und Ereignisse gehören zu einem Calendar. Die Kalender-ID 'primary' verweist auf den Hauptkalender der authentifizierten Person.
from googleapiclient.discovery import build
# Build calendar service (same credentials as Gmail)
calendar = build(
'calendar', 'v3',
credentials=creds,
cache_discovery=False
)
# Get a list of the user's calendars
cal_list = calendar.calendarList().list().execute()
for cal in cal_list.get('items', []):
print(f'{cal["summary"]}: {cal["id"]}')
# Primary calendar ID is the user's email addressBevorstehende Ereignisse auflisten
Verwenden Sie service.events().list(), um Ereignisse abzurufen. Mit den Parametern timeMin und timeMax filtern Sie nach einem Zeitraum. Verwenden Sie immer RFC-3339-Datums- und Zeitangaben mit einem Zeitzonenoffset. Setzen Sie singleEvents=True, um wiederkehrende Ereignisse in einzelne Instanzen aufzulösen.
import datetime
import pytz
def get_upcoming_events(service, calendar_id='primary', max_results=10):
now = datetime.datetime.now(pytz.utc)
time_min = now.isoformat() # RFC 3339 format
time_max = (now + datetime.timedelta(days=7)).isoformat()
events_result = service.events().list(
calendarId=calendar_id,
timeMin=time_min,
timeMax=time_max,
maxResults=max_results,
singleEvents=True, # expand recurring events
orderBy='startTime'
).execute()
events = events_result.get('items', [])
for event in events:
start = event['start'].get('dateTime', event['start'].get('date'))
print(f'{start}: {event["summary"]}')
return eventsStart- und Endzeiten von Ereignissen analysieren
Kalenderereignisse haben zwei Arten von Zeitangaben: dateTime (eine bestimmte Uhrzeit mit Zeitzone) für reguläre Ereignisse und date (nur ein Datum, ohne Uhrzeit) für ganztägige Ereignisse. Prüfen Sie vor dem Parsen immer, welches Feld vorhanden ist.
from datetime import datetime
import re
def parse_event_time(time_dict):
if 'dateTime' in time_dict:
# Parse RFC 3339 datetime: '2026-05-29T14:00:00+03:00'
dt_str = time_dict['dateTime']
# Python 3.7+ fromisoformat handles this
return datetime.fromisoformat(dt_str), False # not all-day
else:
# All-day event: '2026-05-29'
date_str = time_dict['date']
return datetime.strptime(date_str, '%Y-%m-%d'), True # all-day
for event in events:
start_dt, is_all_day = parse_event_time(event['start'])
end_dt, _ = parse_event_time(event['end'])
duration = end_dt - start_dt if not is_all_day else None
print(f'{event["summary"]}: {start_dt.strftime("%H:%M")} '
f'({"all-day" if is_all_day else str(duration)})')Ein einfaches Ereignis erstellen
Verwenden Sie service.events().insert(), um ein neues Ereignis zu erstellen. Die mindestens erforderlichen Felder sind summary (Titel), start und end. Die Zeitangaben müssen das RFC-3339-Format mit Zeitzone verwenden. Das Feld timeZone in start und end gibt den Namen der Zeitzone an.
def create_event(service, title, start_datetime, end_datetime,
description='', timezone='UTC', calendar_id='primary'):
event = {
'summary': title,
'description': description,
'start': {
'dateTime': start_datetime.isoformat(),
'timeZone': timezone
},
'end': {
'dateTime': end_datetime.isoformat(),
'timeZone': timezone
}
}
created = service.events().insert(
calendarId=calendar_id,
body=event
).execute()
print(f'Event created: {created["summary"]}')
print(f'Event ID: {created["id"]}')
print(f'Link: {created["htmlLink"]}')
return created
# --- demo: minimal stand-in for the Calendar API's service object ---
import datetime
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body):
return _Exec({**body, 'id': 'evt_123',
'htmlLink': 'https://calendar.google.com/event?eid=evt_123'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
start = datetime.datetime(2026, 8, 10, 9, 0)
end = start + datetime.timedelta(hours=1)
create_event(service, 'Team Sync', start, end, description='Weekly sync')
Teilnehmer zu Ereignissen hinzufügen
Fügen Sie einem Ereignis Teilnehmer hinzu, indem Sie eine Liste attendees mit E-Mail-Adressen angeben. Setzen Sie sendUpdates='all', um automatisch Google-Calendar-Einladungen an alle Teilnehmer zu senden. Verwenden Sie 'externalOnly', um nur externe Gäste zu benachrichtigen.
import datetime
def schedule_meeting(service, title, start_iso, duration_minutes,
attendees, description=''):
start = datetime.datetime.fromisoformat(start_iso)
end = start + datetime.timedelta(minutes=duration_minutes)
event = {
'summary': title,
'description': description,
'start': {'dateTime': start.isoformat(), 'timeZone': 'UTC'},
'end': {'dateTime': end.isoformat(), 'timeZone': 'UTC'},
'attendees': [
{'email': email} for email in attendees
],
'conferenceData': {
'createRequest': {'requestId': f'meet-{start.timestamp()}'}
} # creates a Google Meet link
}
created = service.events().insert(
calendarId='primary',
body=event,
sendUpdates='all', # send invites
conferenceDataVersion=1 # enable Meet link creation
).execute()
return created
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body, sendUpdates=None, conferenceDataVersion=None):
return _Exec({**body, 'id': 'evt_456'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
created = schedule_meeting(
service, 'Sprint Planning', '2026-08-11T10:00:00', 30,
attendees=['alice@example.com', 'bob@example.com']
)
print(f'Meeting scheduled: {created["summary"]}')
print(f'Attendees: {[a["email"] for a in created["attendees"]]}')
Erinnerungen zu Ereignissen hinzufügen
Ereignisse können Erinnerungen enthalten – Benachrichtigungen, die vor dem Ereignis gesendet werden. Verwenden Sie 'popup' für Benachrichtigungen im Browser oder in der App und 'email' für E-Mail-Erinnerungen. Setzen Sie useDefault: False, um die Kalendereinstellungen durch benutzerdefinierte Zeitabstände zu überschreiben.
def create_event_with_reminders(service, title, start_iso, end_iso):
event = {
'summary': title,
'start': {'dateTime': start_iso, 'timeZone': 'UTC'},
'end': {'dateTime': end_iso, 'timeZone': 'UTC'},
'reminders': {
'useDefault': False,
'overrides': [
{'method': 'email', 'minutes': 24 * 60}, # 1 day before
{'method': 'popup', 'minutes': 30}, # 30 min before
{'method': 'popup', 'minutes': 10} # 10 min before
]
}
}
return service.events().insert(
calendarId='primary',
body=event
).execute()
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body):
return _Exec({**body, 'id': 'evt_789'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
created = create_event_with_reminders(
service, 'Deploy Review', '2026-08-12T15:00:00', '2026-08-12T15:30:00'
)
print(f'Event id: {created["id"]}')
print('Reminders:', created['reminders']['overrides'])
Wiederkehrende Ereignisse erstellen
Wiederkehrende Ereignisse verwenden eine RRULE (Regel für Wiederholungen) – dasselbe Format wie iCalendar RFC 5545. Häufige Regeln sind: FREQ=WEEKLY;BYDAY=MO,WE,FR für Montag, Mittwoch und Freitag sowie FREQ=MONTHLY;BYDAY=1MO für den ersten Montag jedes Monats.
def create_recurring_event(service, title, start_iso, end_iso,
rrule, timezone='UTC'):
event = {
'summary': title,
'start': {'dateTime': start_iso, 'timeZone': timezone},
'end': {'dateTime': end_iso, 'timeZone': timezone},
'recurrence': [
f'RRULE:{rrule}' # recurrence rule string
]
}
return service.events().insert(
calendarId='primary',
body=event
).execute()
# Weekly team standup every Monday at 9am for 30 min
create_recurring_event(
service=calendar_service,
title='Team Standup',
start_iso='2026-06-01T09:00:00',
end_iso='2026-06-01T09:30:00',
rrule='FREQ=WEEKLY;BYDAY=MO;COUNT=52', # 52 weeks
timezone='America/New_York'
)Ein vorhandenes Ereignis aktualisieren
Verwenden Sie service.events().patch(), um bestimmte Felder eines vorhandenen Ereignisses zu aktualisieren, ohne das gesamte Ereignis zu ersetzen. Verwenden Sie .update(), um den gesamten Ereignisinhalt zu ersetzen. Beide Methoden benötigen die Ereignis-ID aus der ursprünglichen Antwort von create oder list.
def reschedule_event(service, event_id, new_start_iso, new_end_iso,
timezone='UTC', calendar_id='primary'):
updated_fields = {
'start': {'dateTime': new_start_iso, 'timeZone': timezone},
'end': {'dateTime': new_end_iso, 'timeZone': timezone}
}
updated_event = service.events().patch(
calendarId=calendar_id,
eventId=event_id,
body=updated_fields,
sendUpdates='all' # notify attendees of the change
).execute()
print(f'Event rescheduled: {updated_event["summary"]}')
print(f'New start: {updated_event["start"]["dateTime"]}')
return updated_event
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def patch(self, calendarId, eventId, body, sendUpdates=None):
return _Exec({'summary': 'Team Sync', 'id': eventId, **body})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
reschedule_event(service, 'evt_123', '2026-08-13T09:00:00', '2026-08-13T10:00:00')
Ereignisse löschen
Verwenden Sie service.events().delete(), um ein Ereignis abzusagen und zu löschen. Wenn Sie sendUpdates='all' setzen, werden die Teilnehmer benachrichtigt. Bei wiederkehrenden Ereignissen können Sie je nach verwendeter Ereignis-ID entweder eine einzelne Instanz oder die gesamte Serie löschen.
from googleapiclient.errors import HttpError
def cancel_event(service, event_id, notify_attendees=True,
calendar_id='primary'):
try:
service.events().delete(
calendarId=calendar_id,
eventId=event_id,
sendUpdates='all' if notify_attendees else 'none'
).execute()
print(f'Event {event_id} cancelled')
return True
except HttpError as e:
if e.resp.status == 404:
print(f'Event {event_id} not found (already deleted?)')
elif e.resp.status == 403:
print('No permission to delete this event')
else:
print(f'Delete failed: {e.resp.status}')
return FalseVerfügbarkeit prüfen
Prüfen Sie vor der Planung eines Meetings die Verfügbarkeit der Teilnehmer mithilfe der freebusy-API. Sie gibt belegte Zeitblöcke für eine Liste von Kalendern in einem bestimmten Zeitraum zurück – ideal, um freie Zeitfenster für Planungsagenten zu finden.
import datetime
import pytz
def check_availability(service, attendees, duration_hours=1):
now = datetime.datetime.now(pytz.utc)
time_min = now.isoformat()
time_max = (now + datetime.timedelta(days=5)).isoformat()
body = {
'timeMin': time_min,
'timeMax': time_max,
'timeZone': 'UTC',
'items': [{'id': email} for email in attendees]
}
result = service.freebusy().query(body=body).execute()
for email in attendees:
busy_slots = result['calendars'].get(email, {}).get('busy', [])
print(f'{email}: {len(busy_slots)} busy slots in next 5 days')
for slot in busy_slots[:3]:
print(f' Busy: {slot["start"]} -> {slot["end"]}')
return resultEreignisse per Suchanfrage suchen
Verwenden Sie den Parameter q in events().list(), um Ereignisse anhand von Text zu suchen – die Suche umfasst Titel, Beschreibung, Ort und Namen der Teilnehmer. Kombinieren Sie ihn mit timeMin/timeMax, um die Ergebnisse auf einen bestimmten Zeitraum einzugrenzen.
def search_events(service, query, days_back=30, days_forward=30,
calendar_id='primary'):
import datetime, pytz
now = datetime.datetime.now(pytz.utc)
result = service.events().list(
calendarId=calendar_id,
q=query,
timeMin=(now - datetime.timedelta(days=days_back)).isoformat(),
timeMax=(now + datetime.timedelta(days=days_forward)).isoformat(),
singleEvents=True,
orderBy='startTime',
maxResults=50
).execute()
events = result.get('items', [])
print(f'Found {len(events)} events matching "{query}"')
for event in events:
start = event['start'].get('dateTime', event['start'].get('date'))
print(f' {start}: {event["summary"]}')
return eventsKurzer Test: Parameter singleEvents
Testen Sie Ihr Verständnis der Calendar API.
Zusammenfassung der Calendar API
Ihre Agenten können Google Calendar jetzt programmgesteuert verwalten:
- Ereignisse auflisten:
events().list(timeMin=now, singleEvents=True, orderBy='startTime') - Ereignisse erstellen:
events().insert(body={summary, start, end, attendees}) - Wiederkehrende Ereignisse:
recurrence: ['RRULE:FREQ=WEEKLY;BYDAY=MO']hinzufügen - Erinnerungen:
reminders.overridesmitmethod: popup/emailundminutesverwenden - Aktualisieren:
events().patch()für teilweise Aktualisierungen;sendUpdates='all', um Teilnehmer zu benachrichtigen - Frei/belegt: Mit
freebusy().query()die Verfügbarkeit vor der Planung prüfen
Lerne AI Agents mit einem KI-Tutor — kostenlos
Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.
- Kurse
- 60
- Lektionen
- 239
Häufig gestellte Fragen
Ist die Lektion „Kalenderereignisse erstellen und abfragen“ kostenlos?
Ja — der vollständige Text von „Kalenderereignisse erstellen und abfragen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des AI Agents-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der AI Agents-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Kalenderereignisse erstellen und abfragen“?
Google Calendar API: Ereignisse auflisten, Besprechungen erstellen und Erinnerungen festlegen. Du übst AI Agents mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um AI Agents zu starten?
Keine Vorkenntnisse erforderlich. AI Agents auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „Kalenderereignisse erstellen und abfragen“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser AI Agents-Lektion Code schreiben und ausführen?
Ja. Jede AI Agents-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Über die API mit Gmail verbinden
- E-Mails programmgesteuert lesen und senden
- Kalenderereignisse erstellen und abfragen
- Einen einfachen E-Mail-Assistenten als Agent erstellen