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 du l'interface utilisateur de Drive ou via le API Google Drive. Lorsque vous partagez du contenu depuis dans Drive, vous pouvez décider si les utilisateurs sont autorisés à modifier, commenter ouvrir uniquement le fichier.

Une clé d'accès à la ressource contribue à protéger votre fichier contre les accès indésirables. Clés de ressource sont un paramètre supplémentaire transmis afin que les utilisateurs puissent accéder à certains fichiers qui ont été partagées à l'aide d'un lien. Utilisateurs qui n'ont jamais consulté le fichier auparavant doit fournir la clé d'accès à la ressource. Les utilisateurs qui ont récemment consulté le ou disposent d'un accès direct, n'ont pas besoin de la clé de ressource pour accéder au fichier.

Un fichier Drive partagé au moyen d'un lien n'est visible que par Utilisateurs pouvant accéder au fichier en raison d'une erreur type=user ou type=group Ressource permissions. Demandes des utilisateurs qui n'ont accès qu'à ces fichiers partagés par lien à l'aide d'un type=domain ou L'autorisation type=anyone peut 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, 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 en lecture seule Champ resourceKey de la ressource files.

S'il s'agit d'un raccourci Drive, une clé d'accès à la ressource pour la cible de raccourci est renvoyée sur le lecteur shortcutDetails.targetResourceKey.

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

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

Clés de ressources pour tous les fichiers référencés par des requêtes à 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 tous les ID de fichier et les ressources paires de clés en utilisant une virgule (,) comme séparateur.

Prenons l'exemple d'une requête visant à déplacer le fichier fileId1 du dossier fileId2 vers dossier fileId3. Supposons que les clés de ressources de ces trois fichiers soient resourceKey1, resourceKey2 et resourceKey3, respectivement. L'en-tête construit à partir de ces valeurs en utilisant une barre oblique et une virgule comme séparateurs est:

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