افزونه ها قبل از اینکه بتوانند کار کنند نیاز به مجوز از کاربر دارند. این در مورد افزونههای منتشر شدهای که از Google Workspace Marketplace نصب کردهاید و افزونههایی که خودتان توسعه میدهید صادق است.
مجوز دادن به افزونه های منتشر شده
پس از نصب یک افزونه منتشر شده، جریان مجوز بلافاصله شروع می شود:
- از شما خواسته می شود که حساب کاربری را انتخاب کنید و افزونه را در آن نصب کنید.
- سپس فهرستی از مجوزهایی که افزونه برای کار کردن به آن نیاز دارد، به شما ارائه میشود تا بدانید که چه کاری میخواهد انجام دهد. این فهرست را به دقت مرور کنید و اگر همچنان میخواهید مجوز بدهید، روی اجازه کلیک کنید. این افزونه را برای استفاده فعال می کند.
- اکنون می توانید آن را از برنامه میزبانی که گسترش می دهد اجرا کنید. اگر برنامه قبلاً در یک برگه مرورگر باز بود، ممکن است لازم باشد قبل از دردسترس شدن افزونه، برگه را بازخوانی کنید.
اگر افزونهای که نصب کردهاید بعداً بهروزرسانی شود و به مجوزهای بیشتری نیاز دارد که هنوز اعطا نکردهاید، دفعه بعد که از برافزا استفاده میکنید، از شما خواسته میشود این مجوزها را ارائه دهید.
تأیید افزونههای منتشر نشده Google Workspace
برافزاهای منتشر نشده مانند برافزاهای منتشر شده جریان مجوز ندارند زیرا هنوز در Google Workspace Marketplace فهرست نشده اند. پس از نصب یک افزونه منتشر نشده، فوراً از شما درخواست مجوز نمی شود. در عوض، جریان مجوز زمانی شروع می شود که برای اولین بار سعی می کنید از افزونه استفاده کنید.
هنگامی که یک افزونه اجرا می شود، تعیین می کند که آیا مجوز کاربر نیاز است یا خیر. اگر مجوز لازم باشد، افزونه یک کارت مجوز ارائه می دهد. مجوز همیشه اولین باری که یک افزونه اجرا میشود لازم است، و همچنین ممکن است اگر نسخه جدیدی از برافزا از سرویسی استفاده میکند که قبلاً مجاز نبوده است، لازم باشد. دکمه Authorize Access یک پنجره محاوره ای را برای کاربر فراهم می کند تا مجوز برای افزونه مجاز یا رد شود.
مجاز کردن سرویسهای غیر Google برای افزونه Google Workspace
این امکان وجود دارد که افزونه Google Workspace به سرویس شخص ثالثی متصل شود که خود به مجوز نیاز دارد. افزونههای Google Workspace که به چنین سرویسهایی متصل میشوند به دو اقدام جداگانه از کاربر نیاز دارند:
- مجوز خود برافزا هنگام نصب یا راه اندازی آن برای اولین بار.
- مجوز سرویس غیر Google در اولین دسترسی به آن.
اگر یک افزونه Google Workspace که در حال توسعه آن هستید نیاز به دسترسی به یک سرویس غیر Google با استفاده از OAuth داشته باشد، باید هنگام ساخت برافزا ، اتصال را برای آن سرویس پیکربندی کنید .
هنگامی که مجوز یک سرویس غیر Google مورد نیاز است، افزونه Google Workspace یک کارت درخواست مجوز برای آن سرویس به کاربر ارائه می دهد. در صورت تمایل می توانید این درخواست مجوز را سفارشی کنید یا از کارت پیش فرض استفاده کنید.
برای جزئیات بیشتر، لطفاً به راهنمای اتصال به خدمات غیر Google مراجعه کنید.
سیستم های کنفرانس شخص ثالث
افزونههای Google Workspace که تقویم Google را گسترش میدهند، همچنین میتوانند راهحلهای کنفرانس دیگری اضافه کنند که به کاربران امکان میدهد هنگام ویرایش رویدادهای Google Calendar، یک سیستم کنفرانس شخص ثالث را انتخاب کنند. اگر افزونه شما گزینه های کنفرانسی را ارائه می دهد که کاربر را ملزم به ورود به آنها می کند، افزونه شما باید این امکان را به کاربر بدهد.
اگر کاربری تلاش میکند تا کنفرانسی را با افزونه شما بدون ورود به سیستم لازم ایجاد کند، روش onCreateFunction
راه حل کنفرانس باید یک شی ConferenceData
حاوی ConferenceError
با URL احراز هویت را برگرداند.
به محض دریافت این شی، Google Calendar یک دکمه LOG IN در رابط کاربری ویرایش رویداد ایجاد می کند که به URL احراز هویت که افزونه ارائه می کند پیوند می دهد. سپس کاربران می توانند از این دکمه برای ورود به سیستم شخص ثالث قبل از استفاده بیشتر از افزونه استفاده کنند.
برای جزئیات بیشتر در مورد مدیریت مجوز با استفاده از ConferenceError
به ایجاد کنفرانس های شخص ثالث مراجعه کنید.
مجوز دادن به افزونههای ویرایشنشده منتشر نشده
این بهترین تمرین است که افزونه های ویرایشگر را در حین توسعه آزمایش کنید . جریان مجوز مشابه با افزونه های ویرایشگر منتشر شده است، با این تفاوت که این جریان زمانی شروع می شود که برای اولین بار سعی می کنید افزونه را آزمایش کنید. اگر بعداً همان افزونه را مجدداً آزمایش کنید، از شما درخواست مجوز مجدد نمیشود.
غیرمجاز کردن افزونه ها
هنگام توسعه افزونهها، غیرمجاز کردن آنها میتواند مفید باشد تا بتوانید جریان مجوز را مجدداً آزمایش کنید.
با انجام موارد زیر می توانید یک افزونه را غیرمجاز کنید:
- کنسول امنیتی حساب خود را باز کنید.
- افزونهای را که میخواهید غیرمجاز کنید، پیدا کرده و روی آن کلیک کنید.
- روی REMOVE ACCESS کلیک کنید.
هنگامی که افزونه را پس از عدم مجوز مجدداً اجرا می کنید، جریان مجوز دوباره ارائه می شود.