Freigeben über


personResponsibility erstellen

Namespace: microsoft.graph

Erstellen Sie ein neues personResponsibility-Objekt im Profil eines Benutzers.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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.ReadWrite AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) User.ReadWrite Nicht verfügbar.
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

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

Anforderungsheader

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

Anforderungstext

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

Die folgende Tabelle zeigt die Eigenschaften, die innerhalb eines neuen personResponsibility-Objekts im Profil eines Benutzers festgelegt werden können.

Eigenschaft Typ Beschreibung
allowedAudiences Zeichenfolge Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Mögliche Werte: me, family, , contactsgroupMembers, organization, federatedOrganizations, everyone, , . unknownFutureValue
collaborationTags Zeichenfolgensammlung Enthält Erfahrungsszenariotags, die ein Benutzer dem Interesse zugeordnet hat. Zulässige Werte in der Auflistung sind: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove.
description Zeichenfolge Beschreibung der Verantwortung.
displayName Zeichenfolge 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.
source personDataSource Woher die Werte stammen, wenn sie von einem anderen Dienst synchronisiert werden. Geerbt von itemFacet.
webUrl Zeichenfolge Enthält einen Link zu einer Webseite oder Ressource zur Verantwortung.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und ein personResponsibility-Objekt im Antworttext zurückgegeben.

Beispiele

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

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

Antwort

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

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"
  ]
}