Partager via


Type de ressource 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.
List collection documentSetVersion Obtenir la liste des versions d’un élément d’ensemble de documents dans une liste.
Create documentSetVersion Create une nouvelle version d’un élément d’ensemble de documents dans une liste.
Restaurer 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"
}