PersonResponsibility aktualisieren

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines personResponsibility-Objekts im Profil eines Benutzers.

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	User.Read	User.Read.All, User.ReadBasic.All, User.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	User.Read	User.ReadWrite
Anwendung	Nicht unterstützt	Nicht unterstützt

HTTP-Anforderung

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der personResponsibility erforderlich sind.

Eigenschaft	Typ	Beschreibung
allowedAudiences	String	Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Mögliche Werte: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
collaborationTags	String collection	Enthält Erfahrungsszenariotags, die ein Benutzer dem Interesse zugeordnet hat. Zulässige Werte in der Auflistung sind: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove.
description	String	Beschreibung der Verantwortung.
displayName	String	Enthält einen Anzeigenamen für die Verantwortung.
Ableitung	inferenceData	Enthält Rückschlussdetails, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
webUrl	String	Enthält einen Link zu einer Webseite oder Ressource zur Verantwortung.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 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"
  ]
}