Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die mehreren hundert Millionen Benutzer von Microsoft 365-Clouddiensten sind Teil des Herzstücks von Microsoft Graph. Die Daten der Benutzer werden sorgfältig verwaltet, geschützt und mit der entsprechenden Berechtigung durch die Dienste von Microsoft Graph zur Verfügung gestellt, um die Produktivität und Kreativität in Unternehmen zu fördern.
Mit der Profil-API können Sie als App-Entwickler Personen in Microsoft 365-Diensten modellieren und darstellen, und mit der Profilkarten-API können Administratoren die Informationen steuern, die auf den Profilkarten der Benutzer in der Organisation angezeigt werden.
Da die Daten des Benutzers in Microsoft Graph allgegenwärtig sind, sind Daten, die aus den Interaktionen des Benutzers abgeleitet werden, besonders interessant. Sie bieten intelligente Einblicke, die Antworten auf Fragen wie die folgenden bieten:
- „Suchen nach Personen, deren Name mit „J“ beginnt“
- „Welche Dokumente sind für diese Person am interessantesten?“
Sie können die Personen-API und die Insights-API in Microsoft Graph nutzen, um intelligentere Apps zu erstellen, welche auf die für einen Benutzer relevanten Personen bzw. Dokumente zugreifen.
Die Personen-API gibt Personen zurück, die nach Relevanz für einen Benutzer sortiert sind, basierend auf den Kontakten dieses Benutzers, organization Verzeichnis und der letzten Kommunikation per E-Mail. Dies ist besonders nützlich, wenn Personen ausgewählt werde müssen.
Die Einblicke-API verwendet erweiterte Analysemethoden und maschinelles Lernen, um dem Benutzer die relevantesten Dateien bereitzustellen, die er für seine tägliche Arbeit benötigt. Die API unterstützt vertraute Microsoft 365-Umgebungen, einschließlich SharePoint-Startseite, der Ansicht "Entdecken" in OneDrive for Business und Outlook im Web.
Vorteile der Integration mit Personendaten
Die Personen-API gibt Daten einer einzelnen Entität zurück: person. Diese enthält die für die heute Geschäftsumgebung typischen Daten einer Einzelperson. Diese Personendaten werden aufgrund ihrer Relevanz in Bezug auf einen Microsoft Graph-Benutzer erst besonders nützlich. Relevanz wird in den zurückgegebenen Ergebnissen notiert, die von der relevantesten bis zur am wenigsten relevant sortiert sind. Sie können die folgenden Microsoft Graph-APIs verwenden, um innerhalb eines organization nach Personen zu suchen.
Verwenden des /search-Endpunkts
Entwickler werden aufgefordert, den /search
Endpunkt beim Erstellen ihrer Produkte zu verwenden. Der /people
Endpunkt befindet sich im Wartungsmodus. Im Folgenden sollten Sie die Verwendung des Endpunkts /search
in Betracht ziehen:
- Alle zukünftigen Investitionen in die Personensuche werden über
/search
verfügbar gemacht, z. B. suche in natürlicher Sprache wie "John der Buchhalter in Nairobi". - Der Attributsuchabgleich für andere Attribute als Name und E-Mail ist verfügbar.
- Bessere Relevanzergebnisse von
/search
liefern bessere Ergebnisse aufgrund der Verwendung von künstlicher Intelligenz, besseren Datenmodellen und ausgefeilter Rechtschreibkorrektur. - Niedrigere Warenkosten bei Verwendung
/search
von , aber insbesondere geringere Latenz.
Suchen von Personen nach Relevanz
Sie können Personen durchsuchen, die mit dem angemeldeten Benutzer oder einem anderem Benutzer im Unternehmen des angemeldeten Benutzers in Beziehung stehen, vorausgesetzt, Sie verfügen über die entsprechende Autorisierung. Sie erhalten eine Sammlung von person-Objekten, die nach Relevanz geordnet ist. Sie können die Sammlung der person-Objekte, die in der Antwort zurückgegeben wird, indem Sie die Abfrageparameter top
, skip
, orderby
, select
und filter
angeben, noch weiter anpassen.
Fuzzysuche basierend auf Personenkriterien
Mit der Personen-API können Sie nach Personen suchen, die für den angemeldeten Benutzer relevant sind, vorausgesetzt, dass Ihre App die Berechtigung durch diesen Benutzer erhalten hat. (Erfahren Sie mehr über Personenberechtigungen.)
Fuzzysuchen geben Ergebnisse basierend auf einer genauen Übereinstimmung sowie auf Ableitungen zur Absicht der Suche zurück. Zur Veranschaulichung gibt das folgende Beispiel person-Objekte zurück, die für den angemeldeten Benutzer relevant sind, dessen Name oder E-Mail-Adresse ein Wort enthält, das mit „j“ beginnt.
GET /me/people/?$search=j
Gründe für die Integration in die Profil-API (Vorschau)
Die Profil-API steht für die nächste Generation der Modellierung und Darstellung von Personen in Microsoft 365-Diensten. Profildaten können zusammen mit Personendaten verwendet werden, um angepasste Benutzeroberflächen basierend auf Microsoft Graph zu erstellen.
Gründe für die Konfiguration von Profilkarten in Ihrem organization
Profilkarten ermöglichen Benutzern in einer Organisation, Informationen über die anderen Benutzer anzuzeigen, z. B. deren Namen und Kontaktinformationen. Administratoren können mit der Profilkarten-API anpassen, wie Informationen über ihre Organisation in den Microsoft 365-Benutzeroberflächen von Personen dargestellt werden.
Warum sollten Pronomen in Ihrem organization konfiguriert werden?
Pronomen dienen als Ersatz für den Namen einer Person in Sätzen, wobei geschlechtsneutrale Versionen in mehreren Sprachen verfügbar sind, z. B. in Englisch, "she", "her, "he", "him" und den geschlechtsneutralen "they", "them". Die Verwendung eines genauen Pronomens zeigt Inklusivität und Respekt und vermeidet Annahmen, die auf Namen oder anfänglichen Beobachtungen der Person basieren. In einer hybriden, multikulturellen Arbeits- oder Schulumgebung kann die einfache Verwendung der richtigen Pronomen dazu beitragen, Vertrauen aufzubauen und die Kommunikation untereinander zu verbessern. Administratoren können die PronomenEinstellungen-API verwenden, um Pronomeneinstellungen in Ihrem organization zu konfigurieren.
Gründe für die Konfiguration von Profilquellen in Ihrem organization
Mit der Profilquellenkonfiguration können Benutzer in einem organization den Ursprung der Profildaten identifizieren, die in Microsoft 365-Umgebungen angezeigt werden. Administratoren können die Darstellung der eigenschaften displayName und webUrl in einer Profilquelle mithilfe einer Reihe alternativer Übersetzungen für die sprachen anpassen, die in ihren organization unterstützt werden.
Warum sollte die Rangfolge der Profilquelle in Ihrem organization konfiguriert werden?
Mit der Rangfolge von Profilquellen können Administratoren steuern, wie Profildaten in Microsoft 365-Umgebungen angezeigt werden. Wenn mehrere Quellen überlappende Daten bereitstellen, können Administratoren die autoritative Quelle von Profildaten definieren, indem sie die Reihenfolge der Datenquellenpriorität mithilfe der profilePropertySetting-API konfigurieren. Weitere Informationen finden Sie unter Verwalten von Rangfolgeneinstellungen für Profilquellen für eine organization mithilfe der Microsoft Graph-API (Vorschau).
Warum sollen Dokumenten-basierte Einblicke integriert werden?
Nutzen von Informationen zur Verbesserung der Zusammenarbeit
An einem typischen Arbeitstag verwenden Benutzer häufig große Mengen an Informationen, die in verschiedenen Dokumenten gespeichert sind, und arbeiten auf verschiedene Weise mit anderen Personen zusammen. Es ist wichtig, dass sie immer das finden können, was sie benötigen, wenn sie es benötigen.
Sie können die Einblicke-API verwenden, die APIs für trending, shared und used beinhaltet. Hiermit können Sie Dateien aus Microsoft 365 basierend auf dem aktuellen Kontext und den Anforderungen der Benutzer abrufen, sodass die Produktivität der Benutzer gesteigert und die Zusammenarbeit im Unternehmen gefördert wird. Organisationen können für diese dokumentbasierten Einblicke Datenschutzeinstellungen anpassen und die Verfügbarkeit dieser Einblicke in spezifischen Microsoft 365-Umgebungen steuern.
Sie können die Ergebnisse der Einblicke-API auf einfache Weise in der App darstellen. Jedes Ergebnis bietet eine Reihe von allgemeinen Visualisierungseigenschaften, wie z. B. eine Vorschaubild-URL oder Vorschautext.
Bessere Zusammenarbeit der Benutzer und Erledigung der eigentlichen Arbeit
Die neuen Personenkarten in Microsoft 365 nutzen die Verwendet- und Freigegeben-Einblicke, um Personen und Wissen miteinander zu verbinden. Die Personenkarte identifiziert relevante Dokumente zu einer Person und zeigt sie anzeigt. Benutzer können Personenkarten überall in der Produktsuite sehen, wie z. B. in Outlook im Web. Siehe Abbildung 2.
Die Einblicke-API bietet mit den Entitäten used und shared ähnliche Funktionen. Sie geben zurück, was sich ein Benutzer angesehen oder woran er gearbeitet hat, oder was Kollegen mit dem Benutzer zuletzt in Microsoft 365 geteilt haben.
Abbildung 2: Outlook im Web anzeigen, dass eine Für einen Benutzer Karte Personen angezeigt wird
Gründe für die Integration in Microsoft Viva Insights (Vorschau)?
Microsoft Viva Insights bietet Einblicke, wie Menschen ihre Zeit verbringen und mit wem sie sie verbringen. Diese Daten können Personen dabei helfen, ihren Tag zu planen, Erkenntnisse über ihren Arbeitsrhythmus zu gewinnen und eine ausgewogene Work-Life-Balance zu finden.
Mithilfe der Analyse-API können Sie die Benutzerdaten mit Apps von Drittanbietern synchronisieren oder sie in solche Apps integrieren. Dies eröffnet verschiedenste Möglichkeiten, die Ihnen dabei helfen, die Produktivität und Zusammenarbeit zwischen Benutzern zu verbessern. Sie können z. B. Viva Insights Daten in Aktivitäten mobiler Geräte integrieren, um Benutzern zu helfen, alle ihre arbeits- und sozialen Aktivitäten nachzuverfolgen und ihren Tag ganz in einer App zu planen.
API-Referenz
Suchen Sie die API-Referenz für diesen Dienst?
- Verwenden der Microsoft Graph-API zum Integrieren von Personen und Arbeitsplatzinformationen in eine App (v1.0)
- Verwenden der Microsoft Graph-API zum Integrieren von Personen und Arbeitsplatzinformationen in eine App (Betaversion)
- Die Person-Ressource in der Personen-API
- Profil (Vorschau)-Ressource
- Profilquelle (Vorschau)
- Profilerstellung Karte Eigenschaftsressource
- Profileigenschaftseinstellung (Vorschau) Ressource
- Einstellungsressource für Pronomen
- Insights-API
- Analyse-API (Vorschau)
Nächste Schritte
- Verwenden Sie den Graph Explorer, um die Personen-, Einblicke und Analyse-APIs mit Ihren eigenen Daten zu testen. Melden Sie sich an, erweitern Sie Personen oder Einblicke in der Spalte auf der linken Seite und probieren Sie deren Beispielabfragen aus.
- Hier finden Sie weitere Informationen zur Personen-API.
- Erfahren Sie, wie Sie die Profilkarte anpassen.
- Weitere Informationen finden Sie unter Verwalten von Pronomeneinstellungen für eine organization.
- Informationen zum Verwalten von Profilquelleneinstellungen für eine organization (Vorschau) finden Sie hier.
- Erfahren Sie, wie Sie die Rangfolgeneinstellungen für Profilquellen für einen organization (Vorschau) verwalten.
- Erfahren Sie mehr über Elementeinblicke, Anpassen des Datenschutzes für Elementeinblicke für Benutzer (Vorschau)und die API für Einstellungen für Elementerkenntnisse (Vorschau), die die Anpassung unterstützt.
- Hier finden Sie weitere Informationen zur Analytics-API.
- Hier finden Sie weitere Informationen zur Profil-API.