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 personResponsibility-Objekts 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. Die möglichen Werte sind: me, family, contacts, groupMembers, organization, federatedOrganizations, , everyone. unknownFutureValue
ZusammenarbeitTags String collection Enthält Erfahrungsszenario-Tags, 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.
Rückschluss inferenceData Enthält Rückschlussdetails, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
source personDataSource Ursprung der Werte, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
webUrl Zeichenfolge Enthält einen Link zu einer Webseite oder Ressource über die Verantwortung.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein personResponsibility-Objekt im Antworttext zurück.

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"
  ]
}
  • Last updated on