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