Zum Hauptinhalt springen

Google Calendar-Integration - Einrichtungsanleitung

Verbinde dein Google Calendar-Konto mit Goodweek, um Kalenderereignisse und Termine direkt aus deinem KI-Arbeitsbereich zu lesen, zu erstellen und zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Google Calendar-Konto mit Goodweek, um Kalenderereignisse und Termine direkt aus deinem KI-Arbeitsbereich zu lesen, zu erstellen und zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die Zugriffsebenen, die dem Nutzer innerhalb von Google Calendar gewährt wurden, und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Die Ergebnisse und verfügbaren Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.

📋 Voraussetzungen

Bevor ein Nutzer die Google Calendar-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek Admin-Panel unter dem Tab Integrationen aktivieren.

Administrator-Einrichtung

Persönliche Google-Konten (@gmail.com)

Keine Administrator-Einrichtung erforderlich. Verbinde dich direkt, indem du die untenstehenden Schritte zur Nutzerverbindung befolgst.

Google Workspace-Konten (Arbeit oder Bildungseinrichtung)

Je nach API-Zugriffsrichtlinie deiner Organisation kann eines der folgenden Szenarien zutreffen.

Szenario 1 — Standard (uneingeschränkter Zugriff durch Drittanbieter)

Jeder Nutzer kann sich direkt verbinden, ohne dass der Administrator eingreifen muss.

Szenario 2 — Der Zugriff durch Drittanbieter ist eingeschränkt (Fehler admin_policy_enforced)

Ein Google Workspace-Super Admin muss Composio als vertrauenswürdige App markieren:

  1. Melde dich als Super Admin bei admin.google.com an.

  2. Gehe zu Sicherheit → Zugriffs- und Datenkontrolle → API-Steuerung → Zugriff von Drittanbieter-Apps verwalten.

  3. Klicke auf Configure new app, suche nach Composio, wähle es aus, setze den Zugriff auf Trusted und klicke auf Save.

Szenario 3 — Der gesamte API-Zugriff durch Drittanbieter ist blockiert

Gehe zu admin.google.com → Sicherheit → Zugriffs- und Datenkontrolle → API-Steuerung und überprüfe die Einstellung "Third-party app access to Google APIs". Falls sie blockiert ist, muss der Administrator eine Ausnahme für Composio erstellen, bevor er Szenario 2 befolgt.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Google Calendar und klicke auf Connect.

  3. Du wirst zu Google weitergeleitet, wo du aufgefordert wirst, dich anzumelden.

  4. Überprüfe die angeforderten Berechtigungen und klicke auf Allow, um zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die Kalender zugreifen, auf die dein individuelles Nutzerkonto Zugriff hat. Geteilte Kalender sind nur zugänglich, wenn dir die entsprechenden Freigabeberechtigungen erteilt wurden.

  • Wenn du mehrere Google-Konten hast, achte darauf, beim Verbindungsschritt das richtige auszuwählen.

  • Du kannst den Zugriff von Goodweek jederzeit über myaccount.google.com → Sicherheit → Drittanbieter-Apps mit Kontozugriff widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Create Event

Erstellt ein neues Ereignis in einem Google Calendar mit Startzeit, Dauer, Teilnehmern und weiteren Details.

Schreiben

Update Event

Aktualisiert die Felder eines bestehenden Kalenderereignisses anhand seiner ID.

Schreiben

Patch Event

Aktualisiert teilweise bestimmte Felder eines bestehenden Kalenderereignisses, ohne den Rest zu überschreiben.

Schreiben

Quick Add Event

Erstellt ein einfaches Kalenderereignis, indem eine Textzeichenfolge in natürlicher Sprache analysiert wird (z. B. „Mittagessen mit Alice morgen um 13 Uhr").

Schreiben

Get Event

Ruft ein einzelnes Kalenderereignis anhand seiner eindeutigen ID ab.

Lesen

Find Event

Sucht mithilfe einer Textabfrage, Zeiträumen und Ereignistypen nach Ereignissen in einem Kalender.

Lesen

List Events

Gibt Ereignisse aus einem angegebenen Kalender innerhalb eines bestimmten Zeitfensters zurück.

Lesen

List Events from All Calendars

Gibt eine einheitliche Ereignisliste über alle Kalender in der Kalenderliste des Nutzers für einen bestimmten Zeitraum zurück.

Lesen

Get Event Instances

Gibt alle Instanzen eines wiederkehrenden Ereignisses innerhalb eines optionalen Zeitraums zurück.

Lesen

Find Free Slots

Findet freie und belegte Zeitfenster in den angegebenen Kalendern innerhalb eines festgelegten Zeitraums.

Lesen

Get Current Date and Time

Gibt das aktuelle Datum und die aktuelle Uhrzeit für eine angegebene Zeitzone zurück, nützlich vor der Berechnung relativer Daten.

Lesen

Create a New Calendar

Erstellt einen neuen sekundären Google Calendar mit einem angegebenen Titel und optionalen Einstellungen.

Schreiben

List Google Calendars

Ruft alle Kalender aus der Google Calendar-Liste des Nutzers ab.

Lesen

Patch Calendar

Aktualisiert teilweise die Metadaten eines bestehenden Kalenders (Name, Beschreibung, Zeitzone usw.).

Schreiben

Move Event

Verschiebt ein Ereignis in einen anderen Kalender.

Lesen

List Calendar Resources

Ruft Kalenderressourcen wie Besprechungsräume aus einer Google Workspace-Domain ab.

Lesen

Create ACL Rule

Erstellt eine Zugriffskontrollregel, um Kalenderfreigabeberechtigungen an einen Nutzer, eine Gruppe oder eine Domain zu vergeben.

Schreiben

List ACL Rules

Ruft alle Zugriffskontrollregeln für einen angegebenen Kalender ab.

Lesen

Delete Event

Löscht ein angegebenes Kalenderereignis anhand seiner ID dauerhaft.

⚠️ Destruktiv

Remove Attendee from Event

Entfernt einen bestimmten Teilnehmer aus einem bestehenden Kalenderereignis.

⚠️ Destruktiv

Delete Calendar

Löscht einen sekundären Kalender, der dem Nutzer gehört, dauerhaft.

⚠️ Destruktiv

Clear Calendar

Löscht alle Ereignisse aus einem primären Kalender, wobei der Kalender selbst erhalten bleibt.

⚠️ Destruktiv

Delete ACL Rule

Entfernt eine Freigabeberechtigung von einem Google Calendar.

⚠️ Destruktiv

Anwendungsfälle

  • Ereignisse aus Unterhaltungen erstellen und verwalten. Plane Meetings, richte Erinnerungen ein oder füge Ereignisse zu deinem Google Calendar direkt aus einer Goodweek-Unterhaltung hinzu — einschließlich Teilnehmern, Ort und Beschreibung — ohne zur Kalender-App zu wechseln.

  • Verfügbarkeit vor der Planung prüfen. Frage freie und belegte Zeitfenster in einem oder mehreren Kalendern ab, um vor dem Vorschlagen an die Teilnehmer eine passende Besprechungszeit zu finden.

  • Deine Agenda bei Bedarf einsehen. Rufe Ereignisse von heute, dieser Woche oder einem beliebigen benutzerdefinierten Zeitraum über alle deine Kalender hinweg ab, um dir einen schnellen Überblick über deinen Terminplan zu verschaffen, ohne deinen Arbeitsbereich zu verlassen.

  • Ereignisse schnell aktualisieren oder absagen. Ändere Ereignisdetails oder entferne Teilnehmer aus bestehenden Meetings direkt in Goodweek, wenn sich Pläne ändern, ohne durch die Kalenderoberfläche zu navigieren.


Fehlerbehebung

"Error 400: admin_policy_enforced" beim Verbinden

Der Administrator deiner Organisation hat den Zugriff von Drittanbieter-Apps eingeschränkt. Nur ein Google Workspace-Super Admin kann dies beheben, indem er Szenario 2 oben befolgt.

Administrator hat Composio als Trusted markiert, aber der Fehler tritt weiterhin auf

Es könnte eine Verzögerung bei der Übertragung geben. Warte einige Minuten und versuche es erneut.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass der Administrator deiner Organisation die Google Calendar-Integration im Goodweek Admin-Panel unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?