یک قانون کنترل دسترسی را به روز می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست کنید
درخواست HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
پارامترها
نام پارامتر | ارزش | توضیحات |
---|---|---|
پارامترهای مسیر | ||
calendarId | string | شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر میخواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید. |
ruleId | string | شناسه قانون ACL. |
پارامترهای پرس و جو اختیاری | ||
sendNotifications | boolean | ارسال اعلانها درباره تغییر اشتراکگذاری تقویم. توجه داشته باشید که هیچ اعلانی در مورد حذف دسترسی وجود ندارد. اختیاری. پیش فرض True است. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
دامنه |
---|
https://www.googleapis.com/auth/calendar |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، یک منبع Acl با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
خواص مورد نیاز | |||
scope | object | میزان دسترسی به تقویم توسط این قانون ACL اعطا می شود. | |
scope. type | string | نوع محدوده. مقادیر ممکن عبارتند از:
default » یا عمومی برای هر کاربری، اعم از احراز هویت یا غیر احراز هویت اعمال میشود. | |
ویژگی های اختیاری | |||
role | string | نقشی که به حوزه اختصاص داده شده است. مقادیر ممکن عبارتند از:
| قابل نوشتن |
scope. value | string | آدرس ایمیل یک کاربر یا گروه یا نام دامنه بسته به نوع دامنه. برای نوع " default " حذف شده است. | قابل نوشتن |
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Acl را در بدنه پاسخ برمی گرداند.
نمونه ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve the access rule from the API AclRule rule = service.acl().get('primary', "ruleId").execute(); // Make a change rule.setRole("newRole"); // Update the access rule AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute(); System.out.println(updatedRule.getEtag());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute() rule['role'] = 'newRole' updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute() print updated_rule['etag']
PHP
از کتابخانه مشتری PHP استفاده می کند.
$rule = $service->acl->get('primary', 'ruleId'); $rule->setRole('newRole'); $updatedRule = $service->acl->update('primary', $rule->getId(), $rule); echo $updatedRule->getEtag();
روبی
از کتابخانه کلاینت Ruby استفاده می کند.
rule = client.get_acl('primary', 'ruleId') rule.role = 'newRole' result = client.update_acl('primary', rule.id, rule) print result.etag
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.