برنامه‌های Google Chat را منتشر کنید

پس از ایجاد یک برنامه گپ، می‌توانید آن را منتشر کنید تا برای افراد یا گروه‌ها، همه افراد سازمان Google Workspace یا هر کاربر گپ Google در دسترس باشد.

نحوه کشف و استفاده کاربران از برنامه‌های چت

برای کشف برنامه‌های Google Chat، کاربران می‌توانند یکی از کارهای زیر را انجام دهند:

  • برنامه‌های چت را از Google Chat یا Google Workspace Marketplace جستجو و نصب کنید.
  • با برنامه ای که به فضای چت اضافه شده است تعامل داشته باشید.
  • پس از اینکه یک سرپرست Google Workspace برنامه را از طرف او نصب کرد، برنامه را در پانل پیام‌های مستقیم آنها کشف کنید.

برای شروع استفاده از یک برنامه، کاربران چت Google می توانند یک پیام مستقیم با برنامه شروع کنند یا آن را به یک فضا اضافه کنند. کاربران همچنین می توانند با ذکر @ آن برنامه را اضافه کنند. مثال زیر نشان می دهد که چگونه یک کاربر @ از یک برنامه Chat برای افزودن آن به یک فضا نام می برد:

افزودن یک برنامه به یک فضا با تایپ @ در یک پیام.

نحوه نصب برنامه‌های چت توسط سرپرستان Google Workspace

سرپرستان Google Workspace می‌توانند برنامه‌های Chat را در Google Workspace Marketplace بیابند و برنامه‌ها را برای کاربران در سازمان خود نصب کنند . وقتی یک سرپرست برنامه چت را نصب می‌کند، برنامه در پانل پیام‌های مستقیم کاربران ظاهر می‌شود.

سرپرستان Google Workspace همچنین می‌توانند استفاده از برنامه‌های Chat را در سازمان Google Workspace خود مدیریت کرده و در فهرست مجاز قرار دهند. اگر در حال توسعه یک برنامه Chat برای سازمانی هستید که از لیست‌های مجاز استفاده می‌کند، باید از یک سرپرست درخواست کنید که برنامه Chat شما را به لیست مجاز اضافه کند تا کاربران بتوانند برنامه را پیدا کرده و از آن استفاده کنند. برای اطلاعات بیشتر به اسناد راهنمای Google Workspace Admin مراجعه کنید، به کاربران اجازه نصب برنامه‌های گپ را بدهید .

برنامه چت خود را با استفاده از کنسول Google Cloud پیکربندی و منتشر کنید

برای انتشار برنامه چت و در دسترس قرار دادن آن برای دیگران، معمولاً باید این مراحل را دنبال کنید:

  1. Google Chat API را فعال و پیکربندی کنید . وقتی API را پیکربندی می‌کنید، به سایر کاربران چت Google اجازه می‌دهید برای آزمایش به برنامه چت شما دسترسی داشته باشند.
  2. برنامه خود را با Google Workspace Marketplace SDK منتشر کنید . می‌توانید برنامه چت خود را به گونه‌ای پیکربندی کنید که برای کاربران سازمان Google Workspace یا همه کاربران Google Chat در دسترس باشد.
  3. اگر سازمان Google Workspace شما دسترسی به برنامه‌های Chat را مدیریت می‌کند، از سرپرست Google Workspace درخواست کنید برنامه را به لیست مجاز سازمان اضافه کند.

تنظیمات مشاهده و انتشار برای برنامه چت شما

جدول زیر نحوه پیکربندی تنظیمات Google Chat API و Google Workspace Marketplace SDK را بر اساس مخاطبان برنامه Chat توضیح می‌دهد:

کاربران برنامه مورد نظر روش احراز هویت تنظیمات Google Chat API تنظیمات Google Workspace Marketplace SDK برنامه چت من در کجا منتشر شده است؟
تیم کوچک شما به عنوان یک کاربر یا یک برنامه احراز هویت کنید. در تنظیمات Visibility ، افراد یا گروه‌های Google را مشخص کنید که می‌توانند به برنامه دسترسی داشته باشند.

اگر حساب Google Workspace شما نیاز دارد که برنامه‌ها در لیست مجاز قرار گیرند، فقط می‌توانید حداکثر 5 آدرس ایمیل فردی را مشخص کنید (نمی‌توانید Google Groups را مشخص کنید).

لازم نیست Google Workspace Marketplace SDK را برای برنامه چت خود پیکربندی کنید. اعضای تیم می‌توانند برنامه چت شما را از Google Chat پیدا کرده و از آن استفاده کنند.
تیم بزرگ شما به عنوان یک کاربر یا یک برنامه احراز هویت کنید. در تنظیمات Visibility ، افراد یا Google Groups را برای آزمایش برنامه Chat خود مشخص کنید.

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

نمایان بودن برنامه را روی Private تنظیم کنید.

تنظیمات نصب را روی Individual + Admin قرار دهید.

اگر حساب Google Workspace شما نیاز دارد که برنامه‌ها در لیست مجاز قرار گیرند، از یک سرپرست درخواست کنید که برنامه Chat شما را به لیست مجاز اضافه کند تا کاربران بتوانند برنامه را پیدا کنند و از آن استفاده کنند. برای اطلاعات بیشتر به اسناد راهنمای Google Workspace Admin مراجعه کنید، به کاربران اجازه نصب برنامه‌های گپ را بدهید .

هر کسی در سازمان Google Workspace شما می‌تواند برنامه Chat شما را در Google Chat پیدا و نصب کند و برنامه شما را در Google Workspace Marketplace مشاهده کند. کاربران و سرپرستان Google Workspace می‌توانند برنامه شما را از Marketplace نصب کنند.

سازمان Google Workspace شما به عنوان یک کاربر یا یک برنامه احراز هویت کنید. در تنظیمات Visibility ، افراد یا Google Groups را برای آزمایش برنامه Chat خود مشخص کنید.

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

نمایان بودن برنامه را روی Private تنظیم کنید.

تنظیمات نصب را روی Individual + Admin قرار دهید.

هر کسی در سازمان Google Workspace شما می‌تواند برنامه Chat شما را در Google Chat پیدا و نصب کند و برنامه شما را در Google Workspace Marketplace مشاهده کند. فقط سرپرستان Google Workspace می‌توانند برنامه شما را از Marketplace نصب کنند.

همه (برنامه چت عمومی) به عنوان یک کاربر یا یک برنامه احراز هویت کنید. در تنظیمات Visibility ، افراد یا Google Groups را برای آزمایش برنامه Chat خود مشخص کنید.

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

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

تنظیمات نصب را روی Individual + Admin قرار دهید

هر کاربر Google Workspace می‌تواند برنامه Chat شما را در Google Chat پیدا و نصب کند و برنامه شما را در Google Workspace Marketplace مشاهده کند. فقط سرپرستان Google Workspace می‌توانند برنامه شما را از Marketplace نصب کنند.

Google Chat API را فعال و پیکربندی کنید

یک پروژه برای برنامه خود در کنسول Google Cloud تنظیم کنید و Google Chat API را فعال کنید:

  1. از دکمه زیر برای ایجاد یک پروژه جدید (یا انتخاب یک پروژه موجود) و اضافه کردن یک حساب سرویس به آن استفاده کنید. به حساب سرویس، نقش مالک پروژه را بدهید.
    API را فعال کنید
  2. کلید JSON دانلود شده را ذخیره کنید. برنامه شما می‌تواند از این کلید برای تأیید اعتبار پیام‌هایی که به‌صورت ناهمزمان به فضاها ارسال می‌کند استفاده کند.
  3. پروژه خود را در باز کنید. در فهرست APIها، روی Google Chat API کلیک کنید.
  4. تب Configuration را انتخاب کنید و اطلاعات برنامه را همانطور که در جدول زیر توضیح داده شده است وارد کنید.

وقتی پیکربندی برنامه را ذخیره می‌کنید، برنامه شما برای کاربران مشخص شده در سازمان Google Workspace شما در دسترس قرار می‌گیرد.

تنظیمات پیکربندی Google Chat API

رشته شرح
نام برنامه نامی که افراد هنگام تعامل با برنامه چت شما استفاده می کنند.
آدرس آواتار یک نشانی وب HTTPS که به تصویر گرافیکی مربعی (مانند PNG یا JPEG)، حداقل ۱۲۸×۱۲۸ اشاره می‌کند، که به عنوان نماد برنامه چت شما ظاهر می‌شود.
شرح شرحی از عملکرد برنامه چت که در زیر نام برنامه چت شما ظاهر می شود.
عملکرد مجموعه‌ای از فیلدها که نحوه تعامل برنامه چت با کاربران را تعیین می‌کند:
  • دریافت پیام‌های ۱:۱ : کاربران می‌توانند برنامه چت را مستقیماً در چت Google پیدا کنند و پیام دهند.
  • پیوستن به فضاها و مکالمات گروهی : کاربران می توانند برنامه چت را به فضاها و مکالمات گروهی اضافه کنند.
تنظیمات اتصال نقطه پایانی برای برنامه Chat که یکی از موارد زیر است:
  • URL برنامه : یک نقطه پایانی HTTPS که اجرای برنامه Chat را میزبانی می کند.
  • پروژه Apps Script : شناسه استقرار برای پروژه Apps Script که یک برنامه Chat را پیاده سازی می کند.
  • نام موضوع Cloud Pub/Sub : یک موضوع Cloud Pub/Sub که برنامه Chat به عنوان نقطه پایانی در آن مشترک شده است.
  • Dialogflow : برنامه Chat را با یکپارچه سازی Dialogflow ثبت می کند. برای اطلاعات بیشتر، به مستندات Dialogflow درباره ادغام با Google Chat مراجعه کنید.
دستورات اسلش دستوراتی که می توانند برای کاربران در چت Google ظاهر شوند. به کاربران اجازه می‌دهد تا عملکردهای اصلی برنامه چت شما را در گپ Google ببینند و اقدام خاصی را که می‌خواهند با آن تعامل داشته باشند انتخاب کنند.
پیش نمایش پیوندها الگوهای نشانی وب که برنامه چت می شناسد و محتوای اضافی را برای زمانی که کاربران پیوند می فرستند ارائه می کند. برای اطلاعات بیشتر، به پیوندهای پیش نمایش مراجعه کنید.
دید حداکثر 5 نفر یا یک یا چند گروه Google که می‌توانند برنامه چت شما را مشاهده و نصب کنند. از این فیلد برای آزمایش برنامه چت یا اشتراک گذاری برنامه چت با تیم خود استفاده کنید. برای کسب اطلاعات بیشتر به تنظیمات مشاهده و انتشار برای برنامه چت خود مراجعه کنید.

مجوزهای پیکربندی برنامه را اعطا کنید

می توانید به کاربران خاصی اجازه دسترسی به صفحه پیکربندی برنامه بدهید. برای انجام این کار، از نقش‌های مالک برنامه‌های چت و نمایشگر IAM برنامه‌های گپ استفاده کنید. کاربران با این نقش‌ها نمی‌توانند از طریق داشبورد APIs & Services به صفحه پیکربندی برنامه پیمایش کنند، اما می‌توانند با پیمایش به کنسول پروژه خود به صورت زیر به صفحه پیکربندی دسترسی پیدا کنند:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

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

از Google Workspace Marketplace SDK برای انجام یکی از موارد زیر استفاده کنید:

  • برنامه چت خود را به صورت عمومی منتشر کنید و به هر کاربر گپ Google اجازه دهید برنامه شما را به یک فضا اضافه کند.
  • برنامه چت خود را در سازمان Google Workspace خود منتشر کنید.
  • برنامه خود را برای سرپرستان Google Workspace قابل مشاهده کنید تا بتوانند برنامه را برای کاربران سازمان خود نصب کنند . برای اینکه برای سرپرستان Google Workspace قابل مشاهده باشد، برنامه شما باید پیام‌رسانی مستقیم داشته باشد.

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

  1. برنامه چت خود را با نصب آن از چت آزمایش کنید. مطمئن شوید که برنامه شما کاملاً کاربردی است و کاری در حال انجام نیست.
  2. الزامات انتشار را بررسی کنید و بررسی کنید که برنامه شما همه آنها را برآورده می کند. به مناطق بررسی مراجعه کنید.
  3. شماره نسخه برنامه خود را ضبط کنید -- برای پیکربندی Google Workspace Marketplace SDK به آن نیاز دارید.

وقتی برای انتشار آماده شدید، به نمای کلی: انتشار یک برنامه مراجعه کنید.