Tipo de recurso listItem

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa un elemento en una lista de SharePoint.

Todos los elementos de una biblioteca de documentos de SharePoint se pueden representar como un recurso listItem o driveItem.

Los valores de columna de la lista están disponibles a través del diccionario fieldValueSet.

Métodos

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

Método	Tipo de valor devuelto	Descripción
Crear	listItem	Crear un nuevo recurso listItem en una lista.
Obtener	listItem	Obtener un elemento en una lista.
Actualizar	fieldValueSet	Actualizar las propiedades de un recurso listItem.
Eliminar	Sin contenido	Elimina un elemento de una lista.
Obtener análisis	itemAnalytics	Obtener análisis para este recurso.
Obtener valores de columna	listItem	Obtener los valores de las columnas de un recurso listItem.
Actualizar valores de columna	fieldValueSet	Actualizar los valores de las columnas de un recurso listItem.
Lista de la versión del conjunto de documentos	colección documentSetVersion	Obtenga una lista de las versiones de un elemento de conjunto de documentos de una lista.
Creación de una versión del conjunto de documentos	documentSetVersion	Cree una nueva versión de un elemento de conjunto de documentos en una lista.
Restauración de la versión del conjunto de documentos	Sin contenido	Restaure el elemento del conjunto de documentos en una versión específica.
Obtener delta	colección listItem	Obtenga elementos de lista recién creados, actualizados o eliminados sin tener que realizar una lectura completa de toda la colección de elementos.
Enumerar permisos	permission	Obtenga una lista de los objetos de permiso asociados a un listItem.
Crear permiso	permission	Obtenga una lista de los objetos de permiso asociados a un listItem.
Obtener permiso	permission	Cree un nuevo objeto de permiso en un objeto listItem.
Actualizar permiso	permission	Actualice un objeto de permiso en un objeto listItem.
Eliminar permiso	Ninguno	Elimine un objeto de permiso en un objeto listItem.

Propiedades

El recurso listItem tiene las siguientes propiedades.

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.

Relación	Tipo	Descripción
activities	Colección itemActivity	Lista de actividades recientes que tuvieron lugar en este elemento.
analytics	Recurso itemAnalytics	Análisis de las actividades de la vista que sucedieron en este elemento.
documentSetVersions	colección documentSetVersion	Información de versión de una versión del conjunto de documentos creada por un usuario.
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.
permissions	Colección permission	El conjunto de permisos del elemento. Solo lectura. Admite valores NULL.
versions	Colección listItemVersion	La lista de versiones anteriores del elemento.

Representación JSON

La siguiente es una representación JSON del recurso

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