Method: permissions.create

Crée une autorisation pour un fichier ou un Drive partagé.

Avertissement:Il n'est pas possible d'effectuer des autorisations simultanées sur un même fichier. 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. Consultez moveToNewOwnersRoot pour en savoir plus.
moveToNewOwnersRoot

boolean

Ce paramètre ne s'applique que si l'élément ne se trouve pas dans un Drive partagé et que la demande tente de transférer la propriété de l'élément. Si elle est définie sur true, l'élément sera déplacé vers le dossier racine Mon Drive du nouveau propriétaire, et tous les parents précédents seront supprimés. Si elle est définie sur false, les parents ne sont pas modifiés.
sendNotificationEmail

boolean

Permet d'envoyer une notification par e-mail lors d'un partage avec des utilisateurs ou des groupes. La valeur par défaut est "true" pour les utilisateurs et les groupes. Cette règle n'est pas autorisée pour les autres demandes. Elle ne doit pas être désactivée pour les transferts de propriété.
supportsAllDrives

boolean

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

boolean

Obsolète: utilisez plutôt supportsAllDrives.
transferOwnership

boolean

Indique s'il faut transférer la propriété à l'utilisateur spécifié et rétrograder le propriétaire actuel en rédacteur. Ce paramètre est requis pour confirmer l'effet secondaire.
useDomainAdminAccess

boolean

Envoyez la demande en tant qu'administrateur de domaine. Si cette règle est définie sur "True", le demandeur obtient l'accès si le paramètre d'ID de fichier fait référence à un Drive partagé et si le demandeur est un administrateur du domaine auquel appartient le Drive partagé.

Corps de la requête

Le corps de la requête contient une instance 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 champs d'application sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide relatif aux autorisations.