Method: permissions.insert

Insère une autorisation pour un fichier ou un Drive partagé.

Avertissement : Les opérations simultanées sur les autorisations d'accès au 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/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 : 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.
sendNotificationEmails

boolean

Indique si des e-mails de notification doivent être envoyés lors du partage avec des utilisateurs ou des groupes. Ce paramètre est ignoré et un e-mail est envoyé si role est owner.
supportsAllDrives

boolean

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

boolean

Obsolète : utilisez plutôt supportsAllDrives.
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 si le demandeur est un administrateur du domaine auquel appartient le Drive partagé.
enforceExpansiveAccess
(deprecated)

boolean

Obsolète : toutes les requêtes utilisent les 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.

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 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.