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 geteilten Ablage.

Abfrageparameter

Parameter
emailMessage

string

Eine benutzerdefinierte Nur-Text-Nachricht für Benachrichtigungs-E-Mails.

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 in der Anfrage versucht wird, die Eigentümerschaft des Elements zu übertragen. Ist die Richtlinie auf true gesetzt, wird das Element in den Stammordner „Meine Ablage“ des neuen Eigentümers verschoben und alle vorherigen übergeordneten Elemente werden entfernt. Wenn false festgelegt ist, werden übergeordnete Elemente nicht geändert.

sendNotificationEmails

boolean

Gibt an, ob beim Teilen für Nutzer oder Gruppen E-Mail-Benachrichtigungen gesendet werden sollen. Wenn role den Wert owner hat, wird dieser Parameter ignoriert und eine E-Mail gesendet.

supportsAllDrives

boolean

Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.

supportsTeamDrives
(deprecated)

boolean

Eingestellt: Verwende stattdessen supportsAllDrives.

useDomainAdminAccess

boolean

Senden Sie die Anfrage als Domainadministrator. Ist die Richtlinie auf „true“ gesetzt, wird dem Anforderer Zugriff gewährt, wenn sich der Datei-ID-Parameter auf eine geteilte Ablage bezieht und der Anforderer ein 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/docs
  • 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 Leitfaden zur Autorisierung.