Übersicht über die Persönliche Kontakte-APIOutlook personal contacts API overview

Über Outlook-Kontakte können Sie die Daten von persönlichen Kontakten speichern; sie sind Teil des Outlook-Messaging-Hubs in Office 365.Outlook contacts lets you store personal contacts' data, and is part of the Outlook messaging hub in Office 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.Through Outlook, you can manage emails, schedule meetings, find information about users in an organization, initiate online conversations, share files, and collaborate in groups.

Warum persönliche Kontakte in Outlook integrieren?Why integrate with Outlook personal contacts?

Ergänzung von Messaging- und Kalenderszenarien für hunderte Millionen von KundenComplement messaging and calendaring scenarios for hundreds of millions of customers

Hunderte Millionen Kunden und mehrere zehn Millionen Organisationskunden nutzen Outlook als E-Mail-Client.Hundreds of millions of consumers and tens of millions of organization customers choose Outlook as their email 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.Contacts provide a complementary function for messaging and calendaring by letting customers maintain a convenient, integrated store of contacts data within Outlook. Die Nutzung der vielfältigen Funktionen von E-Mails oder des Kalenders bedeutet für Entwickler umfassendere Szenarien mit den Kontaktdaten von Benutzern.For developers, tapping into the rich functionality of mail or calendar means opening up richer scenarios with the user's contacts data.

Automatisieren der KontaktorganisationAutomate contact organization

Mit der Kontakte-API können Sie Ihre Kunden organisieren, und zwar in sehr ähnlicher Weise wie die Kunden dies selbst über Outlook tun:The contacts API lets you keep your customers organized, in close parity as the customers do it themselves through Outlook:

  • Ähnlich wie bei der Kundenoberfläche können Sie contact-Instanzen erstellen und diese contactFolder-Objekten zuordnen.Similarly to the customer experience, you can create contact instances and assign them to contactFolder objects.
  • Mit der Kontakte-API können Sie Kategorien, Kontakte, Ereignisse, Nachrichten, Aufgaben und Gruppenbeiträge konsistent zuweisen, um die Organisation und Ermittlung zu verbessern.The contacts API lets you assign categories contacts, as well as events, messages, tasks, and group posts in a consistent way to enhance organization and disovery. Darüber hinaus können Sie eine Masterliste von Kategorien eines Benutzers definieren, was weitere Szenarien eröffnen kann.In addition, you can define a user's master list of categories, which can open up additional creative scenarios.
  • Sie können für einen Kontakt eine Kennzeichnung zur Nachverfolgung festlegen.You can set a flag on a contact for follow-up. (Das Kennzeichnen befindet sich in Microsoft Graph derzeit in der Vorschau.)(Flagging is currently in preview in Microsoft Graph.)

Freigeben von KontaktinformationenShare contact information

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.The contacts API lets you get contact items of the signed-in user, or of the users who have shared or delegated their contacts to the signed-in user. 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.For example, if Garth has shared a contact folder 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.

Nutzen der Personen-API in Microsoft Graph zur besseren Ausnutzung aller PersonendatenLeverage people API in Microsoft Graph to make better use of all people data

Sie können die normalen CRUD-Vorgänge für einen Outlook-Kontakt zum Erstellen und Verwalten von Kontakten verwenden.You can use the typical CRUD operations for an Outlook contact to create and manage contacts. 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.As part of Microsoft Graph, you can also use the people API that looks at a user's Outlook contacts, as well as social networks, organization directory, and people from recent communication, and return information about people from all these sources that are most relevant to the user. Nutzen Sie diese zusätzliche Intelligenz in Personenauswahlszenarien.Take advantage of this additional intelligence in people picker scenarios.

Nutzen der Vorteile anderer freigegebener Features und Vorteile von Microsoft GraphTake advantage of other shared features and conveniences in Microsoft Graph

  • Die contact-Entität unterstützt ein Kontaktfoto, das als dieselbe profilePhoto-Entität wie ein in Exchange Online oder Azure Active Directory gespeichertes Benutzerfoto implementiert wird.The contact entity supports a contact photo which is implemented as the same profilePhoto entity as a user photo stored in Exchange Online or Azure Active Directory. Dadurch wird der Aufwand des Konvertierens von Kontakten und Benutzerprofilfotos reduziert.This eliminates the overhead in converting between contact and user profile photos.
  • Sie können den lokalen App-Speicher synchronisieren, indem Sie Änderungsbenachrichtigungen und Nachverfolgungsänderungen an Kontakten und Kontaktordnern abonnieren.You can keep the app local store synchronized by subscribing to change notifications and tracking changes to contacts and contact folders.
  • Sie können den App-Speicher in einer Kontaktinstanz als offene Erweiterung erweitern oder stark typisierte benutzerdefinierte Daten als Schemaerweiterung hinzufügen.You can extend app storage in a contact instance as an open extension, or add strongly typed custom data to the contact schema as a schema extension.

API-ReferenzAPI reference

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

Nächste SchritteNext steps