Feedback Bearbeiten

PersonAward erstellen

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Erstellen sie ein neues personAward-Objekt 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.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) User.ReadWrite, User.ReadWrite.All
Anwendung User.ReadWrite.All

HTTP-Anforderung

POST /me/profile/awards
POST /users/{id | userPrincipalName}/profile/awards

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die festgelegt werden können, wenn ein neues personAward-Objekt im Profileines Benutzers erstellt wird.

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.
description Zeichenfolge Enteignung des Preises oder der Ehrung.
displayName Zeichenfolge Name des Preises oder der Ehrung.
Ableitung inferenceData Enthält Denkdaten, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
issuedDate Datum Das Datum, an dem der Preis oder die Ehrung gewährt wurde.
issuingAuthority Zeichenfolge Autorität, die den Preis oder die Ehrung gewährt hat.
source personDataSource Wo die Werte stammen, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
thumbnailUrl Zeichenfolge URL, die auf eine Miniaturansicht des Preises oder der Ehrung verweist.
webUrl Zeichenfolge URL, die auf den Preis oder die Ehrung verweist.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein personAward-Objekt im Antworttext zurück.

Beispiele

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

{
  "description": "Lifetime Achievement award from the International Association of Branding Managers",
  "displayName": "Lifetime Achievement Award For Excellence in Branding",
  "issuedDate": "Date",
  "issuingAuthority": "International Association of Branding Management",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}

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": "Lifetime Achievement award from the International Association of Branding Managers",
  "displayName": "Lifetime Achievement Award For Excellence in Branding",
  "issuedDate": "Date",
  "issuingAuthority": "International Association of Branding Management",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}