Method: permissions.insert

Insère 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/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é au format 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 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.
sendNotificationEmails

boolean

Indique si des e-mails de notification doivent être envoyés lorsque vous partagez des éléments 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 à 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.
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 que la personne est administrateur du domaine auquel le Drive partagé appartient.
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.

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 soumis à des restrictions et nécessitent une évaluation de la sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.