Acl: insert

یک قانون کنترل دسترسی ایجاد می کند. اکنون آن را امتحان کنید .

درخواست کنید

درخواست HTTP 

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مسیر
calendarId string شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید.
پارامترهای پرس و جو اختیاری
sendNotifications boolean ارسال اعلان‌ها درباره تغییر اشتراک‌گذاری تقویم. اختیاری. پیش فرض True است.

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:

دامنه
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

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

درخواست بدن

در بدنه درخواست، یک منبع Acl با ویژگی های زیر ارائه کنید:

نام ملک ارزش توضیحات یادداشت ها
ویژگی های مورد نیاز
role string نقشی که به حوزه اختصاص داده شده است. مقادیر ممکن عبارتند از:
  • " none " - بدون دسترسی است.
  • " freeBusyReader " - دسترسی خواندن به اطلاعات آزاد/مشغول را فراهم می کند.
  • " reader " - دسترسی خواندن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربرانی که دسترسی خواننده دارند ظاهر می‌شوند، اما جزئیات رویداد پنهان می‌شوند.
  • " writer " - دسترسی خواندن و نوشتن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربران با دسترسی نویسنده ظاهر می‌شوند و جزئیات رویداد قابل مشاهده خواهند بود. دسترسی خواندن به ACL های تقویم را فراهم می کند.
  • " owner " - مالکیت تقویم را فراهم می کند. این نقش دارای تمام مجوزهای نقش نویسنده با توانایی اضافی برای دستکاری ACLها است.
 قابل نوشتن
scope object میزان دسترسی به تقویم توسط این قانون ACL اعطا می شود.
scope. type string نوع محدوده. مقادیر ممکن عبارتند از:
  • " default " - محدوده عمومی. این مقدار پیش فرض است.
  • " user " - محدوده را به یک کاربر محدود می کند.
  • " group " - محدوده را به یک گروه محدود می کند.
  • " domain " - دامنه را به یک دامنه محدود می کند.
توجه: مجوزهای اعطا شده به دامنه « default » یا عمومی برای هر کاربری، اعم از احراز هویت یا غیر احراز هویت اعمال می‌شود.
ویژگی های اختیاری
scope. value string آدرس ایمیل یک کاربر یا گروه یا نام دامنه بسته به نوع دامنه. برای نوع " default " حذف شده است. قابل نوشتن

پاسخ

در صورت موفقیت آمیز بودن، این روش یک منبع Acl را در بدنه پاسخ برمی گرداند.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.