Method: permissions.create

Crée une autorisation pour un fichier ou un Drive partagé. Pour en savoir plus, consultez Partager des fichiers, des dossiers et des Drive.

Avertissement : Les opérations simultanées sur les autorisations d'un même fichier ne sont pas prises en charge. Seule la dernière mise à jour est appliquée.

Requête HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier ou du Drive partagé.

Paramètres de requête

Paramètres
emailMessage

string

Message personnalisé en texte brut à inclure dans l'e-mail de notification.
enforceSingleParent
(deprecated)

boolean

Obsolète : pour en savoir plus, consultez moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Ce paramètre n'est pris en compte que si l'élément ne se trouve pas dans un Drive partagé et que la requête tente de transférer la propriété de l'élément. Si la valeur est définie sur true, l'élément est déplacé vers le dossier racine "Mon Drive" du nouveau propriétaire et tous les parents précédents sont supprimés. Si la valeur est définie sur false, les parents ne sont pas modifiés.
sendNotificationEmail

boolean

Indique si un e-mail de notification doit être envoyé lorsque vous partagez des fichiers avec des utilisateurs ou des groupes. La valeur par défaut est true pour les utilisateurs et les groupes, et n'est pas autorisée pour les autres demandes. Il ne doit pas être désactivé pour les transferts de propriété.
supportsAllDrives

boolean

Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés.
supportsTeamDrives
(deprecated)

boolean

Obsolète : utilisez plutôt supportsAllDrives.
transferOwnership

boolean

Indique si la propriété doit être transférée à l'utilisateur spécifié et si le propriétaire actuel doit être rétrogradé au rôle de rédacteur. Ce paramètre est obligatoire pour confirmer l'effet secondaire. Pour en savoir plus, consultez Transférer la propriété d'un fichier.
useDomainAdminAccess

boolean

Effectuez la demande en tant qu'administrateur de domaine.

Si la valeur est définie sur true et que les conditions supplémentaires suivantes sont remplies, l'accès est accordé au demandeur :

  1. Le paramètre d'ID de fichier fait référence à un Drive partagé.
  2. Le demandeur est un administrateur du domaine auquel appartient le Drive partagé.

Pour en savoir plus, consultez Gérer les Drive partagés en tant qu'administrateur de domaine.
enforceExpansiveAccess

boolean

Indique si la requête doit appliquer des règles d'accès étendues.

Corps de la requête

Le corps de la requête contient une instance de Permission.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Permission.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Certains sont soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.