Feedback Bearbeiten

personCertification erstellen

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Erstellen sie ein neues personCertification-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/certifications
POST /users/{id | userPrincipalName}/profile/certifications

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die festgelegt werden können, wenn ein neues personCertification-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.
certificationId Zeichenfolge Der verweisbare Bezeichner für die Zertifizierung.
description Zeichenfolge Beschreibung der Zertifizierung.
displayName Zeichenfolge Titel der Zertifizierung.
endDate Date Das Datum, an dem die Zertifizierung abläuft.
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 die Zertifizierung ausgestellt wurde.
issuingAuthority Zeichenfolge Autorität, die die Zertifizierung erteilt hat.
issuingCompany Zeichenfolge Autorität, die die Zertifizierung erteilt hat.
source personDataSource Wo die Werte stammen, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
startDate Date Das Datum, an dem die Zertifizierung gültig wurde.
thumbnailUrl Zeichenfolge URL, die auf eine Miniaturansicht der Zertifizierung verweist.
webUrl Zeichenfolge URL, die auf die Zertifizierung verweist.

Antwort

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

Beispiele

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

{
  "certificationId": "KB-1235466333663322",
  "description": "Blackbelt in Marketing - Brand Management",
  "displayName": "Marketing Blackbelt - Brand Management",
  "thumbnailUrl": "https://iame.io/dfhdfdfd334.jpg",
  "webUrl": "https://www.iame.io/blackbelt"
}

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,
  "certificationId": "KB-1235466333663322",
  "description": "Blackbelt in Marketing - Brand Management",
  "displayName": "Marketing Blackbelt - Brand Management",
  "endDate": "Date",
  "issuedDate": "Date",
  "issuingAuthority": null,
  "issuingCompany": null,
  "startDate": "Date",
  "thumbnailUrl": "https://iame.io/dfhdfdfd334.jpg",
  "webUrl": "https://www.iame.io/blackbelt"
}