Method: permissions.create

Erstellt eine Berechtigung für eine Datei oder eine geteilte Ablage. Weitere Informationen finden Sie unter Dateien, Ordner und Ablagen freigeben.

Warnung:Gleichzeitige Berechtigungsvorgänge für dieselbe Datei werden nicht unterstützt. Es wird nur das letzte Update 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.

Suchparameter

Parameter
emailMessage

string

Eine benutzerdefinierte Nur-Text-Nachricht, die in die E‑Mail-Benachrichtigung aufgenommen werden soll.
enforceSingleParent
(deprecated)

boolean

Veraltet: Weitere Informationen finden Sie unter moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Dieser Parameter hat nur Auswirkungen, wenn sich das Element nicht in einer geteilten Ablage befindet und mit der Anfrage versucht wird, das Eigentum des Elements zu übertragen. Wenn diese Option auf true festgelegt ist, wird das Element in den Stammordner „Meine Ablage“ des neuen Eigentümers verschoben und alle vorherigen übergeordneten Ordner werden entfernt. Wenn die Einstellung auf false festgelegt ist, werden die Eltern nicht geändert.
sendNotificationEmail

boolean

Ob beim Freigeben für Nutzer oder Gruppen eine Benachrichtigungs-E‑Mail gesendet werden soll. Der Standardwert ist true für Nutzer und Gruppen. Für andere Anfragen ist er nicht zulässig. Sie darf für die Übertragung der Inhaberschaft nicht deaktiviert sein.
supportsAllDrives

boolean

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

boolean

Nicht mehr unterstützt: Verwenden Sie stattdessen supportsAllDrives.
transferOwnership

boolean

Ob die Inhaberschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber auf die Rolle „Mitwirkender“ herabgestuft werden soll. Dieser Parameter ist erforderlich, um die Nebenwirkung zu bestätigen. Weitere Informationen
useDomainAdminAccess

boolean

Stellen Sie die Anfrage als Domainadministrator.

Wenn der Wert auf true gesetzt ist und die folgenden zusätzlichen Bedingungen erfüllt sind, wird dem Antragsteller Zugriff gewährt:

  1. Der Parameter „fileId“ verweist auf eine geteilte Ablage.
  2. Der Antragsteller ist Administrator der Domain, zu der die geteilte Ablage gehört.

Weitere Informationen finden Sie unter Geteilte Ablagen als Domainadministrator verwalten.
enforceExpansiveAccess
(deprecated)

boolean

Veraltet: Für alle Anfragen werden die umfassenden Zugriffsregeln verwendet.

Anfragetext

Der Anfragetext enthält eine Instanz von Permission.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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 Autorisierungsleitfaden.