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
List collection listItem Obtenez la collection d’éléments dans une liste.
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 les activités récentes Collection itemActivity Répertorier les activités récentes qui ont eu lieu sur un lecteur, une liste, un élément ou dans une hiérarchie d’éléments.
Obtenir les valeurs des colonnes listItem Obtenir les valeurs de colonne pour listItem.
Mettre à jour les valeurs des colonnes fieldValueSet Mettre à jour les valeurs de colonne d’une listItem.
Indiquer 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 de l’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 Restaurer l’élément de l’ensemble de documents à une version spécifique.
Obtenir delta collection listItem Obtenez des éléments de liste nouvellement créés, mis à jour ou supprimés sans avoir à effectuer une lecture complète de la collection entière d’éléments.
Répertorier les autorisations autorisation Obtenir une liste des objets d’autorisation associés à un listItem.
Autorisations de création autorisation Créez un objet d’autorisation sur un listItem.
Obtenir une autorisation autorisation Obtenir une liste des objets d’autorisation associés à un listItem.
Mettre à jour une autorisation autorisation Mettre à jour un objet d’autorisation sur un listItem.
Supprimer une autorisation Aucun Supprimez un objet d’autorisation sur un 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 d’un ensemble de documents Version 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"
}
  • Last updated on