Ressource List

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.