Obtenir des employésGet employees

Espace de noms : Microsoft. GraphNamespace: microsoft.graph

Important

Les API sous /beta la version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported.

Récupérez les propriétés et les relations d’un objet Employee pour Dynamics 365 Business central.Retrieve the properties and relationships of an employee object for Dynamics 365 Business Central.

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) Financials.ReadWrite.AllFinancials.ReadWrite.All
Délégué (compte Microsoft personnelDelegated (personal Microsoft account Non prise en charge.Not supported.
ApplicationApplication Financials.ReadWrite.AllFinancials.ReadWrite.All

Requête HTTPHTTP request

GET /financials/companies/{id}/employees/{id}

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData Query Parameters to help customize the response.

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.

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 200 OK renvoie un code de réponse et un objet Employees dans le corps de la réponse.If successful, this method returns a 200 OK response code and an employees object in the response body.

DemandeRequest

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

GET https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id}

RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

Remarque : l’objet de réponse affiché ici peut être raccourci pour plus de lisibilité.Note: The response object shown here might be shortened for readability. Toutes les propriétés sont renvoyées à partir d’un appel réel.All the properties will be returned from an actual call.

{
  "id": "id-value",
  "number": "AH",
  "displayName": "Annette Hill",
  "givenName": "Annette",
  "middleName": "",
  "surname": "Hill",
  "jobTitle": "Secretary",
  "address": {
    "street": "677 Fifth Avenue",
    "city": "New York",
    "state": "",
    "countryLetterCode": "",
    "postalCode": "10022"
  },
  "phoneNumber": "4465-4899-4643",
  "mobilePhone": "4564-4564-7831",
  "email": "",
  "personalEmail": "ah@cronus-demosite.com",
  "employmentDate": "2001-06-01",
  "terminationDate": "0001-01-01",
  "status": "Active",
  "birthDate": "1973-12-12",
  "picture@odata.mediaReadLink": "https://api.financials.dynamics.com/v1.0/api/beta/companies/{id}/employees/{id}/picture",
  "lastModifiedDateTime": "2017-03-16T14:57:19.497Z"  
}