Feedback Bearbeiten

ItemObjekt erstellen

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Erstellen eines neuen itemElement-Objekts innerhalb des Profilseines 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/patents
POST /users/{id | userPrincipalName}/profile/patents

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die festgelegt werden können, wenn ein neues itemElement-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 Patents oder der Anmeldung.
displayName Zeichenfolge Titel des Patents oder der Einreichung.
Ableitung inferenceData Enthält Denkdaten, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
isPending Boolescher Wert Gibt an, dass das Patent aussteht.
issuedDate Datum Das Datum, an dem das Patent erteilt wurde.
issuingAuthority Zeichenfolge Autorität, die das Patent erteilt hat.
number Zeichenfolge Die Patentnummer.
source personDataSource Wo die Werte stammen, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
webUrl Zeichenfolge URL, die auf das Patent oder die Einreichung verweist.

Antwort

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

Beispiele

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

{
  "description": "Calculating the intent of a user to purchase an item based on the amount of time they hover their mouse over a given pixel.",
  "displayName": "Inferring User Intent through browsing behaviors",
  "isPending": true,
  "number": "USPTO-3954432633",
  "webUrl": "https://patents.gov/3954432633"
}

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": "me",
  "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": "Calculating the intent of a user to purchase an item based on the amount of time they hover their mouse over a given pixel.",
  "displayName": "Inferring User Intent through browsing behaviors",
  "isPending": true,
  "issuedDate": "Date",
  "issuingAuthority": null,
  "number": "USPTO-3954432633",
  "webUrl": "https://patents.gov/3954432633"
}