Method: notes.permissions.batchDelete
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Löscht eine oder mehrere Berechtigungen für die Notiz. Die angegebenen Entitäten verlieren sofort den Zugriff. Eine Berechtigung mit der Rolle OWNER kann nicht entfernt werden. Wenn das Entfernen einer Berechtigung fehlschlägt, schlägt die gesamte Anfrage fehl und es werden keine Änderungen vorgenommen. Es wird der Fehler 400 „Bad Request“ zurückgegeben, wenn die angegebene Berechtigung für die Notiz nicht vorhanden ist.
HTTP-Anfrage
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Die übergeordnete Ressource, die von allen gelöschten Berechtigungen freigegeben wurde. Format: notes/{note} Wenn dieses Feld festgelegt ist, muss das übergeordnete Element aller in den Nachrichten vom Typ „DeletePermissionRequest“ angegebenen Berechtigungen mit diesem Feld übereinstimmen.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"names": [
string
]
} |
| Felder |
names[] |
string
Erforderlich. Die Namen der Berechtigungen, die gelöscht werden sollen. Format: notes/{note}/permissions/{permission}
|
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/keep
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: notes.permissions.batchDelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nDeletes one or more permissions on the note. The specified entities will immediately lose access. A permission with the `OWNER` role can't be removed. If removing a permission fails, then the entire request fails and no changes are made. Returns a 400 bad request error if a specified permission does not exist on the note.\n\n### HTTP request\n\n`POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` The parent resource shared by all permissions being deleted. Format: `notes/{note}` If this is set, the parent of all of the permissions specified in the DeletePermissionRequest messages must match this field. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------|\n| ``` { \"names\": [ string ] } ``` |\n\n| Fields ||\n|-----------|------------------------------------------------------------------------------------------------------------|\n| `names[]` | `string` Required. The names of the permissions to delete. Format: `notes/{note}/permissions/{permission}` |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/keep`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
