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

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

• هر بار که کاربر یک پیام مستقیم را شروع می کند یا برنامه به یک فاصله اضافه می شود، برنامه یک پیام خوشامدگویی بدون درخواست ارسال می کند. پیام خوشامدگویی با دستور "Help" متفاوت است. برای اطلاعات بیشتر، به ساخت صفحه اصلی برای برنامه چت Google مراجعه کنید.
• این برنامه از دستور "Help" پشتیبانی می کند و به کاربران کمک می کند تا استفاده از برنامه را شروع کنند. برای اطلاعات بیشتر، پاسخ به دستورات اسلش را ببینید.
• این برنامه همیشه هنگام صحبت در یک فضا یا چت مستقیم پاسخ می دهد.
• پیام ها از املا، حروف بزرگ، نقطه گذاری و دستور زبان درست استفاده می کنند. پیام ها حاوی مطالب مخرب، توهین آمیز یا توهین آمیز نیستند.
• پیام‌ها از قالب‌بندی واضح، مختصر و ثابت برای متن یا کارت‌ها مطابق با الزامات Google استفاده می‌کنند.
• اگر پاسخ بیش از 2 ثانیه طول بکشد، برنامه پیامی برای توضیح تاخیر ارسال می کند.
• برنامه‌هایی که اعلان‌ها را ارسال می‌کنند به کاربران اجازه می‌دهند اعلان‌ها را خاموش کنند.
• کاربران می توانند برنامه را با استفاده از @mentioning به یک فضا اضافه کنند.
• کاربران می توانند با استفاده از منوی مشاهده عضو ، برنامه را از یک فضا حذف کنند.
• این برنامه هر چیزی را که برای تعامل با آن لازم است به کاربر نشان می دهد.
• قالب کارت‌هایی که برنامه استفاده می‌کند با الزامات Google مطابقت دارد. به ایجاد کارت های تعاملی مراجعه کنید.
• این برنامه از گزینه Find apps در منوی چت در دسترس است.
• نشانی‌های وب خارجی که برنامه با آنها تعامل دارد، به محیط مرحله‌بندی یا توسعه تعلق ندارند.
• ذکر @ در هر پیامی که در فاصله‌ها به برنامه ارسال می‌شود الزامی است. این تنها راهی است که برنامه می داند که باید پاسخ دهد.
• اگر برنامه چت پیوندهای یک دامنه شخص ثالث را پیش‌نمایش می‌کند:
  • پیش نمایش پیوندها اطلاعات مرتبط و تکمیلی را به پیام کاربر ارائه می دهد. به عنوان مثال، پیش نمایش یک پیوند به یک معامله فروش اطلاعاتی مانند حساب، مبلغ و مرحله را اضافه می کند.
  • توسعه دهنده به دامنه پیش نمایش شده وابسته است.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• URL معتبر است.
• URL از HTTPS استفاده می کند نه HTTP.
• دامنه کامل مشخص شده است.
• مسیر خالی نیست به عنوان مثال، https://altostrat/ خوب است، اما https://altostrat نیست.
• حروف عام را نمی توان در UrlFetchApp استفاده کرد.

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

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

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

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

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

افزونه های Docs

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

• پیش نمایش پیوندها اطلاعات مرتبط و تکمیلی را به کاربر ارائه می دهد. به عنوان مثال، پیش نمایش یک پیوند به یک معامله فروش اطلاعاتی مانند حساب، مبلغ و مرحله را اضافه می کند.
• توسعه دهنده به دامنه پیش نمایش شده وابسته است.

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

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

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

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

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

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

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

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

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

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

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

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

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

• URL ناوبری جهانی به یک برنامه وب اشاره می کند. یک صفحه وب ساده بدون عملکرد، یک برنامه وب محسوب نمی شود.