Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|---|
| List | listItem-Sammlung | Rufen Sie die Sammlung von Elementen in einer Liste ab. |
| 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. |
| Dokumentenmappenversion auflisten | documentSetVersion-Sammlung | Ruft eine Liste der Versionen eines Dokumentenmappenelements in einer Liste ab. |
| Create | documentSetVersion | Erstellen Sie eine neue Version eines Dokumentenmappenelements in einer Liste. |
| Wiederherstellen | 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. |
| gelöscht | deleted | Wenn im Ergebnis einer Deltaenumeration vorhanden, gibt an, dass das Element gelöscht wurde. 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 veranschaulicht den Ressourcentyp.
{
"contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
"deleted": { "@odata.type": "microsoft.graph.deleted" },
"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"
}