Method: permissions.create

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

string

Die ID der Datei oder geteilten Ablage.

Abfrageparameter

Parameter
emailMessage

string

Eine Nur-Text-Nachricht, die in die Benachrichtigungs-E-Mail eingefügt werden soll.
enforceSingleParent
(deprecated)

boolean

Eingestellt: Weitere Informationen findest du unter moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Dieser Parameter wird nur wirksam, wenn sich das Element nicht in einer geteilten Ablage befindet und bei der Anfrage versucht wird, die Inhaberschaft des Elements zu übertragen. Wenn true festgelegt ist, wird das Element in den Stammordner von „Meine Ablage“ des neuen Eigentümers verschoben und alle vorherigen Eltern entfernt. Wenn false festgelegt ist, werden Eltern nicht geändert.
sendNotificationEmail

boolean

Gibt an, ob eine Benachrichtigungs-E-Mail beim Teilen an Nutzer oder Gruppen gesendet werden soll. Der Standardwert für Nutzer und Gruppen ist „true“ und für andere Anfragen nicht zulässig. Sie darf bei Übertragungen der Inhaberschaft nicht deaktiviert werden.
supportsAllDrives

boolean

Gibt an, ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
supportsTeamDrives
(deprecated)

boolean

Eingestellt: Verwenden Sie stattdessen supportsAllDrives.
transferOwnership

boolean

Gibt an, ob die Inhaberschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber auf einen Autor reduziert werden soll. Dieser Parameter ist als Bestätigung des Nebeneffekts erforderlich.
useDomainAdminAccess

boolean

Senden Sie die Anfrage als Domainadministrator. Ist dies auf „true“ gesetzt, wird dem Anfragenden Zugriff gewährt, wenn der Parameter der Datei-ID auf eine geteilte Ablage verweist und der Antragsteller der 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 Sicherheitsbewertung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.