این سند حاوی اطلاعات مجوز و احراز هویت ویژه API تقویم Google است. قبل از خواندن این سند، حتماً اطلاعات عمومی احراز هویت و مجوز Google Workspace را در اطلاعات مربوط به احراز هویت و مجوز مطالعه کنید.
OAuth 2.0 را برای مجوز پیکربندی کنید
صفحه رضایت OAuth را پیکربندی کنید و دامنه ها را انتخاب کنید تا مشخص کنید چه اطلاعاتی برای کاربران و بازبینان برنامه نمایش داده می شود و برنامه خود را ثبت کنید تا بتوانید بعداً آن را منتشر کنید.
دامنه های API تقویم
برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید محدوده های مجوز را شناسایی و اعلام کنید. محدوده مجوز یک رشته URI OAuth 2.0 است که حاوی نام برنامه Google Workspace، نوع داده‌هایی است که به آن دسترسی دارد و سطح دسترسی. Scopes درخواست‌های برنامه شما برای کار با داده‌های Google Workspace، از جمله داده‌های حساب Google کاربران است.
هنگامی که برنامه شما نصب می شود، از کاربر خواسته می شود تا محدوده های مورد استفاده برنامه را تأیید کند. به طور کلی، شما باید محدودترین محدوده ممکن را انتخاب کنید و از درخواست دامنه هایی که برنامه شما به آن نیاز ندارد اجتناب کنید. کاربران با سهولت بیشتری به محدوده‌های محدود و به وضوح توضیح داده شده دسترسی می‌دهند.
Calendar API از حوزه های زیر پشتیبانی می کند:
| محدوده | معنی |
|---|---|
https://www.googleapis.com/auth/calendar | همه تقویم‌هایی را که می‌توانید با استفاده از Google Calendar به آنها دسترسی داشته باشید، مشاهده، ویرایش، اشتراک‌گذاری و حذف دائمی کنید. |
https://www.googleapis.com/auth/calendar.readonly | هر تقویمی را که می توانید با استفاده از تقویم خود به آن دسترسی داشته باشید، ببینید و دانلود کنید. |
https://www.googleapis.com/auth/calendar.events | رویدادها را در همه تقویم‌های خود مشاهده و ویرایش کنید. |
https://www.googleapis.com/auth/calendar.events.readonly | رویدادها را در همه تقویم‌های خود مشاهده کنید. |
https://www.googleapis.com/auth/calendar.settings.readonly | تنظیمات تقویم خود را مشاهده کنید. |
https://www.googleapis.com/auth/calendar.addons.execute | به عنوان یک افزونه تقویم اجرا شود. |