Share via

Recurso de lista

  • Artículo

El recurso list representa una lista en un sitio. Este recurso contiene las propiedades de nivel superior de la lista, incluidas las definiciones de plantilla y campo.

Tareas en una lista

Las tareas siguientes están disponibles para los recursos list. Nota: Esta versión beta solo permite navegar por listas, no permite crearlas ni actualizarlas. Sin embargo, puede crear o actualizar elementos de lista.

Todos los ejemplos siguientes son relativos a un sitio, por ejemplo: https://graph.microsoft.com/v1.0/sites/{site-id}.

Tarea común Método HTTP
Obtener lista GET /lists/{list-id}
Enumerar elementos de lista GET /lists/{list-id}/items
Actualizar elemento de lista PATCH /lists/{list-id}/items/{item-id}
Eliminar elemento de lista DELETE /lists/{list-id}/items/{item-id}
Crear elemento de lista POST /lists/{list-id}
Obtener actividades recientes GET /lists/{list-id}/activities

Representación JSON

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

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "displayName": "title of list",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "items": [ { "@odata.type": "microsoft.graph.listItem" } ],
  "list": {
    "@odata.type": "microsoft.graph.listInfo",
    "hidden": false,
    "template": "documentLibrary | genericList | survey | links | announcements | contacts | accessRequest ..."
  },
  "system": false,

  /* inherited from baseItem */
  "id": "string",
  "name": "name of list",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of list",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "webUrl": "url to visit the list in a browser"
}

Propiedades

El recurso list tiene las siguientes propiedades.

Nombre de propiedad Tipo Descripción
displayName string El título que se puede mostrar de la lista.
list listInfo Proporciona detalles adicionales sobre la lista.
system systemFacet Si está presente, indica que se trata de una lista administrada por el sistema. Solo lectura.

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 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 list tiene las siguientes relaciones con otros recursos.

Nombre de la relación Tipo Descripción
activities Colección itemActivity Las actividades recientes que tuvieron lugar en esta lista.
drive drive Solo está presente en bibliotecas de documentos. Permite el acceso a la lista como un recurso drive con objetos driveItems.
items Collection(listItem) Todos los elementos que se incluyen en la lista.
columns Collection(columnDefinition) La colección de definiciones de campo de esta lista.
contentTypes Collection(contentType) La colección de tipos de contenido presentes en esta lista.