listItem-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt ein Element in einer SharePoint-Liste dar.

Alle Elemente in einer SharePoint-Dokumentbibliothek können als listItem- oder driveItem-Ressource dargestellt werden.

Spaltenwerte in der Liste sind über das fieldValueSet-Wörterbuch verfügbar.

Methoden

Die folgenden Aufgaben sind für listItem-Ressourcen verfügbar. Alle Beispiele beziehen sich auf eine Liste; beispielsweise https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Methode Rückgabetyp Beschreibung
List listItem-Sammlung Rufen Sie die Sammlung von Elementen in einer Liste ab.
Erstellen listItem Erstellen Sie ein neues listItem in einer Liste.
Abrufen listItem Element in einer Liste abrufen.
Update fieldValueSet Aktualisieren Sie die Eigenschaften in einem listItem.
Löschen Kein Inhalt Entfernt ein Element aus einer Liste.
Analysen abrufen itemAnalytics Abrufen von Analysen für diese Ressource.
Aktuelle Aktivitäten abrufen ItemActivity-Sammlung Listen Sie die letzten Aktivitäten auf, die auf einem Laufwerk, in einer Liste, einem Element oder innerhalb einer Elementhierarchie ausgeführt wurden.
Abrufen von Spaltenwerten listItem Abrufen von Spaltenwerten aus listItem.
Aktualisieren von Spaltenwerten fieldValueSet Aktualisieren Sie die Spaltenwerte in einem listItem.
Dokumentenmappenversion auflisten documentSetVersion-Auflistung Abrufen einer Liste der Versionen eines Dokumentensatzelements in einer Liste.
Dokumentenmappenversion erstellen documentSetVersion Erstellen einer neuen Version eines Dokumentsatzelements in einer Liste.
Dokumentmappenversion wiederherstellen Kein Inhalt Wiederherstellen des Dokumentsatzelements in einer bestimmten Version.
Delta abrufen listItem-Sammlung Abrufen neu erstellter, aktualisierter oder gelöschter Listenelemente , ohne die gesamte Elementsammlung vollständig lesen zu müssen.
Berechtigungen auflisten permission Rufen Sie eine Liste der Berechtigungsobjekte ab, die einem listItem zugeordnet sind.
Berechtigung erstellen permission Erstellen Sie ein neues Berechtigungsobjekt für ein listItem.
Berechtigung abrufen permission Rufen Sie eine Liste der Berechtigungsobjekte ab, die einem listItem zugeordnet sind.
Berechtigung aktualisieren permission Aktualisieren Sie ein Berechtigungsobjekt für ein listItem.
Berechtigung löschen Keine Löschen Sie ein Berechtigungsobjekt für ein listItem.

Eigenschaften

Die listItem-Ressource weist folgende Eigenschaften auf.

Eigenschaft Typ Beschreibung
contentType contentTypeInfo Der Inhaltstyp dieses Listenelements

Die folgenden Eigenschaften werden von baseItem geerbt.

Eigenschaftsname Typ Beschreibung
id string Der eindeutige Bezeichner des Elements. Schreibgeschützt.
name string Der Name/Titel des Elements.
createdBy identitySet Die Identität des Erstellers dieses Elements. Schreibgeschützt.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.
description string Der beschreibende Text für das Element.
eTag string ETag für das Element. Schreibgeschützt.
lastModifiedBy identitySet Die Identität derPerson, die dieses Element zuletzt geändert hat. Schreibgeschützt.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.
parentReference itemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.
sharepointIds sharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.
webUrl String (URL) URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.

Beziehungen

Die listItem-Ressource weist folgende Beziehungen zu anderen Ressourcen auf.

Beziehung Typ Beschreibung
Aktivitäten ItemActivity-Sammlung Die Liste der letzten Aktivitäten, die für dieses Element durchgeführt wurden.
Analysen itemAnalytics-Ressource Analysen zu den Anzeigeaktivitäten, die auf diesem Element stattgefunden haben.
documentSetVersions documentSetVersion-Auflistung Versionsinformationen für eine Dokumentenmappe Version, die von einem Benutzer erstellt wurde.
driveItem driveItem Für Dokumentbibliotheken macht die DriveItem Beziehung das ListItem als DriveItem verfügbar
fields fieldValueSet Die Werte der für dieses Listenelement festgelegten Spalte.
Berechtigungen permission collection Der Satz von Berechtigungen für das Element. Schreibgeschützt. Nullwerte zulassend.
Versionen listItemVersion-Sammlung Die Liste der früheren Versionen des Listenelements.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "documentSetVersions": [{"@odata.type": "microsoft.graph.documentSetVersion"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}
  • Last updated on