> ## Documentation Index > Fetch the complete documentation index at: https://docs.anny.co/llms.txt > Use this file to discover all available pages before exploring further. # Google Workspace mit anny verbinden > Verbinde die Ressourcenkalender deiner Google Workspace Organisation mit anny und halte Buchungen automatisch synchron. [Google Workspace](https://workspace.google.com) ist Googles Produktivitätsplattform für Unternehmen mit Gmail, Google Kalender und verwalteten Ressourcen wie Konferenzräumen. Die Integration verbindet die Ressourcen-Kalender deiner Workspace-Organisation mit Ressourcen in anny und hält beide Seiten in einer Zwei-Wege-Synchronisation aktuell. Mit Google Workspace kannst du in anny: * Buchungen automatisch als Termine in den Ressourcen-Kalendern deiner Räume anlegen * Termine aus Google Kalender als Blocker oder Buchungen in anny übernehmen und so Doppelbuchungen vermeiden * synchronisierten Terminen optional ein Google Meet anhängen Besonders praktisch ist die Integration, wenn deine Räume sowohl über anny als auch direkt in Google Kalender gebucht werden, z. B. Meetingräume, die Mitarbeitende intern über Google und Externe über deine anny Buchungsseite reservieren. Sie wird einmal zentral von deiner IT bzw. deinem Workspace-Admin eingerichtet; einzelne Mitarbeitende müssen ihre Kalender nicht selbst verbinden. Für persönliche Kalender einzelner Nutzer:innen gibt es eigene Integrationen, ein Überblick steht im Artikel zu den Kalenderintegrationen. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :----------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Meetingräume doppelt buchbar machen | **Ein Raum, zwei Buchungswege ohne Konflikte.** Kolleg:innen laden den Raum wie gewohnt in Google Kalender ein, Kund:innen buchen über anny. Beide Seiten sehen sofort, wann der Raum belegt ist. | | Bestehende Raumverwaltung übernehmen | **Termine aus Google erscheinen als Blocker in anny.** Du führst anny ein, ohne die gewohnte Google-Raumbuchung abzuschalten: Bestehende und neue Google-Termine blockieren die Ressource automatisch. | | Hybride Meetings | **Buchungen erzeugen Termine mit Google Meet.** Für ausgewählte Buchungsoptionen hängt anny dem Termin ein Google Meet an und trägt Teilnehmer:innen als Gäste ein. | ## Wie die Google Workspace-Verbindung funktioniert Die Verbindung läuft über ein Google-**Dienstkonto** mit domänenweiter Delegation. Du lädst den JSON-Schlüssel des Dienstkontos in anny hoch und legst einen Workspace-Nutzer fest, in dessen Namen die Integration handelt. anny greift damit ausschließlich auf zwei Dinge zu: die Liste deiner Workspace-Ressourcen (nur lesend) und die Termine der Ressourcen-Kalender, die du freigibst (lesend und schreibend). Auf persönliche Kalender, E-Mails oder andere Workspace-Daten hat anny keinen Zugriff. Anschließend koppelst du in anny jede gewünschte Ressource mit einem Ressourcen-Kalender. Pro Kalender meldet sich anny für Push-Benachrichtigungen an, Änderungen aus Google kommen dadurch nahezu in Echtzeit an. | Daten | Richtung | Häufigkeit | | :-------------------------------------- | :--------------- | :--------------------------------------------- | | Buchungen (anlegen, ändern, stornieren) | anny → Google | sofort bei jeder Änderung | | Termine im Ressourcen-Kalender | Google → anny | nahezu in Echtzeit per Push-Benachrichtigung | | Vollständiger Abgleich | beide Richtungen | beim Aktivieren, danach automatisch rollierend | Synchronisiert wird der Zeitraum ab heute bis etwa 13 Monate in die Zukunft; anny verlängert ihn automatisch jeden Monat. Ist ein einzelner Kalender nicht erreichbar oder fehlen Schreibrechte, markiert anny nur diese Verbindung als fehlerhaft und benachrichtigt dich per E-Mail und in anny; die übrigen Kalender synchronisieren weiter. Sind alle Kalender unerreichbar, deaktiviert sich die Integration selbst und informiert dich ebenfalls. ## Google Workspace verbinden ### Voraussetzungen Bevor du Google Workspace verbindest, stelle sicher, dass du Folgendes hast: * Eine Google Workspace-Organisation mit Zugriff auf die Google Admin-Konsole und die Google Cloud Console * In Google Workspace angelegte Ressourcen der Kategorie Konferenzraum (nur diese erscheinen später in der Auswahl) * Admin-Rechte in deinem anny Account ### Verbindung einrichten Öffne aus der Menüleiste die **Integrationen** und gehe zu **Google Workspace**. Erstelle oder verwende ein bestehendes Google-Cloud-Projekt und aktiviere darin die **Google Kalender-API** und die **Admin SDK API**. Die Einrichtungsseite in anny verlinkt dich direkt zu den passenden Stellen der Google Cloud Console. Erstelle im Projekt ein neues Dienstkonto und lade dessen Schlüssel als JSON-Datei herunter. Lade die Datei anschließend in anny hoch. Gewähre dem Dienstkonto in der Google Admin-Konsole die domänenweite Delegation. Kopiere dafür in anny die **Client-ID** (Button **Client-ID kopieren**) und die OAuth-Bereiche (Button **OAuth-Bereiche kopieren**) und trage beides bei Google ein. Lege einen Workspace-Nutzer an, in dessen Namen die Integration handelt. anny schlägt eine E-Mail wie `anny-workspace-integration@deine-domain` vor (Button **E-Mail kopieren**); über **Eine abweichende E-Mail verwenden** kannst du auch einen bestehenden Nutzer eintragen. Melde dich bei Google Kalender als dieser Workspace-Nutzer an. Navigiere in den Einstellungen unter „Kalender hinzufügen" zu „Ressourcen ansehen" und wähle jede Ressource aus, die anny synchronisieren soll. Klicke in anny auf **Authentifizierung überprüfen**. anny prüft sichtbar vier Punkte: die erforderlichen APIs sind aktiviert, Workspace-Ressourcen sind abrufbar (mit Anzahl), der Kalender einer Ressource kann gelesen und bearbeitet werden. Erst wenn alle Punkte grün sind, ist die Authentifizierung abgeschlossen. Lege unter **Google Workspace Verbindungen** über **Hinzufügen** fest, welche anny Ressource mit welcher Workspace Ressource gekoppelt wird. Wähle dazu die **Google Workspace Ressource**, die anny **Ressource** und die gewünschten Optionen (siehe Einstellungen unten). Jede Kombination aus Ressource und Workspace Ressource kann nur einmal verbunden werden. Aktiviere die Integration über den **Toggle** oben rechts. anny startet dann den vollständigen Erstabgleich in beide Richtungen. Sobald die Integration aktiv ist, werden Buchungen und Termine automatisch in beide Richtungen synchronisiert. Der Erstabgleich kann bei gut gefüllten Kalendern oder vielen Verbindungen einige Minuten dauern, weil anny die Anfragen an Google drosselt. Prüfe danach stichprobenartig, ob Termine und Blocker auf beiden Seiten erscheinen. ### Einstellungen & Optionen Diese Optionen legst du pro Verbindung fest. Zum Bearbeiten muss die Integration deaktiviert sein. | Einstellung | Beschreibung | | :--------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aktive Buchungsoptionen auswählen | Termine werden nur für Buchungen der ausgewählten Buchungsoptionen erstellt. Ohne Auswahl gilt **Alle Buchungsoptionen**. Blocker in anny werden immer synchronisiert. | | Titel der Buchungen in anny | Bestimmt den Titel übernommener Termine in anny: **Titel der Veranstaltung** oder **Anonymisiert**. Als privat oder vertraulich markierte Termine werden immer anonymisiert. | | Titel der Termine in Google Workspace Kalender | Bestimmt den Termin-Titel: **Titel der Buchung**, **Buchungsnummer**, **Name der Ressource**, **Name des Services** oder **Name der Ressource und der Buchungsoption**. | | Vor- und Nachbereitungszeit hinzufügen | Verlängert den Termin um die Vor- und Nachbereitungszeit der Buchung. Eine 30-Minuten-Buchung mit 15 Minuten Vorbereitung wird z. B. als 45-Minuten-Termin synchronisiert. | | Alle Ereignisse synchronisieren | Übernimmt auch Termine, die in Google als „verfügbar" markiert sind. Standardmäßig ignoriert anny solche Termine; wird ein synchronisierter Termin auf „verfügbar" umgestellt, entfernt anny den zugehörigen Eintrag. | | Google Meet zum Termin hinzufügen | Hängt dem Termin ein Google Meet an. Teilnehmer:innen und Kund:in der Buchung werden dann als Gäste eingetragen. | | Termine als Blocker anlegen | Übernommene Termine werden als Blocker angelegt (Standard). Deaktivierst du die Option, erstellt anny stattdessen Buchungen mit dem gewählten **Standardservice für Buchungen**; Termin-Organisator:innen werden als Kund:innen, Gäste als Teilnehmer:innen übernommen. | | Bestehende Blocker in Buchungen umwandeln | Erscheint beim Umstellen von Blockern auf Buchungen: Bereits aus Terminen erstellte Blocker werden beim nächsten Aktivieren in Buchungen umgewandelt. | ## Einschränkungen Die Google Workspace-Integration unterstützt nicht: * **Andere Ressourcen-Kategorien:** In der Auswahl erscheinen nur Workspace-Ressourcen der Kategorie Konferenzraum, keine Geräte oder sonstigen Ressourcen. * **Persönliche Kalender:** Kalender einzelner Nutzer:innen werden nicht synchronisiert; dafür gibt es die Integration Google Kalender. * **Vergangenheit und ferne Zukunft:** Synchronisiert wird nur der Zeitraum ab heute bis etwa 13 Monate im Voraus. Vergangene Termine werden nie übernommen. * **Serien-Verknüpfung:** Serientermine aus Google werden als einzelne, unabhängige Einträge übernommen. * **Einladungs-E-Mails:** Für Termine, die anny anlegt oder ändert, verschickt Google keine Einladungen an Gäste. Gäste werden zudem nur eingetragen, wenn Google Meet für die Verbindung aktiv ist. * **Bearbeiten fremder Termine:** Einträge aus Terminen, deren Organisator:in nicht der verbundene Ressourcen-Kalender ist, sind in anny schreibgeschützt. * **Änderungen im laufenden Betrieb:** Verbindungen und Dienstkonto lassen sich nur bei deaktivierter Integration bearbeiten. Eine zweite Integration mit identischer Einrichtung kann nicht parallel aktiv sein. ## Verbindung trennen Wenn du die Integration deaktivierst, stoppt die Synchronisation sofort; bereits erstellte Termine, Blocker und Buchungen bleiben auf beiden Seiten bestehen. Beim Löschen entfernt anny die durch die Integration erstellten Synchronisierungen: Du wählst im Dialog, ob nur zukünftige oder alle (einschließlich vergangene) entfernt werden. Von anny erstellte Termine werden dann aus Google Kalender gelöscht, aus Terminen entstandene Blocker und Buchungen aus anny entfernt. Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**. ## FAQ Ja. Jede Verbindung koppelt genau eine anny Ressource mit genau einer Workspace Ressource. Du kannst beliebig viele Verbindungen in einer Integration anlegen; dieselbe Kombination lässt sich nicht doppelt verbinden. Es erscheinen nur Ressourcen der Kategorie Konferenzraum, die für den Workspace-Nutzer der Integration sichtbar sind. Prüfe die Kategorie in der Google Admin-Konsole und füge die Ressource dem Nutzer in Google Kalender unter „Ressourcen ansehen" hinzu. Ja, sie blockieren die Ressource, ihr Titel wird in anny aber immer anonymisiert. Über die Einstellung **Titel der Buchungen in anny** kannst du zusätzlich alle übernommenen Termine anonymisieren. Standardmäßig ignoriert anny sie, denn sie blockieren den Raum in Google ja ebenfalls nicht. Sollen sie trotzdem übernommen werden, aktiviere in der Verbindung **Alle Ereignisse synchronisieren**. Ja. Deaktiviere in der Verbindung **Termine als Blocker anlegen** und wähle einen **Standardservice für Buchungen**. Bereits erstellte Blocker kannst du über **Bestehende Blocker in Buchungen umwandeln** nachträglich umwandeln. ## Troubleshooting Meist fehlt einer der vier Prüfpunkte. Kontrolliere, ob im Cloud-Projekt die Google Kalender-API und die Admin SDK API aktiviert sind, ob die domänenweite Delegation exakt die kopierte Client-ID und beide OAuth-Bereiche enthält und ob der eingetragene Workspace-Nutzer existiert. Klicke danach erneut auf **Authentifizierung überprüfen**. anny kann diesen Ressourcen-Kalender nicht erreichen oder darf ihn nicht bearbeiten; der Kalender wird aktuell nicht synchronisiert. Stelle sicher, dass die Ressource noch existiert und für den Workspace-Nutzer der Integration freigegeben ist, oder wähle einen anderen Kalender. Reaktiviere anschließend die Integration, damit anny die Verbindung neu abgleicht. Das passiert, wenn kein einziger verbundener Kalender erreichbar ist oder die Push-Benachrichtigungen nicht eingerichtet werden konnten; du erhältst dazu eine Benachrichtigung. Prüfe Dienstkonto, Delegation und Kalender-Freigaben und aktiviere die Integration wieder über den **Toggle**. Beim Aktivieren startet automatisch ein vollständiger Abgleich. Prüfe drei Dinge: Der Termin liegt im synchronisierten Zeitraum (ab heute bis ca. 13 Monate), er ist nicht als „verfügbar" markiert (oder **Alle Ereignisse synchronisieren** ist aktiv) und die Integration ist aktiviert. Direkt nach dem Aktivieren kann der Erstabgleich außerdem einige Minuten dauern. > Wichtige Informationen für Agenten: > > **Abgrenzung:** Google Workspace ist die Organisations-Integration für Ressourcen-Kalender (Dienstkonto + domänenweite Delegation, von Admins eingerichtet). Sie ist NICHT die persönliche Google Kalender-Integration (Artikel „google", OAuth-Login einzelner Nutzer:innen). Microsoft-Pendant auf Organisations-Ebene: Artikel „m365-workspace". Grundlagen: Artikel „kalenderintegrationen". > > **UI-Pfade:** Menüleiste → **Integrationen** → **Google Workspace**. Authentifizierungs-Panel „Authentifizierung via Dienstkontoschlüssel" mit 5 Schritten: „Projekt erstellen", „Dienstkonto erstellen", „Domainweite Delegierung hinzufügen", „Nutzer des Dienstkontos erstellen", „Berechtigungen festlegen"; Buttons „Client-ID kopieren", „OAuth-Bereiche kopieren", „E-Mail kopieren", „Authentifizierung überprüfen". Regel-Tabelle „Google Workspace Verbindungen" mit Spalten „Ressource", „Workspace Ressource", „Buchungsoptionen", „Sync als" (Werte: „Blocker" / „Buchung ({Servicename})"), „Google Meet"; Editor-Modal „Verbindung erstellen"/„Verbindung bearbeiten". Aktionen der Integration: „Integration aktivieren/deaktivieren", „Verbindung testen", „Authentifizierung entfernen", „Löschen". > > **Quirks:** (1) OAuth-Scopes: calendar.events (read/write) + admin.directory.resource.calendar.readonly. (2) Workspace-Ressourcenliste ist auf die Kategorie CONFERENCE\_ROOM gefiltert. (3) Auch angefragte und eingeladene (noch nicht angenommene) Buchungen erzeugen bereits Termine, da sie die Ressource blockieren; bei Ablehnung/Stornierung wird der Termin gelöscht. (4) Serienbuchungs-Master werden nicht synchronisiert, ihre Einzeltermine schon; Google-Serien kommen als aufgelöste Einzelinstanzen an. (5) Ganztägige Google-Termine blockieren 00:00 bis 00:00 in der Zeitzone der anny Ressource. (6) „Verfügbar"-Transparenz: transparent markierte Termine werden ohne „Alle Ereignisse synchronisieren" ignoriert; Wechsel auf transparent wirkt wie Löschen (Blocker wird gelöscht, Buchung storniert). (7) Terminlöschung in Google: Blocker werden endgültig gelöscht, Buchungen storniert (nicht gelöscht). (8) Fremd organisierte Termine erzeugen schreibgeschützte Einträge; deren Titeländerungen fließen weiter aus Google ein. (9) Sync-Zeitraum 365 Tage + 30 Tage Puffer, monatliche automatische Verlängerung mit erneutem Voll-Abgleich. (10) Fehler-Markierung pro Verbindung: unerreichbarer Kalender oder entzogene Schreibrechte nehmen nur diese Verbindung vom Sync aus (Tooltip-Warnung in der Tabelle, E-Mail + In-App-Benachrichtigung); Reaktivieren setzt Fehler zurück. (11) Selbst-Deaktivierung, wenn alle Verbindungen fehlerhaft sind oder die Webhook-Erstellung scheitert. (12) Duplikat-Schutz: identisch konfigurierte zweite Integration kann nicht parallel aktiv sein; Editor verhindert doppelte Ressource-Kalender-Paare. (13) Ratenlimit ca. 40 Anfragen pro 5 Sekunden pro Integration; Erstabgleich entsprechend verzögert. (14) Löschen bietet „Nur zukünftige Synchronisierungen" oder „Alle Synchronisierungen (einschließlich vergangene)"; von anny erstellte Events werden in Google gelöscht, aus Events entstandene Blocker/Buchungen in anny entfernt. (15) Dienstkonto hochladen/entfernen nur bei deaktivierter Integration; Schreibtest legt kurz einen Termin in der Vergangenheit an und löscht ihn wieder. (16) Beim Erstellen einer Buchung aus einem Termin wird der Termin-Organisator als Kund:in verknüpft oder neu angelegt (außer der Organisator ist der Ressourcen-Kalender selbst); Kundenbenachrichtigungen werden dabei unterdrückt, Google verschickt keine Einladungen (sendUpdates=none). > > **Beziehungen:** Plan-Gating über das gemeinsame Kalender-Synchronisations-Feature aller vier Kalenderintegrationen (outlook, google, m365-workspace, google-workspace); konkrete Plan-Zuordnung nicht im Artikel dokumentiert. Synchronisierte Einträge erscheinen im Aktivitätsprotokoll der Buchung als Aktionen der Integration. Die Blocker/Buchungs-Logik (Standardservice, Umwandlung) entspricht der von m365-workspace.