listItem-Ressource

Namespace: microsoft.graph

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 Methoden sind für listItem-Ressourcen verfügbar. Alle Beispiele beziehen sich auf eine Liste: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Methode	Rückgabetyp	Beschreibung
Abrufen	listItem	Element in einer Liste abrufen.
Abrufen von Spaltenwerten	listItem	Abrufen von Spaltenwerten aus listItem.
Analysen abrufen	itemAnalytics	Abrufen von Analysen für diese Ressource.
Aktivitäten nach Intervall abrufen	itemActivityStat	Eine Sammlung von itemActivityStats innerhalb des angegebenen Zeitintervalls abrufen.
Erstellen	listItem	Erstellen Sie ein neues listItem in einer Liste.
Löschen	Kein Inhalt	Entfernt ein Element aus einer Liste.
Update	fieldValueSet	Aktualisieren Sie die Eigenschaften in einem listItem.
Aktualisieren von Spaltenwerten	fieldValueSet	Aktualisieren Sie die Spaltenwerte in einem listItem.
DocumentSetVersions auflisten	documentSetVersion-Sammlung	Ruft eine Liste der Versionen eines Dokumentenmappenelements in einer Liste ab.
DocumentSetVersion erstellen	documentSetVersion	Erstellen Sie eine neue Version eines Dokumentenmappenelements in einer Liste.
Wiederherstellen von documentSetVersion	Kein Inhalt	Stellen Sie das Dokumentmappenelement auf eine bestimmte Version wieder her.
Delta abrufen	listItem-Sammlung	Rufen Sie neu erstellte, aktualisierte oder gelöschte Listenelemente ab, ohne die gesamte Elementsammlung vollständig lesen zu müssen.

Eigenschaften

Die listItem-Ressource weist folgende Eigenschaften auf.

Eigenschaft	Typ	Beschreibung
contentType	contentTypeInfo	Der Inhaltstyp dieses Listenelements

Die folgenden Eigenschaften werden von baseItem geerbt.

Eigenschaft	Typ	Beschreibung
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.
id	string	Der eindeutige Bezeichner des Elements. 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.
name	string	Der Name/Titel des Elements.
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-Sammlung	Versionsinformationen für eine Dokumentenmappenversion, 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.
Versionen	listItemVersion-Sammlung	Die Liste der früheren Versionen des Listenelements.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt 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"
}