Feedback Bearbeiten

ItemPublication erstellen

  • Artikel
  • 6 Minuten Lesedauer

Namespace: microsoft.graph

Erstellen eines neuen itemPublication-Objekts 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/publications
POST /users/{id | userPrincipalName}/profile/publications

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die festgelegt werden können, wenn ein neues itemPublication-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.
createdBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, die die Entität erstellt hat. Geerbt von itemFacet.
createdDateTime DateTimeOffset Stellt dateTimeOffset für den Zeitpunkt bereit, zu dem die Entität erstellt wurde. Geerbt von itemFacet.
description Zeichenfolge Beschreibung der Publikation.
displayName Zeichenfolge Titel der Publikation.
id Zeichenfolge Bezeichner, der für die individuelle Adressierung der Entität verwendet wird. Geerbt von Entität
Ableitung inferenceData Enthält Denkdaten, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
lastModifiedBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, der die Entität zuletzt geändert hat. Geerbt von itemFacet.
lastModifiedDateTime DateTimeOffset Stellt dateTimeOffset für den Zeitpunkt bereit, zu dem die Entität erstellt wurde. Geerbt von itemFacet.
publishedDate Datum Das Datum, an dem die Publikation veröffentlicht wurde.
publisher String Publikation oder Publisher für die Publikation.
source personDataSource Wo die Werte stammen, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
thumbnailUrl Zeichenfolge URL, die auf eine Miniaturansicht der Publikation verweist.
webUrl Zeichenfolge URL, die auf die Publikation verweist.

Antwort

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

Beispiele

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

{
  "description": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "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": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}