PersonResponsibility aktualisieren

Namespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften eines personResponsibility-Objekts im Profileines Benutzers.

Berechtigungen

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.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
Anwendung	User.ReadBasic.All, User.Read.All, User.ReadWrite.All

HTTP-Anforderung

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des personResponsibility-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie eine PersonResponsibilityerstellen.

Eigenschaft	Typ	Beschreibung
allowedAudiences	Zeichenfolge	Die Zielgruppen, die in der Lage sind, die in der Entität enthaltenen Werte anzuzeigen. Geerbt von itemFacet. Mögliche Werte: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
collaborationTags	String collection	Enthält Erfahrungsszenario-Tags, die ein Benutzer mit dem Interesse verknüpft hat. Zulässige Werte in der Auflistung sind: askMeAbout , ableToMentor , , wantsToLearn wantsToImprove .
description	String	Beschreibung der Verantwortlichkeit.
displayName	Zeichenfolge	Enthält einen Anzeigenamen für die Zuständigkeit.
Ableitung	inferenceData	Enthält Denkdaten, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
webUrl	Zeichenfolge	Enthält einen Link zu einer Webseite oder Ressource zur Zuständigkeit.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes personResponsibility-Objekt im Antworttext zurück.

Beispiele

Anforderung

PATCH https://graph.microsoft.com/beta/me/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
Content-Type: application/json

{
  "collaborationTags": [
    "askMeAbout"
  ]
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
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"
  ]
}