Method: notes.permissions.batchDelete
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Borra uno o más permisos de la nota. Las entidades especificadas perderán el acceso de inmediato. No se puede quitar un permiso con el rol OWNER. Si la eliminación de un permiso falla, la solicitud completa falla y no se realizan cambios. Devuelve un error de solicitud incorrecta 400 si no existe un permiso especificado en la nota.
Solicitud HTTP
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
parent |
string
El recurso superior que comparten todos los permisos que se borrarán. Formato: notes/{note} Si se establece, el elemento superior de todos los permisos especificados en los mensajes DeletePermissionRequest debe coincidir con este campo.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
{
"names": [
string
]
} |
| Campos |
names[] |
string
Es obligatorio. Los nombres de los permisos que se borrarán. Formato: notes/{note}/permissions/{permission}
|
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/keep
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
