Ressurce ListItem

Espace de noms: microsoft.graph

Correspond à un élément dans une liste SharePoint.

Tous les éléments d’une bibliothèque de documents SharePoint peuvent être représentés sous la forme d’une ressource listItem ou driveItem.

Les valeurs des colonnes de la liste sont disponibles dans le dictionnaire fieldValueSet.

Méthodes

Les méthodes suivantes sont disponibles pour les ressources ListItem. Tous les exemples concernent une liste : https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Méthode	Type renvoyé	Description
Obtenir	listItem	Obtenir un élément dans une liste
Obtenir des valeurs de colonne	listItem	Obtenir les valeurs de colonne pour listItem.
Obtenir les données analytiques	itemAnalytics	Obtenir les données analytiques pour cette ressource.
Obtenir des activités par intervalle	itemActivityStat	Obtenir une collection d’itemActivityStats dans l’intervalle de temps spécifié.
Create	listItem	Créer une ressource listItem dans une liste.
Delete	Aucun contenu	Supprimer un élément d’une liste.
Update	fieldValueSet	Mettre à jour les propriétés sur une listItem.
Mettre à jour les valeurs des colonnes	fieldValueSet	Mettre à jour les valeurs de colonne d’une listItem.
Répertorier documentSetVersions	collection documentSetVersion	Obtenir la liste des versions d’un élément d’ensemble de documents dans une liste.
Créer documentSetVersion	documentSetVersion	Créez une nouvelle version d’un élément d’ensemble de documents dans une liste.
Restaurer documentSetVersion	Aucun contenu	Restaurez l’élément d’ensemble de documents vers une version spécifique.
Obtenir delta	collection listItem	Obtenez les éléments de liste nouvellement créés, mis à jour ou supprimés sans avoir à effectuer une lecture complète de l’ensemble de la collection d’éléments.

Propriétés

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

Propriété	Type	Description
contentType	contentTypeInfo	Type de contenu de l’élément de cette liste.

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

Propriété	Type	Description
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.
id	string	Identificateur unique de 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.
name	string	Nom/titre de l’élément.
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 listItem a les relations suivantes avec les autres ressources.

Relation	Type	Description
activities	Collection itemActivity	Liste des activités qui ont récemment eu lieu sur cet élément.
analytics	Ressource itemAnalytics	Données analytiques sur l’affichage des activités effectuées sur ce site.
documentSetVersions	collection documentSetVersion	Informations de version pour une version d’ensemble de documents créée par un utilisateur.
driveItem	driveItem	Pour les bibliothèques de documents, la relation driveItem présente la ressource listItem comme une ressource driveItem
fields	fieldValueSet	Valeurs des colonnes définies sur cet élément de liste.
versions	Collection listItemVersion	Liste des versions précédentes de l’élément de liste.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "documentSetVersions": [{"@odata.type": "microsoft.graph.documentSetVersion"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}