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 benutzerdefinierte Nur-Text-Nachricht, die in die Benachrichtigungs-E-Mail aufgenommen werden soll.
enforceSingleParent
(deprecated)

boolean

Eingestellt: Weitere Informationen finden Sie unter moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Dieser Parameter wird nur wirksam, wenn sich das Element nicht in einer geteilten Ablage befindet und mit der Anfrage versucht wird, die Eigentümerschaft 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 der Wert auf false festgelegt ist, werden die Eltern nicht geändert.
sendNotificationEmail

boolean

Gibt an, ob eine Benachrichtigungs-E‑Mail gesendet werden soll, wenn Inhalte für Nutzer oder Gruppen freigegeben werden. Der Standardwert ist true für Nutzer und Gruppen. Für andere Anfragen ist er nicht zulässig. Es darf für die Übertragung der Eigentümerschaft nicht deaktiviert sein.
supportsAllDrives

boolean

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

boolean

Verworfen: Verwenden Sie stattdessen supportsAllDrives.
transferOwnership

boolean

Gibt an, ob die Inhaberschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber zu einem Mitbearbeiter herabgestuft werden soll. Dieser Parameter ist erforderlich, um die Nebenwirkung zu bestätigen.
useDomainAdminAccess

boolean

Die Anfrage als Domainadministrator ausführen. Wenn dieser Parameter auf „true“ gesetzt ist, erhält der Anfragende Zugriff, wenn der Parameter „fileId“ auf eine geteilte Ablage verweist und der Anfragende Administrator der Domain ist, zu der die geteilte Ablage gehört.
enforceExpansiveAccess

boolean

Gibt an, ob für die Anfrage umfassende Zugriffsregeln erzwungen werden sollen.

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 für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.