Method: permissions.create

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

Avertissement:Les opérations simultanées sur les autorisations ne sont pas acceptées sur le 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

L'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 sa propriété. Si la valeur est 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. S'il est défini sur false, les parents ne sont pas modifiés.

sendNotificationEmail

boolean

Permet d'envoyer un e-mail de notification lors d'un partage avec des utilisateurs ou des groupes. La valeur par défaut est "true" pour les utilisateurs et les groupes. Elle n'est pas autorisée pour les autres requêtes. 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

Permet de transférer la propriété à l'utilisateur spécifié et de transférer le propriétaire actuel à un rédacteur. Ce paramètre est obligatoire pour confirmer l'effet secondaire.

useDomainAdminAccess

boolean

Émettez la requête en tant qu'administrateur de domaine. Si cette règle est définie sur "true", l'utilisateur à l'origine de la demande est autorisé à accéder aux fichiers si le paramètre d'ID du fichier fait référence à un Drive partagé et si le demandeur est un administrateur du domaine auquel le Drive partagé appartient.

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 sur les autorisations.