Method: permissions.update
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktualisiert eine Berechtigung mit Patch-Semantik.
Warnung:Gleichzeitige Berechtigungsvorgänge für dieselbe Datei werden nicht unterstützt. Es wird nur die letzte Aktualisierung angewendet.
HTTP-Anfrage
PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
fileId |
string
Die ID der Datei oder geteilten Ablage.
|
permissionId |
string
Die ID der Berechtigung.
|
Abfrageparameter
| Parameter |
removeExpiration |
boolean
Ob das Ablaufdatum entfernt werden soll.
|
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 in einen Mitbearbeiter herabgestuft werden soll. Dieser Parameter ist erforderlich, um die Nebenwirkung zu bestätigen.
|
useDomainAdminAccess |
boolean
Stellen Sie die Anfrage als Domainadministrator. Wenn diese Option auf „true“ gesetzt ist, erhält der Antragsteller Zugriff, wenn sich der Datei-ID-Parameter auf eine geteilte Ablage bezieht und der Antragsteller Administrator der Domain ist, zu der die geteilte Ablage gehört.
|
enforceExpansiveAccess |
boolean
Gibt an, ob für die Anfrage erweiterte 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 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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: permissions.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a permission with patch semantics.\n\n**Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.\n\n### HTTP request\n\n`PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------|\n| `fileId` | `string` The ID of the file or shared drive. |\n| `permissionId` | `string` The ID of the permission. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `removeExpiration` | `boolean` Whether to remove the expiration date. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `transferOwnership` | `boolean` Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `enforceExpansiveAccess` | `boolean` Whether the request should enforce expansive access rules. |\n\n### Request body\n\nThe request body contains an instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains an instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
