Method: permissions.create

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

Avertissement : Les opérations simultanées sur les autorisations d'accès à 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 ne prendra 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 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.
useDomainAdminAccess

boolean

Émettez la demande en tant qu'administrateur de domaine. Si la valeur est définie sur "true", le demandeur se verra accorder l'accès si le paramètre d'ID de fichier fait référence à un Drive partagé et que le demandeur est un administrateur du domaine auquel appartient le Drive partagé.
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.

Niveaux d'accès 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.