افزونه ها را نصب و مجوز دهید

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

این بخش مستندات نحوه نصب، مجوز و شروع استفاده از افزونه ها را توضیح می دهد.

افزونه ها را نصب کنید

قبل از اینکه بتوانید از یک افزونه استفاده کنید، باید آن را نصب کنید . پس از نصب، افزونه در برنامه میزبان Google Workspace که گسترش می‌دهد در دسترس قرار می‌گیرد.

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

برای جزئیات بیشتر، به انتشار افزونه ها مراجعه کنید.

مجوز افزودنی ها

پس از نصب یک افزونه، در برنامه میزبانی Google Workspace که گسترش می دهد در دسترس قرار می گیرد. اولین باری که کاربر سعی می کند از افزونه استفاده کند، برنامه میزبان کارت مجوز یا گفتگو را به او ارائه می دهد. این کارت توضیح می‌دهد که افزونه برای انجام چه کارهایی برای کاربر به مجوز نیاز دارد، مانند دسترسی به محتوای صفحه Google فعلی. سپس کاربر می تواند آن مجوزها را اعطا کند و اجازه دهد تا افزونه ادامه یابد. اگر کاربر مجوز افزونه را رد کند، نمی تواند از افزونه استفاده کند.

افزونه‌های ویرایشگر از مدل مجوز استفاده می‌کنند که با افزونه‌های Google Workspace متفاوت است. از آنجایی که افزونه‌های ویرایشگر روی فایل‌های Google Drive کار می‌کنند، مدل مجوز ویرایشگر حالت‌های مجوز مختلفی را تعریف می‌کند که وقتی از افزونه‌ها برای فایل‌های جداگانه استفاده می‌شوند، نتیجه می‌شوند. هنگام توسعه افزونه‌های ویرایشگر، درک حالت‌های مختلف و نحوه حرکت یک افزونه بین آن‌ها مهم است.

افزودنی های منتشر شده را مجاز کنید

پس از نصب یک افزونه منتشر شده، جریان مجوز بلافاصله شروع می شود:

  1. از شما خواسته می شود که یک حساب کاربری برای نصب افزونه انتخاب کنید .
  2. سپس فهرستی از مجوزهایی که افزونه برای کار کردن به آن نیاز دارد، به شما ارائه می‌شود تا بدانید که چه کاری می‌خواهد انجام دهد. این فهرست را با دقت مرور کنید و اگر همچنان می‌خواهید مجوز بدهید، روی Allow کلیک کنید. این افزونه را برای استفاده فعال می کند.
  3. اکنون می توانید آن را از برنامه میزبانی که گسترش می دهد اجرا کنید. اگر برنامه قبلاً در یک برگه مرورگر باز بود، ممکن است لازم باشد قبل از دردسترس شدن افزونه، برگه را بازخوانی کنید.

اگر افزونه‌ای که نصب کرده‌اید بعداً به‌روزرسانی شود و به مجوزهای بیشتری نیاز دارد که هنوز اعطا نکرده‌اید، دفعه بعد که از برافزا استفاده می‌کنید، از شما خواسته می‌شود این مجوزها را ارائه دهید.

افزونه‌های منتشر نشده Google Workspace را مجاز کنید

کارت مجوز افزودنی

برافزاهای منتشر نشده مانند برافزاهای منتشر شده جریان مجوز ندارند زیرا هنوز در Google Workspace Marketplace فهرست نشده اند. پس از نصب یک افزونه منتشر نشده، فوراً از شما درخواست مجوز نمی شود. در عوض، جریان مجوز زمانی شروع می شود که برای اولین بار سعی می کنید از افزونه استفاده کنید.

هنگامی که یک افزونه اجرا می شود، تعیین می کند که آیا مجوز کاربر نیاز است یا خیر. اگر مجوز لازم باشد، افزونه یک کارت مجوز ارائه می دهد. مجوز همیشه اولین باری که یک افزونه اجرا می‌شود لازم است، و همچنین ممکن است اگر نسخه جدیدی از برافزا از سرویسی استفاده می‌کند که قبلاً مجاز نبوده است، لازم باشد. دکمه Authorize Access یک پنجره محاوره ای را برای کاربر فراهم می کند تا مجوز برای افزونه مجاز یا رد شود.

خدمات غیر Google را برای افزونه Google Workspace مجاز کنید

این امکان وجود دارد که یک افزونه Google Workspace به سرویس شخص ثالثی متصل شود که خود به مجوز نیاز دارد. افزونه‌های Google Workspace که به چنین سرویس‌هایی متصل می‌شوند به دو اقدام جداگانه از کاربر نیاز دارند:

  • مجوز خود برافزا هنگام نصب یا راه اندازی آن برای اولین بار.
  • مجوز سرویس غیر Google در اولین دسترسی به آن.

اگر افزونه Google Workspace که در حال توسعه آن هستید نیاز به دسترسی به یک سرویس غیر Google با استفاده از OAuth دارد، باید هنگام ساخت افزونه، اتصال را برای آن سرویس پیکربندی کنید.

برای اطلاعات بیشتر، به اتصال افزونه Google Workspace خود به یک سرویس شخص ثالث مراجعه کنید.

سیستم های کنفرانس شخص ثالث

افزونه‌های Google Workspace که Google Calendar را گسترش می‌دهند، می‌توانند راه‌حل‌های کنفرانس دیگری را نیز اضافه کنند که به کاربران امکان می‌دهد هنگام ویرایش رویدادهای Google Calendar، یک سیستم کنفرانس شخص ثالث را انتخاب کنند. اگر افزونه شما گزینه های کنفرانسی را ارائه می دهد که کاربر را ملزم به ورود به آنها می کند، افزونه شما باید این امکان را به کاربر بدهد.

اگر کاربری تلاش می‌کند تا کنفرانسی را با افزونه شما بدون ورود به سیستم لازم ایجاد کند، روش onCreateFunction راه‌حل کنفرانس باید یک شی ConferenceData حاوی ConferenceError با URL احراز هویت را برگرداند.

به محض دریافت این شی، Google Calendar یک دکمه LOG IN در رابط کاربری ویرایش رویداد ایجاد می کند که به URL احراز هویت که افزونه ارائه می کند پیوند می دهد. سپس کاربران می توانند از این دکمه برای ورود به سیستم شخص ثالث قبل از استفاده بیشتر از افزونه استفاده کنند.

برای جزئیات بیشتر در مورد مدیریت مجوز با استفاده از ConferenceError به ایجاد کنفرانس های شخص ثالث مراجعه کنید.

مجوز ویرایشگر افزودنی منتشر نشده

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

غیرمجاز کردن افزونه ها

هنگام توسعه افزونه‌ها، غیرمجاز کردن آنها می‌تواند مفید باشد تا بتوانید جریان مجوز را مجدداً آزمایش کنید.

با انجام موارد زیر می توانید یک افزونه را غیرمجاز کنید:

  1. کنسول امنیتی حساب خود را باز کنید.
  2. افزونه‌ای را که می‌خواهید غیرمجاز کنید، پیدا کرده و روی آن کلیک کنید.
  3. روی حذف دسترسی کلیک کنید.

هنگامی که افزونه را پس از عدم مجوز مجدداً اجرا می کنید، جریان مجوز دوباره ارائه می شود.

حذف نصب افزونه ها

برای حذف نصب افزونه‌ای که از Google Workspace Marketplace نصب کرده‌اید، به حذف نصب برنامه یا افزونه Marketplace مراجعه کنید.

برای حذف نصب یک برافزای منتشرنشده که در Apps Script ساخته شده است، به Uninstall an uninstall a add-on مراجعه کنید.