Personen auflistenList people

Dient zum Abrufen einer Sammlung von person-Objekten, die nach ihrer Relevanz für den Benutzer sortiert sind, die von den Mustern bei Kommunikation, Zusammenarbeit und den Geschäftsbeziehungen des Benutzers abhängt.Retrieve a collection of person objects ordered by their relevance to the user, which is determined by the user's communication and collaboration patterns, and business relationships.

Sie können diese Informationen über die People API abrufen. Beispiele finden Sie in dem Abschnitt Beispiele sowie im Artikel zum Thema Abrufen relevanter Informationen über Personen.You can get this information via the People API. For examples, see the Examples section and the article Get relevant information about people.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) People.Read, People.Read.AllPeople.Read, People.Read.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) People.ReadPeople.Read
AnwendungApplication People.Read.AllPeople.Read.All

HTTP-AnforderungHTTP request

GET /me/people
GET /users/{id | userPrincipalName}/people

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter, um bei der Anpassung der Antwort zu helfen. Beispiele dazu finden Sie im Artikel Abrufen relevanter Informationen über Personen.This method supports the OData query parameters to help customize the response, as shown in the examples in the article Get relevant information about people.

NameName WertValue BeschreibungDescription
$filter$filter Zeichenfolgestring Dient zum Einschränken der Antwort auf diejenigen Personen, deren Datensätze die angegebenen Kriterien enthalten.Limits the response to only those people whose record contains the specified criteria.
$orderby$orderby Zeichenfolgestring Standardmäßig werden die Personen in der Antwort nach ihrer Relevanz für die Abfrage sortiert.By default the people in the response are sorted by their relevance to your query. Sie können die Reihenfolge der Personen in der Antwort mit dem $orderby-Parameter ändern.You can change the order of the people in the response using the $orderby parameter.
$search$search Zeichenfolgestring Dient für die Suche nach Personen anhand des Namens oder des Alias.Search for people by name or alias. Unterstützt Fuzzyübereinstimmung.Supports Fuzzy matching. Parameter funktioniert nur für die Suche nach den relevanten Personen des angemeldeten Benutzers, nicht für die Suche nach Personen, die für andere Benutzer relevant sind.Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Unterstützt auch das Schlüsselwort topic, um Personen anhand von Themen zu finden, die aus E-Mail-Gesprächen mit dieser Person extrahiert wurden.Also supports the topic keyword to find people based on topics extracted from e-mail conversations with that person. Sehen Sie sich den Abschnitt Eine Fuzzy-Suche durchführen unter Relevante Informationen über Personen erhalten für Informationen und Beispiele an.See the Perform a fuzzy search section at Get relevant information about people for information and examples.
$select$select stringstring Durch Trennzeichen getrennte Liste der Eigenschaften, die in die Antwort eingeschlossen werden sollen. Wählen Sie für optimale Leistung nur eine Teilmenge der benötigten Eigenschaften.Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.
$skip$skip intint Die ersten n Ergebnisse werden übersprungen. Hilfreich für Paging. Wird bei Verwendung von $search nicht unterstützt.Skip the first n results, useful for paging. This is not supported when using $search.
$top$top intint Anzahl der Ergebnisse, die zurückgegeben werden.Number of results to be returned.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
AnnehmenAccept application/jsonapplication/json

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von person-Objekten im Antworttext zurückgegeben. Die Antwort kann ein person-Objekt oder eine Sammlung von person-Objekten enthalten.If successful, this method returns a 200 OK response code and a collection of person objects in the response body. The response can contain one person object or a collection of person objects.

BeispieleExamples

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/me/people

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 1370

{
    "value": [
        {
            "id": "33b43a5b-87d6-41ec-91f8-a2610048105f",
            "displayName": "Marketing",
            "givenName": null,
            "surname": null,
            "birthday": "",
            "personNotes": "",
            "isFavorite": false,
            "jobTitle": null,
            "companyName": null,
            "yomiCompany": "",
            "department": null,
            "officeLocation": null,
            "profession": "",
            "userPrincipalName": "",
            "imAddress": null,
            "scoredEmailAddresses": [
                {
                    "address": "Marketing@contoso.com",
                    "relevanceScore": 30.0
                }
            ],
            "phones": [],
            "postalAddresses": [],
            "websites": [],
            "personType": {
                "class": "Group",
                "subclass": "UnifiedGroup"
            }
        },
        {
            "id": "e3d0513b-449e-4198-ba6f-bd97ae7cae85",
            "displayName": "Isaiah Langer",
            "givenName": "Isaiah",
            "surname": "Langer",
            "birthday": "",
            "personNotes": "",
            "isFavorite": false,
            "jobTitle": "Web Marketing Manager",
            "companyName": null,
            "yomiCompany": "",
            "department": "Sales & Marketing",
            "officeLocation": "20/1101",
            "profession": "",
            "userPrincipalName": "IsaiahL@contoso.com",
            "imAddress": "sip:isaiahl@contoso.com",
            "scoredEmailAddresses": [
                {
                    "address": "IsaiahL@contoso.com",
                    "relevanceScore": 20.0
                }
            ],
            "phones": [
                {
                    "type": "business",
                    "number": "+1 918 555 0101"
                }
            ],
            "postalAddresses": [],
            "websites": [],
            "personType": {
                "class": "Person",
                "subclass": "OrganizationUser"
            }
        }
    ]
}

Weitere Beispiele finden Sie im Artikel Abrufen relevanter Informationen über Personen.For more examples, see the article Get relevant information about people.