Partager via

Ressource List

  • Article

La ressource list représente une liste dans un site. Cette ressource contient les propriétés de niveau supérieur de la liste, y compris les définitions de modèle et de champ.

Tâches dans une liste

Les tâches suivantes peuvent être exécutées sur les ressources list. Remarque : cette version bêta vous permet uniquement d’accéder aux listes. Vous ne pouvez pas en créer ni les mettre à jour. Toutefois, vous pouvez créer ou mettre à jour des éléments de liste.

Tous les exemples ci-dessous concernent un site, par exemple : https://graph.microsoft.com/v1.0/sites/{site-id}.

Tâche courante Méthode HTTP
Obtenir une liste GET /lists/{list-id}
Énumérer les éléments de liste GET /lists/{list-id}/items
Mettre à jour l’élément de la liste PATCH /lists/{list-id}/items/{item-id}
Supprimer l’élément de liste DELETE /lists/{list-id}/items/{item-id}
Créer un élément de liste POST /lists/{list-id}
Obtenir les activités récentes GET /lists/{list-id}/activities

Représentation JSON

Voici une représentation JSON de la ressource 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"
}

Propriétés

La ressource list possède les propriétés suivantes.

Nom de la propriété Type Description
displayName string Titre affichable de la liste.
list listInfo Fournit des informations supplémentaires sur la liste.
system systemFacet Indique s’il s’agit d’une liste gérée par le système, le cas échéant. En lecture seule.

Les propriétés suivantes sont héritées de la ressource baseItem.

Nom de la propriété Type Description
id string Identificateur unique de l’élément. En lecture seule.
name string Nom de l’élément.
createdBy identitySet Identité du créateur de cet élément. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de l’élément. En lecture seule.
description string Description de l’élément.
eTag string ETag pour l’élément. En lecture seule.
lastModifiedBy identitySet Identité du dernier modificateur de cet élément. En lecture seule.
lastModifiedDateTime DateTimeOffset Date et heure de dernière modification de l’élément. En lecture seule.
parentReference itemReference Informations de l’élément parent, si l’élément possède un parent. En lecture-écriture.
sharepointIds sharepointIds Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.
webUrl chaîne (URL) URL qui affiche l’élément dans le navigateur. En lecture seule.

Relations

La ressource list a les relations suivantes avec les autres ressources.

Nom de la relation Type Description
activities Collection itemActivity Activités récentes qui ont eu lieu au sein de cette liste.
lecteur drive Présent uniquement dans les bibliothèques de documents. Permet d’accéder à la liste comme s’il s’agissait d’une ressource drive avec les ressources driveItem.
items Collection(listItem) Tous les éléments contenus dans le lecteur.
colonnes Collection(columnDefinition) Collection des définitions de champ pour cette liste.
contentTypes Collection(contentType) Collection de types de contenu présents dans cette liste.