Share via

Ressource ListItem

  • Article

Cette ressource représente un élément d’une liste SharePoint. Les valeurs des colonnes de la liste sont disponibles dans le dictionnaire fieldValueSet.

Tâches disponibles pour une ressource listItem

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/v1.0/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
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

Représentation JSON

Voici une représentation JSON de la ressource listItem.

{
  "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"}],
  "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"
}

Propriétés

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

Nom de la 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.

Nom de la relation Type Description
activities Collection itemActivity Liste des activités qui ont récemment eu lieu sur cet élément.
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.