Feedback Bearbeiten

PersonCertification aktualisieren

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften eines personCertification-Objekts aus dem 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

PATCH /me/profile/certifications/{id}
PATCH /users/{id | userPrincipalName}/profile/certifications/{id}

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

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.
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 200 OK Antwortcode und ein aktualisiertes objekt "personCertification" im Antworttext zurück.

Beispiele

Anforderung

PATCH https://graph.microsoft.com/beta/users/{userId}/profile/certifications/{id}
Content-Type: application/json

{
  "issuingAuthority": "International Academy of Marketing Excellence",
  "issuingCompany": "International Academy of Marketing Excellence"
}

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