فرآیند بررسی برنامه و الزامات برای Google Workspace Marketplace

• دکمه‌های ارتباط با برنامه از توضیحات موجود است.
• نام برنامه با حروف بزرگ A تا Z یا 0 تا 9 شروع می‌شود. نمی‌تواند با نماد شروع شود.

• برنامه چت دارای ویژگی‌های تعاملی است و می‌تواند به پیام‌های مستقیم یا فضاهای خالی اضافه شود.

• این برنامه هر بار که کاربر یک پیام مستقیم را شروع می‌کند یا برنامه به یک فاصله اضافه می‌شود، یک پیام خوشامدگویی بدون اعلان ارسال می‌کند. پیام خوشامدگویی با دستور "راهنما" متفاوت است. مستندات را مشاهده کنید .
• این برنامه از دستور «راهنما» پشتیبانی می‌کند و به کاربران در شروع کار کمک می‌کند. مستندات را مشاهده کنید .
• این برنامه همیشه وقتی در یک فضای خصوصی یا چت مستقیم با آن صحبت می‌شود، پاسخ می‌دهد.
• پیام‌ها از املای صحیح، حروف بزرگ و کوچک، علائم نگارشی و دستور زبان استفاده می‌کنند. پیام‌ها حاوی مطالب مخرب، توهین‌آمیز یا توهین‌آمیز نیستند.
• پیام‌ها از قالب‌بندی واضح، مختصر و ثابت برای متن یا کارت‌ها مطابق با الزامات گوگل استفاده می‌کنند.
• اگر پاسخ بیش از ۲ ثانیه طول بکشد، برنامه پیامی ارسال می‌کند که دلیل تأخیر را توضیح می‌دهد.
• برنامه‌هایی که اعلان ارسال می‌کنند، به کاربران اجازه می‌دهند اعلان‌ها را خاموش کنند.
• کاربران می‌توانند با استفاده از @mentioning برنامه را به یک فضا اضافه کنند.
• کاربران می‌توانند با استفاده از منوی View member، برنامه را از یک فضا حذف کنند.
• این برنامه هر آنچه را که برای تعامل با آن لازم است به کاربر نشان می‌دهد.
• قالب کارت‌هایی که برنامه استفاده می‌کند، الزامات گوگل را برآورده می‌کند. مستندات را مشاهده کنید .
• این برنامه از طریق گزینه «یافتن برنامه‌ها» در منوی چت در دسترس است.
• URL های خارجی که برنامه با آنها تعامل دارد، به محیط توسعه یا مرحله بندی تعلق ندارند.
• استفاده از @mention در هر پیامی که به برنامه ارسال می‌شود، بین فاصله‌ها الزامی است. این تنها راهی است که برنامه متوجه می‌شود باید پاسخ دهد.
• اگر برنامه چت، لینک‌های یک دامنه شخص ثالث را پیش‌نمایش می‌دهد:
  • پیش‌نمایش لینک‌ها اطلاعات مرتبط و تکمیلی را به پیام کاربر ارائه می‌دهد. برای مثال، پیش‌نمایش لینک یک معامله فروش، اطلاعاتی مانند حساب، مبلغ و مرحله را اضافه می‌کند.
  • توسعه‌دهنده با دامنه‌ی پیش‌نمایش‌شده مرتبط است.

  برای آشنایی با پیش‌نمایش لینک‌ها، مستندات را مشاهده کنید .

• (توصیه می‌شود) برای اینکه مدیران Workspace بتوانند برنامه شما را از طرف کاربران سازمان خود نصب کنند، برنامه شما باید بتواند پیام‌های مستقیم دریافت و ارسال کند.

• این برنامه دارای یک آواتار قابل تشخیص و واضح است.

• این برنامه از افزونه‌های مرورگر کروم برای ارائه قابلیت‌ها با دستکاری مستقیم HTML درایو استفاده نمی‌کند.
• اگر برنامه شما از حوزه‌های حساس یا محدود استفاده می‌کند، باید تأیید OAuth را پشت سر بگذارد. برای تأیید به ارسال برنامه خود مراجعه کنید.
• اگر برنامه شما از محدوده‌های محدود استفاده می‌کند، باید ارزیابی امنیتی را نیز پشت سر بگذارد. به ارزیابی امنیتی مراجعه کنید.

• اگر برنامه فایل‌ها را در درایو ذخیره کند، به کاربران اجازه می‌دهد یک پوشه انتخاب کنند یا یک پوشه مخصوص برنامه ایجاد و دوباره استفاده کنند. داده‌های پیکربندی را می‌توان در پوشه App Data ذخیره کرد. برنامه فایل‌ها را در پوشه My Drive کاربر ذخیره نمی‌کند.
• این برنامه فقط فایل‌هایی را در درایو ذخیره می‌کند که به عملکرد مستند شده‌ی برنامه متصل باشند.

• اقدامات مورد انتظار و ضروری در این افزونه گنجانده شده است و تمام ابزارهای لازم برای تکمیل گردش کار خود را فراهم می‌کند. به عنوان مثال:
  • اگر افزونه استایل‌بندی را به کل سند اعمال کند، گزینه‌ای را ارائه می‌دهد که استایل‌بندی را فقط به متن انتخاب‌شده اعمال کند.
  • اگر افزونه داده‌های صفحه‌گسترده را در یک فید سرویس وب بارگذاری کند، برای پیمایش آسان، پیوندی به آن فید دارد.
  • اگر افزونه نیاز به داشتن حساب کاربری داشته باشد، در صورتی که کاربر از قبل حساب کاربری نداشته باشد، لینک‌ها یا اطلاعاتی را برای ایجاد آسان حساب کاربری ارائه می‌دهد.
• این افزونه دارای آیتم‌های منو در زیر برگه افزونه‌ها است.
• حتی اگر افزونه فقط شامل توابع سفارشی باشد، باز هم شامل مستندات مناسب است.
• این افزونه به درستی از onInstall() و onOpen() برای پر کردن منوی خود استفاده می‌کند. موارد منو هنگام نصب اولیه افزونه و باز شدن یک فایل دیگر پر می‌شوند. به مجوز افزونه ویرایشگر مراجعه کنید.
• حالت‌های مجوز به درستی تنظیم شده‌اند. به بخش حالت‌های مجوز مراجعه کنید.
• این افزونه باید در محیط اجرایی V8 مربوط به Apps Script پیاده‌سازی شود. برای اطلاعات بیشتر، به بخش «مروری بر محیط اجرایی V8» مراجعه کنید.

• این افزونه تمام اطلاعات لازم برای درک اولیه محصول و نحوه استفاده از آن را ارائه می‌دهد.
• کد افزونه بیش از حد از کتابخانه‌ها استفاده نمی‌کند، زیرا کتابخانه‌ها می‌توانند باعث کاهش عملکرد افزونه شوند.
• در صورت امکان از خطاها اجتناب شده و به درستی مدیریت می‌شوند، در غیر این صورت:
  • پیام‌های خطا در یک پنجره محاوره‌ای نمایش داده می‌شوند، نه در یک هشدار جاوا اسکریپت یا در نوار قرمز پیش‌فرض. آن‌ها مشکل را بیان می‌کنند و به زبان ساده توضیح می‌دهند که کاربر برای رفع آن چه کاری باید انجام دهد.
  • در صورت امکان، اگر کاربر کار اشتباهی انجام دهد، دکمه‌ای نمایش داده می‌شود که مشکل را برای او برطرف می‌کند.
  • برای اطلاعات بیشتر، به راهنمای سبک افزونه‌ها مراجعه کنید.
• لینک‌های صفحات خارجی در پنجره‌های جدید باز می‌شوند و صحیح هستند.
• این افزونه بصری است و به خوبی طراحی شده است. این به این معنی است که:
  • همیشه مشخص است که چه کاری باید انجام شود و چگونه باید آن را انجام داد.
  • این افزونه قابل فهم و ساده است. از اصطلاحات فنی و اصطلاحات تخصصی اجتناب شده است.
  • گردش‌های کاری تا حد امکان واضح و تسهیل‌شده هستند.
  • کاربر و محتوای او تا حد امکان ایمن هستند.
• این افزونه از راهنمای سبک رابط کاربری برای افزونه‌های ویرایشگر پیروی می‌کند و از بسته CSS برای افزونه‌های ویرایشگر استفاده می‌کند.
• این افزونه فقط از یک اکشن اصلی آبی در هر نمایشگر استفاده می‌کند.
• این افزونه هر بار یک پنجره گفتگو را نمایش می‌دهد. همپوشانی ندارد یا چندین پنجره گفتگو همزمان باز نیستند.
• رابط کاربری افزونه به طور مرتب در فضاهای اختصاص داده شده جای می‌گیرد:
  • متن و برچسب‌ها با "..." قطع نمی‌شوند.
  • کاربر مجبور نیست پیمایش عمودی زیادی انجام دهد.
  • عرض محتوا از ۳۰۰p بیشتر نمی‌شود، بنابراین نوار پیمایش افقی ندارد.
• این افزونه برای تمام اقدامات حساس نیاز به تأیید دارد یا هشدارهایی را نمایش می‌دهد. برای مثال، اگر افزونه در شرف بازنویسی تمام محتوای یک صفحه گسترده باشد، به کاربر هشدار داده می‌شود و قبل از وقوع، اقدام را تأیید می‌کند.

  شما می‌توانید از طریق تغییرات طراحی از این الزام اجتناب کنید. به عنوان مثال، یک افزونه Google Sheets که داده‌ها را وارد می‌کند، خطر بازنویسی محتوای موجود را ایجاد می‌کند. می‌توانید با ایجاد یک برگه برای داده‌ها به عنوان اقدام پیش‌فرض، این خطر را از بین ببرید.

• کاربران نمی‌توانند چندین بار در حین بارگذاری یک عمل، آن را اجرا کنند. برای مثال، دکمه‌ها در حین بارگذاری یک عمل، خاموش یا پنهان می‌شوند.

افزونه‌های تقویم

• اگر افزونه از calendar.name یا common.name استفاده کند، نام موجود در مانیفست با نام ارائه شده در فهرست برنامه یکسان است.
• اگر افزونه از calendar.conferenceSolution استفاده کند، نام راهکار کنفرانس شامل «تقویم گوگل» نمی‌شود.
• ( توصیه می‌شود ) اگر افزونه از calendar.conferenceSolution استفاده می‌کند، نام راهکار کنفرانس نباید بیش از ۳۰ کاراکتر باشد.

• این افزونه از عنصر رابط کاربری صحیح (مانند ابزارک‌ها یا رابط کاربری iframe شده در افزونه‌های Meet) برای عملکرد مورد نظر استفاده می‌کند. برای مثال، از یک سوئیچ برای انتخاب یک مقدار بولی استفاده کنید.

افزونه‌های تقویم

• تقویم‌های ثانویه و واگذاری وظایف پشتیبانی می‌شوند، یا اگر پشتیبانی نمی‌شوند، به خوبی مدیریت می‌شوند. برای مثال، اگر کاربر هنگام ایجاد یک رویداد، تقویم دیگری را که به آن دسترسی ویرایش دارد انتخاب کند، ایجاد کنفرانس با شکست مواجه نمی‌شود.
• رویدادهای تکرارشونده به درستی کار می‌کنند.
• اگر افزونه از calendar.conferenceSolution استفاده کند، حداقل یک راهکار کنفرانس ارائه شده است.
• اگر افزونه، راهکارهای کنفرانس ارائه دهد، از فیلدهای داده کنفرانس مناسب استفاده می‌شود. برای مثال، لینک‌های کنفرانس ویدیویی، شماره تلفن‌ها، لینک‌های SIP، کدهای دسترسی و سایر ویژگی‌های پشتیبانی‌شده از فیلدهای داده ساختاریافته استفاده می‌کنند و در فیلد یادداشت‌ها ارائه نمی‌شوند.
• اگر افزونه راهکارهای کنفرانس ارائه دهد، فقط جزئیات کنفرانس را ویرایش می‌کند و هیچ فیلد رویداد دیگری را ویرایش نمی‌کند.
• اگر افزونه، راهکارهای کنفرانس ارائه دهد، ایجاد کنفرانس کمتر از ۵ ثانیه طول می‌کشد.

افزونه‌های جیمیل

اگر افزونه از UrlFetchApp یا OpenLinkUrl استفاده می‌کند:

• آدرس اینترنتی معتبر است.
• این آدرس اینترنتی (URL) از HTTPS به جای HTTP استفاده می‌کند.
• دامنه کامل مشخص شده است.
• مسیر خالی نیست. برای مثال، https://altostrat/ قابل قبول است، اما https://altostrat نه.
• نمی‌توان از کاراکترهای Wildcard در UrlFetchApp استفاده کرد.

با افزونه‌ها آشنا شوید

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

• این افزونه یک صفحه اصلی دارد. اگر افزونه Google Workspace شما یک افزونه Gmail تبدیل‌شده باشد، یک صفحه اصلی پیش‌فرض اعمال می‌شود.
• عنصر رابط کاربری (مانند کارت افزونه یا رابط کاربری آی‌فریم‌شده در افزونه‌های Meet) به درستی کار می‌کند. برای مثال، موارد تکراری وجود ندارد؛ دکمه‌های برگشت، به‌روزرسانی و رفرش به درستی کار می‌کنند.
• پس از اینکه کاربر افزونه را تأیید کرد، اطلاعاتی (مانند یک کارت صفحه اصلی سفارشی یا یک صفحه وب در افزونه‌های Meet) برای خوشامدگویی به کاربر نمایش داده می‌شود که شامل دکمه ورود (در صورت نیاز)، لوگو و شرح مختصری از افزونه است.
  • اگر دکمه ورود به سیستم فعال شود، یک صفحه ورود به سیستم سفارشی از فروشنده شخص ثالث نمایش داده می‌شود که به وضوح نشان می‌دهد یک سرویس شخص ثالث خارج از Google Workspace در حال کار است.
• رابط کاربری افزونه به طور مرتب در فضاهای اختصاص داده شده جای می‌گیرد:
  • متن و برچسب‌ها با "..." قطع نمی‌شوند.
  • کاربر مجبور نیست پیمایش عمودی زیادی انجام دهد.
  • عرض محتوا از ۳۰۰p بیشتر نمی‌شود، بنابراین نوار پیمایش افقی ندارد.
• کد افزونه بیش از حد از کتابخانه‌ها استفاده نمی‌کند، زیرا کتابخانه‌ها می‌توانند باعث کاهش عملکرد افزونه شوند.

افزونه‌های تقویم

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

افزونه‌های اسناد

اگر پیش‌نمایش‌های افزونه، لینک‌هایی از یک دامنه شخص ثالث (تراشه‌های هوشمند) را نشان می‌دهند:

• پیش‌نمایش لینک‌ها اطلاعات مرتبط و تکمیلی را به کاربر ارائه می‌دهد. برای مثال، پیش‌نمایش لینک یک معامله فروش، اطلاعاتی مانند حساب، مبلغ و مرحله را اضافه می‌کند.
• توسعه‌دهنده با دامنه‌ی پیش‌نمایش‌شده (الگوی URL مشخص‌شده‌ای که باعث ایجاد تراشه‌ی هوشمند می‌شود) مرتبط است.

برای اطلاعات بیشتر، به پیش‌نمایش لینک‌ها با تراشه‌های هوشمند مراجعه کنید.

افزونه‌های درایو

• اگر برنامه فایل‌ها را در درایو ذخیره کند، به کاربران اجازه می‌دهد یک پوشه انتخاب کنند یا یک پوشه مخصوص برنامه ایجاد و دوباره استفاده کنند. داده‌های پیکربندی را می‌توان در پوشه App Data ذخیره کرد. برنامه فایل‌ها را در پوشه My Drive کاربر ذخیره نمی‌کند.
• این افزونه فقط فایل‌هایی را در درایو ذخیره می‌کند که به عملکرد مستند افزونه متصل باشند.

افزونه‌های جیمیل

• این افزونه بدون هیچ دلیلی به افزونه‌های مرورگر کروم اشاره نمی‌کند یا به آنها لینک نمی‌دهد.
• منوی «اقدامات بیشتر more_vert شامل اقدامات عمومی است که به درستی کار می‌کنند. برای مثال، خروج، درباره، پشتیبانی و غیره.

با افزونه‌ها آشنا شوید

• اگر افزونه نیاز به مجوز یا اشتراک دارد: وقتی کاربر مجوز ندارد، باید یک پیام کاربرپسند به او نشان داده شود.
• اگر کاربر به دلیل مشکل مجوز نتواند از افزونه استفاده کند، پیام خطا باید به وضوح دلیل عدم امکان استفاده از افزونه را بیان کند و راهکاری را برای رفع مشکل به کاربر پیشنهاد دهد.
• فهرست افزونه در Google Workspace Marketplace باید جزئیات مربوط به مجوز و الزامات اشتراکی که ممکن است برای استفاده از افزونه لازم باشد را مشخص کند. اگر افزونه دارای سطح پولی باشد، فهرست Marketplace باید پیوندی به صفحه وبی ارائه دهد که اطلاعات بیشتری در مورد قیمت‌گذاری یا نحوه تماس با فروشنده ارائه می‌دهد.
• وقتی کاربر هنوز وارد سیستم نشده باشد، افزونه باید گزینه ورود با یک ضربه (One Tap) که در Display Google One Tap و گزینه جایگزین «ورود با گوگل» که در Authentication موجود است را نمایش دهد. علاوه بر مکانیزم «ورود با گوگل»، ممکن است گزینه‌های ورود دیگری نیز ارائه شود.
• افزونه باید طراحی واکنش‌گرا داشته باشد تا بتواند محتوا را با اندازه‌های مختلف تطبیق دهد.
• مسیرهای کاربر افزونه باید حتی در صورت غیرفعال بودن کوکی‌های شخص ثالث، فعال باشند.
• افزونه نباید درون iframe پیمایش افقی داشته باشد.
• اگر یک افزونه بخواهد از مرحله اصلی استفاده کند، باید برای تجربیات چند نفره طراحی شده باشد و امکان دستکاری محتوا توسط چندین شرکت کننده را به طور همزمان فراهم کند. برای تجربیات تک نفره، توسعه دهنده باید از پنل کناری استفاده کند.
• ( توصیه شده ) افزونه باید کاربر وارد شده را نمایش دهد.
• ( توصیه شده ) انتخاب محلی‌سازی: زبان باید بر اساس ترجیحات محلی تنظیم شده توسط مرورگر در صورت وجود، انتخاب شود.
• ( توصیه می‌شود ) انتخاب محتوا باید از طریق یک رابط مرور محتوا که شامل محتوای اخیراً مشاهده شده است، انجام شود.
• ( توصیه می‌شود ) اگر دیگر به پنل کناری نیازی نیست، افزونه باید پس از راه‌اندازی به صحنه اصلی، پنل کناری را ببندد .

افزونه‌های تقویم

• لوگوی راهکار کنفرانس یک URL عمومی است. به بخش «ارائه لوگوهای راهکار کنفرانس» مراجعه کنید.
• اگر افزونه از calendar.conferenceSolution استفاده کند، لوگوی راهکار کنفرانس از الزامات calendar.logoUrl پیروی می‌کند. به منبع مانیفست تقویم مراجعه کنید.
• اگر افزونه از calendar.logoUrl یا common.logoUrl استفاده کند، لوگو با آیکون ارائه شده در فهرست برنامه یکسان است.
• اگر افزونه از calendar.logoUrl یا common.logoUrl استفاده کند، آدرس اینترنتی لوگو به صورت زیر شروع می‌شود: https://lh3.googleusercontent.com/

با افزونه‌ها آشنا شوید

• لوگوی برند افزونه باید از نظر اندازه و سبک به گونه‌ای باشد که در پنل کناری Meet قابل شناسایی باشد.
• نشانی‌های اینترنتی مناسب برای لوگوی حالت تاریک باید در مانیفست افزونه مشخص شوند.

افزونه‌های درایو

• ( توصیه می‌شود ) اگر می‌خواهید فراداده‌های محدود دریافت کنید، افزونه شامل دامنه‌ی drive.addons.metadata.readonly است.

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