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 Textnachricht für die Benachrichtigungs-E-Mail.

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.

sendNotificationEmail

boolean

Gibt an, ob beim Teilen für Nutzer oder Gruppen eine E-Mail-Benachrichtigung gesendet wird. Die Standardeinstellung für Nutzer und Gruppen ist „true“ und für andere Anfragen nicht zulässig. Er darf für die Übertragung der Inhaberschaft nicht deaktiviert werden.

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.

transferOwnership

boolean

Gibt an, ob die Eigentümerschaft auf den angegebenen Nutzer übertragen und der aktuelle Inhaber auf einen Autor herabgestuft werden soll. Dieser Parameter ist erforderlich, um den Nebeneffekt zu bestätigen.

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/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.