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

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

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

معماری یک برنامه چت اجرا شده با Apps Script.

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

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

اهداف

  • محیط خود را تنظیم کنید.
  • اسکریپت را تنظیم کنید
  • برنامه چت را منتشر کنید.
  • برنامه چت را تست کنید.

پیش نیازها

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. اگر خارجی را برای نوع کاربر انتخاب کرده اید، کاربران آزمایشی را اضافه کنید:
    1. در بخش تست کاربران ، روی افزودن کاربران کلیک کنید.
    2. آدرس ایمیل خود و سایر کاربران آزمایشی مجاز را وارد کنید، سپس روی ذخیره و ادامه کلیک کنید.
  6. خلاصه ثبت برنامه خود را مرور کنید. برای ایجاد تغییرات، روی ویرایش کلیک کنید. اگر ثبت برنامه خوب به نظر می رسد، روی بازگشت به داشبورد کلیک کنید.

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

برای تنظیم اسکریپت، از یک الگو استفاده می کنید و سپس پروژه Cloud خود را در Apps Script تنظیم می کنید.

اسکریپت را از قالب ایجاد کنید

  1. به صفحه شروع برنامه ها اسکریپت بروید.
  2. روی الگوی برنامه چت کلیک کنید. شاید لازم باشد برای دیدن این الگو به پایین اسکرول کنید.
  3. روی پروژه Untitled کلیک کنید، Quickstart app تایپ کنید و روی تغییر نام کلیک کنید.

شماره پروژه 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 کلیک کنید.

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

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

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

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

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

  4. روی ذخیره کلیک کنید و صفحه را بازخوانی کنید.

  5. در صفحه پیکربندی، در زیر وضعیت برنامه ، وضعیت را روی Live - در دسترس کاربران قرار دهید.

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

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

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

  1. چت را باز کنید.
  2. با کلیک روی Start a chat > Find apps، یک پیام مستقیم جدید به برنامه ارسال کنید.
  3. در صفحه Find apps، Quickstart App جستجو کنید.
  4. در کنار Quickstart App ، روی Chat کلیک کنید.
  5. در پیام مستقیم جدید با برنامه، Hello تایپ کرده و enter فشار دهید.

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

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

مراحل بعدی

  • ایجاد کارت‌های تعاملی – پیام‌های کارت از طرح‌بندی تعریف‌شده، عناصر رابط کاربری تعاملی مانند دکمه‌ها و رسانه‌های غنی مانند تصاویر پشتیبانی می‌کنند. از پیام های کارت برای ارائه اطلاعات دقیق، جمع آوری اطلاعات از کاربران و راهنمایی کاربران برای برداشتن گام بعدی استفاده کنید.
  • پشتیبانی از دستورات اسلش – دستورات اسلش به شما این امکان را می دهد که دستورات خاصی را که کاربران می توانند به برنامه شما بدهند، با تایپ دستوری که با اسلش رو به جلو ( / ) شروع می شود، مانند /help ، ثبت و تبلیغ کنید.
  • راه‌اندازی دیالوگ‌ها - دیالوگ‌ها رابط‌های پنجره‌ای و مبتنی بر کارت هستند که برنامه شما می‌تواند برای تعامل با کاربر باز کند. چند کارت را می توان به صورت متوالی به هم متصل کرد، که به کاربران کمک می کند فرآیندهای چند مرحله ای را تکمیل کنند، مانند پر کردن داده های فرم.