Acl: insert

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

درخواست

درخواست HTTP 

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

پارامترها

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

مجوز

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

محدوده
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

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

درخواست بدنه

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

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

 قابل نوشتن
scope object میزان دسترسی به تقویم توسط این قانون ACL اعطا می‌شود.
scope. type string نوع دامنه. مقادیر ممکن عبارتند از:
  • " default " - محدوده عمومی. این مقدار پیش‌فرض است.
  • « user » - دامنه را به یک کاربر واحد محدود می‌کند.
  • « group » - دامنه را به یک گروه محدود می‌کند.
  • « domain » - دامنه را به یک دامنه محدود می‌کند.
توجه: مجوزهای اعطا شده به محدوده « default » یا عمومی، برای هر کاربری، چه احراز هویت شده و چه نشده، اعمال می‌شود.
ویژگی‌های اختیاری
scope. value string آدرس ایمیل یک کاربر یا گروه، یا نام یک دامنه، بسته به نوع دامنه. برای نوع " default " حذف شده است. قابل نوشتن

پاسخ

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

امتحانش کن!

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