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

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