Accéder aux fichiers Drive partagés par lien à l'aide de clés de ressource

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éterminer si les utilisateurs sont autorisés à le modifier, le commenter ou uniquement à l'ouvrir.

Une clé d'accès à la ressource permet de protéger votre fichier contre les accès indésirables. Les clés d'accès à la ressource sont un paramètre supplémentaire transmis pour que les utilisateurs puissent accéder à certains fichiers partagés à l'aide d'un lien. Les utilisateurs n'ayant pas consulté le fichier auparavant doivent fournir la clé d'accès à la ressource pour y accéder. Ceux 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 ne peut être découvert que par les utilisateurs qui peuvent y accéder en raison d'une ressource type=user ou type=group permissions. Les requêtes des utilisateurs qui n'ont accès à ces fichiers partagés par lien qu'avec 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 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 en lecture seule resourceKey de la ressource files.

Si le fichier est un raccourci Drive, la clé d'accès à la ressource de la cible du raccourci est renvoyée dans le champ en lecture seule shortcutDetails.targetResourceKey.

Les champs de la ressource files qui renvoient des URL, tels que exportLinks, webContentLink, et webViewLink, incluent également la resourceKey. Les clients qui s'intègrent à l'interface utilisateur Drive peuvent également utiliser resourceKeys dans le state paramètre. Pour en savoir plus, consultez Télécharger et exporter des fichiers.

Définir la clé d'accès à la ressource dans la requête

Les clés d'accès à la ressource pour 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 d'accès à la ressource avec l'en-tête HTTP X-Goog-Drive-Resource-Keys.

Syntaxe

Une paire d'ID de fichier et de clé d'accès à la ressource est définie dans l'en-tête à l'aide d'une barre oblique (/) comme séparateur. L'en-tête est créé en combinant toutes les paires d'ID de fichier et de clé d'accès à la ressource à l'aide de virgules (,) comme séparateurs.

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 d'accès à la ressource pour ces trois fichiers soient respectivement resourceKey1, resourceKey2 et resourceKey3. L'en-tête créé à partir de ces valeurs à l'aide d'une barre oblique et de virgules comme séparateurs est le suivant :

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3