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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.