Obtener los metadatos de una lista
Devuelve los metadatos de un recurso list.
Permisos
Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | Sites.Read.All, Sites.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | Sites.Read.All, Sites.ReadWrite.All |
Solicitud HTTP
GET /sites/{site-id}/lists/{list-id}
GET /sites/{site-id}/lists/{list-id}?expand=columns,items(expand=fields)
Cuerpo de solicitud
No proporcione un cuerpo de solicitud con este método.
Ejemplo
Solicitud
GET /sites/{site-id}/lists/{list-id}
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "1234-112-112-4",
"name": "MicroFeed",
"createdDateTime": "2016-08-30T08:32:00Z",
"lastModifiedDateTime": "2016-08-30T08:32:00Z",
"list": {
"hidden": false,
"template": "genericList"
}
}
Con las instrucciones select
y expand
, puede recuperar metadatos de listas, definiciones de columnas y elementos de lista en una sola solicitud.
Solicitud
GET /sites/{site-id}/lists/{list-id}?select=id,name,lastModifiedDateTime&expand=columns(select=name,description),items(expand=fields(select=Name,Color,Quantity))
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "1234-112-112-4",
"name": "Inventory",
"lastModifiedDateTime": "2016-08-30T08:32:00Z",
"columns": [
{
"name": "Name",
"description": "Customer-facing name of the SKU"
},
{
"name": "Color",
"description": "Color of the item in stock"
},
{
"name": "Quantity",
"description": "Number of items in stock"
}
],
"items": [
{
"id": "2",
"fields": {
"Name": "Gadget",
"Color": "Red",
"Quantity": 503
}
},
{
"id": "4",
"fields": {
"Name": "Widget",
"Color": "Blue",
"Quantity": 2357
}
},
{
"id": "7",
"fields": {
"Name": "Gizmo",
"Color": "Green",
"Quantity": 92
}
}
]
}