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

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

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

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

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

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

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

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

درخواست صحیح scopeها برای APIهای گوگل

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

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

هنگام نوشتن کد برای فراخوانی APIهای Google Workspace، دنبال کردن راهنمای سریع جاوا اسکریپت ساده‌ترین راه برای شروع کار است. این رویکرد به بهترین شیوه‌ها برای استفاده از Google Sign-In و پنجره‌های محاوره‌ای پایبند است. توجه داشته باشید که مقداردهی اولیه کلاینت توکن در جاوا اسکریپت مستلزم درخواست جداگانه دامنه‌هایی است که برنامه در زمان اجرا از آنها استفاده می‌کند. برای بهترین تجربه کاربری، این دامنه‌های درخواستی باید با دامنه‌های موجود در صفحه پیکربندی برنامه 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 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 با ابعاد ۲۵۶ پیکسل در ۲۵۶ پیکسل استفاده کنید.

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

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

با استفاده از یک ابزار بررسی کنتراست مانند Contrast Checker از Web Accessibility In Mind (WebAIM)، مطمئن شوید که لوگو (و سایر عناصر گرافیکی ) شما در حالت کنتراست بالا خوب به نظر می‌رسد.

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

در تصویر خود فاصله‌گذاری (padding) قرار ندهید. در عوض، تصویر را تا مرزهای فایل خود گسترش دهید.