Type de ressource 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 sont relatifs à une liste ; par exemple, https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.
| Méthode | Type renvoyé | Description |
|---|---|---|
| Create | listItem | Créer une ressource listItem dans une liste. |
| Obtenir | listItem | Obtenir un élément dans une liste |
| Update | fieldValueSet | Mettre à jour les propriétés sur une listItem. |
| Delete | Aucun contenu | Supprimer un élément d’une liste. |
| Obtenir les données analytiques | itemAnalytics | Obtenir les données analytiques pour cette ressource. |
| Obtenir des valeurs de colonne | listItem | Obtenir les valeurs de colonne pour listItem. |
| Mettre à jour les valeurs des colonnes | fieldValueSet | Mettre à jour les valeurs de colonne d’une listItem. |
| Lister la version de l’ensemble de documents | collection documentSetVersion | Obtenir la liste des versions d’un élément d’ensemble de documents dans une liste. |
| Créer une version d’ensemble de documents | documentSetVersion | Créez une nouvelle version d’un élément d’ensemble de documents dans une liste. |
| Restaurer la version de l’ensemble de documents | 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. |
| Répertorier les autorisations | autorisation | Obtenez la liste des objets d’autorisation associés à un objet listItem. |
| Créer une autorisation | autorisation | Obtenez la liste des objets d’autorisation associés à un objet listItem. |
| Obtenir une autorisation | autorisation | Créez un objet d’autorisation sur un objet listItem. |
| Mettre à jour une autorisation | autorisation | Mettre à jour un objet d’autorisation sur un objet listItem. |
| Supprimer une autorisation | Aucune | Supprimer un objet d’autorisation sur un objet listItem. |
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. |
| autorisations | collection permission | Ensemble d’autorisations pour l’élément. En lecture seule. Pouvant accepter la valeur Null. |
| 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"
}