Method: permissions.insert

Insère 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/v2/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 les e-mails 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.
sendNotificationEmails

boolean

Permet d'envoyer des notifications par e-mail lors du partage avec des utilisateurs ou des groupes. Ce paramètre est ignoré, et un e-mail est envoyé si role est défini sur owner.
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.
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/docs
  • 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.