Compartir a través de


Elementos de lista

Espacio de nombres: microsoft.graph

Obtenga la colección de elementos en un recurso list.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Sites.Read.All Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Sites.Read.All Sites.ReadWrite.All

Solicitud HTTP

GET /sites/{site-id}/lists/{list-id}/items
GET /sites/{site-id}/lists/{list-id}/items?expand=fields
GET /sites/{site-id}/lists/{list-id}/items?expand=fields(select=Column1,Column2)

Parámetros de consulta opcionales

Este método admite y $filter$expand de los parámetros de consulta de OData para ayudar a personalizar la respuesta.

Uso del parámetro de consulta $filter

Puede aplicar el $filter parámetro de consulta (eq, ne, lt, gtle, gey startswith) para obtener un subconjunto de la colección listItem. Tanto las propiedades como los campos listItem se pueden filtrar. Al filtrar por campos indizados, el servicio solo puede filtrar un campo indexado a la vez.

Nota:

El filtrado funciona mejor en columnas indizadas.

En función del número de elementos que coinciden con la condición de filtrado, los resultados se devuelven todos a la vez o en varias páginas. Para obtener más información, vea Paginación de los datos de Microsoft Graph en su aplicación.

Encabezados de solicitud

Nombre Descripción
Autorización {code} del portador. Necesario.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y una colección de objetos listItem en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Obtener elementos de lista con campos específicos

En el ejemplo siguiente se muestra cómo obtener una colección listItem con campos específicos mediante el parámetro de $expand consulta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/243bca4b-4e5e-45af-b37d-25f6135a740d/items?expand=fields(select=Name,Color,Quantity)

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "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
       }
    }
  ]
}

Ejemplo 2: Obtención de elementos de lista filtrados con campos específicos

En el ejemplo siguiente se muestra cómo obtener una colección listItem filtrada por el campo Quantity con campos específicos mediante el parámetro de $expand consulta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/243bca4b-4e5e-45af-b37d-25f6135a740d/items?expand=fields(select=Name,Color,Quantity)&$filter=fields/Quantity lt 600

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "2",
      "fields": {
        "Name": "Gadget",
        "Color": "Red",
        "Quantity": 503
       }
    },
    {
      "id": "7",
      "fields": {
        "Name": "Gizmo",
        "Color": "Green",
        "Quantity": 92
       }
    }
  ]
}