Method: notes.permissions.batchDelete
یک یا چند مجوز در یادداشت را حذف می کند. نهادهای مشخص شده بلافاصله دسترسی را از دست خواهند داد. مجوز با نقش OWNER قابل حذف نیست. اگر حذف مجوز ناموفق باشد، کل درخواست با شکست مواجه می شود و هیچ تغییری ایجاد نمی شود. اگر مجوز مشخص شده در یادداشت وجود نداشته باشد، یک خطای درخواست بد 400 را برمی‌گرداند.
درخواست HTTP
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string منبع والد مشترک با همه مجوزها در حال حذف است. قالب: notes/{note} اگر این تنظیم شده باشد، والد همه مجوزهای مشخص شده در پیام‌های DeletePermissionRequest باید با این قسمت مطابقت داشته باشد. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"names": [
string
]
} |
| فیلدها |
|---|
names[] | string مورد نیاز. نام مجوزهای حذف. قالب: notes/{note}/permissions/{permission} |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/keep
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-11 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-11 بهوقت ساعت هماهنگ جهانی."],[[["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."]]],[]]
