listItem-Ressource

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 unten beziehen sich auf eine Liste, z. B.: https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Häufige Aufgaben	HTTP-Methode
Get	GET /items/{item-id}
Abrufen von Spaltenwerten	GET /items/{item-id}?expand=fields
Analysen abrufen	GET /items/{item-id}/analytics
Aktivitäten nach Intervall abrufen	GET /items/{item-id}/getActivitiesByInterval
Create	POST /items
Delete	DELETE /items/{item-id}
Update	PATCH /items/{item-id}
Aktualisieren von Spaltenwerten	PATCH /items/{item-id}/fields
createLink	POST /items/{itemId}/createLink
DocumentSetVersions auflisten	GET /items/{item-id}/documentSetVersions
DocumentSetVersion erstellen	POST /items/{item-id}/documentSetVersions
Wiederherstellen von documentSetVersion	POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore
Delta abrufen	GET /items/{item-id}/delta

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

Es folgt eine JSON-Darstellung der 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" },
  "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"
}