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