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

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

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

مرجع زیر تنظیمات موجود در صفحه پیکربندی برنامه Google Workspace Marketplace SDK را شرح می دهد.

قابلیت مشاهده برنامه

هشدار: پس از انتخاب گزینه مشاهده و ذخیره صفحه پیکربندی برنامه، نمی توانید بعداً انتخاب خود را تغییر دهید.

اگر از حساب 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 Chat. شما باید حداقل یک گزینه را انتخاب کنید. در برخی موارد، می توانید چندین ادغام برنامه را در فهرست برنامه خود قرار دهید. فهرست ادغام برنامه ها را با هم ببینید.

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

افزونه Google Workspace (Apps Script)

برای انتشار افزونه Google Workspace، باید شناسه استقرار برافزا را ارائه دهید. برای یافتن شناسه استقرار، مراحل زیر را دنبال کنید:

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

افزونه Google Workspace (زمان اجرای جایگزین)

اگر افزونه Google Workspace خود را به زبان برنامه‌نویسی غیر از Google Apps Script ساخته‌اید، این مراحل را دنبال کنید تا شناسه استقرار را از منبع استقرار 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

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

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

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

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

اطلاعات توسعه دهنده

این فیلدها در صفحه فهرست فروشگاه برنامه شما ظاهر می شوند.

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