بهترین شیوه ها

با دنبال کردن این راهنماها برای طراحی افزونه Google Meet، تجربه کلی کاربران خود را بهبود بخشید.

بهترین شیوه های مجوز

توصیه می‌شود برای هر افزونه Google Meet که نیاز به احراز هویت یا مجوز دارد، از بهترین روش‌های زیر استفاده کنید.

از Google Sign-in استفاده کنید

بسیاری از کاربران افزونه های Google Workspace قبلاً قبل از پیوستن به جلسه وارد Google شده اند. بنابراین، در دسترس بودن Google One Tap به‌عنوان یک گزینه می‌تواند چندین کلیک کاربران شما را هنگام عبور از جریان ورود به سیستم ذخیره کند. برای اطلاعات بیشتر، به مدیریت روش‌های ورود به سیستم برای افزونه خود مراجعه کنید.

صفحه ورود به سیستم شخص ثالث را در یک پنجره جدید باز کنید

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

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

اگر برافزای Meet شما با Google API تماس می‌گیرد، باید فهرست کاملی از دامنه‌های OAuth مورد نیاز افزونه خود را ارائه دهید . این کار در صفحه پیکربندی برنامه Google Workspace Marketplace انجام می شود. پس از افزودن این محدوده‌ها، هنگام نصب برافزای Meet به کاربران شما پیامی نمایش داده می‌شود که به کاربران می‌گوید به چه نوع داده‌هایی اجازه دسترسی به برنامه شما را می‌دهند.

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

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

بهترین شیوه های تعمیر و نگهداری

بهترین روش‌های زیر برای نوشتن برنامه‌های کاربردی وب قابل نگهداری هستند، اما هنگام نوشتن افزونه‌های Meet اهمیت ویژه‌ای دارند.

از آخرین نسخه SDK افزونه های Google Meet استفاده کنید

SDK افزونه‌های Meet مرتباً به‌روزرسانی می‌شود. SDK به نسخه‌سازی معنایی پایبند است. برای یافتن آخرین نسخه:

  • هنگام استفاده از gstatic : آخرین نسخه SDK در URL gstatic موجود در دستورالعمل های استفاده از SDK موجود است.
  • هنگام استفاده از npm : npm update @googleworkspace/meet-add-ons از داخل دایرکتوری حاوی package.json برای وب‌سایتی که برافزای Meet شما را میزبانی می‌کند، اجرا کنید.

یک پروژه مرحله‌بندی Google Cloud ایجاد کنید

هنگامی که افزونه Google Meet شما در Google Workspace Marketplace منتشر شد ، هر گونه استقرار جدید افزونه Google Meet شما فوراً در دسترس کاربران Meet قرار می گیرد. کاربران به محض خالی کردن حافظه پنهان یا منقضی شدن حافظه پنهان، این به روز رسانی ها را مشاهده خواهند کرد. بنابراین، توصیه می کنیم تا زمانی که تغییرات به طور کامل آزمایش نشده اند، تغییرات را به سایت تولید خود فشار ندهید.

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

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

تست ها را بنویسید

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

  • تمسخر SDK برافزای Meet، و سپس تأیید اینکه افزونه Meet عملکردهای SDK را همانطور که انتظار می‌رود فراخوانی می‌کند.
  • واحد تمام عملکردهای غیر مرتبط با SDK افزونه شما را با چارچوب تست وب ترجیحی شما آزمایش می کند.

بهترین شیوه های تجربه کاربر

بهترین روش‌های زیر کمک می‌کند افزونه Meet را بصری‌تر و دقیق‌تر کنید.

تمام حالت شروع را در پانل کناری مدیریت کنید

ما قویاً توصیه می کنیم افزونه خود را بر اساس اقدامات کاربر انجام شده در پانل کناری تنظیم کنید. این کار با تنظیم وضعیت شروع فعالیت در جاوا اسکریپت انجام می شود. تمام داده‌هایی که وارد ActivityStartingState می‌شوند باید توسط آغازگر افزونه (معمولا میزبان جلسه) در پانل کناری تنظیم شوند. می توانید اولین نمای پانل جانبی را به عنوان فرمی در نظر بگیرید که تنظیم افزونه شما را کنترل می کند.

پانل کناری را در صورت عدم استفاده ببندید

پس از شروع فعالیت با فراخوانی متد startActivity() ، تنها در صورتی باید پانل کناری را باز نگه دارید که بخشی ضروری از تجربه کاربر برای افزونه Google Meet شما باشد. با فراخوانی متد unloadSidePanel() می‌توانید پانل کناری را پس از باز شدن مرحله اصلی ببندید.

افزونه Meet خود را از طریق اشتراک‌گذاری صفحه تبلیغ کنید

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

دستورالعمل های طراحی لوگو

این دستورالعمل ها را هنگام طراحی لوگوی مخصوص Meet دنبال کنید تا در حال حاضر و آینده به بهترین شکل ظاهر شود:

از فرمت فایل PNG با اندازه 256 x 256 پیکسل استفاده کنید.

از شفافیت استفاده کنید

با استفاده از ابزارهای برنامه‌نویس برای افزودنی‌های Meet ، تأیید کنید که نشان‌واره حالت تاریک شما در حالت تاریک خوب به نظر می‌رسد.

الزامات گرافیکی را برای ادغام برنامه های خاص رعایت کنید.

بالشتک را در تصویر خود قرار ندهید. در عوض تصویر را تا مرزهای فایل خود گسترش دهید.