listItem-Ressourcentyp
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. |
| List | documentSetVersion-Sammlung | Ruft eine Liste der Versionen eines Dokumentenmappenelements in einer Liste ab. |
| Create | documentSetVersion | Create 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. |
| 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 zeigt den Ressourcentyp.
{
"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"
}