Übersicht über die Outlook-Kalender-APIOutlook calendar API overview

Der Outlook-Kalender ist Teil des Messaging-Hubs von Outlook in Office 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.Outlook calendar is part of the Outlook messaging hub in Office 365 that also lets you manage emails and contacts, find information about users in an organization, initiate online conversations, share files, and collaborate in groups.

Vorteile der Integration mit dem Outlook-KalenderWhy integrate with Outlook calendar?

Die umfangreichen Funktionen von Outlook-Kalender und der zugehörigen API eröffnen viele App-Verkaufschancen.The rich features of Outlook calendar and its API open up many app opportunities. In den folgenden Abschnitten sind einige davon aufgeführt.The following sections list a few of them.

Erreichen Sie mehreren hundert Millionen Kunden, und erstellen Sie umfassende Szenarien.Reach hundreds of millions of customers and build rich scenarios

Viele Millionen von Kunden verwenden den Outlook-Kalender als Teil eines integrierten Hubs, mit dem sie effektiv kommunizieren und produktiv arbeiten können.Many millions of customers use Outlook calendar as part of an integrated hub that lets them effectively communicate and get things done. 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.They can set up meetings, manage emails, find information about contacts and other users, and initiate conversations or online meetings all in one place, be it on the web, mobile, or desktop. 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.Microsoft Graph not only connects apps to the calendar, mail, and contacts data of these customers, it enables apps to integrate with the best of Microsoft 365 and support a wide range of scenarios that enhance productivity and collaboration.

Die meisten Features in der Outlook-Kalender-API gelten für Kalender in privaten Microsoft-Konten und Geschäfts-, Schul- oder Unikonten.Most features in the Outlook calendar API apply to calendars in personal Microsoft accounts and work or school accounts.

** Kennzeichnet unten Features, die speziell für Outlook-Kalender nur in Geschäfts-, Schul- oder Unikonten gelten.** Denotes features specifically applicable to Outlook calendars in work or school accounts.

Automatisieren der Terminorganisation und KalendereinträgeAutomate appointment organization and calendaring

Kunden schätzen die Möglichkeiten in Outlook zum Organisieren ihrer Zeit für Arbeit, Familie und eigene Aktivitäten.Customers like how Outlook lets them organize their time for work, family, and personal activities. 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:Microsoft Graph REST API keeps close parity with the customer experience, letting apps create, manage, and respond to events just as naturally:

  • In Outlook können Kunden einzelnen Kalender für Arbeit, Familie und andere Zwecke erstellen und diese dann als Kalendergruppen organisieren.In Outlook, customers can create individual calendars for work, family, and other purposes, and organize them in calendar groups. Sie können die kostenlosen Geburtstags- und Feiertagskalender aktivieren, damit sie an die Geburtstage ihrer Kontakte und Feiertage erinnert werden.They can turn on the free Birthdays and Holiday calendar to remind them of contacts' birthdays and local holidays. Sie können Kalender hinzufügen, die ihren Interessen entsprechen, z. B. Kalender für Sportmannschaften und TV-Programme.They can add calendars that match their interests, such as calendars for sport teams and TV programs. Kunden können Kalender auswählen und sie überlagern, sodass ihre Termine in derselben Ansicht angezeigt werden.Customers can select and overlay calendars, and see their events in the same view. Mit der Kalender-API kann Ihre App Kalender auf ähnliche Weise in Kalendergruppen organisieren und ebenfalls mit anderen Kalendern von Interesse interagieren, genau wie jeder andere Kalender im Postfach des Benutzers.Through the calendar API, your app can similarly organize calendars in calendar groups, and interact with interesting calendars just like any other calendar in the user's mailbox.

  • Kunden mit Outlook können Kategorien einheitlich auf Ereignisse, Nachrichten, Kontakte, Aufgaben und Gruppenbeiträge anwenden, um die Organisation und Ermittlung zu verbessern.Outlook customers can apply categories to events, messages, contacts, tasks, and group posts in a consistent way to enhance organization and disovery. 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.The calendar API lets you access and define a user's master list of categories, which opens up additional creative scenarios. 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.For example, an athletic club can organize a sports tournament and offer an app that differentiates emails and events for each sport with their own color category. 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.For last-minute news such as unforeseen timetable changes, the app can also set the importance property of those events and emails to alert customers.

  • Im Kalenderordner haben Sie die Möglichkeit zum Erstellen und Aktualisieren von Einzelinstanz-Events, oder Sie können wiederkehrende Events planen und pflegen.In a calendar folder, you can create and update single instance events, or schedule and maintain recurring events. Sie haben die Möglichkeit, dass Kunden auf Besprechungsanfragen antworten sowie zum erneuten Erinnern oder Schließen von Erinnerungen mit der zugehörigen Ereignis-Navigationseigenschaft.You can let your customers respond to meeting requests, and snooze or dismiss reminders using the associated event navigation property.

Helfen Sie Ihren Kunden, auf dem neuesten Stand zu bleiben und ihren Tag im Blick habenHelp customers stay synchronized and navigate their day

Die Kalender-API unterstützt Ihre Kunden dabei, ihren Tag im Blick zu behalten und ihre Produktivität zu steigern:The calendar API helps customers navigate their day and enhance productivity:

  • Sie können den lokalen App-Speicher synchronisieren, indem Sie Änderungsbenachrichtigungen abonnieren und Ereignisänderungen im Kalender eines Benutzers nachverfolgen.You can keep the app local store synchronized by subscribing to change notifications and tracking changes to events in a user's calendar.
  • Sie können die Agenda des Benutzers basierend auf einer einfachen Erinnerungsansicht anzeigen.You can display the user's agenda based on a light-weight reminder view.
  • 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.You can let the user conveniently accept and take a meeting online through its webLink property, which opens the meeting in Outlook on the web.
  • Benutzer können einer Besprechung von unterwegs auch mit Vorbehalt zusagen oder sie ablehnen.Users can also tentatively accept or decline a meeting while on the go.

Verbessern der ZusammenarbeitEnhance collaboration

  • In Outlook können Kunden Kalender für andere freigeben und ihnen die Berechtigung zum Lesen, Schreiben oder Löschen von Kalenderinhalten gewähren.In Outlook, customers can share calendars with one another and give permissions to read, write, or delete calendar contents. Alternativ können sie einen Kalender auch an eine andere Person delegieren, damit diese in ihrem Namen auf Besprechungsanfragen antworten kann.Or, they can delegate a calendar to let another customer respond to meeting requests on their behalf. 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.Programmatically, while you cannot initiate a share or delegate action on behalf of a user, you can use a set of properties to verify the sharing status and enable scenarios around shared or delegated calendars: canEdit, canShare, canViewPrivateItems, isShared, and 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.The calendar API lets you get calendar items of the signed-in user, or users who have shared or delegated their calendars to the signed-in user. 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.For example, if Garth has shared a calendar with John, or if Garth has delegated access to John, then delegated permissions from John would give you read access to Garth's shared calendar and contents as well.
  • Office 365-Gruppen erleichtert den Gruppenmitgliedern die Zusammenarbeit und den Zugriff auf Gruppenunterhaltung und Kalender direkt in Outlook.** Office 365 groups make it convenient for group members to collaborate and access group conversations and calendars right 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.Aside from a few minor differences between group calendars and user calendars, the calendar API lets you interact with group calendars just like user calendars. Weitere Informationen finden Sie in der Kalenderressource.**See the calendar resource for more information.

Intelligente PlanungSchedule smart

Outlook und die Kalender-API bieten zahlreiche intelligente Funktionen zum Planen von Ereignissen:Outlook and the calendar API offer many smart conveniences to schedule events:

  • 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.Through Outlook calendar app settings, customers can enable automatic adding of events from emails, such as flight, hotel, or dining reservations, and billing invoices. 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.Once added, you can interact with these events just like any other event objects in the user's mailbox, and build creative scenarios upon this Outlook capability.
  • In Outlook ist das Buchen eines Besprechungsraums so einfach wie das Hinzufügen eines Teilnehmers zum Ereignis.** In Outlook, booking a meeting room is as straight-forward as adding an attendee to the event. Die Kalender-API stellt einen Besprechungsraum als ein emailAddress-Objekt dar.The calendar API represents a meeting room as an emailAddress object. Sie können Räume erhalten (Vorschau) und Raumlisten erhalten (Vorschau), die in einem Mandanten verfügbar sind.You can get rooms (preview) and get room lists (preview) that are available in a tenant. Um eine Besprechung in einem bestimmten Raum zu organisieren, weisen Sie sie der location-Eigenschaft des Ereignisses zu.**To organize a meeting in a specific room, assign it to the location property of the event.
  • Sie können die Frei/Gebucht-Informationen für Benutzer und Ressourcen für einen bestimmten Zeitraum suchen.** You can look up the free/busy information for users and resources for a specific time period. Sie können diese Daten dann auf unterschiedliche Szenarien anwenden, einschließlich der Ressourcenplanung und der Ereignisplanung.**You can then use this data to apply to different scenarios including resource planning and event scheduling.
  • 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.** If your scenario involves scheduling meetings at an optimal time, you can consider using findMeetingTimes to identify possible times or locations to meet. Die Funktion findMeetingTimes berücksichtigt den Frei-/Gebucht-Status der Teilnehmer sowie die bevorzugten Räume, Zeiten und anderen angegebenen Einschränkungen.The findMeetingTimes function considers the free/busy status of the attendees, and any preferred rooms, time, and other constraints you provide. 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.**If the first try doesn't return a common meeting time, check the reason, adjust your criteria and call findMeetingTimes again.

Telefonkonferenz an mehreren Standorten und in verschiedenen ZeitzonenTeleconference across multiple locations and time zones

Durch die Globalisierung nehmen an geschäftlichen Besprechungen heutzutage auch häufig Teilnehmer an verschiedenen Orten und in unterschiedlichen Zeitzonen teil.With globalization, today's business meetings often involve attendees participating from different locations and time zones. Nachfolgend erfahren Sie, wie Sie Besprechungen dieser Art mit der Kalender-API verwalten können:Here's how you can use the calendar API to manage such meetings:

  • 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.As an example in Outlook, customers can organize a meeting and include attendees joining from a conference room in Seattle, a coffee shop in Paris, and a home office in China. 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.Programmatically, the event locations property, which is a collection of location objects, can reflect this level of details in displayName and locationType for each location. Sehen Sie sich das Beispiel an.See an example.
  • Outlook bietet Kunden die Flexibilität, Ereignisse zu organisieren und eine Zeitzone für die Start- und Endzeiten des Ereignisses anzugeben.Outlook gives customers the flexibility to organize events and specify a time zone for each of the start and end times of an event. 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.To support this flexibility, by default, the calendar API returns the start and end times of an event in UTC, and provides the originalStartTimeZone and originalEndTimeZone properties to note the time zones used when the event was created.
  • 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.Alternatively, you can specify the Prefer: outlook.timezone="{time zone name}" header so that a GET event operation returns start and end in the time zone you specify. Der Name der Zeitzone kann einer der von Windows unterstützten Namen sein, sowie einer der in dieser Liste aufgeführten Namen.The time zone name can be any of those supported by Windows, as well as those on this list. Sehen Sie sich ein Beispiel für die Verwendung des Prefer-Headers an.See an example of the Prefer header in use.

Erstellen von Apps mit Positionsinformationen und Bereitstellen von intelligentem Kontext (Vorschau)Build apps with location awareness and provide intelligent context (preview)

Mithilfe der Orte-API (Vorschau) können Sie Benutzern helfen, zu einem Ort zu navigieren, oder eine intelligente Lösung basierend auf dem Standort des Benutzers bereitstellen.Use the places API (preview) to help users navigate to a place, or provide an intelligent solution based on the user's location. Es folgen einige Beispielszenarien:The following are some sample scenarios:

  • Integrieren von Positionsdetails in Kalenderereignisse, um den Benutzern zu erleichtern, ihren Tag im Blick zu behalten und die Produktivität zu steigern.**Incorporate place details in calendar events to help users navigate their day and enhance productivity.**
  • Catering-Anwendungen können mithilfe der Orte-API bei Navigation und Einrichtung am Veranstaltungsort helfen.**Catering applications can use the places API to assist venue navigation and set up.**
  • Automatisieren des E-Mail-Versands von Vorabinformationen zu Besprechungen an die Teilnehmer und Hinzufügen einer Karte mit der Wegbeschreibung zum Raum.**Automate emailing pre-meeting details to attendees and include a map on how to get to a room.**
  • Einrichten von Bot-Assistenten für den Empfang, um Informationen zu bestimmten Räumen in einem Gebäude bereitzustellen.**Set up reception bot assistants to provide information about specific rooms in a building.**

Abhängig von Ihrem App-Szenario können Sie die Orte-API im Kontext von Outlook oder unabhängig von Outlook verwenden.Depending on your app scenario, you can use the places API within the context of Outlook, or independent of Outlook.

Nutzen der Vorteile von Informationen aus sozialen Netzwerken und andere Vorteile für Entwickler in Microsoft GraphTake advantage of social intelligence and other developer conveniences in Microsoft Graph

Mit der Personen-API in Microsoft Graph können Sie eine Verbindung zu Personendaten herstellen, die auf den Kommunikations- und Zusammenarbeitsmustern eines Benutzer und den Geschäftsbeziehungen basieren.Use the people API in Microsoft Graph to connect to people data which is based on a user's communication and collaboration patterns, and business relationships. Sie können z. B. Steuerelemente wie eine Personenauswahl implementieren und Personen vorschlagen, die für den Benutzer relevant sind, wenn Sie Besprechungen im Namen des Benutzers organisieren.You can implement controls such as a people picker, and suggest persons relevant to the user when organizing meetings on the user's behalf.

Verringern Sie den Aufwand, indem Sie die App-Daten in externen Datenspeichern speichern und verwalten.Save overhead in storing and managing app data in external data stores. Mit Microsoft Graph können Sie benutzerdefinierte App-Daten als offene Erweiterungen in einer einzelnen Ressourceninstanz speichern.With Microsoft Graph, you can store custom app data as open extensions in individual resource instances. Wenn die Daten eingegeben werden müssen oder das typisierte Schema freigegeben werden soll, können Sie benutzerdefinierte App-Daten in Schemaerweiterungen speichern.If you require the data to be typed, or would like to be able to share the typed schema, you can store custom app data in schema extensions.

API-ReferenzAPI reference

Suchen Sie die API-Referenz für diesen Dienst?Looking for the API reference for this service?

Nächste SchritteNext steps