این صفحه نحوه استفاده از Google Workspace Marketplace SDK را برای پیکربندی و مدیریت برنامه خود در Google Workspace Marketplace توضیح می دهد.
برای اینکه برنامه خود را برای استفاده در دسترس قرار دهید، باید آن را در Marketplace SDK تنظیم کنید. Marketplace SDK یک جعبه ابزار است که به شما امکان می دهد برنامه خود را در Google Workspace Marketplace ایجاد و کنترل کنید. شما از Marketplace SDK برای مدیریت تنظیمات Marketplace مانند موارد زیر استفاده می کنید:
- آیا برنامه شما برای یک سازمان Google Workspace خاص (یک برنامه خصوصی ) در دسترس است یا برای همه کاربران Marketplace (یک برنامه عمومی )
- انواع کاربران Marketplace که می توانند برنامه شما را نصب کنند
- برنامه شما با کدام برنامه Google Workspace ادغام می شود
- دامنه های OAuth که برنامه شما به آن نیاز دارد
- اطلاعاتی در مورد اینکه چه کسی برنامه را ساخته و نگهداری می کند
صرف نظر از اینکه برنامه خود را به صورت خصوصی یا عمومی منتشر می کنید، باید از Marketplace SDK برای مدیریت برنامه خود در Marketplace استفاده کنید.
بازار SDK را فعال کنید
اگر قبلاً این کار را نکرده‌اید، در پروژه Google Cloud خود، Google Workspace Marketplace SDK را فعال کنید.
پروژه Cloud خود را در کنسول Google Cloud باز کنید
اگر قبلاً باز نشده است، پروژه Cloud را که می‌خواهید برای این نمونه استفاده کنید باز کنید:
- در کنسول Google Cloud، به صفحه انتخاب پروژه بروید.
- پروژه Google Cloud را که می خواهید استفاده کنید انتخاب کنید. یا روی ایجاد پروژه کلیک کنید و دستورالعمل های روی صفحه را دنبال کنید. اگر یک پروژه Google Cloud ایجاد می‌کنید، ممکن است لازم باشد صورت‌حساب پروژه را روشن کنید .
Google Workspace Marketplace SDK را روشن کنید
قبل از استفاده از Google API، باید آنها را در پروژه Google Cloud روشن کنید. می‌توانید یک یا چند API را در یک پروژه Google Cloud روشن کنید.در کنسول Google Cloud، Google Workspace Marketplace SDK را فعال کنید.
تنظیمات پیکربندی برنامه خود را تعیین کنید
مرجع زیر تنظیمات موجود در صفحه پیکربندی برنامه Marketplace SDK را شرح می دهد.
انتخاب کنید چه کسی می تواند برنامه شما را مشاهده و نصب کند
وقتی برنامه خود را پیکربندی می‌کنید، کاربرانی را مشخص می‌کنید که می‌توانند با استفاده از تنظیمات زیر به برنامه شما دسترسی داشته باشند:
- نمایان بودن برنامه : اگر برنامه‌ای را در یک سازمان Google Workspace منتشر می‌کنید، خواه فهرست برنامه‌تان فهرست نشده باشد، برای همه کاربران سازمان شما قابل مشاهده باشد یا هر کسی که از Google Workspace استفاده می‌کند.
- تنظیمات نصب : آیا این برنامه فقط توسط سرپرستان Google Workspace قابل نصب است یا خیر.
صرف نظر از تنظیماتی که در فهرست برنامه خود مشخص می کنید، کاربرانی که متعلق به یک سازمان Google Workspace هستند ممکن است نتوانند برنامه شما را بر اساس تنظیمات تنظیم شده توسط سرپرستان خود کشف، نصب یا استفاده کنند. مدیران می توانند به روش های زیر بر در دسترس بودن برنامه شما تأثیر بگذارند:
- کنترل کنید که آیا کاربران آنها می‌توانند برنامه‌ها را در Marketplace مشاهده کنند و برنامه‌ها را از طرف کاربران خود نصب کنند.
- از یک لیست مجاز برای مدیریت و مدیریت برنامه ها برای سازمان خود استفاده کنید. اگر در حال توسعه برنامه‌ای برای سازمانی هستید که از لیست‌های مجاز استفاده می‌کند، درباره افزودن برنامه به فهرست مجاز با یک سرپرست مشورت کنید.
- برخی از برنامه‌های Google Workspace را خاموش کنید، مانند حذف دسترسی به Google Chat، برنامه‌های Google Chat یا هر دو. در این موارد، کاربران نمی‌توانند برنامه شما را از Marketplace نصب کنند.
برای آشنایی با نحوه مدیریت دسترسی مدیران به Marketplace، به مستندات راهنمای مدیریت بازار مراجعه کنید.
تنظیمات مشاهده برنامه
اگر از حساب Google Workspace (حساب ایجاد شده توسط سازمان محل کار یا مدرسه شما) استفاده می کنید، گزینه App Visibility را می بینید. اگر از یک حساب مصرف کننده استفاده می کنید (یک حساب که با "gmail.com@" ختم می شود)، فقط می توانید به صورت عمومی منتشر کنید.
- عمومی : این برنامه را می‌توان توسط افرادی خارج از دامنه شما پیدا و نصب کرد. اگر نمایان بودن عمومی را انتخاب کنید، Google فهرست برنامه شما را قبل از انتشار بررسی و تأیید می‌کند.
- خصوصی : فقط افرادی که در دامنه شما هستند می توانند برنامه شما را پیدا و نصب کنند.
اگر انتخاب کنید که به‌عنوان فهرست‌نشده منتشر کنید، فهرست برنامه در نتایج مرور یا جستجو نشان داده نمی‌شود. کاربران فقط با URL مستقیم می توانند به صفحه فروشگاه برنامه دسترسی داشته باشند.
اگر می‌خواهید محدود کنید که برنامه شما در کدام کشورها و مناطق در دسترس است، هنگام ایجاد فهرست فروشگاه ، آن را در بخش توزیع تنظیم می‌کنید.
تنظیمات نصب برنامه
گزینه Installation Settings تعیین می کند که آیا کاربران یا مدیران Google Workspace می توانند برنامه شما را از صفحه فهرست فروشگاه شما در Google Workspace Marketplace نصب کنند.
- Individual + Admin Install (پیش‌فرض) : برنامه را می‌توان توسط کاربران فردی یا توسط ادمین‌های دامنه، واحد سازمانی یا گروهی از کاربران نصب کرد. خط‌مشی‌های دامنه کاربر ممکن است از نصب یک برنامه جلوگیری کند، حتی اگر نصب‌های جداگانه فعال باشد.
- نصب فقط ادمین : این برنامه را فقط مدیران دامنه، واحد سازمانی یا گروهی از کاربران می‌توانند نصب کنند. برنامه شما فقط در نتایج جستجوی Google Workspace Marketplace برای مدیران و افرادی که به حساب Google خود وارد نشده‌اند نشان داده می‌شود. اگر برنامه شما نیاز به نصب دامنه دارد، این گزینه را انتخاب کنید.
نصب متداول و تنظیمات دید
جدول زیر برخی از گزینه های رایج پیکربندی برنامه را برای نصب و مشاهده خلاصه می کند:
| کاربران برنامه مورد نظر | تنظیم نمایان بودن برنامه | تنظیمات نصب برنامه | چه کسی می تواند برنامه من را نصب کند؟ | چه کسی می تواند از برنامه من استفاده کند؟ | |
|---|---|---|---|---|---|
| برای برنامه های ساخته شده برای یک سازمان Google Workspace | |||||
| کاربران خاص در سازمان شما | خصوصی و فهرست نشده | فردی + نصب ادمین | در صورت اجازه، هر کسی در سازمان شما که نشانی وب فهرست برنامه را دارد. | در صورت اجازه، هر کسی در سازمان شما که نشانی وب فهرست برنامه را دارد. | |
| سازمان شما | خصوصی | فردی + نصب ادمین | در صورت اجازه، هر کسی در سازمان شما. | در صورت اجازه، هر کسی در سازمان شما. | |
| سازمان شما | خصوصی | فقط مدیر | مدیران | کاربرانی که برنامه را توسط سرپرست خود نصب کرده اند. | |
| برای برنامه‌هایی که در دسترس کاربران خارج از یک سازمان Google Workspace خاص هستند | |||||
| کاربران در سازمان‌های Google Workspace | عمومی | فقط مدیر | مدیران | کاربرانی که برنامه را توسط سرپرست خود نصب کرده اند. | |
| همه کاربران Google Workspace | عمومی | فردی + نصب ادمین |
|
| |
نحوه ادغام برنامه شما با برنامه های Google Workspace را مشخص کنید
خدمات Google Workspace را انتخاب کنید که برنامه یا افزونه شما برای کار با آن طراحی شده است، مانند افزونه Google Workspace یا برنامه Google Chat. شما باید حداقل یک گزینه را انتخاب کنید. در برخی موارد، می توانید چندین ادغام برنامه را در فهرست برنامه خود قرار دهید. فهرست ادغام برنامه ها را با هم ببینید.
بسته به ادغام برنامه‌هایی که انتخاب می‌کنید، ممکن است لازم باشد اطلاعات بیشتری ارائه دهید و APIهای مربوطه را در پروژه Google Cloud خود فعال کنید. جدول زیر تنظیمات اضافی مورد نیاز برای هر یک را شرح می دهد:
افزونه Google Workspace (Apps Script)
برای انتشار افزونه Google Workspace، باید شناسه استقرار برافزا را ارائه دهید. برای یافتن شناسه استقرار، مراحل زیر را دنبال کنید:
- افزونه Google Workspace خود را در ویرایشگر Apps Script باز کنید.
- روی Deploy > Manage Deployments کلیک کنید.
- در زیر شناسه استقرار، روی Copy کلیک کنید.
افزونه Google Workspace (استقرار HTTP)
اگر افزونه Google Workspace خود را با استفاده از نقاط پایانی HTTP ساخته‌اید، این مراحل را دنبال کنید تا شناسه استقرار را از منبع استقرار Google Cloud دریافت کنید.
- در صفحه پیکربندی برنامه در بخش «افزونه Google Workspace»، روی HTTP یا سایر موارد استقرار > انتخاب استقرار کلیک کنید.
- استقرار مورد نظر برای انتشار را انتخاب کنید.
- روی انتخاب کلیک کنید.
افزودنی ویرایشگر (اسناد، برگه‌ها، اسلایدها، فرم‌ها)
برای انتشار یک افزونه ویرایشگر، باید شناسه اسکریپت پروژه و نسخه ای را که می خواهید منتشر کنید ارائه دهید.
برای پیدا کردن شناسه اسکریپت پروژه، مراحل زیر را دنبال کنید:
- افزونه را در ویرایشگر Apps Script باز کنید.
- در سمت چپ، روی تنظیمات پروژه کلیک کنید.
- در بخش «IDs»، شناسه اسکریپت را کپی کنید.
برای پیدا کردن نسخه، مراحل زیر را دنبال کنید:
- افزونه را در ویرایشگر Apps Script باز کنید.
- در بالا سمت چپ، روی Deploy > Manage Deployments کلیک کنید.
- شماره نسخه در قسمت "پیکربندی" است.
برنامه چت گوگل
برای انتشار یک برنامه Google Chat، باید Google Chat API را پیکربندی کنید. به انتشار برنامه‌های گپ Google مراجعه کنید.
برنامه Drive
برای انتشار یک برنامه Drive، باید Google Drive API را فعال و پیکربندی کنید.
برنامه وب
برای انتشار یک برنامه وب، باید URL ناوبری جهانی آن را ارائه دهید، نشانی اینترنتی که از منوی برنامه های Google به برنامه وب اشاره می کند. برنامه وب شما باید در حال تولید و کاملاً کاربردی باشد.
وقتی صفحه فهرست فروشگاه را پر می‌کنید، باید نمادهای دیگری در اندازه‌های ۹۶×۹۶ و ۴۸×۴۸ پیکسل ارائه دهید.
اگر برنامه وب خود را در Apps Script ساخته اید، این مراحل را دنبال کنید تا URL ناوبری جهانی را دریافت کنید:
- افزونه Google Workspace خود را در ویرایشگر Apps Script باز کنید.
- روی Deploy > New Deployment کلیک کنید.
- در بخش «انتخاب نوع»، روی برنامه وب کلیک کنید.
- گزینه ها را پر کنید و روی Deploy کلیک کنید.
- روی Copy کلیک کنید.
سطح دسترسی مورد نیاز برنامه خود را مشخص کنید
در زیر OAuth Scopes ، فهرست کاملی از دامنه های OAuth 2.0 را که برنامه شما نیاز دارد ارائه دهید. محدوده‌های OAuth که در اینجا وارد می‌کنید باید با آنچه در صفحه رضایت OAuth خود نشان می‌دهید و در صورت وجود با مانیفست Apps Script مطابقت داشته باشد.
اگر بیش از یک برنامه ادغام می‌کنید، مطمئن شوید که دامنه‌های هر یک را به صفحه پیکربندی برنامه SDK Marketplace و صفحه رضایت OAuth خود اضافه کرده‌اید.
همیشه از باریک‌ترین دامنه‌های ممکن استفاده کنید (مثلاً اگر فقط به یک محدوده فقط خواندنی نیاز دارید، یک محدوده کامل Drive را وارد نکنید).
برای پروژه های Apps Script، برای جزئیات بیشتر به محدوده مجوز مراجعه کنید.
اطلاعاتی در مورد توسعه دهنده برنامه ارائه دهید
در قسمت اطلاعات برنامه‌نویس ، اطلاعات تماس و سایر جزئیات را پر کنید. این فیلدها در صفحه فهرست فروشگاه برنامه شما ظاهر می شوند.
| فیلدها | |
|---|---|
| وضعیت معامله گر | با توجه به قوانین حمایت از مصرف کننده، مصرف کنندگان مستقر در منطقه اقتصادی اروپا (EEA) باید مطلع شوند که آیا یک تاجر در Google Workspace Marketplace یک تاجر است یا یک غیر تاجر :
اگر مشخص نشده باشد، "وضعیت معامله گر نامشخص" در صفحه فهرست فروشگاه برنامه شما ظاهر می شود. |
| نام توسعه دهنده | نامی که باید به عنوان نویسنده برنامه نمایش داده شود. اگر معامله گر هستید، نام تجاری یا نام قانونی خود را وارد کنید. |
| آدرس پستی توسعه دهنده | برای معامله گران مورد نیاز است. برای غیر تاجران جمع آوری نشده است. محل کسب و کار شما آدرس پستی معتبری را وارد کنید تا بتوان با شما تماس گرفت. |
| آدرس وب سایت توسعه دهنده | وب‌سایتی که شما (یا سازمانتان) را به‌عنوان توسعه‌دهنده توصیف می‌کند. |
| ایمیل برنامه نویس | آدرس ایمیل برای استفاده به عنوان نقطه تماس. در فهرست برنامه شما گنجانده نشده است. اطمینان حاصل کنید که این آدرس ایمیل هنگام استفاده به روز نگه داشته می شود:
|
| آدرس وب سایت برنامه | اختیاری. وب‌سایتی که برنامه شما را بیشتر توضیح می‌دهد. |
تنظیمات پیکربندی برنامه خود را در Marketplace SDK ذخیره کنید
با استفاده از اطلاعات بخش قبلی ، پیکربندی برنامه خود را در Marketplace SDK ذخیره کنید:
در کنسول Google Cloud، به صفحه پیکربندی SDK Marketplace بروید:
هر بخش را بر اساس آنچه در بخش قبل تعیین کردید پر کنید.
روی ذخیره کلیک کنید.
(اختیاری) می توانید تجزیه و تحلیل استفاده از برنامه را در Google Analytics دریافت کنید. برای انجام این کار، شناسه Google Analytics را در Marketplace SDK اضافه کنید.
- به تب Analytics بروید.
- شناسه Google Analytics خود را وارد کنید.
- روی ذخیره کلیک کنید.