ListItem-RessourceListItem resource

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Diese Ressource stellt ein Element in einer SharePoint-[Liste][] dar.This resource represents an item in a SharePoint list. Spaltenwerte in der Liste sind über das fieldValueSet-Wörterbuch verfügbar.Column values in the list are available through the fieldValueSet dictionary.

Aufgaben zu einem listItemTasks on a listItem

Die folgenden Aufgaben sind für listItem-Ressourcen verfügbar.The following tasks are available for listItem resources. Alle Beispiele unten beziehen sich auf eine [Liste][], z. B.: https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.All examples below are relative to a list, eg: https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Häufige AufgabenCommon task HTTP-MethodeHTTP method
GetGet GET /items/{item-id}GET /items/{item-id}
Abrufen von SpaltenwertenGet column values GET /items/{item-id}?expand=fieldsGET /items/{item-id}?expand=fields
Analysen abrufenGet analytics /Items/{Item-ID}/Analytics abrufenGET /items/{item-id}/analytics
Aktivitäten nach Intervall abrufenGet activities by interval /Items/{Item-ID}/getActivitiesByInterval abrufenGET /items/{item-id}/getActivitiesByInterval
CreateCreate POST /itemsPOST /items
DeleteDelete DELETE /items/{item-id}DELETE /items/{item-id}
UpdateUpdate PATCH /items/{item-id}PATCH /items/{item-id}
Aktualisieren von SpaltenwertenUpdate column values PATCH /items/{item-id}/fieldsPATCH /items/{item-id}/fields

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer listItem-Ressource.Here is a JSON representation of a listItem resource.

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

EigenschaftenProperties

Die listItem-Ressource weist folgende Eigenschaften auf.The listItem resource has the following properties.

EigenschaftsnameProperty name TypType BeschreibungDescription
contentTypecontentType contentTypeInfocontentTypeInfo Der Inhaltstyp dieses ListenelementsThe content type of this list item

Die folgenden Eigenschaften werden von baseItem geerbt.The following properties are inherited from baseItem.

EigenschaftennameProperty name TypType BeschreibungDescription
idid Zeichenfolgestring Der eindeutige Bezeichner des Elements. Schreibgeschützt.The unique identifier of the item. Read-only.
namename stringstring Der Name/Titel des Elements.The name / title of the item.
createdBycreatedBy identitySetidentitySet Die Identität des Erstellers dieses Elements.Identity of the creator of this item. Schreibgeschützt.Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.The date and time the item was created. Read-only.
descriptiondescription stringstring Der beschreibende Text für das Element.The descriptive text for the item.
eTageTag stringstring ETag für das Element. Schreibgeschützt.ETag for the item. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Die Identität derPerson, die dieses Element zuletzt geändert hat.Identity of the last modifier of this item. Schreibgeschützt.Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.The date and time the item was last modified. Read-only.
parentReferenceparentReference itemReferenceitemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.Parent information, if the item has a parent. Read-write.
sharepointIdssharepointIds sharepointIdssharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.Returns identifiers useful for SharePoint REST compatibility. Read-only.
webUrlwebUrl String (URL)string (url) URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the item in the browser. Read-only.

BeziehungenRelationships

Die listItem-Ressource weist folgende Beziehungen zu anderen Ressourcen auf.The listItem resource has the following relationships to other resources.

BeziehungsnameRelationship name TypType BeschreibungDescription
Aktivitätenactivities ItemActivity-SammlungitemActivity collection Die Liste der letzten Aktivitäten, die für dieses Element durchgeführt wurden.The list of recent activities that took place on this item.
Analysenanalytics itemAnalytics-RessourceitemAnalytics resource Analysen zu den Anzeigeaktivitäten, die auf diesem Element stattgefunden haben.Analytics about the view activities that took place on this item.
driveItemdriveItem driveItemdriveItem Für Dokumentbibliotheken macht die DriveItem Beziehung das ListItem als ** DriveItem** verfügbarFor document libraries, the driveItem relationship exposes the listItem as a driveItem
fieldsfields fieldValueSetfieldValueSet Die Werte der für dieses Listenelement festgelegten Spalte.The values of the columns set on this list item.
Versionenversions listItemVersion-SammlunglistItemVersion collection Die Liste der früheren Versionen des Listenelements.The list of previous versions of the list item.