این صفحه نحوه ایجاد یک برنامه چت HTTP را توضیح می دهد. راه های مختلفی برای پیاده سازی این معماری وجود دارد. در Google Cloud، میتوانید از Cloud Functions، Cloud Run و App Engine استفاده کنید. در این شروع سریع، یک تابع Cloud را می نویسید و اجرا می کنید که برنامه چت از آن برای پاسخ به پیام کاربر استفاده می کند.
با این معماری، همانطور که در نمودار زیر نشان داده شده است، Chat را برای ادغام با Google Cloud یا سرور داخلی با استفاده از HTTP پیکربندی میکنید:
در نمودار قبل، کاربر در حال تعامل با برنامه چت HTTP دارای جریان اطلاعات زیر است:
- کاربر پیامی را در چت به یک برنامه چت، چه در یک پیام مستقیم یا در فضای چت، ارسال می کند.
- یک درخواست HTTP به یک سرور وب ارسال میشود که یک سیستم ابری یا درون محل است که حاوی منطق برنامه چت است.
- در صورت تمایل، منطق برنامه Chat میتواند با سرویسهای Google Workspace (مانند Calendar و Sheets)، سایر سرویسهای Google (مانند Maps، YouTube، و Vertex AI) یا سایر سرویسهای وب (مانند سیستم مدیریت پروژه یا ابزار فروش بلیط) یکپارچه شود.
- وب سرور یک پاسخ HTTP را به سرویس برنامه Chat در Chat برمی گرداند.
- پاسخ به کاربر تحویل داده می شود.
- به صورت اختیاری، برنامه چت میتواند با Chat API تماس بگیرد تا پیامها را به صورت ناهمزمان ارسال کند یا عملیات دیگری را انجام دهد.
این معماری به شما انعطاف پذیری را برای استفاده از کتابخانه ها و اجزای موجود در سیستم شما ارائه می دهد زیرا این برنامه های چت را می توان با استفاده از زبان های برنامه نویسی مختلف طراحی کرد.
اهداف
- محیط خود را تنظیم کنید.
- ایجاد و استقرار یک تابع ابری.
- برنامه را در چت منتشر کنید.
- برنامه را تست کنید.
پیش نیازها
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- یک پروژه Google Cloud با فعال کردن صورتحساب. برای بررسی فعال بودن صورتحساب پروژه موجود، به تأیید وضعیت صورتحساب پروژههای خود مراجعه کنید. برای ایجاد پروژه و تنظیم صورتحساب، به ایجاد پروژه Google Cloud مراجعه کنید.
محیط را تنظیم کنید
قبل از استفاده از Google API، باید آنها را در پروژه Google Cloud روشن کنید. میتوانید یک یا چند API را در یک پروژه Google Cloud روشن کنید.در کنسول Google Cloud، Google Chat API، Cloud Build API، Cloud Functions API، Cloud Pub/Sub API، Cloud Logging API، Artifact Registry API، و Cloud Run API را فعال کنید.
ایجاد و استقرار یک تابع ابری
ایجاد و استقرار یک Cloud Function که یک کارت چت با نام نمایشی فرستنده و تصویر آواتار ایجاد می کند. هنگامی که برنامه چت پیامی دریافت می کند، عملکرد را اجرا می کند و با کارت پاسخ می دهد.
برای ایجاد و استقرار عملکرد برای برنامه Chat خود، مراحل زیر را انجام دهید:
Node.js
در کنسول Google Cloud، به صفحه Cloud Functions بروید:
مطمئن شوید که پروژه برنامه چت شما انتخاب شده است.
در صفحه ایجاد تابع، تابع خود را تنظیم کنید:
- در Environment ، 2nd gen را انتخاب کنید.
- در نام تابع ،
QuickStartChatApp
را وارد کنید. - در منطقه ، یک منطقه را انتخاب کنید.
- در بخش Authentication، Require authentication را انتخاب کنید.
- روی Next کلیک کنید.
در Runtime ، جدیدترین نسخه Node.js را انتخاب کنید.
در کد منبع ، ویرایشگر درون خطی را انتخاب کنید.
در نقطه ورود ، متن پیش فرض را حذف کنید و
avatarApp
را وارد کنید.کد زیر را جایگزین محتوای
index.js
کنید:روی Deploy کلیک کنید.
پایتون
در کنسول Google Cloud، به صفحه Cloud Functions بروید:
مطمئن شوید که پروژه برنامه چت شما انتخاب شده است.
در صفحه ایجاد تابع، تابع خود را تنظیم کنید:
- در Environment ، 2nd gen را انتخاب کنید.
- در نام تابع ،
QuickStartChatApp
را وارد کنید. - در منطقه ، یک منطقه را انتخاب کنید.
- در بخش Authentication، Require authentication را انتخاب کنید.
- روی Next کلیک کنید.
در Runtime ، جدیدترین نسخه پایتون را انتخاب کنید.
در کد منبع ، ویرایشگر درون خطی را انتخاب کنید.
در نقطه ورود ، متن پیش فرض را حذف کرده و
avatar_app
را وارد کنید.محتوای
main.py
را با کد زیر جایگزین کنید:روی Deploy کلیک کنید.
جاوا
در کنسول Google Cloud، به صفحه Cloud Functions بروید:
مطمئن شوید که پروژه برنامه چت شما انتخاب شده است.
در صفحه ایجاد تابع، تابع خود را تنظیم کنید:
- در Environment ، 2nd gen را انتخاب کنید.
- در نام تابع ،
QuickStartChatApp
را وارد کنید. - در منطقه ، یک منطقه را انتخاب کنید.
- در بخش Authentication، Require authentication را انتخاب کنید.
- روی Next کلیک کنید.
در Runtime ، جدیدترین نسخه جاوا را انتخاب کنید.
در کد منبع ، ویرایشگر درون خطی را انتخاب کنید.
در نقطه ورود ، متن پیش فرض را حذف کرده و وارد
App
شوید.src/main/java/com/example/Example.java
را بهsrc/main/java/App.java
تغییر نام دهید.کد زیر را جایگزین محتوای
App.java
کنید:کد زیر را جایگزین محتوای
pom.xml
کنید:روی Deploy کلیک کنید.
صفحه جزئیات Cloud Functions باز می شود و عملکرد شما با دو نشانگر پیشرفت ظاهر می شود: یکی برای ساخت و دیگری برای سرویس. هنگامی که هر دو نشانگر پیشرفت ناپدید می شوند و با علامت چک جایگزین می شوند، عملکرد شما مستقر و آماده است.
به Google Chat اجازه دهید تا عملکرد شما را فراخوانی کند
برای مجاز کردن Google Chat برای فراخوانی عملکرد شما، حساب سرویس Google Chat را با نقش Cloud Run Invoker اضافه کنید.
در کنسول Google Cloud، به صفحه Cloud Run بروید:
در لیست خدمات Cloud Run، کادر کنار عملکرد دریافت را انتخاب کنید. (روی خود تابع کلیک نکنید.)
روی Permissions کلیک کنید. پانل مجوزها باز می شود.
روی افزودن اصلی کلیک کنید.
در New Principals ،
chat@system.gserviceaccount.com
را وارد کنید.در انتخاب نقش ، Cloud Run > Cloud Run Invoker را انتخاب کنید.
روی ذخیره کلیک کنید.
برنامه را در Google Chat منتشر کنید
پس از استقرار عملکرد Cloud، این مراحل را دنبال کنید تا آن را به یک برنامه چت Google تبدیل کنید:
در کنسول Google Cloud، روی > عملکردهای ابری کلیک کنید.
منومطمئن شوید که پروژه ای که برای آن Cloud Functions را فعال کرده اید انتخاب شده باشد.
در لیست توابع، روی QuickStartChatApp کلیک کنید.
روی تب Triggers کلیک کنید.
در زیر HTTPS ، URL را کپی کنید.
«Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی Manage کلیک کنید.
روی Configuration کلیک کنید و برنامه Google Chat را راه اندازی کنید:
- در نام برنامه ،
Quickstart App
وارد کنید. - در URL آواتار ،
https://developers.google.com/chat/images/quickstart-app-avatar.png
را وارد کنید. - در توضیحات ،
Quickstart app
وارد کنید. - در بخش عملکرد ، دریافت پیام های 1:1 و پیوستن به فضاها و مکالمات گروهی را انتخاب کنید.
- در قسمت تنظیمات اتصال ، URL برنامه را انتخاب کنید و URL مربوط به راهانداز عملکرد Cloud را در کادر قرار دهید.
- در Authentication Audience ، URL App را انتخاب کنید.
- در قسمت Visibility ، این برنامه Google Chat را برای افراد و گروههای خاصی در دامنه خود در دسترس قرار دهید را انتخاب کنید و آدرس ایمیل خود را وارد کنید.
- در زیر گزارشها ، Log errors to Logging را انتخاب کنید.
- در نام برنامه ،
روی ذخیره کلیک کنید.
برنامه چت برای دریافت و پاسخ به پیام ها در چت آماده است.
برنامه چت خود را تست کنید
برای آزمایش برنامه چت خود، یک فضای پیام مستقیم با برنامه چت باز کنید و یک پیام ارسال کنید:
Google Chat را با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان آزمایشکننده معتمد ارائه کردهاید، باز کنید.
- روی گپ جدید کلیک کنید.
- در قسمت افزودن 1 یا چند نفر ، نام برنامه چت خود را تایپ کنید.
برنامه چت خود را از نتایج انتخاب کنید. یک پیام مستقیم باز می شود.
- در پیام مستقیم جدید با برنامه،
Hello
را تایپ کرده وenter
فشار دهید.
پاسخ برنامه چت حاوی یک پیام کارتی است که نام فرستنده و تصویر آواتار را نشان می دهد، همانطور که در تصویر زیر نشان داده شده است:
برای افزودن آزمایشکنندگان مورد اعتماد و کسب اطلاعات بیشتر درباره آزمایش ویژگیهای تعاملی، به تست ویژگیهای تعاملی برای برنامههای گپ Google مراجعه کنید.
عیب یابی
وقتی یک برنامه یا کارت Google Chat خطایی را برمیگرداند، رابط Chat پیامی را نشان میدهد که میگوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.
اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیامهای خطای توصیفی و دادههای گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامههای گپ، خطاها را برطرف کنید. برای راهنمایی برای مشاهده، اشکالزدایی و رفع خطاها، به عیبیابی و رفع خطاهای Google Chat مراجعه کنید.
تمیز کردن
برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این آموزش، توصیه می کنیم پروژه Cloud را حذف کنید.
- در کنسول Google Cloud، به صفحه مدیریت منابع بروید. > IAM & Admin > Manage Resources کلیک کنید. منو
- در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی حذف حذف کنید.
- در گفتگو، ID پروژه را تایپ کنید و سپس بر روی Shut down کلیک کنید تا پروژه حذف شود.
موضوعات مرتبط
برای افزودن ویژگیهای بیشتر به برنامه چت، موارد زیر را ببینید: