برنامه خود را در Google Workspace Marketplace SDK پیکربندی کنید

این صفحه نحوه استفاده از Google Workspace Marketplace SDK را برای پیکربندی و مدیریت برنامه خود در Google Workspace Marketplace توضیح می دهد.

برای اینکه برنامه خود را برای استفاده در دسترس قرار دهید، باید آن را در Google Workspace Marketplace SDK راه اندازی کنید. Google Workspace Marketplace SDK ابزاری است که به شما امکان می دهد برنامه خود را در Google Workspace Marketplace ایجاد و کنترل کنید. شما از Google Workspace Marketplace SDK برای مدیریت تنظیمات Marketplace مانند موارد زیر استفاده می‌کنید:

• آیا برنامه شما برای یک سازمان Google Workspace خاص (یک برنامه خصوصی ) در دسترس است یا برای همه کاربران Marketplace (یک برنامه عمومی )
• انواع کاربران Marketplace که می توانند برنامه شما را نصب کنند
• برنامه شما با کدام برنامه Google Workspace ادغام می شود
• دامنه های OAuth که برنامه شما به آن نیاز دارد
• اطلاعاتی در مورد اینکه چه کسی برنامه را ساخته و نگهداری می کند

صرف نظر از اینکه برنامه خود را به صورت عمومی یا خصوصی منتشر می کنید، باید از Google Workspace Marketplace SDK برای مدیریت برنامه خود در Marketplace استفاده کنید.

Google Workspace Marketplace SDK را فعال کنید

اگر قبلاً این کار را نکرده‌اید، در پروژه Google Cloud خود، Google Workspace Marketplace SDK را فعال کنید:

1. کنسول Google Cloud را باز کنید.
2. در بالا، روی انتخاب پروژه کلیک کنید. اگر پروژه Google Cloud دیگری از قبل باز است، روی نام پروژه Cloud کلیک کنید تا پروژه‌های Cloud را تغییر دهید.
3. پروژه Cloud برنامه خود را انتخاب کنید و روی Open کلیک کنید.
4. در بالا، در نوار جستجو، Google Workspace Marketplace SDK را تایپ کرده و enter را فشار دهید.

5. صفحه Google Workspace Marketplace SDK را باز کنید.

   هشدار: مطمئن شوید که Google Workspace Marketplace SDK را فعال کرده اید، نه API. Google Workspace Marketplace API ابزار متفاوتی است که برای ادغام با خدمات صدور مجوز و صورت‌حساب Google استفاده می‌شود.

6. اگر Google Workspace Marketplace SDK قبلاً فعال نشده است، روی فعال کردن کلیک کنید.

تنظیمات پیکربندی برنامه خود را تعیین کنید

مرجع زیر تنظیمات موجود در صفحه پیکربندی برنامه Google Workspace 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 مستقیم می توانند به صفحه فروشگاه برنامه دسترسی داشته باشند.

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

تنظیمات نصب برنامه

تنظیمات نصب تعیین می کند که آیا کاربران یا سرپرستان Workspace می توانند برنامه شما را از صفحه فهرست فروشگاه شما در Google Workspace Marketplace نصب کنند یا خیر.

توجه: برای برنامه‌های گپ Google، فقط می‌توانید Individual + Admin Install را انتخاب کنید زیرا افراد می‌توانند برنامه‌های Chat را مستقیماً از Google Chat کشف و نصب کنند. برای جزئیات در مورد نحوه نصب، به انتشار برنامه‌های گپ Google مراجعه کنید.

• Individual + Admin Install (پیش‌فرض) : برنامه را می‌توان توسط کاربران فردی یا توسط ادمین‌های دامنه، واحد سازمانی یا گروهی از کاربران نصب کرد. خط‌مشی‌های دامنه کاربر ممکن است از نصب یک برنامه جلوگیری کند، حتی اگر نصب‌های جداگانه فعال باشد.
• نصب فقط ادمین : این برنامه را فقط مدیران دامنه، واحد سازمانی یا گروهی از کاربران می‌توانند نصب کنند. برنامه شما فقط در نتایج جستجوی Google Workspace Marketplace برای مدیران و افرادی که به حساب Google خود وارد نشده‌اند نشان داده می‌شود. اگر برنامه شما نیاز به نصب دامنه دارد، این گزینه را انتخاب کنید.

نصب متداول و تنظیمات دید

جدول زیر برخی از گزینه های رایج پیکربندی برنامه را برای نصب و مشاهده خلاصه می کند:

کاربران برنامه مورد نظر	تنظیم نمایان بودن برنامه	تنظیمات نصب برنامه	چه کسی می تواند برنامه من را نصب کند؟	چه کسی می تواند از برنامه من استفاده کند؟
برای برنامه های ساخته شده برای یک سازمان Google Workspace
کاربران خاص در سازمان شما	خصوصی و فهرست نشده	فردی + نصب ادمین	در صورت اجازه، هر کسی در سازمان شما که نشانی وب فهرست برنامه را دارد.	در صورت اجازه، هر کسی در سازمان شما که نشانی وب فهرست برنامه را دارد.
سازمان شما	خصوصی	فردی + نصب ادمین	در صورت اجازه، هر کسی در سازمان شما.	در صورت اجازه، هر کسی در سازمان شما.
سازمان شما	خصوصی	فقط مدیر	مدیران	کاربرانی که برنامه را توسط سرپرست خود نصب کرده اند.
برای برنامه‌هایی که در دسترس کاربران خارج از یک سازمان Google Workspace خاص هستند
کاربران در سازمان‌های Google Workspace	عمومی	فقط مدیر	مدیران	کاربرانی که برنامه را توسط سرپرست خود نصب کرده اند.
همه کاربران Google Workspace	عمومی	فردی + نصب ادمین	هر کسی که از برنامه های 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، باید شناسه استقرار برافزا را ارائه دهید. برای یافتن شناسه استقرار، مراحل زیر را دنبال کنید:

1. افزونه Google Workspace خود را در ویرایشگر Apps Script باز کنید.
2. روی Deploy > Manage Deployments کلیک کنید.
3. در زیر شناسه استقرار، روی Copy کلیک کنید.

افزونه Google Workspace (استقرار HTTP)

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

1. در صفحه پیکربندی برنامه در بخش «افزونه Google Workspace»، روی «استقرار با استفاده از منبع استقرار ابری» > «استقرار» را انتخاب کنید.
2. استقرار مورد نظر برای انتشار را انتخاب کنید.
3. روی انتخاب کلیک کنید.

افزودنی ویرایشگر (اسناد، برگه‌ها، اسلایدها، فرم‌ها)

برای انتشار یک افزونه ویرایشگر، باید شناسه اسکریپت پروژه و نسخه ای را که می خواهید منتشر کنید ارائه دهید.

برای پیدا کردن شناسه اسکریپت پروژه، مراحل زیر را دنبال کنید:

1. افزونه را در ویرایشگر Apps Script باز کنید.
2. در سمت چپ، روی تنظیمات پروژه کلیک کنید.
3. در بخش «IDs»، شناسه اسکریپت را کپی کنید.

برای پیدا کردن نسخه، مراحل زیر را دنبال کنید:

1. افزونه را در ویرایشگر Apps Script باز کنید.
2. در بالا سمت چپ، روی Deploy > Manage Deployments کلیک کنید.
3. شماره نسخه در قسمت "پیکربندی" است.

برنامه چت گوگل

برای انتشار یک برنامه Google Chat، باید Google Chat API را پیکربندی کنید. به انتشار برنامه ها مراجعه کنید.

برنامه Drive

برای انتشار یک برنامه Drive، باید Drive API را فعال و پیکربندی کنید.

برنامه وب

برای انتشار یک برنامه وب، باید URL ناوبری جهانی آن را ارائه دهید، نشانی اینترنتی که از منوی برنامه های Google به برنامه وب اشاره می کند. برنامه وب شما باید در حال تولید و کاملاً کاربردی باشد.

وقتی صفحه فهرست فروشگاه را پر می‌کنید، باید نمادهای دیگری در اندازه‌های ۹۶×۹۶ و ۴۸×۴۸ پیکسل ارائه دهید.

اگر برنامه وب خود را در Apps Script ساخته اید، برای دریافت URL ناوبری جهانی، این مراحل را دنبال کنید:

1. افزونه Google Workspace خود را در ویرایشگر Apps Script باز کنید.
2. روی Deploy > New Deployment کلیک کنید.
3. در بخش «انتخاب نوع»، روی برنامه وب کلیک کنید.
4. گزینه ها را پر کنید و روی Deploy کلیک کنید.
5. روی Copy کلیک کنید.

سطح دسترسی مورد نیاز برنامه خود را مشخص کنید

در زیر OAuth Scopes ، فهرست کاملی از محدوده های OAuth مورد نیاز برنامه خود را ارائه دهید. محدوده‌های OAuth که در اینجا وارد می‌کنید باید با آنچه در صفحه رضایت OAuth خود نشان می‌دهید و در صورت وجود با مانیفست Apps Script مطابقت داشته باشد.

اگر بیش از یک برنامه ادغام می‌کنید، مطمئن شوید که دامنه‌های هر یک را به صفحه پیکربندی برنامه SDK بازار Google Workspace و صفحه رضایت OAuth خود اضافه کرده‌اید.

همیشه از باریک‌ترین دامنه‌های ممکن استفاده کنید (مثلاً اگر فقط به یک محدوده فقط خواندنی نیاز دارید، یک محدوده کامل Drive را وارد نکنید).

برای پروژه های Apps Script، برای جزئیات بیشتر به Scopes مراجعه کنید.

اطلاعاتی در مورد توسعه دهنده برنامه ارائه دهید

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

فیلدها
وضعیت معامله گر	با توجه به قوانین حمایت از مصرف کننده، مصرف کنندگان مستقر در منطقه اقتصادی اروپا (EEA) باید مطلع شوند که آیا یک تاجر در Google Workspace Marketplace یک تاجر است یا یک غیر تاجر : تاجر - تاجر شخصی است که برای اهداف مربوط به یک تجارت، تجارت، صنعت یا حرفه فعالیت می کند. یا به نام یا از طرف یک تاجر. غیر تاجر - غیر تاجر (مصرف کننده) شخصی است که برای مقاصد غیر حرفه ای عمل می کند. اگر مشخص نشده باشد، "وضعیت معامله گر نامشخص" در صفحه فهرست فروشگاه برنامه شما ظاهر می شود.
آدرس پستی توسعه دهنده	برای معامله گران مورد نیاز است. برای غیر تاجران جمع آوری نشده است. محل کسب و کار شما آدرس پستی معتبری را وارد کنید تا بتوان با شما تماس گرفت.
نام توسعه دهنده	نامی که باید به عنوان نویسنده برنامه نمایش داده شود. اگر معامله گر هستید، نام تجاری یا نام قانونی خود را وارد کنید.
آدرس وب سایت توسعه دهنده	وب‌سایتی که شما (یا سازمانتان) را به‌عنوان توسعه‌دهنده توصیف می‌کند.
ایمیل توسعه دهنده	آدرس ایمیل برای استفاده به عنوان نقطه تماس. در فهرست برنامه شما گنجانده نشده است. مطمئن شوید که این آدرس ایمیل به‌روز نگه داشته می‌شود—از آن استفاده می‌شود: اگر Google نیاز به تماس با توسعه دهنده داشته باشد - برای مثال، در طول فرآیند بررسی برنامه. برای ارسال بازخورد از افزونه‌های ویرایشگر اگر نشانی وب گزارش مشکل در صفحه فهرست فروشگاه ارائه نشده است.
آدرس وب سایت برنامه	اختیاری. وب‌سایتی که برنامه شما را بیشتر توضیح می‌دهد.

تنظیمات پیکربندی برنامه خود را در Google Workspace Marketplace SDK ذخیره کنید

با استفاده از اطلاعات بخش قبلی ، پیکربندی برنامه خود را در Google Workspace Marketplace SDK ذخیره کنید:

1. Google Workspace Marketplace SDK را باز کنید.
2. به تب App Configuration بروید.
3. هر بخش را بر اساس آنچه در بخش قبل تعیین کردید پر کنید.
4. روی ذخیره کلیک کنید.
5. (اختیاری) می توانید تجزیه و تحلیل استفاده از برنامه را در Google Analytics دریافت کنید. برای انجام این کار، شناسه Google Analytics را در Google Workspace Marketplace SDK اضافه کنید.
   1. به تب Analytics بروید.
   2. شناسه Google Analytics خود را وارد کنید.
   3. روی ذخیره کلیک کنید.