Erstellt eine Berechtigung für eine Datei oder geteilte Ablage.
Warnung:Gleichzeitige Berechtigungsvorgänge für dieselbe Datei werden nicht unterstützt. Es wird nur die letzte Aktualisierung angewendet.
HTTP-Anfrage
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
fileId |
Die ID der Datei oder geteilten Ablage. |
Abfrageparameter
Parameter | |
---|---|
emailMessage |
Eine benutzerdefinierte Textnachricht für die Benachrichtigungs-E-Mail. |
enforceSingleParent |
Eingestellt: Weitere Informationen findest du unter |
moveToNewOwnersRoot |
Dieser Parameter wird nur wirksam, wenn sich das Element nicht in einer geteilten Ablage befindet und in der Anfrage versucht wird, die Eigentümerschaft des Elements zu übertragen. Ist die Richtlinie auf |
sendNotificationEmail |
Gibt an, ob beim Teilen für Nutzer oder Gruppen eine E-Mail-Benachrichtigung gesendet wird. Die Standardeinstellung für Nutzer und Gruppen ist „true“ und für andere Anfragen nicht zulässig. Er darf für die Übertragung der Inhaberschaft nicht deaktiviert werden. |
supportsAllDrives |
Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Eingestellt: Verwende stattdessen |
transferOwnership |
Gibt an, ob die Eigentümerschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber auf einen Autor herabgestuft werden soll. Dieser Parameter ist erforderlich, um den Nebeneffekt zu bestätigen. |
useDomainAdminAccess |
Senden Sie die Anfrage als Domainadministrator. Ist die Richtlinie auf „true“ gesetzt, wird dem Anforderer Zugriff gewährt, wenn sich der Datei-ID-Parameter auf eine geteilte Ablage bezieht und der Anforderer ein Administrator der Domain ist, zu der die geteilte Ablage gehört. |
Anfragetext
Der Anfragetext enthält eine Instanz von Permission
.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Permission
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.