این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Acl: update

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

درخواست

درخواست HTTP

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

پارامترها

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

مجوز

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

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

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

درخواست بدنه

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

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

پاسخ

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

امتحانش کن!

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