Vous pouvez partager des fichiers et des dossiers Google Drive avec d'autres personnes à l'aide de l' interface utilisateur Drive ou de l' API Google Drive. Lorsque vous partagez un fichier à partir de Drive, vous pouvez décider si les utilisateurs sont autorisés à le modifier, à le commenter ou à l'ouvrir uniquement.
Une clé d'accès à la ressource contribue à protéger votre fichier contre les accès indésirables. Les clés de ressources sont un paramètre supplémentaire transmis afin que les utilisateurs puissent accéder à certains fichiers partagés à l'aide d'un lien. Les utilisateurs qui n'ont jamais consulté le fichier doivent fournir la clé d'accès à la ressource pour pouvoir y accéder. Les personnes qui ont récemment consulté le fichier ou qui disposent d'un accès direct n'ont pas besoin de la clé d'accès à la ressource pour y accéder.
Un fichier Drive partagé avec un lien n'est visible que par les utilisateurs ayant accès au fichier via une ressource permissions
type=user
ou type=group
. Les requêtes des utilisateurs qui n'ont accès qu'à ces fichiers partagés par lien à l'aide d'une autorisation type=domain
ou type=anyone
peuvent nécessiter une clé d'accès à la ressource.
Pour en savoir plus sur les autorisations, consultez Partager des fichiers, des dossiers et des Drive. Pour obtenir la liste complète des rôles et des opérations autorisées par chacun d'eux, consultez la section Rôles et autorisations.
Lire la clé d'accès à la ressource à partir du fichier
L'API Drive renvoie la clé d'accès à la ressource d'un fichier dans le champ resourceKey
en lecture seule de la ressource files
.
Si le fichier est un raccourci Drive, la touche ressource de la cible du raccourci est renvoyée dans le champ shortcutDetails.targetResourceKey
en lecture seule.
Les champs de la ressource files
qui renvoient des URL, tels que exportLinks
, webContentLink
et webViewLink
, incluent également resourceKey
. Les clients qui s'intègrent à l'UI Drive peuvent également utiliser resourceKeys
dans le paramètre state
. Pour en savoir plus, consultez Télécharger et exporter des fichiers.
Définir la clé d'accès à la ressource sur la requête
Les clés de ressources de tous les fichiers référencés par les requêtes adressées à l'API Drive sont définies dans l'en-tête HTTP X-Goog-Drive-Resource-Keys
.
Les requêtes adressées à l'API Drive peuvent spécifier une ou plusieurs clés de ressource avec l'en-tête HTTP X-Goog-Drive-Resource-Keys
.
Syntaxe
Un ID de fichier et une paire de clés de ressource sont définis dans l'en-tête à l'aide d'une barre oblique (/
). L'en-tête est créé en combinant toutes les paires de clés d'ID de fichier et de ressource en les séparant par une virgule (,
).
Prenons l'exemple d'une requête visant à déplacer le fichier fileId1
du dossier fileId2
vers le dossier fileId3
. Supposons que les clés de ressources de ces trois fichiers soient respectivement resourceKey1
, resourceKey2
et resourceKey3
. L'en-tête créé à partir de ces valeurs en utilisant une barre oblique et une virgule comme séparateurs est le suivant:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
Articles associés
- Partager des fichiers, des dossiers et des Drive
- Télécharger et exporter des fichiers
- Protéger le contenu des fichiers
- Configurer l'intégration de l'interface utilisateur Drive