برنامه خود را در 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 را باز کنید.

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 نصب کنند یا خیر.

• 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 خود فعال کنید. جدول زیر تنظیمات اضافی مورد نیاز برای هر یک را شرح می دهد:

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

در زیر 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. روی ذخیره کلیک کنید.