PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
پارامترها
نام پارامتر
ارزش
توضیحات
پارامترهای مسیر
calendarId
string
شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید.
ruleId
string
شناسه قانون ACL.
پارامترهای پرس و جو اختیاری
sendNotifications
boolean
ارسال اعلان‌ها درباره تغییر اشتراک‌گذاری تقویم. توجه داشته باشید که هیچ اعلانی در مورد حذف دسترسی وجود ندارد. اختیاری. پیش فرض True است.
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
" default " - محدوده عمومی. این مقدار پیش فرض است.
" user " - محدوده را به یک کاربر محدود می کند.
" group " - محدوده را به یک گروه محدود می کند.
" domain " - دامنه را به یک دامنه محدود می کند.
توجه: مجوزهای اعطا شده به دامنه « default » یا عمومی برای هر کاربری، اعم از احراز هویت یا غیر احراز هویت اعمال می‌شود.
ویژگی های اختیاری
role
string
نقشی که به حوزه اختصاص داده شده است. مقادیر ممکن عبارتند از:
" none " - بدون دسترسی است.
" freeBusyReader " - دسترسی خواندن به اطلاعات آزاد/مشغول را فراهم می کند.
" reader " - دسترسی خواندن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربرانی که دسترسی خواننده دارند ظاهر می‌شوند، اما جزئیات رویداد پنهان می‌شوند.
" writer " - دسترسی خواندن و نوشتن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربران با دسترسی نویسنده ظاهر می‌شوند و جزئیات رویداد قابل مشاهده خواهند بود. دسترسی خواندن به ACL های تقویم را فراهم می کند.
" owner " - مالکیت تقویم را فراهم می کند. این نقش دارای تمام مجوزهای نقش نویسنده با توانایی اضافی برای دستکاری ACLها است.
قابل نوشتن
scope. value
string
آدرس ایمیل یک کاربر یا گروه یا نام دامنه بسته به نوع دامنه. برای نوع " default " حذف شده است.
قابل نوشتن
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Acl را در بدنه پاسخ برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
پارامترها
نام پارامتر
ارزش
توضیحات
پارامترهای مسیر
calendarId
string
شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید.
ruleId
string
شناسه قانون ACL.
پارامترهای پرس و جو اختیاری
sendNotifications
boolean
ارسال اعلان‌ها درباره تغییر اشتراک‌گذاری تقویم. توجه داشته باشید که هیچ اعلانی در مورد حذف دسترسی وجود ندارد. اختیاری. پیش فرض True است.
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
" default " - محدوده عمومی. این مقدار پیش فرض است.
" user " - محدوده را به یک کاربر محدود می کند.
" group " - محدوده را به یک گروه محدود می کند.
" domain " - دامنه را به یک دامنه محدود می کند.
توجه: مجوزهای اعطا شده به دامنه « default » یا عمومی برای هر کاربری، اعم از احراز هویت یا غیر احراز هویت اعمال می‌شود.
ویژگی های اختیاری
role
string
نقشی که به حوزه اختصاص داده شده است. مقادیر ممکن عبارتند از:
" none " - بدون دسترسی است.
" freeBusyReader " - دسترسی خواندن به اطلاعات آزاد/مشغول را فراهم می کند.
" reader " - دسترسی خواندن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربرانی که دسترسی خواننده دارند ظاهر می‌شوند، اما جزئیات رویداد پنهان می‌شوند.
" writer " - دسترسی خواندن و نوشتن به تقویم را فراهم می کند. رویدادهای خصوصی برای کاربران با دسترسی نویسنده ظاهر می‌شوند و جزئیات رویداد قابل مشاهده خواهند بود. دسترسی خواندن به ACL های تقویم را فراهم می کند.
" owner " - مالکیت تقویم را فراهم می کند. این نقش دارای تمام مجوزهای نقش نویسنده با توانایی اضافی برای دستکاری ACLها است.
قابل نوشتن
scope. value
string
آدرس ایمیل یک کاربر یا گروه یا نام دامنه بسته به نوع دامنه. برای نوع " default " حذف شده است.
قابل نوشتن
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Acl را در بدنه پاسخ برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Acl: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates an access control rule.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| `ruleId` | `string` | ACL rule identifier. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Required Properties** ||||\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| **Optional Properties** ||||\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nResponse\n--------\n\nIf successful, this method returns an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
