Ressurce ListItem

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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 tâches suivantes peuvent être exécutées sur les ressources listItem. Tous les exemples ci-dessous concernent une liste, par exemple : https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Tâche courante	Méthode HTTP
Get	GET /items/{item-id}
Obtenir des valeurs de colonne	GET /items/{item-id}?expand=fields
Obtenir les données analytiques	GET /items/{item-id}/analytics
Obtenir des activités par intervalle	GET /items/{item-id}/getActivitiesByInterval
Créer	POST /items
Supprimer	DELETE /items/{item-id}
Mettre à jour	PATCH /items/{item-id}
Mettre à jour les valeurs des colonnes	PATCH /items/{item-id}/fields
createLink	POST /items/{itemId}/createLink
Répertorier documentSetVersions	GET /items/{item-id}/documentSetVersions
Créer documentSetVersion	POST /items/{item-id}/documentSetVersions
Restaurer documentSetVersion	POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore
Obtenir delta	GET /items/{item-id}/delta

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.

Nom de la propriété	Type	Description
id	string	Identificateur unique de l’élément. En lecture seule.
name	string	Nom/titre 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 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

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