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.

Eigenschaften

Die listItem-Ressource weist folgende Eigenschaften auf.

Eigenschaftsname	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	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	Identität der letzten Person, die dieses Element 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.

Beziehungsname	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.
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

Es folgt eine JSON-Darstellung einer listItem-Ressource.

{
  "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" },
  "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"
}