- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
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 |
L'ID du fichier ou du Drive partagé |
Paramètres de requête
Paramètres | |
---|---|
emailMessage |
Message personnalisé en texte brut à inclure dans l'e-mail de notification. |
enforceSingleParent |
Obsolète: consultez |
moveToNewOwnersRoot |
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 |
sendNotificationEmail |
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 |
Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés. |
supportsTeamDrives |
Obsolète: utilisez plutôt |
transferOwnership |
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 |
É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.