listItem-RessourcelistItem resource

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.

MethodenMethods

Die folgenden Methoden sind für listItem-Ressourcen verfügbar.The following methods are available for listItem resources. Alle Beispiele beziehen sich auf eine [Liste][]: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.All examples are relative to a list: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

MethodeMethod RückgabetypReturn Type BeschreibungDescription
GetGet lisItemlisItem Element in einer Liste abrufen.Get an item in a list.
Abrufen von SpaltenwertenGet column values listItemlistItem Abrufen von Spaltenwerten aus listItem.Get column values from listItem.
Analysen abrufenGet analytics itemAnalyticsitemAnalytics Abrufen von Analysen für diese Ressource.Get analytics for this resource.
Aktivitäten nach Intervall abrufenGet activities by interval itemActivityStatitemActivityStat Eine Sammlung von itemActivityStats innerhalb des angegebenen Zeitintervalls abrufen.Get a collection of itemActivityStats within the specified time interval.
[Erstellen][]Create listItemlistItem Erstellen Sie ein neues listItem in einer Liste.Create a new listItem in a list.
LöschenDelete Kein InhaltNo Content Entfernt ein Element aus einer Liste.Removes an item from a list.
UpdateUpdate fieldValueSetfieldValueSet Aktualisieren Sie die Eigenschaften in einem listItem.Update the properties on a listItem.
Aktualisieren von SpaltenwertenUpdate column values fieldValueSetfieldValueSet Aktualisieren Sie die Spaltenwerte in einem listItem.Update column values on a listItem.

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.

EigenschaftsnameProperty name TypType BeschreibungDescription
idid stringstring 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.

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