Ressource ListItem
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. |