Compartir a través de


Tipo de recurso listItem

Espacio de nombres: microsoft.graph

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

Los métodos siguientes están disponibles para los recursos listItem. Todos los ejemplos son relativos a una lista: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Método Tipo de valor devuelto Descripción
Obtener listItem Obtener un elemento en una lista.
Obtener valores de columna listItem Obtener los valores de las columnas de un recurso listItem.
Obtener análisis itemAnalytics Obtener análisis para este recurso.
Obtener actividades por intervalo itemActivityStat Obtener una colección de itemActivityStats dentro del intervalo de tiempo especificado.
Crear listItem Crear un nuevo recurso listItem en una lista.
Eliminar Sin contenido Elimina un elemento de una lista.
Actualizar fieldValueSet Actualizar las propiedades de un recurso listItem.
Actualizar valores de columna fieldValueSet Actualizar los valores de las columnas de un recurso listItem.
Lista colección documentSetVersion Obtenga una lista de las versiones de un elemento de conjunto de documentos de una lista.
Crear documentSetVersion Create una nueva versión de un elemento de conjunto de documentos en una lista.
Restaurar 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.

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.

Propiedad Tipo Descripción
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.
id cadena El identificador único del 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.
name string Nombre o título del elemento.
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.
versions Colección listItemVersion La lista de versiones anteriores del elemento.

Representación JSON

La siguiente representación JSON muestra el tipo de 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"
}