دامنه های API تقویم Google را انتخاب کنید

این سند حاوی اطلاعات مربوط به مجوز و احراز هویت مختص API تقویم گوگل است. قبل از مطالعه این سند، حتماً اطلاعات عمومی احراز هویت و مجوز Google Workspace را در بخش «درباره احراز هویت و مجوز بیشتر بدانید» مطالعه کنید.

پیکربندی OAuth 2.0 برای احراز هویت

صفحه رضایت OAuth را پیکربندی کنید و محدوده‌هایی را برای تعریف اطلاعات نمایش داده شده به کاربران و بررسی‌کنندگان برنامه انتخاب کنید و برنامه خود را ثبت کنید تا بتوانید بعداً آن را منتشر کنید.

محدوده‌های API تقویم

برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید حوزه‌های مجوز را شناسایی و اعلام کنید. حوزه مجوز، یک رشته URI از نوع OAuth 2.0 است که شامل نام برنامه Google Workspace، نوع داده‌هایی که به آنها دسترسی دارد و سطح دسترسی است. حوزه‌ها، درخواست‌های برنامه شما برای کار با داده‌های Google Workspace، از جمله داده‌های حساب Google کاربران، هستند.

وقتی برنامه شما نصب می‌شود، از کاربر خواسته می‌شود تا محدوده‌های مورد استفاده برنامه را اعتبارسنجی کند. به طور کلی، شما باید محدوده‌ای را انتخاب کنید که بیشترین تمرکز را داشته باشد و از درخواست محدوده‌هایی که برنامه شما به آنها نیاز ندارد، خودداری کنید. کاربران راحت‌تر به محدوده‌های محدود و واضح دسترسی می‌دهند.

API تقویم از حوزه‌های زیر پشتیبانی می‌کند:

محدوده معنی
https://www.googleapis.com/auth/calendar تمام تقویم‌هایی را که می‌توانید با استفاده از تقویم گوگل به آنها دسترسی داشته باشید، ببینید، ویرایش کنید، به اشتراک بگذارید و برای همیشه حذف کنید.
https://www.googleapis.com/auth/calendar.readonly هر تقویمی را که می‌توانید با استفاده از تقویم خود به آن دسترسی داشته باشید، مشاهده و دانلود کنید.
https://www.googleapis.com/auth/calendar.freebusy در تقویم‌هایتان، زمان‌های خالی‌تان را مشاهده کنید.
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 به عنوان افزونه تقویم اجرا شود.
https://www.googleapis.com/auth/calendar.addons.current.event.read رویدادهایی را که در تقویم گوگل باز می‌کنید، ببینید.
https://www.googleapis.com/auth/calendar.addons.current.event.write رویدادهایی را که در تقویم گوگل باز می‌کنید ویرایش کنید.
https://www.googleapis.com/auth/calendar.events.owned رویدادهای تقویم‌های گوگل متعلق به خودتان را ببینید، ایجاد کنید، تغییر دهید و حذف کنید.
https://www.googleapis.com/auth/calendar.events.owned.readonly رویدادهای تقویم‌های گوگلی که خودتان دارید را ببینید.
https://www.googleapis.com/auth/calendar.events.freebusy در تقویم‌های گوگلی که به آنها دسترسی دارید، موجود بودن آنها را مشاهده کنید.
https://www.googleapis.com/auth/calendar.app.created تقویم‌های ثانویه گوگل ایجاد کنید و رویدادهای آنها را ببینید، ایجاد کنید، تغییر دهید و حذف کنید.
https://www.googleapis.com/auth/calendar.calendarlist تقویم‌های گوگلی که در آن‌ها مشترک هستید را ببینید، اضافه کنید و حذف کنید.
https://www.googleapis.com/auth/calendar.calendarlist.readonly فهرست تقویم‌های گوگلی که در آن‌ها مشترک هستید را ببینید.
https://www.googleapis.com/auth/calendar.calendars ویژگی‌های تقویم‌های گوگلی که به آنها دسترسی دارید را ببینید و تغییر دهید و تقویم‌های ثانویه ایجاد کنید.
https://www.googleapis.com/auth/calendar.calendars.readonly عنوان، توضیحات، منطقه زمانی پیش‌فرض و سایر ویژگی‌های تقویم‌های گوگل که به آنها دسترسی دارید را مشاهده کنید.
https://www.googleapis.com/auth/calendar.acls مجوزهای اشتراک‌گذاری تقویم‌های گوگل متعلق به خودتان را ببینید و تغییر دهید.
https://www.googleapis.com/auth/calendar.acls.readonly مجوزهای اشتراک‌گذاری تقویم‌های گوگلی که در اختیار دارید را ببینید.
https://www.googleapis.com/auth/calendar.events.public.readonly رویدادها را در تقویم‌های عمومی ببینید.