با Google Chat توسعه دهید

این صفحه یک نمای کلی از Google Chat API و برنامه‌های Google Chat ارائه می‌کند.

نمای کلی Google Chat API

Chat API شامل سرویس‌های gRPC یا منابع REST و روش‌هایی است که به Chat دسترسی می‌دهد، از جمله فضاها، اعضای فضایی، پیام‌ها، واکنش‌های پیام، پیوست‌های پیام، رویدادهای فضایی و حالت‌های خواندن کاربر.

مفاهیم

بخش زیر خدمات، منابع و روش‌های مربوط به Chat API را تعریف می‌کند:

فضاها

فضاها مکان‌هایی هستند که افراد و برنامه‌ها می‌توانند با هم گفتگو کرده و فایل‌ها را به اشتراک بگذارند. چند نوع فضا وجود دارد. پیام‌های مستقیم (DM) مکالمات 1:1 بین دو کاربر یا یک کاربر و یک برنامه چت هستند. چت گروهی مکالمه بین سه یا چند کاربر و برنامه های چت است. فضاهای نام‌گذاری شده مکان‌هایی هستند که افراد در آن پیام می‌فرستند، فایل‌ها را به اشتراک می‌گذارند و همکاری می‌کنند.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

اعضا

اعضا کاربران و برنامه‌های چت هستند که به یک فضا پیوسته‌اند یا به آن دعوت شده‌اند.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

پیام ها

پیام‌ها شامل پیام‌های متنی و کارتی هستند که در فضاها ارسال می‌شوند. پیام‌ها می‌توانند فایل‌هایی به آنها پیوست داشته باشند. افراد می توانند با اضافه کردن ایموجی به پیام ها به آنها واکنش نشان دهند.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

واکنش ها

واکنش‌ها نشان‌دهنده شکلک‌هایی هستند که افراد برای واکنش به یک پیام استفاده می‌کنند، مانند 👍، 🚲، و 🌞.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

ایموجی سفارشی

شکلک سفارشی نشان دهنده شکلک های سفارشی ایجاد شده و به اشتراک گذاشته شده در سازمان در Google Chat است. ایموجی سفارشی می تواند در محتوای یک پیام گنجانده شود یا برای واکنش به یک پیام استفاده شود.

مرجع منبع:

رسانه ها و پیوست ها

رسانه فایلی را نشان می‌دهد که در چت Google آپلود شده است، مانند تصاویر، ویدیوها و اسناد.

مرجع منبع رسانه (در RPC موجود نیست):

پیوست ها نمونه هایی از رسانه (فایل) هستند که به پیام ها پیوست شده اند.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

رویدادهای فضایی

رویدادهای فضایی نشان دهنده تغییرات در یک فضا یا منابع فرزند آن، از جمله اعضا، پیام ها و واکنش های آن است.

مرجع منبع:

برای مثال استفاده، نگاه کنید به:

وضعیت خواندن کاربر

وضعیت‌های خواندن کاربر منابع تکی هستند که جزئیات مربوط به آخرین پیام خوانده شده کاربر مشخص شده در فضای چت Google یا رشته پیام را نشان می‌دهند.

مرجع منبع وضعیت خواندن فاصله:

مرجع منبع وضعیت خواندن موضوع:

برای مثال استفاده، نگاه کنید به:

تنظیمات اعلان فضای کاربر

تنظیمات اعلان فضای کاربر منابع تکی هستند که تنظیمات اعلان کاربر مشخص شده را در فضای چت Google نشان می دهند.

مرجع منبع:

احراز هویت

فراخوانی Chat API نیاز به احراز هویت دارد. هر روش Chat API به احراز هویت کاربر (برای انجام اقدامات یا دسترسی به داده‌ها از طرف یک کاربر) یا تأیید اعتبار برنامه (برای انجام اقدامات یا دسترسی به داده‌ها به عنوان برنامه چت) نیاز دارد. برخی از روش ها هم از احراز هویت کاربر و هم از تأیید اعتبار برنامه پشتیبانی می کنند.

برای کسب اطلاعات بیشتر درباره احراز هویت در چت، به نمای کلی احراز هویت مراجعه کنید.

کتابخانه های مشتری

روش توصیه شده برای اکثر توسعه دهندگان برای فراخوانی Google Chat API با کتابخانه های Cloud Client ما برای زبان دلخواه شما مانند Python، جاوا یا Node.js است.

اگر با Google Apps Script کدنویسی می کنید، به جای نصب کتابخانه سرویس گیرنده، از سرویس گفتگوی پیشرفته استفاده کنید.

ساخت برنامه های چت

Chat API به شما امکان می‌دهد برنامه‌های Google Chat بسازید که خدمات و منابع شما را مستقیماً در Google Chat قرار می‌دهند. می‌توانید برنامه‌های چت را برای انجام یکی از کارهای زیر بسازید:

  • بازیابی اطلاعات بر اساس جستجوهای متنی ساختاریافته یا آزاد وارد شده توسط کاربر.
  • با استفاده از اطلاعات ارائه شده توسط کاربر، گزارش های حادثه یا سایر مصنوعات را ایجاد کنید.
  • همکاری تیمی را تقویت کنید، مانند ارائه "حافظه تیم" یا منابع برنامه ریزی.

می توانید برنامه چت خود را با استفاده از چندین سبک معماری مختلف طراحی کنید، از جمله موارد زیر:

  • برنامه‌های تعاملی : به تعامل کاربر، مانند نام‌گذاری‌های @ یا دستورات اسلش پاسخ دهید و اطلاعات را ارائه کنید یا کاربران را از طریق یک گردش کار با کارت‌ها و گفتگوها راهنمایی کنید.
  • برنامه‌های خط فرمان یا قلاب‌های وب : پیام‌های فعال مانند زنگ هشدار یا اعلان‌ها را از یک سیستم دیگر به یک فضا ارسال کنید. کاربران نمی توانند مستقیماً با این نوع برنامه تعامل داشته باشند.
  • برنامه‌های رویداد محور : در یک فضای گپ مشترک شوید و به آن واکنش نشان دهید، مانند پیوستن یک عضو جدید. در پاسخ به یک رویداد، برنامه می‌تواند پیامی ارسال کند یا اقدام دیگری انجام دهد.

برای جزئیات در مورد طراحی برنامه چت، به انتخاب معماری برنامه چت Google مراجعه کنید.

آیا می‌خواهید Google Chat API را در عمل ببینید؟
کانال Google Workspace Developers ویدیوهایی درباره نکات، ترفندها و جدیدترین ویژگی‌ها ارائه می‌دهد.