Method: permissions.create

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

Avertissement:Les opérations d'autorisations simultanées sur 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é au format 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 prend effet 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 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 false, les parents ne sont pas modifiés.

sendNotificationEmail

boolean

Indique si un e-mail de notification doit être envoyé lorsque vous partagez un élément avec des utilisateurs ou des groupes. Cette valeur est définie par défaut sur "true" pour les utilisateurs et les groupes, et n'est pas autorisée pour les autres requêtes. 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 supportsAllDrives à la place.

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 statut d'auteur. Ce paramètre est obligatoire pour confirmer l'effet secondaire.

useDomainAdminAccess

boolean

Envoyer la demande en tant qu'administrateur de domaine. Si la valeur est "true", l'accès est accordé à la personne à l'origine de la demande si le paramètre d'ID de fichier fait référence à un Drive partagé et qu'elle est administrateur du domaine auquel le Drive partagé appartient.

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 champs d'application 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.