listItem-Ressourcentyp

Artikel
06/18/2024

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 sind relativ zu einer Liste; Beispiel: https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Methode	Rückgabetyp	Beschreibung
Create	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.
Abrufen von Spaltenwerten	listItem	Abrufen von Spaltenwerten aus listItem.
Aktualisieren von Spaltenwerten	fieldValueSet	Aktualisieren Sie die Spaltenwerte in einem listItem.
Dokumentsatzversion auflisten	documentSetVersion-Sammlung	Ruft eine Liste der Versionen eines Dokumentenmappenelements in einer Liste ab.
Erstellen einer Dokumentenmappenversion	documentSetVersion	Erstellen Sie eine neue Version eines Dokumentenmappenelements in einer Liste.
Wiederherstellen der Dokumentmappenversion	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.
Berechtigungen auflisten	permission	Ruft eine Liste der Berechtigungsobjekte ab, die einem listItem zugeordnet sind.
Berechtigung erstellen	permission	Ruft eine Liste der Berechtigungsobjekte ab, die einem listItem zugeordnet sind.
Berechtigung abrufen	permission	Erstellen Sie ein neues Berechtigungsobjekt für ein listItem-Objekt.
Berechtigung aktualisieren	permission	Aktualisieren eines Berechtigungsobjekts für ein listItem-Objekt.
Berechtigung löschen	Keine	Löschen eines Berechtigungsobjekts für ein listItem-Objekt.

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

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

Freigeben über