Créer personResponsibility

Espace de noms: microsoft.graph

Créez un objet personResponsibility dans le profil d’un utilisateur.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) User.ReadWrite AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All
Déléguée (compte Microsoft personnel) User.ReadWrite Non disponible.
Application Non prise en charge. Non prise en charge.

Requête HTTP

POST /me/responsibilities
POST /users/{id | userPrincipalName}/responsibilities

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet personResponsibility .

Le tableau suivant indique les propriétés qu’il est possible de définir dans un nouvel objet personResponsibility dans le profil d’un utilisateur.

Propriété Type Description
allowedAudiences String Les publics qui sont en mesure de voir les valeurs contenues dans l’entité. Hérité de itemFacet. Les valeurs possibles sont : me, , contactsfamily, groupMembers, organizationfederatedOrganizationseveryoneunknownFutureValue.
collaborationTags String collection Contient des balises de scénario d’expérience qu’un utilisateur a associées à l’intérêt. Les valeurs autorisées dans la collection sont : askMeAbout, , wantsToLearnableToMentorwantsToImprove, .
description String Description de la responsabilité.
displayName String Contient un nom convivial pour la responsabilité.
inférence inferenceData Contient des détails d’inférence si l’entité est déduite par l’application de création ou de modification. Hérité de itemFacet.
source personDataSource L’origine des valeurs si elles sont synchronisées à partir d’un autre service. Hérité de itemFacet.
webUrl String Contient un lien vers une page web ou une ressource sur la responsabilité.

Réponse

En cas de réussite, cette méthode renvoie un 201 Created code de réponse et un objet personResponsibility dans le corps de la réponse.

Exemples

POST https://graph.microsoft.com/beta/me/responsibilities
Content-Type: application/json

{
  "description": "Member of the Microsoft API Council",
  "displayName": "API Council",
  "collaborationTags": [
    "askMeAbout"
  ]
}

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
  "allowedAudiences": "organization",
  "inference": null,
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "source": null,
  "description": "Member of the Microsoft API Council",
  "displayName": "API Council",
  "webUrl": null,
  "collaborationTags": [
    "askMeAbout"
  ]
}