listItem-Ressource

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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.

Aufgaben zu einem listItem

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
documentSetVersion wiederherstellen	POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore
Delta abrufen	GET /items/{item-id}/delta

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

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

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