Method: permissions.create

• HTTP-Anfrage
• Pfadparameter
• Anfrageparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche
• Testen!

Erstellt eine Berechtigung für eine Datei oder geteilte Ablage. Weitere Informationen finden Sie unter Dateien, Ordner und Ablagen freigeben.

Warnung:Gleichzeitige Berechtigungsvorgänge für dieselbe Datei werden nicht unterstützt. Es wird nur das letzte Update 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 E‑Mail-Benachrichtigung aufgenommen werden soll.
enforceSingleParent (deprecated)	boolean Eingestellt: Weitere Informationen finden Sie unter moveToNewOwnersRoot.
moveToNewOwnersRoot	boolean Dieser Parameter hat nur Auswirkungen, wenn sich das Element nicht in einer geteilten Ablage befindet und mit der Anfrage versucht wird, das Eigentum des Elements zu übertragen. Wenn diese Option 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 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. 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: Der Parameter „fileId“ verweist auf eine geteilte Ablage. Der Antragsteller ist Administrator der Domain, zu der die geteilte Ablage gehört. Weitere Informationen finden Sie unter Geteilte Ablagen als Domainadministrator verwalten.
enforceExpansiveAccess	boolean Gibt an, ob für die Anfrage umfassende Zugriffsregeln erzwungen werden sollen.

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