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 Änderungen an Berechtigungen (z. B. Aktualisieren oder Löschen) für dieselbe Datei, denselben Ordner oder dieselbe geteilte Ablage werden für keine Nutzer oder Clients 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.

Suchparameter

Parameter
emailMessage

string

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

boolean

Eingestellt: Weitere Informationen finden Sie unter moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Dieser Parameter wird nur berücksichtigt, wenn sich das Element nicht in einer geteilten Ablage befindet und mit der Anfrage versucht wird, das Eigentum des Elements zu übertragen. Wenn der Wert 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 Eigentümerschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber zu einem Autor 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

Eingestellt: 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.