Partager via

Type de ressource itemReference

  • Article

Espace de noms: microsoft.graph

La ressource itemReference fournit les informations nécessaires pour traiter un driveItem ou un listItem via l’API.

Propriétés

Propriété Type Description
driveId Chaîne Identificateur unique de l’instance de lecteur qui contient l’élément driveItem. Retourné uniquement si l’élément se trouve dans un lecteur. En lecture seule.
driveType String Identifie le type de lecteur. Retourné uniquement si l’élément se trouve dans un lecteur. Pour connaître les valeurs, reportez-vous à la rubrique relative à la ressource drive.
id Chaîne Identificateur unique de l’élément driveItem dans le lecteur ou d’un listItem dans une liste. En lecture seule.
name String Nom de l’élément référencé. En lecture seule.
chemin Chaîne Chemin codé en pourcentage qui peut être utilisé pour accéder à l’élément. En lecture seule.
shareId String Identificateur unique pour une ressource partagée accessible via l’API Partages.
sharepointIds sharepointIds Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.
siteId Chaîne Pour OneDrive Entreprise et SharePoint, cette propriété représente l’ID du site qui contient la bibliothèque de documents parente de la ressource driveItem ou la liste parente de la ressource listItem. La valeur est identique à la propriété id de cette ressource de site . Il s’agit d’une chaîne opaque qui se compose de trois identificateurs du site.
Pour OneDrive, cette propriété n’est pas renseignée.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "driveId": "string",
  "driveType": "personal | business | documentLibrary",
  "id": "string",
  "name": "string",
  "path": "string",
  "shareId": "string",
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteId": "string"
}

Remarques

Pour déterminer l’adresse d’un driveItem à partir d’une ressource itemReference, créez une URL au format :

GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{id}

La valeur du chemin d’accès est un chemin d’API encodé en pourcentage par rapport au lecteur cible, par exemple : /drive/root:/Documents/my%20file.docx.

Pour récupérer le chemin d’accès explicite pour une barre de navigation, vous pouvez tout ignorer jusqu’au premier : de la chaîne path.