یک تقویم موجود در لیست تقویم کاربر را به روز می کند. این روش از معنای پچ پشتیبانی می کند. توجه داشته باشید که هر درخواست پچ سه واحد سهمیه مصرف می کند. ترجیح می دهند از یک get و به دنبال آن یک update استفاده کنند. مقادیر فیلدی که مشخص می کنید جایگزین مقادیر موجود می شوند. فیلدهایی که در درخواست مشخص نمی کنید بدون تغییر باقی می مانند. فیلدهای آرایه، در صورت مشخص شدن، آرایه های موجود را بازنویسی می کنند. این هر عنصر آرایه قبلی را کنار می گذارد. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
پارامترها
| نام پارامتر | ارزش | توضیحات |
|---|---|---|
| پارامترهای مسیر | ||
calendarId | string | شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید. |
| پارامترهای پرس و جو اختیاری | ||
colorRgbFormat | boolean | برای نوشتن رنگ‌های تقویم (RGB) از فیلدهای foregroundColor و backgroundColor استفاده شود یا خیر. اگر از این ویژگی استفاده شود، فیلد colorId مبتنی بر فهرست به طور خودکار روی بهترین گزینه تطبیق تنظیم می شود. اختیاری. پیش فرض نادرست است. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
| دامنه |
|---|
https://www.googleapis.com/auth/calendar |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، بخش‌های مربوطه از یک منبع CalendarList را مطابق با قوانین معنایی پچ ارائه کنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع CalendarList را در بدنه پاسخ برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.