یک برنامه گوگل چت بسازید که بتوانید مستقیماً به آن پیام دهید و با انعکاس پیام‌های شما پاسخ دهد.
نمودار زیر معماری و الگوی پیام‌رسانی را نشان می‌دهد:
در نمودار قبلی، کاربری که با یک برنامه چت Apps Script تعامل دارد، جریان اطلاعات زیر را دارد:
- کاربر پیامی را به یک برنامه چت، چه در پیام مستقیم و چه در فضای چت، ارسال می‌کند.
- منطق برنامه چت که در Apps Script پیاده‌سازی شده و در Google Cloud قرار دارد، پیام را دریافت و پردازش می‌کند.
- به صورت اختیاری، منطق برنامه چت می‌تواند با سرویس‌های Google Workspace مانند تقویم یا Sheets یا سایر سرویس‌های Google مانند Google Maps یا YouTube ادغام شود.
- منطق برنامه چت، پاسخی را به سرویس برنامه چت در Chat ارسال می‌کند.
- پاسخ به کاربر تحویل داده می‌شود.
اهداف
- محیط خود را تنظیم کنید.
- اسکریپت را تنظیم کنید.
- برنامه چت را منتشر کنید.
- برنامه چت را آزمایش کنید.
پیش‌نیازها
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- یک پروژه گوگل کلود. برای ایجاد آن، به «ایجاد یک پروژه گوگل کلود» مراجعه کنید.
محیط خود را تنظیم کنید
پروژه ابری خود را در کنسول گوگل کلود باز کنید
اگر هنوز باز نشده است، پروژه ابری که قصد دارید برای این نمونه استفاده کنید را باز کنید:
- در کنسول گوگل کلود، به صفحه انتخاب پروژه بروید.
- پروژه گوگل کلود مورد نظر خود را انتخاب کنید. یا روی ایجاد پروژه کلیک کنید و دستورالعمل‌های روی صفحه را دنبال کنید. اگر یک پروژه گوگل کلود ایجاد می‌کنید، ممکن است لازم باشد پرداخت هزینه را برای آن پروژه فعال کنید .
فعال کردن API چت
قبل از استفاده از APIهای گوگل، باید آنها را در یک پروژه گوگل کلود فعال کنید. می‌توانید یک یا چند API را در یک پروژه گوگل کلود فعال کنید.در کنسول گوگل کلود، Google Chat API را فعال کنید.
صفحه رضایت OAuth را پیکربندی کنید
همه برنامه‌هایی که از OAuth 2.0 استفاده می‌کنند، نیاز به پیکربندی صفحه رضایت دارند. پیکربندی صفحه رضایت OAuth برنامه شما، آنچه را که به کاربران و بررسی‌کنندگان برنامه نمایش داده می‌شود، تعریف می‌کند و برنامه شما را ثبت می‌کند تا بتوانید بعداً آن را منتشر کنید.
- در کنسول گوگل کلود، به Menu > برویدGoogle Auth platform > برندسازی .
- اگر قبلاً تنظیمات را انجام داده‌اید Google Auth platformمی‌توانید تنظیمات صفحه رضایت OAuth زیر را در Branding ، Audience و Data Access پیکربندی کنید. اگر پیامی با این مضمون مشاهده کردید Google Auth platform هنوز پیکربندی نشده است ، روی شروع کار کلیک کنید:
- در قسمت اطلاعات برنامه ، در قسمت نام برنامه ، نامی برای برنامه وارد کنید.
- در ایمیل پشتیبانی کاربر ، یک آدرس ایمیل پشتیبانی انتخاب کنید که کاربران در صورت داشتن هرگونه سوال در مورد رضایت خود بتوانند با شما تماس بگیرند.
- روی بعدی کلیک کنید.
- در قسمت مخاطبان ، داخلی (Internal) را انتخاب کنید.
- روی بعدی کلیک کنید.
- در قسمت اطلاعات تماس ، یک آدرس ایمیل وارد کنید که از طریق آن بتوانید از هرگونه تغییر در پروژه خود مطلع شوید.
- روی بعدی کلیک کنید.
- در قسمت Finish ، سیاست داده‌های کاربر سرویس‌های API گوگل را مرور کنید و در صورت موافقت، گزینه «من با سیاست‌های داده‌های کاربر سرویس‌های API گوگل موافقم» را انتخاب کنید.
- روی ادامه کلیک کنید.
- روی ایجاد کلیک کنید.
- فعلاً می‌توانید از اضافه کردن محدوده‌ها صرف نظر کنید. در آینده، وقتی برنامه‌ای برای استفاده در خارج از سازمان Google Workspace خود ایجاد می‌کنید، باید نوع کاربر (User type) را به خارجی (External) تغییر دهید. سپس محدوده‌های مجوز مورد نیاز برنامه خود را اضافه کنید. برای کسب اطلاعات بیشتر، به راهنمای کامل پیکربندی رضایت OAuth مراجعه کنید.
اسکریپت را تنظیم کنید
برای تنظیم اسکریپت، از یک الگو استفاده می‌کنید و سپس پروژه Cloud خود را در Apps Script تنظیم می‌کنید.
اسکریپت را از روی الگو ایجاد کنید
- به صفحه شروع به کار اسکریپت برنامه‌ها بروید.
- روی الگوی برنامه چت در بالای صفحه کلیک کنید.
- روی پروژه بدون عنوان کلیک کنید،
Quickstart appتایپ کنید و روی تغییر نام کلیک کنید.
شماره پروژه ابری را کپی کنید
- در کنسول گوگل کلود، به Menu > IAM & Admin > Settings بروید.
- در فیلد شماره پروژه ، مقدار را کپی کنید.
پروژه Cloud مربوط به پروژه Apps Script را تنظیم کنید.
- در پروژه‌ی اسکریپت برنامه‌های چت، روی تنظیمات پروژه کلیک کنید.
. - در زیر پروژه پلتفرم ابری گوگل (GCP) ، روی تغییر پروژه کلیک کنید.
- در قسمت شماره پروژه GCP ، شماره پروژه Google Cloud را وارد کنید.
- روی تنظیم پروژه کلیک کنید.
اکنون کد برنامه‌ی کاربردی دارید که می‌توانید آن را امتحان کنید (همانطور که در مراحل بعدی توضیح داده شده است) و سپس آن را مطابق با نیازهای خود سفارشی کنید.
هنگام باز کردن الگوی Apps Script، مطمئن شوید که با حساب گوگل صحیح وارد شده‌اید. گاهی اوقات حساب فعلی می‌تواند بدون اینکه متوجه شوید، به حساب پیش‌فرض شما تغییر کند.
ایجاد یک استقرار آزمایشی
شما برای این پروژه Apps Script به یک شناسه استقرار نیاز دارید تا بتوانید در مرحله بعدی از آن استفاده کنید.
برای دریافت شناسه استقرار سر، موارد زیر را انجام دهید:
- در پروژه‌ی اسکریپت برنامه‌های چت، روی Deploy > Test deployments کلیک کنید.
- شناسه استقرار Head را برای استفاده در مرحله بعد کپی کنید و روی Done کلیک کنید.
انتشار برنامه چت
برنامه چت را از کنسول منتشر کنید.
- در کنسول ،
Google Chat APIرا جستجو کنید و روی Google Chat API کلیک کنید. - روی مدیریت کلیک کنید.
روی پیکربندی کلیک کنید و برنامه چت را تنظیم کنید:
- پاک کردن «این برنامه گپ را به عنوان یک افزونه Google Workspace بسازید» . یک کادر محاوره‌ای باز می‌شود که از شما می‌خواهد تأیید کنید. در کادر محاوره‌ای، روی غیرفعال کردن کلیک کنید.
- در فیلد نام برنامه ،
Quickstart appوارد کنید. - در فیلد آدرس اینترنتی آواتار ،
https://developers.google.com/chat/images/quickstart-app-avatar.pngرا وارد کنید. - در قسمت توضیحات ،
Quickstart appوارد کنید. - در بخش عملکرد ، گزینه «پیوستن به فضاها و مکالمات گروهی» را انتخاب کنید.
- در تنظیمات اتصال، گزینه Apps Script را انتخاب کنید.
- در فیلد Deployment ID ، شناسه استقرار Head را که قبلاً کپی کرده‌اید، جایگذاری کنید.
- در قسمت «قابلیت مشاهده»، گزینه «افراد و گروه‌های خاص در دامنه شما» را انتخاب کنید و ایمیل خود را وارد کنید.
روی ذخیره کلیک کنید.
برنامه چت آماده پاسخگویی به پیام‌ها است.
برنامه چت را آزمایش کنید
برای آزمایش برنامه چت خود، یک فضای پیام مستقیم با برنامه چت باز کنید و پیامی ارسال کنید:
با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان یک آزمایشگر مورد اعتماد ارائه دادید، Google Chat را باز کنید.
- روی گپ جدید کلیک کنید.
- در فیلد «افزودن ۱ یا چند نفر» ، نام برنامه چت خود را تایپ کنید.
برنامه چت خود را از بین نتایج انتخاب کنید. یک پیام مستقیم باز می‌شود.
در پیام مستقیم جدید با برنامه،
Helloرا تایپ کنید وenterفشار دهید.برنامه چت از شما برای افزودن آن تشکر می‌کند و پیام شما را منعکس می‌کند.
برای افزودن آزمایش‌کنندگان مورد اعتماد و کسب اطلاعات بیشتر در مورد آزمایش ویژگی‌های تعاملی، به بخش «آزمایش ویژگی‌های تعاملی برای برنامه‌های Google Chat» مراجعه کنید.
عیب‌یابی
وقتی یک برنامه یا کارت چت گوگل خطایی را برمی‌گرداند، رابط چت پیامی با عنوان «مشکلی پیش آمده است» یا «درخواست شما قابل پردازش نیست» نمایش می‌دهد. گاهی اوقات رابط کاربری چت هیچ پیام خطایی را نمایش نمی‌دهد، اما برنامه یا کارت چت نتیجه غیرمنتظره‌ای را ایجاد می‌کند؛ برای مثال، ممکن است پیام کارت ظاهر نشود.
اگرچه ممکن است پیام خطا در رابط کاربری چت نمایش داده نشود، پیام‌های خطای توصیفی و داده‌های گزارش برای کمک به شما در رفع خطاها هنگام فعال بودن ثبت خطا برای برنامه‌های چت در دسترس هستند. برای کمک به مشاهده، اشکال‌زدایی و رفع خطاها، به عیب‌یابی و رفع خطاهای گوگل چت مراجعه کنید.
تمیز کردن
برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این آموزش، توصیه می‌کنیم پروژه Cloud را حذف کنید.
- در کنسول گوگل کلود، به صفحه مدیریت منابع بروید. روی منو > مدیریت و دسترسی به منابع (IAM & Admin) > مدیریت منابع (Manage Resources) کلیک کنید.
- در لیست پروژه‌ها، پروژه‌ای را که می‌خواهید حذف کنید انتخاب کنید و سپس روی «حذف کلیک کنید.
- در کادر محاوره‌ای، شناسه پروژه را تایپ کنید و سپس برای حذف پروژه، روی خاموش کردن (Shut down) کلیک کنید.
مراحل بعدی
- ایجاد کارت‌های تعاملی – پیام‌های کارتی از یک طرح‌بندی تعریف‌شده، عناصر رابط کاربری تعاملی مانند دکمه‌ها و رسانه‌های غنی مانند تصاویر پشتیبانی می‌کنند. از پیام‌های کارتی برای ارائه اطلاعات دقیق، جمع‌آوری اطلاعات از کاربران و راهنمایی کاربران برای برداشتن گام بعدی استفاده کنید.
- پاسخ به دستورات - دستورات به کاربران کمک می‌کنند تا ویژگی‌های کلیدی برنامه چت شما را کشف و استفاده کنند.
- دیالوگ‌های شروع - دیالوگ‌ها رابط‌های پنجره‌ای و مبتنی بر کارت هستند که برنامه شما می‌تواند برای تعامل با کاربر باز کند. چندین کارت را می‌توان به صورت متوالی به هم متصل کرد، که به کاربران کمک می‌کند فرآیندهای چند مرحله‌ای مانند پر کردن داده‌های فرم را تکمیل کنند.
- Codelab: آماده ساخت یک برنامه چت پیشرفته‌تر هستید؟ بازخورد برنامه چت از codelab را ببینید. برنامه‌هایی برای Google Chat با Gemini بسازید .