Übersicht über die Persönliche Kontakte-API

  • Artikel

Über Outlook-Kontakte können Sie die Daten von persönlichen Kontakten speichern; sie sind Teil des Outlook-Messaging-Hubs in Microsoft 365. Über Outlook können Sie E-Mails verwalten, Besprechungen planen, Informationen zu Benutzern in einer Organisation suchen, Onlineunterhaltungen initiieren, Dateien freigeben und in Gruppen zusammenarbeiten.

Warum persönliche Kontakte in Outlook integrieren?

Ergänzung von Messaging- und Kalenderszenarien für hunderte Millionen von Kunden

Hunderte Millionen Kunden und mehrere zehn Millionen Organisationskunden nutzen Outlook als E-Mail-Client. Kontakte bieten eine ergänzende Funktion für Messaging- und Kalenderfunktionen, indem Kunden eine praktischen, integrierten Speicher von Kontaktdaten innerhalb von Outlook pflegen können. Die Nutzung der vielfältigen Funktionen von E-Mails oder des Kalenders bedeutet für Entwickler umfassendere Szenarien mit den Kontaktdaten von Benutzern.

Automatisieren der Kontaktorganisation

Mit der Kontakte-API können Sie Ihre Kunden organisieren, und zwar in sehr ähnlicher Weise wie die Kunden dies selbst über Outlook tun:

  • Ähnlich wie bei der Kundenoberfläche können Sie contact-Instanzen erstellen und diese contactFolder-Objekten zuordnen.
  • Mit der Kontakte-API können Sie Kategorien, Kontakte, Ereignisse, Nachrichten, Aufgaben und Gruppenbeiträge konsistent zuweisen, um die Organisation und Ermittlung zu verbessern. Darüber hinaus können Sie eine Masterliste von Kategorien eines Benutzers definieren, was weitere Szenarien eröffnen kann.
  • Sie können für einen Kontakt eine Kennzeichnung zur Nachverfolgung festlegen. (Das Kennzeichnen befindet sich in Microsoft Graph derzeit in der Vorschau.)

Freigeben von Kontaktinformationen

Mit der Kontakte-API können Sie Kontaktelemente des angemeldeten Benutzers oder von Benutzern, die ihre Kontakte für den angemeldeten Benutzer freigegeben oder an ihn delegiert haben, abrufen. Wenn Garth beispielsweise einen Kontaktordner 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.

Nutzen der Personen-API in Microsoft Graph zur besseren Ausnutzung aller Personendaten

Sie können die normalen CRUD-Vorgänge für einen Outlook-Kontakt zum Erstellen und Verwalten von Kontakten verwenden. Im Rahmen von Microsoft Graph können Sie auch die Personen-API verwenden, die sich die Outlook-Kontakte eines Benutzers sowie die sozialen Netzwerke, das Unternehmensverzeichnis und Personen aus kürzlichen Kommunikationen ansieht und Informationen zu Personen aus all diesen Quellen zurückgibt, die für den Benutzer am wichtigsten sind. Nutzen Sie diese zusätzliche Intelligenz in Personenauswahlszenarien.

Nutzen der Vorteile anderer freigegebener Features und Vorteile von Microsoft Graph

  • Die Kontaktentität unterstützt ein Kontaktfoto, das als die gleiche profilePhoto-Entität wie ein Benutzerfoto implementiert wird, das in Exchange Online oder Microsoft Entra ID gespeichert ist. Dadurch wird der Aufwand des Konvertierens von Kontakten und Benutzerprofilfotos reduziert.
  • Sie können den lokalen App-Speicher synchronisieren, indem Sie Änderungsbenachrichtigungen und Nachverfolgungsänderungen an Kontakten und Kontaktordnern abonnieren.
  • Sie können den App-Speicher in einer Kontaktinstanz als offene Erweiterung erweitern oder stark typisierte benutzerdefinierte Daten als Schemaerweiterung hinzufügen.

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?

Nächste Schritte