Recurso ListItem

  • Artículo

Este recurso representa un elemento en una lista de SharePoint. Los valores de columna de la lista están disponibles a través del diccionario fieldValueSet.

Tareas en un recurso listItem

Las tareas siguientes están disponibles para los recursos listItem. Todos los ejemplos siguientes son relativos a una lista, por ejemplo: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Tarea común Método HTTP
Obtener GET /items/{item-id}
Obtener valores de columna GET /items/{item-id}?expand=fields
Crear POST /items
Eliminar DELETE /items/{item-id}
Actualizar PATCH /items/{item-id}
Actualizar valores de columna PATCH /items/{item-id}/fields

Representación JSON

A continuación se incluye una representación JSON del recurso listItem.

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

Propiedades

El recurso listItem tiene las siguientes propiedades.

Nombre de propiedad Tipo Descripción
contentType contentTypeInfo El tipo de contenido de este elemento de lista

Las siguientes propiedades se heredan de baseItem.

Nombre de propiedad Tipo Descripción
id cadena El identificador único del elemento. Solo lectura.
name string Nombre o título del elemento.
createdBy identitySet Identidad del creador de este elemento. Solo lectura.
createdDateTime DateTimeOffset La fecha y la hora de creación del elemento. Solo lectura.
description string Texto descriptivo del elemento.
eTag string ETag para el elemento. Solo lectura.
lastModifiedBy identitySet Identidad del usuario que modificó por última vez este elemento. Solo lectura.
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación del elemento. Solo lectura.
parentReference itemReference Información primaria, si el elemento tiene un elemento primario. Lectura y escritura.
sharepointIds sharepointIds Devuelve los identificadores útiles para la compatibilidad con REST de SharePoint. Solo lectura.
webUrl string (url) Dirección URL que muestra el elemento en el explorador. Solo lectura.

Relaciones

El recurso listItem tiene las siguientes relaciones con otros recursos.

Nombre de la relación Tipo Descripción
activities Colección itemActivity Lista de actividades recientes que tuvieron lugar en este elemento.
driveItem driveItem Para bibliotecas de documentos, la relación driveItem expone el recurso listItem como un recurso driveItem
fields fieldValueSet Los valores de las columnas establecidos en este elemento de lista.
versions Colección listItemVersion La lista de versiones anteriores del elemento.