# Zoom-Kalender-Endpunkte ### Web-Kalenderdienst Der Web-Kalenderdienst ist das Herzstück der Fähigkeit von Zoom, Kalenderinformationen an alle Zoom-Apps bereitzustellen. #### Welche Informationen speichert Zoom? Der Zoom Web-Kalenderdienst speichert die Objekte, die erforderlich sind, um den Kalenderanbieter jedes Benutzers zu authentifizieren. Das bedeutet, dass Zoom das Refresh-Token speichert, wenn Organisationen OAuth verwenden, um Outlook oder Google Kalender mit den Zoom-Diensten zu verbinden. Es bedeutet auch, dass Zoom für Organisationen, die Basic-Authentifizierung für Exchange On-Premises verwenden, den Kontobenutzernamen und das Passwort speichert. | Synchronisierte Ereignisse | | --------------------------- | | `attendeesOmitted` | | `description` | | `displayName` (Teilnehmer) | | `E-Mail` (Teilnehmer) | | `fixedWorkingLocation` | | `iCalUID` | | `Standort` | | `displayName` (Organisator) | | `E-Mail` (Organisator) | | `Zusammenfassung` | | `Zeitvorschlag` | | `Arbeitsort aktiviert` | Wenn die bidirektionale Kalender-Synchronisierung (Synchronisieren 2.0) aktiviert ist, behält Zoom externe Kalender-Eventdaten (von Microsoft 365 oder Google Kalender) nicht in seiner Datenbank.\ \ Stattdessen überwacht der Dienst ein rollierendes 24-Monats-Fenster der Kalenderaktivität (bis zu 6 Monate in der Vergangenheit und 18 Monate in der Zukunft). Wenn innerhalb dieses Fensters Änderungen auftreten, erhält Zoom Änderungsbenachrichtigungen vom Kalenderanbieter und ruft die aktualisierten Eventdaten bei Bedarf ab, um die entsprechenden Zoom Meeting-Updates zu verarbeiten. Der Meeting-Dienst wird dann benachrichtigt, die erforderlichen Änderungen anzuwenden. Administratoren können diese Funktion auf Konto- oder Benutzergruppenebene Konfigurieren. Siehe unsere [Support-Dokumentation](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) für weitere Informationen. #### Wie werden gespeicherte Tokens und Anmeldedaten geschützt? Die gespeicherten Tokens und Anmeldedaten werden im Ruhezustand mit 256-Bit-AES-GCM-Verschlüsselung verschlüsselt. Diese Daten gelten als Kundendaten und unterliegen den Zugriffssteuerungsrichtlinien und -standards von Zoom. Diese Kontrollen werden von unabhängigen Prüfungsunternehmen bewertet, sofern dies in unseren Sicherheitszertifizierungen und -bestätigungen angegeben ist, wie z. B. SOC 2. Berechtigter Zugriff auf Infrastrukturdaten und -systeme wird protokolliert, überwacht und mithilfe von Multifaktor-Authentifizierung und Zugriffssteuerungen mit minimalen Berechtigungen kontrolliert. #### Wie wird der Datenverkehr zwischen Apps und dem Kalenderanbieter geschützt? Die Kommunikation zwischen Kalenderanbietern und jeglicher Zoom-Software — Zoom-Desktop-/Mobil-Apps, Zoom Web Kalender Service, Planen-Tools und dem API Connector — wird während der Übertragung mit TLS 1.2 verschlüsselt. #### Wie lange ist ein OAuth-Token gültig? Zoom wird Access-Tokens anfordern, die in 1 Stunde ablaufen, und Refresh-Tokens, die in 90 Tagen ablaufen. Anbieter für die Kalenderintegration können jedoch Tokens mit abweichenden Begrenzungen bereitstellen. Folgen Sie den Anweisungen Ihres Anbieters, wenn Sie die standardmäßigen Werte ändern müssen. #### Kann ich ein OAuth-Token oder Anmeldedaten widerrufen? Zoom-Administratoren können jederzeit wählen, die Kalenderintegration aus einem einzelnen Zoom-Konto zu entfernen, wodurch verhindert wird, dass die Kalenderfunktion des Benutzers funktioniert. Löschen Sie umgehend alle gespeicherten Token oder Anmeldeinformationen für diesen Benutzer. Microsoft 365-Administratoren kann die Kalenderzugriff von Zoom von allen Benutzerkonten entfernen, indem sie die Zoom-Anwendung im Entra-ID Enterprise Application-Portal löschen, und Administratoren von Google Arbeitsplatz können den Zugriff widerrufen, indem sie die Google Cloud Platform Console verwenden. #### Kann ich Zooms Fähigkeit einschränken, Kalender- oder Kontaktdaten bei einem Anbieter zu schreiben? Nach der ersten Konfiguration können Zoom-Administratoren zwischen Lese- und Lese-/Schreibberechtigungen für sowohl Kalender als auch Kontakte Wählen, wenn sie über Microsoft 365-Methoden Verbinden. Administratoren können außerdem Google Arbeitsplatz-Integrationen für Benutzerkalender einschränken. ### Desktop- und Mobile-Apps #### Speichern die Zoom-Apps irgendwelche Kalender- oder Kontaktdaten? Zoom-Apps speichern Kalenderinformationen im temporären Speicher (RAM) und schreiben keine Elemente auf die lokale Festplatte. Dazu gehören Authentifizierungstokens, Anmeldedaten, Kalender-Eventinformationen und Kontaktdaten. Diese Daten sind nicht mehr verfügbar, sobald der Client beendet wird. #### Was passiert bei der Anmeldung? Zoom-Apps führen bei jeder Anmeldung eine vollständige Aktualisierung durch, um die Liste der bevorstehenden Events zu erfassen. Dies umfasst den Empfang ihres OAuth-Access-Token oder der gespeicherten Anmeldedaten vom Zoom Web Kalender Service und anschließend die Verwendung dieses Objekts, um Event-Daten direkt vom Kalenderanbieter zu aktualisieren. Wenn das Access-Token ungültig ist, verwendet der Zoom Web Kalender Service das Refresh-Token, um ein neues Access-Token anzufordern und an den Client weiterzugeben. #### Woher weiß der Client, dass er seine Liste der bevorstehenden Events aktualisieren soll? Der Zoom Web-Kalenderdienst abonniert für jeden Benutzer einen Webhook des Kalenderanbieters, nachdem der Kalender im Webportal verbunden wurde. Diese Webhooks benachrichtigen den Web-Kalenderdienst über alle Änderungen, sodass er dann die Zoom-Anwendung benachrichtigen kann, dass ein Update erforderlich ist. Schließlich fordert die Zoom-Anwendung ein Update direkt vom Kalenderanbieter an. Apps, die keine Update-Benachrichtigung erhalten, aktualisieren ihre Event-Liste alle 30 Minuten. #### Welche Meeting-Details sind dem Kunden Verfügbar? Zoom-Apps anzeigen Meeting-Daten, nachdem sie die Events, die sie analysiert, bereinigt haben, was bedeutet, dass sie alle Attribute verworfen haben, die sie nicht verwendet. Die Event-Attribute, die zur Verwendung gespeichert und verworfen werden, sind in der folgenden Tabelle aufgeführt. | Gespeichert zum Anzeigen im Client | Verworfen und nicht beibehalten | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- | | | | | \*Nur wenn die Event-Erfassung mit AI Companion 2.0 aktiviert ist | | #### Werden Kalenderdaten in Client-Protokollen gespeichert? Zoom-Apps geben keine sensiblen Kalenderdaten wie Token, Anmeldedaten oder Ereignisse in Clientprotokollen aus. ### Planen-Tools Zoom bietet eine Vielzahl von Tools, um die Zoom-Meeting-Planen-Erfahrung mit Microsoft- und Google-Produkten zu vereinfachen. Zu diesen Produkten gehören native Planen-Integrationen für Google Arbeitsplatz und Microsoft 365 oder Softwareerweiterungen zur Verwendung mit auswählbaren Browsern und Outlook. #### Wie funktionieren die Planen-Tools? Alle Planen-Tools, außer dem Outlook-Plug-in, senden API-Anfragen direkt sowohl an den Kalenderanbieter als auch an Zooms Web-Kalenderdienst. Das Outlook-Plug-in unterscheidet sich dadurch, dass es ein Meeting über die Zoom-Desktopanwendung plant, die die API-Anfrage im Namen des Plug-ins an den Zoom Web-Kalenderdienst sendet. #### Welche Informationen werden an Zoom gesendet, wenn mit einem Tool geplant wird? Die einzigen Daten, die bei der Verwendung eines Planen-Tools gespeichert werden, sind Informationen, die erforderlich sind, um ein Meeting zu planen. Wenn zum Beispiel ein Benutzer ein Zoom Meeting mit dem Microsoft 365 Hinzufügen-In plant, verwendet das Hinzufügen-In den Betreff des Events, das Datum, die Uhrzeit, die Zeitzone und das Wiederholungskennzeichen, um das Zoom Meeting zu planen. Das Zoom Hinzufügen-In fordert keine zusätzlichen Details wie den Nachrichtentext oder die Teilnehmerliste an und verwendet diese auch nicht. #### Gibt es Firewall- oder Sicherheitsanforderungen? Die Planen-Tools erfordern keine zusätzlichen Änderungen an der Firewall oder der Sicherheit über das hinaus, was bereits für Kalenderintegrationen erforderlich ist. Die vollständige Liste der Anforderungen ist dokumentiert in [Netzwerk- und Firewall-Regeln für Zoom](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### Was ist der Unterschied zwischen dem Outlook-Plug-in und dem Outlook-Hinzufügen-in? Das Outlook-Plug-in ist auf dem Rechner eines Endbenutzers installiert und unterstützt Benutzer beim Planen von Zoom Meetings über ihren Outlook-Client. Das Plug-in kommuniziert über einen Interprozesskommunikations-Kanal (IPC) mit dem Desktop-Client von Zoom Workplace. Mithilfe dieses IPC sendet das Plug-in Zeitpläne über die Ressourcen des Clients an den Web-Planungsdienst von Zoom. Um unseren Nutzern die bestmögliche Erfahrung zu bieten und gleichzeitig die von Apple und Microsoft festgelegten Richtlinien und Vorgaben einzuhalten, empfiehlt Zoom dringend die Bereitstellung und Nutzung des Zoom für Outlook Hinzufügen-Ins. Das Hinzufügen-In bietet Ihnen eine einfachere Bereitstellung und robustere Lösungen für die administrative Verwaltung, wird von Microsoft aktiv unterstützt und erfüllt die kürzlich verschärften Sicherheitsanforderungen von Anbietern wie Apple besser. {% hint style="danger" %} **Warnung** Neue Funktionsverbesserungen werden für das Zoom für Outlook Plugin nicht implementiert. Es wird dringend empfohlen, auf das Zoom für Outlook add-in zu migrieren. {% endhint %} Das Outlook-Add-in ist eine webbasierte Anwendung, die keine lokale Installation auf Benutzer-Maschinen erfordert und stattdessen als integrierte Web-App erscheint, die sowohl im lokalen Client als auch in Outlook im Web verfügbar ist. Das Add-in funktioniert über Web-APIs, die direkt mit Zoom’s Calendaring Web Service kommunizieren. Das Plug-in und das Hinzufügen-In bieten ähnliche Funktionalität, aber das Hinzufügen-In erfordert, dass das Outlook JavaScript API-Anforderungsset v1.8 verfügbar ist — eine Version, die nur in modernen Versionen von Outlook existiert und für Exchange Server On-Premises überhaupt nicht verfügbar ist —. Das bedeutet: * Das Outlook-Hinzufügen-in kann nicht für die Planen von Stellvertretern mit lokalem Exchange Server verwendet werden. * Delegierte müssen den Microsoft 365 Outlook-Client, Outlook 2021 oder neuer für Mac/PC oder Outlook im Web verwenden, um Meetings im Namen eines anderen Benutzers zu planen. #### Wie kann ich die offizielle Zoom Hinzufügen-in Anwendung identifizieren? Die offizielle Zoom für Outlook Anwendung verfügbar von der [Microsoft AppSource Store](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) wird in Ihrem Entra ID Enterprise Apps-Verzeichnis unter dem Namen „Zoom-Office-Hinzufügen-in-SSO“ mit der Anwendungs-ID ce63c970-e2d7-45e6-bee1-80c330b0800b installiert. #### Muss ich das Outlook-Plug-in oder das Plug-in aktualisieren oder Hinzufügen? Ab Januar 2025 hat Microsoft damit begonnen, veraltete Exchange Online-Tokens durch Nested App-Authentifizierung (NAA) zu ersetzen. Zoom-Administratoren sollten in Zusammenarbeit mit Entra-Administratoren NAA im Zoom-Webportal gemäß den Anweisungen im Support-Artikel Konfigurieren. [Konfigurieren der verschachtelten App-Authentifizierung für Office Hinzufügen-Ins](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **Hinweis** Verschachtelte App-Authentifizierung (NAA) wird nur mit Exchange Online unterstützt. Organisationen, die Exchange 2019 (oder andere lokale Versionen von Exchange) verwenden, müssen weiterhin Legacy-Exchange-Benutzeridentitätstoken und Callback-Token verwenden, da diese in lokalen Umgebungen nicht blockiert werden. {% endhint %} Andernfalls ist das Zoom für Outlook-Add-in eine webbasierte Anwendung, die keine lokale Installation auf den Geräten der Benutzer erfordert und stattdessen als integrierte Webanwendung erscheint, die über Web-APIs arbeitet, um mit dem Web Calendaring Service von Zoom zu kommunizieren. Das Add-in ist verfügbar für Windows- und macOS-Outlook-Apps, Android- und iOS-Outlook-Apps sowie Outlook im Web. Das Add-in kann von Outlook-Administratoren konfiguriert und im großen Umfang bereitgestellt oder von einzelnen Benutzern installiert werden. Das Outlook-Plug-in arbeitet als installierte Software, die gelegentlichen Updates und Verbesserungen unterliegt. Folglich erfordert das Plug-in im Laufe der Zeit eine Versionsverwaltung und Upgrades. {% hint style="info" %} **Hinweis** Eine verschachtelte App-Authentifizierung ist für das Outlook-Plug-in nicht erforderlich. {% endhint %} #### Welches Tool zum Planen eignet sich am besten für meine Umgebung? **Google Arbeitsplatz** Organisationen, die Google Arbeitsplatz verwenden, können ganz einfach alle Benutzer dazu Aktivieren, Zoom Meetings über Google Kalender zu planen, indem sie die Zoom for GSuite App aus dem Google Arbeitsplatz Marketplace installieren. Die App wird zentral verwaltet und automatisch aktualisiert, wenn Zoom Verbesserungen an Google übermittelt. Alternativ sind auch die Browser-basierten Erweiterungen Verfügbar, jedoch sind sie im Allgemeinen besser für Nutzer persönlicher Konten geeignet, da sie eine lokale Installation und regelmäßige Aktualisierungen erfordern und nicht zentral verwaltet werden. **Microsoft** Für Organisationen, die Microsoft 365 oder einen lokalen Exchange Server verwenden, hängt die beste Option sowohl von der Umgebung als auch davon ab, wie die Kalenderintegration konfiguriert ist. Das Add-in „Zoom für Outlook“ ist das bevorzugte Tool für Microsoft 365-Umgebungen – egal, ob Sie die Desktop-, Web- oder mobilen Versionen von Outlook verwenden. Das Add-in erfordert Outlook für Microsoft 365, Outlook 2013 oder höher für Windows oder Outlook 2016 oder höher für Mac. Die bidirektionale Kalender Synchronisieren sorgt für nahtlose Kalenderaktualisierungen und ist bei der Integration von Kalendern standardmäßig aktiviert. Dadurch kann Zoom Änderungen an Outlook-Kalenderereignissen automatisch widerspiegeln – etwa verschobene Termine oder Stornierungen – ohne dass Benutzer Meetings manuell über das Hinzufügen-In aktualisieren oder entfernen müssen. Dies ist besonders wichtig, da Zoom-Meeting-Links ablaufen können, wenn Änderungen nicht erfasst werden, insbesondere wenn ein Meeting mehr als 30 Tage über sein ursprüngliches Datum hinaus verschoben wird. Meeting-IDs laufen in der Regel nach 30 Tagen ab, sofern sie nicht Teil einer wiederkehrenden Serie sind. Die moderne JavaScript-API (v1.8), die Event-basierte Automatisierung wie OnAppointmentSend ermöglicht, wird von den folgenden Umgebungen und Anwendungen nicht unterstützt: * Lokale Exchange-Umgebungen * Klassisches Outlook mit M365 verbunden * Mobiles Outlook auf iOS und Android Infolgedessen kann Zoom Besprechungen in diesen Setups nicht automatisch erkennen oder über das Hinzufügen-In aktualisieren. Ohne bidirektionales Synchronisieren oder API-basierte Automatisierung spiegeln selbst wiederkehrende Besprechungen Änderungen möglicherweise nicht wider, was zu abgelaufenen oder ungültigen Zoom-Links führt. Das Zoom Outlook-Plug-in wird nur auf Windows-Systemen unterstützt. Es bietet eine verbesserte Meeting-Synchronisierung durch direkte Integration mit der Zoom Workplace App und umgeht dabei Microsoft API-Einschränkungen. Es wird zwar für Windows-Systeme ohne Bidirektionale Synchronisieren empfohlen, hat jedoch einige bemerkenswerte Einschränkungen: * Erfordert von der IT verwaltete MSI-Updates * Langsamere Meeting-Planen * Kein macOS- oder mobiler Support ### Zoom Rooms Die Kalender-Integration von Zoom Rooms wird unabhängig von der Desktop- oder mobilen Client-Integration des Benutzers durchgeführt. Nach der Einrichtung werden Kalenderereignisse auf Zoom Rooms-Displays angezeigt, einschließlich Fernsehbildschirmen, Planen-Oberflächen und Bedienfeldern. Benutzer können Besprechungen mit einmaligem Antippen auf dem Raum-Controller starten oder beitreten. Die folgenden Schritte sind eine grobe Übersicht über den Einrichtungsprozess: 1. Konfigurieren Sie Microsoft Exchange Online und aktualisieren Sie PowerShell-Skripts für Zoom Rooms-Postfach-Einstellungen 2. Richten Sie Microsoft Graph API-Berechtigungen ein, um den Zugriff auf Kalenderdaten zu Aktivieren Zoom empfiehlt Microsoft Graph API mit Berechtigungen für Anwendungen als die Standard-Integrationsmethode. Diese Empfehlung steht im Einklang mit Microsofts Plan, Exchange Web Services (EWS)-Protokolle zu entfernen. Die Graph API-Methode bietet die stabilste Verbindung zwischen Zoom Rooms und Microsoft 365-Kalendern. {% hint style="info" %} **Hinweis** Organisationen, die Systeme für Konferenzräume von Drittanbietern (wie Cisco, Poly und Lifesize) verwenden, müssen zusätzliche Schritte über den Zoom Enhanced API Connector durchführen, um ordnungsgemäße Kalender- und Meeting-Funktionen sicherzustellen. Weitere Informationen zur Konfiguration des Kalender-Access für Zoom Rooms finden Sie in unserem M365 Calendaring Field Guide Dokument. {% endhint %} #### Welche Methoden kann ich verwenden, um Access zu Raumpostfächern zu gewähren? Die Zoom Rooms Kalender-Integration basiert auf der Microsoft Graph API (MGAPI). Microsoft hat begonnen [die Methoden der Exchange Web Services (EWS) auslaufen lassen](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) die zuvor verfügbar waren, um Microsoft 365-Daten mit Zoom-Diensten zu verbinden. Zoom betrachtet diese EWS-Methoden als Legacy-Optionen. Google Arbeitsplatz hat nur eine einzige Methode zum Anwenden von Berechtigungen. #### Welche Berechtigungen sind für das Dienst-Konto erforderlich? Die spezifische Berechtigung variiert je nach ausgewählter Methode. Jede Option und die erforderlichen Berechtigungen sind in der folgenden Tabelle aufgeführt: | Anbieter | Methode | Erforderliche Berechtigungen | | --------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------- | | Microsoft 365/Microsoft Exchange Server | Anwendungsberechtigungen (Microsoft Graph API) | Administrator-Konto: Unternehmensverwaltung und Empfängerverwaltung | | Microsoft 365/Microsoft Exchange Server | Vollständiger Delegierten-Zugriff (Microsoft Graph API) | Senden als Vollzugriff | | Google Arbeitsplatz | - | Änderungen vornehmen und Freigaben verwalten | {% hint style="info" %} **Zoom-Empfehlung** Zoom empfiehlt, dass Kalenderintegrationen die Methode der Anwendungsberechtigungen verwenden. Diese Konfiguration erfordert weniger Aufwand für den Administrator und benötigt kein dediziertes Servicekonto. Sie ist auch der von Microsoft empfohlene Ansatz für Enterprise-Anwendungen, die als Hintergrunddienste ausgeführt werden. {% endhint %} ### Erweiterter API-Connector Die Kalender-Integration für standardbasierte H.323- und SIP-Raumsysteme über den Enhanced API Connector (im frühen Jahr 2021 veröffentlicht) erfolgt unabhängig von Benutzer-Client- und Zoom Rooms-Konfiguration. Die Dienstkontomethodik und die Berechtigungen sind identisch mit dem zuvor behandelten Zoom Rooms-Abschnitt. #### Was ist an dem Datenfluss des Enhanced API Connector anders? Raumsysteme, die über den Enhanced API Connector verbunden sind, kontaktieren Kalenderanbieter nicht direkt, was sich von den Verbindungsabläufen der Zoom-Anwendung und von Zoom Rooms unterscheidet. Der Zoom Web Service fungiert als Client für diese Systeme und überträgt Kalenderdaten direkt an die Endpunkte, mit einer Ausnahme für Poly-Geräte. Poly-Geräte fragen zuerst den Zoom Web Service nach Kalenderaktualisierungen ab, der dann Kalenderdaten an das Gerät überträgt. #### Wie viele Tage von Kalenderereignissen werden abgerufen? Der Enhanced API Connector ruft bevorstehendes Meeting-Daten für die nächsten 30 Tage ab und entfernt abgeschlossene Meetings nach 30 Tagen aus dem Speicher. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://library.zoom.com/technical-library/de/administratorbereich/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.