Method: notes.permissions.batchDelete
Удаляет одно или несколько разрешений для заметки. Указанные сущности немедленно потеряют доступ. Разрешение с ролью OWNER
невозможно удалить. Если удаление разрешения завершается неудачей, то весь запрос завершается неудачей и никакие изменения не вносятся. Возвращает ошибку 400 неверный запрос, если указанное разрешение не существует в заметке.
HTTP-запрос
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
parent | string Родительский ресурс, общий для всех удаляемых разрешений. Формат: notes/{note} Если этот параметр установлен, родительский элемент всех разрешений, указанных в сообщениях DeletePermissionRequest, должен соответствовать этому полю. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"names": [
string
]
} |
Поля |
---|
names[] | string Необходимый. Имена разрешений для удаления. Формат: notes/{note}/permissions/{permission} |
Тело ответа
В случае успеха тело ответа пустое.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/keep
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-11 UTC.
[null,null,["Последнее обновление: 2024-11-11 UTC."],[[["This operation allows the deletion of one or more permissions on a note, removing access for the specified entities."],["The request must be sent as a POST request to the specified URL, including the note ID in the path parameter."],["The request body requires a JSON object with an array of permission names to be deleted, formatted as 'notes/{note}/permissions/{permission}'."],["Upon success, the response body will be empty, indicating the permissions have been removed."],["This operation requires authorization with the 'https://www.googleapis.com/auth/keep' scope."]]],[]]