با Google Apps Script یک برنامه Google Chat بسازید

پیش‌نمایش توسعه‌دهنده: به‌عنوان بخشی از برنامه پیش‌نمایش برنامه‌نویس Google Workspace موجود است که دسترسی زودهنگام به ویژگی‌های خاصی را اعطا می‌کند.

این صفحه نحوه ساخت افزونه Google Workspace را توضیح می‌دهد که در Google Chat با استفاده از Google Apps Script کار می‌کند. در Google Chat، افزونه‌ها به عنوان برنامه‌های Google Chat برای کاربران ظاهر می‌شوند. برای کسب اطلاعات بیشتر، به نمای کلی Extend Google Chat مراجعه کنید.

برنامه چت به شما امکان می دهد مستقیماً پیام دهید و با تکرار پیام های خود پاسخ دهید.

نمودار زیر معماری و الگوی پیام رسانی را نشان می دهد:

در نمودار قبلی، کاربر در حال تعامل با برنامه Apps Script Chat دارای جریان اطلاعات زیر است:

1. کاربر پیامی را به یک برنامه چت ارسال می کند، چه در یک پیام مستقیم یا در فضای چت.
2. منطق برنامه Chat که در Apps Script که در Google Cloud قرار دارد پیاده سازی شده است، پیام را دریافت و پردازش می کند.
3. به صورت اختیاری، منطق برنامه Chat می‌تواند با سرویس‌های Google Workspace، مانند تقویم یا برگه‌ها، یا سایر خدمات Google، مانند Google Maps یا YouTube، ادغام شود.
4. منطق برنامه Chat پاسخی را به سرویس برنامه Chat در Chat برمی‌گرداند.
5. پاسخ به کاربر تحویل داده می شود.

اهداف

• محیط خود را تنظیم کنید.
• اسکریپت را تنظیم کنید
• یک افزونه Google Workspace را برای برنامه Chat پیکربندی کنید.
• برنامه چت را تست کنید.

پیش نیازها

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
• یک پروژه Google Cloud. برای ایجاد یک پروژه، به ایجاد پروژه Google Cloud مراجعه کنید.

محیط خود را تنظیم کنید

پروژه Cloud خود را در کنسول Google Cloud باز کنید

اگر قبلاً باز نشده است، پروژه Cloud را که می‌خواهید برای این نمونه استفاده کنید باز کنید:

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

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

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

Chat API را روشن کنید

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

• در کنسول Google Cloud، Google Chat API را فعال کنید.

  API را فعال کنید

صفحه رضایت OAuth را پیکربندی کنید

همه برنامه‌هایی که از OAuth 2.0 استفاده می‌کنند به پیکربندی صفحه رضایت نیاز دارند. پیکربندی صفحه رضایت OAuth برنامه شما، آنچه را که برای کاربران و بازبینان برنامه نمایش داده می شود، مشخص می کند و برنامه شما را ثبت می کند تا بتوانید بعداً آن را منتشر کنید.

1. در کنسول Google Cloud، به منو > APIs & Services > صفحه رضایت OAuth بروید.

   به صفحه رضایت OAuth بروید

2. برای نوع User Internal را انتخاب کنید، سپس روی Create کلیک کنید.
3. فرم ثبت نام برنامه را تکمیل کنید، سپس روی ذخیره و ادامه کلیک کنید.

4. در حال حاضر، می‌توانید از افزودن دامنه‌ها صرفنظر کنید و روی ذخیره و ادامه کلیک کنید. در آینده، وقتی برنامه‌ای را برای استفاده خارج از سازمان Google Workspace خود ایجاد می‌کنید، باید نوع کاربر را به خارجی تغییر دهید و سپس محدوده‌های مجوز مورد نیاز برنامه خود را اضافه کنید.

5. خلاصه ثبت برنامه خود را مرور کنید. برای ایجاد تغییرات، روی ویرایش کلیک کنید. اگر ثبت برنامه خوب به نظر می رسد، روی بازگشت به داشبورد کلیک کنید.

اسکریپت را تنظیم کنید

برای تنظیم اسکریپت، یک کپی از پروژه شروع سریع تهیه می‌کنید و سپس پروژه Cloud خود را در Apps Script تنظیم می‌کنید.

یک کپی از پروژه شروع سریع تهیه کنید

1. روی دکمه زیر کلیک کنید تا افزونه در پروژه Google Chat Apps Script باز شود.
   پروژه را باز کنید
2. روی نمای کلی کلیک کنید.
3. در صفحه نمای کلی، کلیک کنید یک کپی تهیه کنید .

4. کپی پروژه Apps Script خود را نام ببرید:

   1. روی Copy of Add-on Chat app کلیک کنید.

   2. در عنوان پروژه ، Add-on Chat app تایپ کنید

   3. روی تغییر نام کلیک کنید.

شماره پروژه Cloud را کپی کنید

1. در کنسول Google Cloud، به منو > IAM & Admin > تنظیمات بروید.

   به تنظیمات IAM و Admin بروید

2. در قسمت Project number مقدار را کپی کنید.

پروژه Cloud پروژه Apps Script را تنظیم کنید

1. در پروژه برنامه Chat Apps Script، روی تنظیمات پروژه کلیک کنید .
2. در پروژه Google Cloud Platform (GCP) ، روی تغییر پروژه کلیک کنید.
3. در شماره پروژه GCP ، شماره پروژه Google Cloud را جای‌گذاری کنید.
4. روی تنظیم پروژه کلیک کنید.

اکنون کد برنامه کاربردی دارید که می‌توانید آن را امتحان کنید (همانطور که در مراحل زیر توضیح داده شد) و سپس آن را سفارشی کنید تا نیازهای خود را برآورده کنید.

هنگام باز کردن پروژه Apps Script مطمئن شوید که به حساب Google صحیح وارد شده اید. حساب جاری گاهی اوقات می تواند بدون اینکه متوجه شوید به حساب پیش فرض شما تغییر کند.

یک استقرار آزمایشی ایجاد کنید

برای این پروژه Apps Script به یک شناسه استقرار نیاز دارید تا بتوانید در مرحله بعد از آن استفاده کنید.

برای دریافت شناسه استقرار هد، موارد زیر را انجام دهید:

1. در پروژه برنامه Chat Apps Script، روی Deploy > Test Deployments کلیک کنید.
2. شناسه توسعه Head را برای استفاده در مرحله بعد کپی کنید و روی Done کلیک کنید.

افزونه را پیکربندی کنید

با استفاده از استقرار Apps Script خود، این مراحل را برای ایجاد یک افزونه و استقرار برنامه Google Chat دنبال کنید:

1. در کنسول ، Google Chat API را جستجو کنید و روی Google Chat API کلیک کنید.
2. روی Manage کلیک کنید.

3. روی Configuration کلیک کنید و برنامه Chat را راه اندازی کنید:

   1. در قسمت نام برنامه ، Add-on Chat app وارد کنید.
   2. در قسمت URL آواتار ، https://developers.google.com/chat/images/quickstart-app-avatar.png را وارد کنید.
   3. در قسمت توضیحات ، Add-on Chat app وارد کنید.
   4. در بخش عملکرد ، دریافت پیام های 1:1 و پیوستن به فضاها و مکالمات گروهی را انتخاب کنید.
   5. در قسمت تنظیمات اتصال، پروژه Apps Script را انتخاب کنید.
   6. در قسمت Deployment ID ، Head Deployment ID را که قبلاً کپی کرده‌اید، قرار دهید.
   7. در قسمت Visibility، افراد و گروه‌های خاص در دامنه خود را انتخاب کنید و ایمیل خود را وارد کنید.

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

برنامه چت برای پاسخ دادن به پیام ها آماده است.

برنامه چت را تست کنید

برای آزمایش برنامه چت خود، یک فضای پیام مستقیم با برنامه چت باز کنید و یک پیام ارسال کنید:

1. Google Chat را با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان آزمایش‌کننده معتمد ارائه کرده‌اید، باز کنید.

   به Google Chat بروید

2. روی گپ جدید کلیک کنید.
3. در قسمت افزودن 1 یا چند نفر ، نام برنامه چت خود را تایپ کنید.

4. برنامه چت خود را از نتایج انتخاب کنید. یک پیام مستقیم باز می شود.

   توجه: اگر برنامه Chat خود را در لیست نتایج نمی‌بینید، مطمئن شوید که حساب Google Workspace خود را در تنظیمات Visibility صفحه پیکربندی Chat API در کنسول Google Cloud قرار داده‌اید.

5. در پیام مستقیم جدید با برنامه، Hello تایپ کرده و enter فشار دهید.

   برنامه چت از شما برای افزودن آن تشکر می کند و پیام شما را بازتاب می دهد.

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

عیب یابی

وقتی یک برنامه یا کارت Google Chat خطایی را برمی‌گرداند، رابط Chat پیامی را نشان می‌دهد که می‌گوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.

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

تمیز کردن

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

احتیاط: حذف یک پروژه دارای اثرات زیر است:

• همه چیز در پروژه حذف می شود. اگر از یک پروژه موجود برای این آموزش استفاده کرده اید، وقتی آن را حذف می کنید، هر کار دیگری را که در پروژه انجام داده اید نیز حذف می کنید.
• شناسه های پروژه سفارشی گم می شوند. وقتی این پروژه را ایجاد کردید، ممکن است یک ID پروژه سفارشی ایجاد کرده باشید که می خواهید در آینده از آن استفاده کنید. برای حفظ URL هایی که از شناسه پروژه استفاده می کنند، مانند URL در appspot.com، به جای حذف کل پروژه، منابع انتخاب شده در داخل پروژه را حذف کنید.

اگر قصد دارید چندین آموزش و شروع سریع را کاوش کنید، استفاده مجدد از پروژه ها می تواند به شما کمک کند از فراتر رفتن از محدودیت های سهمیه پروژه جلوگیری کنید.

1. در کنسول Google Cloud، به صفحه مدیریت منابع بروید. > IAM & Admin > Manage Resources کلیک کنید.

   به Resource Manager بروید

2. در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی حذف کلیک کنید.
3. در گفتگو، ID پروژه را تایپ کنید و سپس بر روی Shut down کلیک کنید تا پروژه حذف شود.