Übersicht über die Outlook-Kalender-API

  • Artikel

Der Outlook-Kalender ist Teil des Messaging-Hubs von Outlook in Microsoft 365, mit dem Sie ebenfalls Ihre E-Mails und Kontakte verwalten, Informationen zu Benutzern in Ihrem Unternehmen suchen, Onlineunterhaltungen initiieren, Dateien teilen und in Gruppen zusammenarbeiten können.

Vorteile der Integration mit dem Outlook-Kalender

Die umfangreichen Funktionen von Outlook-Kalender und der zugehörigen API eröffnen viele App-Verkaufschancen. In den folgenden Abschnitten sind einige davon aufgeführt.

Erreichen Sie mehreren hundert Millionen Kunden, und erstellen Sie umfassende Szenarien.

Viele Millionen von Kunden verwenden den Outlook-Kalender als Teil eines integrierten Hubs, mit dem sie effektiv kommunizieren und produktiv arbeiten können. Sie können Besprechungen planen, E-Mails verwalten, Informationen zu Kontakten und anderen Benutzern suchen sowie Unterhalten oder Online-Meetings initiieren, und das alles an einem Ort, entweder im Internet, auf Mobilgeräten oder vom Desktop aus. Microsoft Graph verknüpft Apps nicht nur mit den Kalender-, Mail und Kontaktdaten dieser Kunden, sondern ermöglicht Apps auch die Integration mit den besten Funktionen von Microsoft 365 und unterstützt eine breite Palette von Szenarien, mit denen sich die Produktivität steigern und die Zusammenarbeit verbessern lassen.

Die meisten Features in der Outlook-Kalender-API gelten für Kalender in privaten Microsoft-Konten und Geschäfts-, Schul- oder Unikonten.

** Kennzeichnet unten Features, die speziell für Outlook-Kalender nur in Geschäfts-, Schul- oder Unikonten gelten.

Automatisieren der Terminorganisation und Kalendereinträge

Kunden schätzen die Möglichkeiten in Outlook zum Organisieren ihrer Zeit für Arbeit, Familie und eigene Aktivitäten. Die Microsoft Graph-REST-API hält sich eng an die Benutzererfahrung und ermöglicht es, dass Apps genauso einfach Ereignisse erstellen, verwalten und darauf reagieren können:

  • In Outlook können Kunden einzelnen Kalender für Arbeit, Familie und andere Zwecke erstellen und diese dann als Kalendergruppen organisieren. Sie können die kostenlosen Geburtstags- und Feiertagskalender aktivieren, damit sie an die Geburtstage ihrer Kontakte und Feiertage erinnert werden. Sie können Kalender hinzufügen, die ihren Interessen entsprechen, z. B. Kalender für Sportmannschaften und TV-Programme. Kunden können Kalender auswählen und sie überlagern, sodass ihre Termine in derselben Ansicht angezeigt werden. Über die Kalender-API kann Ihre App Kalender auf ähnliche Weise in Kalendergruppen organisieren und mit interessanten Kalendern interagieren, genau wie jeder andere Kalender im Postfach des Benutzers.

  • Kunden mit Outlook können Kategorien einheitlich auf Ereignisse, Nachrichten, Kontakte, Aufgaben und Gruppenbeiträge anwenden, um die Organisation und Ermittlung zu verbessern. Mit der Kalender-API können Sie außerdem auf die Masterliste von Kategorien eines Benutzers zugreifen und diese definieren, sodass Sie weiteren kreative Szenarien erstellen können. So kann zum Beispiel ein Sportverein einen Wettkampf organisieren und eine App anbieten, in der E-Mail und Events für die einzelnen Sportarten jeweils unterschiedlich farblich markiert werden. Wenn kurzfristige Änderungen auftreten, sich z. B. die Wettkampfzeiten unvorhergesehen ändern, kann die App auch die Wichtig-Eigenschaft dieser Events und E-Mails festlegen, um Kunden darüber zu benachrichtigen.

  • Im Kalenderordner haben Sie die Möglichkeit zum Erstellen und Aktualisieren von Einzelinstanz-Events, oder Sie können wiederkehrende Events planen und pflegen. Sie können Es Ihren Kunden ermöglichen, auf Besprechungsanfragen zu reagieren und Erinnerungen mithilfe der zugehörigen Ereignisnavigationseigenschaftwiederzuentlassen oder zu verwerfen.

Helfen Sie Ihren Kunden, auf dem neuesten Stand zu bleiben und ihren Tag im Blick haben

Die Kalender-API unterstützt Ihre Kunden dabei, ihren Tag im Blick zu behalten und ihre Produktivität zu steigern:

  • Sie können den lokalen App-Speicher synchronisieren, indem Sie Änderungsbenachrichtigungen abonnieren und Ereignisänderungen im Kalender eines Benutzers nachverfolgen.
  • Sie können die Agenda des Benutzers basierend auf einer einfachen Erinnerungsansicht anzeigen.
  • Sie können ermöglichen, dass der Benutzer einer Besprechung bequem online zusagt und über die webLink-Eigenschaft, mit der die Besprechnung in Outlook im Web geöffnet wird, online daran teilnimmt.
  • Benutzer können einer Besprechung von unterwegs auch mit Vorbehalt zusagen oder sie ablehnen.

Verbessern der Zusammenarbeit

  • In Outlook können Kunden Kalender für andere freigeben und ihnen die Berechtigung zum Lesen, Schreiben oder Löschen von Kalenderinhalten gewähren. Alternativ können sie einen Kalender auch an eine andere Person delegieren, damit diese in ihrem Namen auf Besprechungsanfragen antworten kann. Obwohl Sie die Freigabe oder Delegierung einer Aktion im Namen eines anderen Benutzers nicht programmgesteuert initiieren können, können Sie einen Eigenschaftensatz verwenden, um den Freigabestatus zu prüfen und Szenarien zu freigegebenen oder delegierten Kalendern zu aktivieren: CanEdit, CanShare, CanViewPrivateItems, IsShared und IsSharedWithMe.
  • Mit der Kalender-API können Sie Kalenderelemente des angemeldeten Benutzers oder von Benutzern, die ihre Kalender für den angemeldeten Benutzer freigegeben oder an ihn delegiert haben, abrufen. Wenn Garth beispielsweise einen Kalenderordner für John freigegeben hat oder wenn Garth John Zugriff erteilt hat, so würden Sie über delegierte Berechtigungen von John Lesezugriff auf den freigegebenen Kalender und auch auf die Inhalte erhalten.
  • Microsoft 365-Gruppen erleichtert den Gruppenmitgliedern die Zusammenarbeit und den Zugriff auf Gruppenunterhaltungen und Kalender direkt in Outlook. Abgesehen von einigen kleineren Unterschieden zwischen Gruppenkalendern und Benutzerkalendern, ermöglicht die Kalender-API Ihnen die Interaktion mit Gruppenkalendern auf die gleiche Weise wie mit Benutzerkalendern. Weitere Informationen finden Sie in der Kalenderressource.**

Intelligente Planung

Outlook und die Kalender-API bieten zahlreiche intelligente Funktionen zum Planen von Ereignissen:

  • Mit den App-Einstellungen für Outlook-Kalender können Kunden das automatische Hinzufügen von Ereignissen aus E-Mails aktivieren, wie z. B. Flug-, Hotel- oder Restaurantreservierungen und Rechnungen. Nachdem sie hinzugefügt wurden, können Sie diese Ereignisse genau wie jedes andere Ereignis-Objekte im Postfach des Benutzers verwenden und kreative Szenarien für diese Outlook-Funktion erstellen.
  • In Outlook ist das Buchen eines Besprechungsraums so einfach wie das Hinzufügen eines Teilnehmers zum Ereignis. Die Kalender-API stellt einen Besprechungsraum als ein emailAddress-Objekt dar. Sie können Räume abrufen und Raumlisten abrufen, die in einem Mandanten zur Verfügung stehen. Um eine Besprechung in einem bestimmten Raum zu organisieren, weisen Sie sie der location-Eigenschaft des Ereignisses zu.**
  • Sie können die Frei/Gebucht-Informationen für Benutzer und Ressourcen für einen bestimmten Zeitraum suchen. Sie können diese Daten dann auf unterschiedliche Szenarien anwenden, einschließlich der Ressourcenplanung und der Ereignisplanung.**
  • Wenn dieses Szenario das Planen von Besprechungen zu einem optimalen Zeitpunkt umfasst, sollten Sie findMeetingTimes verwenden, um mögliche Zeiten und Orte für Besprechungen zu identifizieren. Die Funktion findMeetingTimes berücksichtigt den Frei-/Gebucht-Status der Teilnehmer sowie die bevorzugten Räume, Zeiten und anderen angegebenen Einschränkungen. Wenn beim ersten Versuch keine gemeinsame Besprechungszeit zurückgegeben wird, überprüfen Sie den Grund, passen Sie Ihre Kriterien an, und rufen Sie FindMeetingTimes erneut auf.**

Telefonkonferenz an mehreren Standorten und in verschiedenen Zeitzonen

Durch die Globalisierung nehmen an geschäftlichen Besprechungen heutzutage auch häufig Teilnehmer an verschiedenen Orten und in unterschiedlichen Zeitzonen teil. Nachfolgend erfahren Sie, wie Sie Besprechungen dieser Art mit der Kalender-API verwalten können:

  • Kunden können beispielsweise in Outlook eine Besprechung organisieren und Teilnehmer aus einem Konferenzraum in Seattle, in einem Café in Paris und im Heimbüro in China einbeziehen. Die locations-Eigenschaft des Ereignisses, die eine Sammlung von location-Objekten ist, kann programmgesteuert diese Detailebene in displayName und locationType für das jeweilige location-Objekt widergeben. Sehen Sie sich das Beispiel an.
  • Outlook bietet Kunden die Flexibilität, Ereignisse zu organisieren und eine Zeitzone für die Start- und Endzeiten des Ereignisses anzugeben. Um diese Flexibilität zu unterstützen, gibt die Kalender-API standardmäßig die Start- und End-Zeiten eines Ereignisses in UTC an und stellt die Eigenschaften originalStartTimeZone und originalEndTimeZone bereit, um so die beim Erstellen des Ereignisses verwendeten Zeitzonen anzugeben.
  • Alternativ können Sie den Prefer: outlook.timezone="{time zone name}"-Header angeben, damit ein GET-Ereignisvorgang Start und Ende in der angegebenen Zeitzone zurückgibt. Der Name der Zeitzone kann einer der von Windows unterstützten Namen sein, sowie einer der in dieser Liste aufgeführten Namen. Sehen Sie sich ein Beispiel für die Verwendung des Prefer-Headers an.
  • Organisationen, die Onlinebesprechungsanbieter wie Microsoft Teams und Skype unterstützen, können Outlook-Kalender so einrichten, dass diese Anbieter verwendet werden. Sie können Ereignisse in diesen Kalendern bequem als Onlinebesprechungen organisieren oder daran teilnehmen.

Erstellen von Apps mit Positionsinformationen und Bereitstellen von intelligentem Kontext

Mithilfe der Orte-API können Sie Benutzern helfen, zu einem Ort zu navigieren, oder eine intelligente Lösung basierend auf dem Standort des Benutzers bereitstellen. Es folgen einige Beispielszenarien:

  • Integrieren von Positionsdetails in Kalenderereignisse, um den Benutzern zu erleichtern, ihren Tag im Blick zu behalten und die Produktivität zu steigern.**
  • Catering-Anwendungen können mithilfe der Orte-API bei Navigation und Einrichtung am Veranstaltungsort helfen.**
  • Automatisieren des E-Mail-Versands von Vorabinformationen zu Besprechungen an die Teilnehmer und Hinzufügen einer Karte mit der Wegbeschreibung zum Raum.**
  • Einrichten von Bot-Assistenten für den Empfang, um Informationen zu bestimmten Räumen in einem Gebäude bereitzustellen.**

Abhängig von Ihrem App-Szenario können Sie die Orte-API im Kontext von Outlook oder unabhängig von Outlook verwenden.

Nutzen der Vorteile von Informationen aus sozialen Netzwerken und andere Vorteile für Entwickler in Microsoft Graph

Verwenden Sie die People-API in Microsoft Graph, um eine Verbindung mit Personendaten herzustellen, die auf den Kommunikations- und Zusammenarbeitsmustern und Geschäftsbeziehungen eines Benutzers basieren. Sie können Steuerelemente wie eine Personenauswahl implementieren und Personen vorschlagen, die für den Benutzer relevant sind, wenn Sie Besprechungen im Namen des Benutzers organisieren.

Verringern Sie den Aufwand, indem Sie die App-Daten in externen Datenspeichern speichern und verwalten. Mit Microsoft Graph können Sie benutzerdefinierte App-Daten als offene Erweiterungen in einer einzelnen Ressourceninstanz speichern. Wenn die Daten typisiert werden müssen oder Sie das typisierte Schema weitergeben möchten, können Sie benutzerdefinierte Anwendungsdaten in Schemaerweiterungen speichern.

Wo befinden sich die Daten?

Die Microsoft Graph-API unterstützt den Zugriff auf Daten in primären und freigegebenen Postfächern der Benutzer. Die Daten können Kalender, E-Mails oder persönliche Kontakte sein, die in einem Postfach in der Cloud auf Exchange Online als Teil von Microsoft 365 gespeichert sind.

Die API unterstützt nicht den Zugriff auf In-Situ-Archivpostfächer, die sich weder in Exchange Online noch auf Exchange Server befinden.

API-Referenz

Suchen Sie die API-Referenz für diesen Dienst?

Verwandte Inhalte