Was sich ändert
Zusätzlich zum Lesen und Schreiben von Arbeitsortdaten erweitern wir die Funktionalität der Kalender-API um Abwesenheits- und Fokuszeitdaten. Entwickler können die API nutzen, um diese Informationen zu lesen und zu schreiben und die Verfügbarkeit der Nutzer mit externen Systemen zu synchronisieren. Sie können die API beispielsweise in Verbindung mit HR-Systemen verwenden, um automatisch OOO-Einträge zum Kalender eines Benutzers hinzuzufügen, wenn dieser seine Urlaubszeit einreicht. Oder die API kann verwendet werden, um im Kalender eines Benutzers automatisch Fokuszeit zu blockieren, um Schulungskurse zu absolvieren.
Das Lesen und Schreiben außerhalb des Büros und der Fokuszeit ist in einer Vielzahl von Situationen hilfreich, z. B.: Erstellen und Aktualisieren von OOO- und Fokuszeitereignissen (
Ereignisse.Einfügen,
Ereignisse.Update,
Ereignisse.Patch). Festlegung von OOO- und Focus-Time-spezifischen Funktionen, wie z. B. das automatische Ablehnen von Besprechungen und das Einstellen des Nicht-Stören-Status. Auswahl einer beliebigen Kombination von Ereignistypen zum Lesen aus einem Kalender (
Ereignisse.Liste).
Außerdem müssen die Benutzer durch das Lesen und Schreiben dieser Informationen nicht mehr dieselben Informationen in mehrere Systeme eingeben, was dazu beiträgt, den manuellen Aufwand zu verringern.
Wer ist davon betroffen?
Entwickler
Warum Sie es verwenden sollten
Die Unterstützung von Veranstaltungen außerhalb des Büros und von Fokuszeiten verbindet die Unterstützung des Arbeitsortes, die
Anfang des Jahres angekündigtum die API-Funktionalität für Kalenderereignisse zu vervollständigen. Jeder spezifische Ereignistyp kann im gesamten IT-Ökosystem Ihres Unternehmens synchronisiert werden, um nahtlose Benutzerabläufe zu schaffen und Benutzer mit Ressourcen und untereinander zu verbinden. Dazu gehören Dinge wie:
Zuordnung von Arbeitsortdaten zur besseren Anpassung der Ressourcen vor Ort und zur Aktualisierung anderer Oberflächen von Drittanbietern, wie z. B. Hot-Desk-Buchungstools. Automatische Sperrung von OOO auf der Grundlage von Urlaubs- oder PTO-Anträgen, Sperrung von Fokuszeit-Ereignissen, um Nutzern Zeit zu geben, an Onboarding- oder anderen Schulungsprogrammen des Unternehmens teilzunehmen.
Zusätzliche Details
Wenn Sie vor dieser Aktualisierung den Kalender eines Benutzers über API v3 auslesen wollten, wurden Abwesenheits- und Fokuszeit-Ereignisse mit unknownorganizer@calendar.google.com im Organisatorfeld und ohne ihre spezifischen Eigenschaften zurückgegeben. Mit diesem Update werden diese Ereignisse mit all ihren Eigenschaften und dem spezifischen Benutzer als Organisator zurückgegeben. Bitte überprüfen Sie Ihren Code, um sicherzustellen, dass er keine impliziten Annahmen über die früheren API-Rückgabewerte macht, und verwenden Sie die
eventType Parameter zur Durchführung verschiedener Operationen mit regulären, OOO-, Fokuszeit- oder Arbeitsort-Ereignissen
Erste Schritte
Tempo der Einführung
Bereiche für schnelle Freigabe und planmäßige FreigabeErweiterte Einführung (möglicherweise länger als 15 Tage für die Sichtbarkeit der Funktionen) ab 16. November 2023
Verfügbarkeit
Die Kalender-API ist für alle verfügbar.
Abwesenheitsereignisse sind für Google Workspace Essentials, Enterprise Essentials, Frontline, Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Starter, Business Standard, Business Plus, Education Fundamentals, Education Standard und Education Plus Kunden verfügbar.
Focus Time-Veranstaltungen sind für Kunden von Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard und Education Plus verfügbar.
Ressourcen
