Référence OneDrive Work IQ (préversion)

Aperçu

Outils disponibles

getOnedrive

Obtenez des informations sur OneDrive de l’utilisateur, notamment les métadonnées de lecteur, le quota et les informations de propriétaire.

Aucun paramètre requis.

getFolderChildrenInMyOnedrive

Énumère les 20 premiers fichiers et dossiers (DriveItems) contenus dans un dossier parent spécifié dans OneDrive de l’utilisateur.

Paramètres facultatifs :

• parentFolderId : ID du dossier parent dont les fichiers et dossiers sont répertoriés (valeur par défaut : « racine »)

trouverFichierOuDossierDansMonOnedrive

Recherche un fichier ou un dossier (DriveItem) dans la requête OneDrive de l’utilisateur. Plus efficace que de rechercher tous les fichiers accessibles si vous savez que l’élément se trouve dans OneDrive de l’utilisateur.

Paramètres obligatoires :

• searchQuery : Requête de recherche ; peut être l’intégralité ou le nom de fichier partiel

obtenirLesMétadonnéesDuFichierOuDossierDansMonOnedrive

Obtenir les métadonnées d’un fichier ou d’un dossier (DriveItem) à partir de OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier dans OneDrive de l’utilisateur

getFileOrFolderMetadataByUrl

Obtenir les métadonnées d’un fichier ou d’un dossier (DriveItem) à partir d’une URL de partage. Seuls les utilisateurs disposant d’autorisations explicites existantes pour accéder au fichier sont autorisés à obtenir les métadonnées.

Paramètres obligatoires :

• fileOrFolderUrl : URL du fichier ou du dossier. L’URL ne sera pas utilisée pour la partager avec l’utilisateur ; ils doivent déjà avoir un accès explicite

readSmallTextFileFromMyOnedrive

Lisez (téléchargez) un fichier texte à partir de OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileId : ID du fichier (DriveItem) à lire/télécharger

créerPetitFichierTexteDansMonOnedrive

Créez ou chargez un fichier texte de taille inférieure à 5 Mo sur OneDrive de l’utilisateur.

Paramètres obligatoires :

• Fichier: Nom du fichier à créer
• contentText : Contenu texte du fichier

Paramètres facultatifs :

• parentFolderId : ID du dossier parent (valeur par défaut : « racine »)

créerUnDossierDansMonOnedrive

Créez un dossier (DriveItem) dans OneDrive de l’utilisateur en tant qu’enfant du dossier parent spécifié. Si un dossier portant le même nom existe déjà, un suffixe numérique est ajouté (par exemple, NewFolder (1)).

Paramètres obligatoires :

• Foldername: Nom du dossier à créer

Paramètres facultatifs :

• parentFolderId : ID du dossier parent (valeur par défaut : « racine »)

renommerFichierOuDossierDansMonOnedrive

Renommez un fichier ou un dossier (DriveItem) dans OneDrive de l’utilisateur. Le nouveau nom doit se conformer aux conventions d’affectation de noms.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à renommer
• newFileOrFolderName : Nouveau nom du fichier ou du dossier

Paramètres facultatifs :

• ETag: Valeur ETag pour le contrôle de la concurrence. L’opération réussit uniquement si l’ETag actuel de DriveItem correspond à

supprimerFichierOuDossierDansMonOnedrive

Supprimez un fichier ou un dossier (DriveItem) de OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à supprimer

Paramètres facultatifs :

• Etag: Valeur ETag pour le contrôle de la concurrence

partagerFichierOuDossierDansMonOnedrive

Envoie une invitation de partage pour accorder des autorisations de lecture/écriture sur un fichier ou un dossier (DriveItem) dans OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à partager
• recipientEmails : Tableau d’adresses e-mail des destinataires à inviter
• Rôles: Tableau de rôles à attribuer. Valeurs acceptées : 'read', 'write' (le paramètre 'write' accorde à la fois les droits de lecture et d'écriture)

Paramètres facultatifs :

• Message: Message personnalisé à inclure dans l’e-mail d’invitation (par défaut : « Voici le fichier sur lequel nous travaillons. »)
• sendInvitation : Indique s’il faut envoyer une invitation de partage (valeur par défaut : true)

définirLibelléDeConfidentialitéSurFichierDansMonOneDrive

Définissez l’étiquette de confidentialité d’un fichier dans OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileId : ID du fichier (DriveItem)
• sensitivityLabelId : ID de l’étiquette de confidentialité à attribuer, ou une chaîne vide pour la supprimer

Paramètres facultatifs :

• assignmentMethod : Méthode d’affectation : 'standard', 'privileged', 'auto' ou 'unknownFutureValue' (valeur par défaut : 'privileged')
• justificationText : Texte de justification à des fins d’audit ; obligatoire lors de la rétrogradation ou de la suppression d’une étiquette (valeur par défaut : « Modifié par MCPServer »)

créerUnPetitFichierBinaireDansMonOneDrive

Créez un fichier binaire de taille inférieure à 5 Mo en encodant son contenu en base64 vers le OneDrive de l'utilisateur.

Paramètres obligatoires :

• Fichier: Nom du fichier à créer, y compris l’extension de fichier
• base64Content : Contenu de fichier binaire encodé sous forme de chaîne base64

Paramètres facultatifs :

• parentFolderId : ID du dossier parent (valeur par défaut : « racine »)

readSmallBinaryFileFromMyOnedrive

Lit un fichier binaire de taille inférieure à 5 Mo à partir du OneDrive de l'utilisateur. Le contenu du fichier est retourné sous forme de chaîne encodée en base64.

Paramètres obligatoires :

• fileId : ID du fichier (DriveItem) à lire ou télécharger

copierFichierOuDossierDansMonOneDrive

Copiez un fichier ou un dossier (DriveItem) dans un dossier de destination dans le OneDrive de l'utilisateur. Cette opération est asynchrone ; utilisez checkOperationStatusInMyOnedrive pour surveiller la progression.

Paramètres obligatoires :

• sourcefileid : ID du fichier ou dossier source (DriveItem) à copier
• destfolderid : ID du dossier de destination (doit exister dans le OneDrive de l'utilisateur)

Paramètres facultatifs :

• newfilename : Nouveau nom de l’élément copié (valeur par défaut du nom d’origine)

déplacerFichierOuDossierDansMonOnedrive

Déplacez un fichier ou un dossier (DriveItem) vers un dossier de destination dans le OneDrive de l'utilisateur. Cette opération est asynchrone ; utilisez checkOperationStatusInMyOnedrive pour surveiller la progression.

Paramètres obligatoires :

• sourcefileid : ID du fichier ou dossier source (DriveItem) à déplacer
• destfolderid : ID du dossier de destination (doit exister dans le OneDrive de l'utilisateur)

Paramètres facultatifs :

• newfilename : Nouveau nom pour l’élément déplacé (valeur par défaut du nom d’origine)

vérifierLeStatutDeLOpérationDansMonOnedrive

Vérifiez l’état d’une opération asynchrone (telle que la copie ou le déplacement) à l’aide du jeton d’opération retourné par l’opération d’origine. Retourne les informations de progression si elles sont toujours en cours, les détails de l’erreur en cas d’échec, ou les métadonnées finales du fichier ou du dossier s’ils sont terminés avec succès.

Paramètres obligatoires :

• operationToken : Jeton d’opération retourné à partir d’une opération asynchrone comme copyFileOrFolderInMyOnedrive ou moveFileOrFolderInMyOnedrive

Fonctions principales

gestion des OneDrive

• Obtenir des informations sur OneDrive (quota, propriétaire)
• Accéder à OneDrive personnel de l’utilisateur
• Toutes les opérations ciblent oneDrive de l’utilisateur authentifié

Recherche et découverte de fichiers

• Rechercher des fichiers et des dossiers par nom dans OneDrive de l’utilisateur
• Obtenir des métadonnées de fichier ou de dossier par ID ou URL de partage
• Parcourir le contenu du dossier (jusqu’à 20 éléments)

Opérations de fichier

• Créer des fichiers texte et binaires (≤5 Mo)
• Lire des fichiers texte et binaires (≤5 Mo)
• Supprimer des fichiers avec contrôle de concurrence
• Renommer des fichiers avec la protection eTag
• Copier et déplacer des fichiers et des dossiers de manière asynchrone

Gestion des dossiers

• Créer des dossiers avec des chemins parent facultatifs
• Suffixe numérique automatique pour les noms de dossiers en double
• Répertorier le contenu du dossier (jusqu’à 20 éléments)
• Obtenir les métadonnées de dossier
• Supprimer des dossiers avec contrôle de concurrence
• Renommer des dossiers avec la protection eTag

Partage et autorisations

• Partager des fichiers et des dossiers avec des utilisateurs
• Contrôle d’accès en fonction du rôle (lecture, écriture)
• Notifications par e-mail pour le partage
• Messages personnalisés dans les invitations

Sécurité et conformité

• Appliquer et supprimer des étiquettes de confidentialité
• Méthodes d’affectation multiples (standard, privilégié, automatique)
• Prise en charge de la justification de l’audit
• Contrôle de la concurrence avec eTags

Notes

• Toutes les opérations ciblent le OneDrive personnel de l’utilisateur authentifié
• Les opérations de fichier sont limitées à ≤5 Mo pour le chargement et le téléchargement
• Les opérations de suppression et de renommage prennent en charge les eTags pour le contrôle de concurrence.
• Le partage nécessite des adresses e-mail valides et des autorisations appropriées
• Les étiquettes de confidentialité nécessitent une licence et une configuration appropriées
• La liste des dossiers retourne au maximum 20 éléments par défaut