Répertorier les personnesList people

Récupérer une collection d’objets person classés selon leur pertinence pour l’utilisateur (user), laquelle est déterminée par les relations professionnelles et les modèles de communication et de collaboration de l’utilisateur.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.

Vous pouvez obtenir ces informations via l’API Contacts. Pour obtenir des exemples, voir la section Exemples et l’article sur l’obtention d’informations pertinentes sur les personnes.You can get this information via the People API. For examples, see the Examples section and the article Get relevant information about people.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) People.Read, People.Read.AllPeople.Read, People.Read.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) People.ReadPeople.Read
ApplicationApplication People.Read.AllPeople.Read.All

Requête HTTPHTTP request

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

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData suivants afin de vous aider à personnaliser la réponse, comme indiqué dans les exemples présentés dans l’article sur l’obtention d’informations pertinentes sur les contacts.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.

NomName ValeurValue DescriptionDescription
$filter$filter stringstring Limite la réponse uniquement aux contacts dont l’enregistrement contient les critères spécifiés.Limits the response to only those people whose record contains the specified criteria.
$orderby$orderby stringstring Par défaut, les contacts de la réponse sont triés selon leur pertinence par rapport à votre requête.By default the people in the response are sorted by their relevance to your query. Vous pouvez modifier l’ordre des contacts dans la réponse à l’aide du paramètre $orderby.You can change the order of the people in the response using the $orderby parameter.
$search$search stringstring Rechercher des personnes par nom ou alias.Search for people by name or alias. Prend en charge la correspondance approximative.Supports Fuzzy matching. Paramètre fonctionne uniquement pour la recherche de personnes pertinents connecté l’utilisateur, ne pas pour la recherche de personnes appropriées à d’autres utilisateurs.Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Prend également en charge la topic mot clé à rechercher des personnes en fonction de rubriques extraites des conversations par messagerie électronique avec cette personne.Also supports the topic keyword to find people based on topics extracted from e-mail conversations with that person. Consultez la section d’effectuer une recherche approximative à obtenir des informations pertinentes sur les personnes pour plus d’informations et des exemples.See the Perform a fuzzy search section at Get relevant information about people for information and examples.
$select$select stringstring Liste de propriétés séparées par des virgules à inclure dans la réponse. Pour des performances optimales, sélectionnez uniquement le sous-ensemble de propriétés nécessaire.Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.
$skip$skip intint Ignorer les n premiers résultats (utile pour la pagination). Cette fonctionnalité n'est pas prise en charge lorsque vous utilisez $search.Skip the first n results, useful for paging. This is not supported when using $search.
$top$top intint Nombre de résultats à renvoyer.Number of results to be returned.

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
AccepterAccept application/jsonapplication/json

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets person dans le corps de la réponse. La réponse peut contenir un seul objet person ou une collection d’objets person.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.

ExemplesExamples

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

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

RéponseResponse

Voici un exemple de réponse.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"
            }
        }
    ]
}

Pour obtenir d’autres exemples, consultez l’article Utiliser l’API Contacts dans Microsoft Graph pour obtenir des informations sur les contacts plus pertinents pour vous.For more examples, see the article Get relevant information about people.