Ce guide contient des tâches liées à la gestion des Drive partagés, comme la création de Drive partagés et la gestion des membres et des autorisations, à l'aide de l'API Google Drive.
Pour en savoir plus sur les limites applicables aux dossiers dans les Drive partagés, consultez Limites applicables aux dossiers.
Créer des Drive partagés
Pour créer un Drive partagé, utilisez la méthode drives.create
.
Java
Python
Node.js
PHP
.NET
Les appels à la méthode drives.create
sont idempotents.
Le paramètre requestId
identifie la tentative logique de création du lecteur partagé. Si la requête expire ou renvoie une erreur de backend indéterminée, la même requête peut être répétée. Le requestId
et le corps de la requête doivent rester identiques.
Si le Drive partagé a été créé avec succès lors d'une requête précédente ou en raison d'une nouvelle tentative, la réponse normale est renvoyée. Parfois, par exemple après une longue période ou si le corps de la requête a changé, une erreur 409
peut être renvoyée, indiquant que le requestId
doit être supprimé.
Ajouter ou supprimer des membres d'un Drive partagé
Ajoutez ou supprimez des membres d'un Drive partagé à l'aide de la ressource permissions
.
Pour ajouter un membre, créez l'autorisation sur le Drive partagé. Les méthodes d'autorisation peuvent également être utilisées sur des fichiers individuels d'un Drive partagé pour accorder des droits supplémentaires aux membres ou permettre aux non-membres de collaborer sur des éléments spécifiques.
Pour en savoir plus et obtenir des exemples de code, consultez Partager des fichiers, des dossiers et des Drive.
Supprimer un Drive partagé
Utilisez la méthode drives.delete
pour supprimer un lecteur partagé. Avant de supprimer un Drive partagé, vous devez placer tout son contenu dans la corbeille ou le supprimer.
Gérer les Drive partagés pour les administrateurs de domaine
Appliquez le paramètre useDomainAdminAccess
avec les ressources drives
et permissions
pour gérer les Drive partagés dans une organisation.
Les utilisateurs qui appellent ces méthodes avec useDomainAdminAccess=true
doivent disposer du droit d'administrateur Drive and Docs
.
Les administrateurs peuvent rechercher des Drive partagés ou mettre à jour les autorisations des Drive partagés appartenant à leur organisation, quelle que soit leur appartenance à un Drive partagé donné.
Récupérer un Drive partagé sans organisateur
L'exemple suivant montre comment utiliser ces ressources pour récupérer des lecteurs partagés qui n'ont plus d'organisateur.
Java
Python
Node.js
PHP
.NET
Empêcher les utilisateurs de télécharger, d'imprimer ou de copier votre fichier
Vous pouvez limiter la façon dont les utilisateurs peuvent télécharger, imprimer et copier des fichiers dans les Drives partagés.
Pour déterminer si l'utilisateur peut modifier les restrictions de téléchargement appliquées par l'organisateur d'un Drive partagé, cochez le champ booléen capabilities.canChangeDownloadRestriction
. Si capabilities.canChangeDownloadRestriction
est défini sur true
, des restrictions de téléchargement peuvent être appliquées au Drive partagé. Pour en savoir plus, consultez Comprendre les fonctionnalités des fichiers.
La ressource drives
contient une collection de champs booléens restrictions
permettant d'indiquer si une action peut être effectuée sur un Drive partagé.
Les restrictions s'appliquent à un Drive partagé ou aux éléments qu'il contient.
Les restrictions peuvent être définies à l'aide de la méthode drives.update
.
Pour appliquer des restrictions de téléchargement à un Drive partagé, un administrateur de Drive partagé peut définir le champ restrictions.downloadRestriction
de la ressource drives
à l'aide de l'objet DownloadRestriction
.
Si vous définissez le champ booléen restrictedForReaders
sur true
, vous indiquez que le téléchargement et la copie sont restreints pour les lecteurs. Si vous définissez le champ booléen restrictedForWriters
sur true
, vous indiquez que le téléchargement et la copie sont restreints pour les rédacteurs. Notez que si le champ restrictedForWriters
est défini sur true
, le téléchargement et la copie sont également limités pour les lecteurs. De même, définir restrictedForWriters
sur true
et restrictedForReaders
sur false
revient à définir restrictedForWriters
et restrictedForReaders
sur true
.
Rétrocompatibilité.
Avec l'introduction de l'objet DownloadRestriction
, la fonctionnalité du champ booléen restrictions.copyRequiresWriterPermission
a été mise à jour.
Maintenant, en définissant restrictions.copyRequiresWriterPermission
sur true
, le champ booléen restrictedForReaders
de l'objet DownloadRestriction
est défini sur true
pour indiquer que le téléchargement et la copie sont restreints pour les lecteurs.
Si vous définissez le champ copyRequiresWriterPermission
sur false
, les champs restrictedForWriters
et restrictedForReaders
sont également définis sur false
. Cela signifie que les paramètres de restriction de téléchargement ou de copie sont supprimés pour tous les utilisateurs.
Champs qui contrôlent les fonctionnalités de téléchargement, d'impression et de copie
Le tableau suivant liste les champs de ressources drives
qui affectent les fonctionnalités de téléchargement, d'impression et de copie :
Champ | Description | Version |
---|---|---|
capabilities.canCopy |
Indique si l'utilisateur actuel peut copier des fichiers dans un Drive partagé. | v2 et v3 |
capabilities.canDownload |
Indique si l'utilisateur actuel peut télécharger des fichiers dans un Drive partagé. | v2 et v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Indique si l'utilisateur actuel peut modifier la restriction copyRequiresWriterPermission d'un Drive partagé. |
v2 et v3 |
capabilities.canResetDriveRestrictions |
Indique si l'utilisateur actuel peut rétablir les restrictions par défaut du Drive partagé. | v2 et v3 |
capabilities.canChangeDownloadRestriction |
Indique si l'utilisateur actuel peut modifier la restriction de téléchargement d'un Drive partagé. | v3 uniquement |
restrictions.copyRequiresWriterPermission |
Indique si les options permettant de copier, d'imprimer ou de télécharger des fichiers dans un Drive partagé sont désactivées pour les lecteurs et les commentateurs. Lorsque true , le champ du même nom est défini sur true pour tous les fichiers de ce Drive partagé. |
v2 et v3 |
restrictions.downloadRestriction |
Les restrictions de téléchargement appliquées par les administrateurs du Drive partagé. | v3 uniquement |
Limites applicables aux dossiers
Les dossiers des Drive partagés sont soumis à certaines limites de stockage. Pour en savoir plus, consultez Limites des Drive partagés dans Google Drive.
Nombre maximal d'éléments
Dans le Drive partagé d'un utilisateur, chaque dossier peut contenir 500 000 éléments au maximum, y compris des fichiers, des dossiers et des raccourcis.
Une fois la limite atteinte, le Drive partagé ne peut plus accepter d'éléments. Pour recevoir à nouveau des fichiers, les utilisateurs doivent supprimer définitivement des éléments du dossier. Notez que les éléments placés dans la corbeille sont pris en compte dans la limite, mais pas ceux qui ont été supprimés définitivement. Pour en savoir plus, consultez Placer des fichiers et des dossiers dans la corbeille ou les supprimer.
Limite de profondeur des dossiers
Un dossier dans un Drive partagé ne peut pas contenir plus de 100 niveaux de dossiers imbriqués. Cela signifie qu'un dossier enfant ne peut pas être stocké dans un dossier dont la profondeur est supérieure à 99 niveaux. Cette limitation ne s'applique qu'aux dossiers enfants.
Si vous essayez d'ajouter plus de 100 niveaux de dossiers, vous recevrez un code d'état HTTP teamDriveHierarchyTooDeep
.