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 siguientes son relativos a una lista, por ejemplo: https://graph.microsoft.com/beta/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 |
Obtener análisis | GET /items/{item-id}/analytics |
Obtener actividades por intervalo | GET /items/{item-id}/getActivitiesByInterval |
Crear | POST /items |
Eliminar | DELETE /items/{item-id} |
Actualizar | PATCH /items/{item-id} |
Actualizar valores de columna | PATCH /items/{item-id}/fields |
createLink | POST /items/{itemId}/createLink |
Enumerar documentSetVersions | GET /items/{item-id}/documentSetVersions |
Creación de documentSetVersion | POST /items/{item-id}/documentSetVersions |
Restauración de documentSetVersion | POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore |
Obtener delta | GET /items/{item-id}/delta |
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. |
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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de