یک قانون کنترل دسترسی را به روز می کند. این روش از معنای پچ پشتیبانی می کند. توجه داشته باشید که هر درخواست پچ سه واحد سهمیه مصرف می کند. ترجیح می دهند از یک get و به دنبال آن یک update استفاده کنند. مقادیر فیلدی که مشخص می کنید جایگزین مقادیر موجود می شوند. فیلدهایی که در درخواست مشخص نمی کنید بدون تغییر باقی می مانند. فیلدهای آرایه، در صورت مشخص شدن، آرایه های موجود را بازنویسی می کنند. این هر عنصر آرایه قبلی را کنار می گذارد. الآن امتحانش کن .
درخواست
درخواست HTTP
PATCH 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 را طبق قوانین معنایی پچ‌ها عرضه کنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع Acl را در بدنه پاسخ برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.