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

این صفحه نحوه استفاده از 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 را که می‌خواهید برای این نمونه استفاده کنید باز کنید:

1. در کنسول Google Cloud، به صفحه انتخاب پروژه بروید.

   یک پروژه Cloud را انتخاب کنید

2. پروژه Google Cloud را که می خواهید استفاده کنید انتخاب کنید. یا روی ایجاد پروژه کلیک کنید و دستورالعمل های روی صفحه را دنبال کنید. اگر یک پروژه Google Cloud ایجاد می‌کنید، ممکن است لازم باشد صورت‌حساب پروژه را روشن کنید .

Google Workspace Marketplace SDK را روشن کنید

قبل از استفاده از Google API، باید آنها را در پروژه Google Cloud روشن کنید. می‌توانید یک یا چند API را در یک پروژه Google Cloud روشن کنید.

• در کنسول Google Cloud، Google Workspace Marketplace SDK را فعال کنید.

  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 Workspace.

نحوه ادغام برنامه شما با برنامه های Google Workspace را مشخص کنید

خدمات Google Workspace را انتخاب کنید که برنامه یا افزونه شما برای کار با آن طراحی شده است، مانند افزونه Google Workspace یا برنامه Google Chat. شما باید حداقل یک گزینه را انتخاب کنید. در برخی موارد، می توانید چندین ادغام برنامه را در فهرست برنامه خود قرار دهید. فهرست ادغام برنامه ها را با هم ببینید.

بسته به ادغام برنامه‌هایی که انتخاب می‌کنید، ممکن است لازم باشد اطلاعات بیشتری ارائه دهید و APIهای مربوطه را در پروژه Google Cloud خود فعال کنید. جدول زیر تنظیمات اضافی مورد نیاز برای هر یک را شرح می دهد:

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

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

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

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

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

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

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

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

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

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

1. در کنسول Google Cloud، به صفحه پیکربندی SDK Marketplace بروید:

   به صفحه پیکربندی SDK Marketplace بروید

2. هر بخش را بر اساس آنچه در بخش قبل تعیین کردید پر کنید.

3. روی ذخیره کلیک کنید.

4. (اختیاری) می توانید تجزیه و تحلیل استفاده از برنامه را در Google Analytics دریافت کنید. برای انجام این کار، شناسه Google Analytics را در Marketplace SDK اضافه کنید.

   1. به تب Analytics بروید.
   2. شناسه Google Analytics خود را وارد کنید.
   3. روی ذخیره کلیک کنید.