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"
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour