افزونه های Google Workspace را بسازید

این صفحه یک نمای کلی برای نحوه طراحی، ساخت و انتشار افزونه های Google Workspace ارائه می دهد. این مرور کلی مراحل زیر را توضیح می دهد:

1. برنامه‌های Google Workspace را در جایی که می‌خواهید افزونه شما در دسترس کاربران قرار گیرد، تعیین کنید.
2. پروژه های افزونه خود را تنظیم کنید و مالک و همکاران خود را انتخاب کنید.
3. ظاهر و رفتار افزونه خود را طراحی و پیکربندی کنید.
4. افزونه را بسازید.
5. محدوده های OAuth افزونه خود را تأیید کنید.
6. افزونه را در یک یا چند برنامه Google Workspace آزمایش کنید.
7. افزونه را منتشر کنید.

برنامه های میزبان Google Workspace را انتخاب کنید

می‌توانید افزونه‌های Google Workspace را طوری پیکربندی کنید که در برنامه‌های میزبان Google Workspace زیر ظاهر شوند:

• جیمیل
• تقویم گوگل
• Google Chat (پیش‌نمایش برنامه‌نویس)
• Google Docs
• گوگل درایو
• Google Sheets
• اسلایدهای گوگل

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

پروژه های افزونه خود را تنظیم کنید و مالک و همکاران خود را انتخاب کنید

اگر افزونه خود را در Apps Script بسازید، هم یک پروژه Apps Script و هم یک پروژه Google Cloud ایجاد می کنید. اگر افزونه خود را به زبانی غیر از Apps Script می‌سازید، فقط باید یک پروژه Google Cloud ایجاد کنید.

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

هشدار: اگر همکارانی را به پروژه های افزودنی خود اضافه نمی کنید، بسیار مهم است که قبل از بسته شدن یا حذف شدن حساب مالک، مالکیت آنها را منتقل کنید. در غیر این صورت ممکن است به طور کامل دسترسی به کد افزونه و تنظیمات را از دست بدهید.

پروژه های Apps Script

می توانید فایل های پروژه Apps Script افزونه خود را در یک درایو مشترک بسازید تا هیچ حسابی به تنهایی مالکیت آن را نداشته باشد. قرار دادن فایل اسکریپت الحاقی خود در یک درایو اشتراکی تضمین می کند که چندین همکار به پروژه اسکریپت دسترسی دارند.

هنگامی که یک افزونه منتشر می کنید، یک حساب کاربری به عنوان ناشر عمل می کند. حساب انتشار باید به پروژه اسکریپت دسترسی ویرایش داشته باشد، اما نیازی نیست که مالک باشد.

برای ایجاد یک پروژه Apps Script، به پروژه‌های اسکریپت مراجعه کنید.

پروژه های Google Cloud

توصیه می‌کنیم همکارانی را به پروژه Cloud افزونه اضافه کنید . این کمک می‌کند مطمئن شوید که فردی در تیم شما همیشه می‌تواند به تنظیمات Cloud این افزونه دسترسی داشته باشد.

برای ایجاد یک پروژه Google Cloud، به ایجاد پروژه Google Cloud مراجعه کنید.

ظاهر و رفتار افزونه خود را طراحی و پیکربندی کنید

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

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

برای راهنمایی در مورد نحوه طراحی تجربه کاربری افزونه خود به راهنمای سبک افزودنی Google Workspace مراجعه کنید.

مانیفست افزونه را پیکربندی کنید

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

برای جزئیات، به افزونه Manifests for Google Workspace مراجعه کنید.

همانطور که کد و ویژگی را به افزونه خود اضافه می کنید، مانیفست را در صورت نیاز ویرایش کنید تا ظاهر و رفتار افزونه مورد نیاز را ایجاد کنید.

ظاهر و رفتار برنامه چت Google را پیکربندی کنید

پیش‌نمایش برنامه‌نویس: به‌عنوان بخشی از برنامه پیش‌نمایش برنامه‌نویس Google Workspace موجود است که دسترسی زودهنگام به ویژگی‌های خاصی را اعطا می‌کند.

اگر افزونه‌ای طراحی کرده‌اید که چت Google را گسترش می‌دهد، باید از Google Chat API برای پیکربندی ظاهر و رفتار یک برنامه چت استفاده کنید. برای مراحل، به پیکربندی برنامه Google Chat مراجعه کنید.

افزونه را بسازید

شما باید یک رابط مبتنی بر کارت برای افزونه پیاده سازی کنید. از سرویس Apps Script's Card استفاده کنید یا اگر به زبان کد دیگری می نویسید، JSON با فرمت مناسب را برای رابط به عنوان کارت بازگردانید.

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

ساخت کارت ها

شما با ایجاد اشیاء Card و پر کردن آنها با ویجت ها ، یک رابط کاربری افزودنی تعریف می کنید. توابع راه‌اندازی که در مانیفست شما مشخص شده‌اند باید یک شی Card یا آرایه‌ای از اشیاء Card را برگردانند که «صفحه‌های» مختلف رابط افزودنی را نشان می‌دهند. افزونه شما همچنین می‌تواند کارت‌های جدیدی را در پاسخ به اقدامات کاربر ایجاد و نمایش دهد.

در Apps Script، با استفاده از کلاس CardBuilder کارت ایجاد می کنید. هر کارت به یک CardHeader و یک یا چند CardSections نیاز دارد. شما باید هر بخش کارت را با ویجت های جداگانه ای که رابط الحاقی را تشکیل می دهند پر کنید. ویجت‌های تعامل معمولاً به اقداماتی مرتبط می‌شوند تا رفتار تعاملی خود را تعریف کنند.

پس از اینکه تمام بخش‌ها و ابزارک‌ها را از طریق CardBuilder به کارت خود اضافه کردید، باید CardBuilder.build() برای ایجاد شی Card مربوطه فراخوانی کنید.

توجه: عدم فراخوانی build() پس از استفاده از کلاس های سازنده در سرویس Card منجر به خطاهای نوع می شود. برای مثال، توابع ماشه باید اشیاء Card را برگردانند. بازگرداندن اشیاء CardBuilder در عوض منجر به خطا می شود.

می‌توانید از دیگر سرویس‌های داخلی Apps Script مانند CalendarApp برای بازیابی اطلاعات برای نمایش در کارت‌های افزودنی که می‌سازید استفاده کنید. می‌توانید از داده‌های واکشی شده از سرویس‌های غیر Google استفاده کنید.

اگر افزونه شما نیاز به دسترسی به APIهای غیر Google دارد که به OAuth نیاز دارند، باید آن سرویس را پیکربندی کرده و به آن متصل شوید—برای جزئیات بیشتر به راهنمای اتصال به خدمات غیر Google مراجعه کنید.

سفارش ساخت و ساز

هنگام ساخت کارت، باید از بالا به بالا بسازید. یعنی باید از این دستور ساخت استفاده کنید:

1. ویجت را بسازید.
2. ویجت را به بخش کارت اضافه کنید.
3. این کار را تا زمانی تکرار کنید که بخش کارت تمام ویجت های خود را داشته باشد.
4. بخش کارت را به کارت اضافه کنید.

این مورد ضروری است زیرا وقتی یک ویجت را به بخش کارت یا کارت اضافه می کنید، در واقع یک کپی از آن ویجت را اضافه می کنید. هر تغییری که پس از افزودن شی ویجت روی آن ایجاد می کنید در کارت نهایی منعکس نمی شود.

هشدار: یک ویجت را فقط پس از اتمام ساختن آن به بخش کارت یا کارت اضافه کنید. فقط یک بخش کارت را پس از پر شدن کامل از ویجت های کارت به کارت اضافه کنید. ویجت ها یا بخش ها را بعد از اضافه شدن تغییر ندهید. اگر می خواهید تغییری در ویجت اضافه شده ایجاد کنید، باید بخش یا کارتی را که به آن اضافه شده است، دوباره ایجاد کنید.

اقدامات جهانی

می توانید از اقدامات جهانی برای ارائه عملکرد مستقل از زمینه استفاده کنید. کنش‌های جهانی، آیتم‌های منو هستند که بدون توجه به اینکه چه کارتی نمایش داده می‌شود، در رابط کاربری افزودنی موجود است. همه اقدامات جهانی تعریف شده همیشه در منوی کارت افزونه ظاهر می شوند.

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

دامنه های OAuth افزودنی را تأیید کنید

محدوده ها مشخص می کنند که افزونه مجاز است چه اقداماتی را از طرف کاربر انجام دهد. این بهترین تمرین برای افزونه‌ها است که فقط محدوده‌هایی برای اقداماتی داشته باشند که باید انجام دهند و نه بیشتر.

در پروژه های الحاقی، صراحتاً دامنه های افزودنی را تنظیم کنید تا مطمئن شوید که افزونه از حداقل مجموعه دامنه های ممکن استفاده می کند. شما تعیین می کنید که افزونه شما از چه محدوده هایی در مانیفست افزونه استفاده کند.

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

افزونه را تست کنید

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

برای شروع آزمایش افزونه خود، به راهنمای زیر مراجعه کنید:

• افزونه های Google Workspace Apps Script را آزمایش و اشکال زدایی کنید
• افزونه های HTTP Google Workspace را آزمایش و اشکال زدایی کنید
• ویژگی‌های تعاملی را برای برنامه‌های Google Chat آزمایش کنید

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

انتشار برافزای شما آن را در دسترس دیگران، چه به صورت عمومی و چه فقط برای کاربران دامنه شما، می کند. قبل از شروع فرآیند انتشار، حتماً نمای کلی انتشارات را مرور کنید. انتشار فرآیند پیچیده ای است که برای تکمیل آن به آمادگی و زمان نیاز دارد.

افزونه‌های Google Workspace در Google Workspace Marketplace منتشر می‌شوند. افزونه‌های در دسترس عموم باید قبل از انتشار بررسی برنامه را کامل کنند.

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