Method: permissions.insert

Fügt eine Berechtigung für eine Datei oder geteilte Ablage ein.

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/v2/files/{fileId}/permissions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der Datei oder der geteilten Ablage.

Suchparameter

Parameter
emailMessage

string

Eine benutzerdefinierte Nur-Text-Nachricht, die in Benachrichtigungs-E‑Mails enthalten sein soll.
enforceSingleParent
(deprecated)

boolean

Veraltet: 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.
sendNotificationEmails

boolean

Ob Benachrichtigungs-E‑Mails gesendet werden sollen, wenn Inhalte für Nutzer oder Gruppen freigegeben werden. Dieser Parameter wird ignoriert und eine E-Mail wird gesendet, wenn role owner ist.
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.
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
(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/docs
  • 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.