جلسات را از Google Chat برنامه ریزی کنید

سطح کدنویسی : متوسط
مدت زمان : ۲۵ دقیقه
نوع پروژه : افزونه‌ی Google Workspace برای توسعه‌ی چت .

اهداف

  • بفهمید که راه حل چه کاری انجام می‌دهد.
  • درک کنید که سرویس‌های Apps Script در این راهکار چه کاری انجام می‌دهند.
  • محیط خود را تنظیم کنید.
  • اسکریپت را تنظیم کنید.
  • اسکریپت را اجرا کنید.

درباره این راهکار

از طریق یک پیام مستقیم (DM) یا فضایی در Google Chat، یک جلسه را در تقویم گوگل برنامه‌ریزی کنید. می‌توانید جزئیات خاصی مانند موضوع، زمان شروع یا مدت زمان را برای جلسه تنظیم کنید یا از تنظیمات پیش‌فرض برای برنامه‌ریزی فوری جلسه استفاده کنید.

رابط کاربری برنامه چت زمان‌بندی جلسات

چگونه کار می‌کند؟

اسکریپت برنامه چت از دستورات و دیالوگ‌های اسلش برای دریافت جزئیات جلسه از کاربران و برنامه‌ریزی یک رویداد در تقویم استفاده می‌کند. این اسکریپت شامل تنظیمات پیش‌فرض جلسه است که می‌تواند متناسب با نیازهای شما سفارشی‌سازی شود.

سرویس‌های اسکریپت برنامه‌ها

این راهکار از سرویس‌های زیر استفاده می‌کند:

  • سرویس تقویم - رویداد تقویم را از اطلاعات جلسه ارائه شده ایجاد می‌کند.
  • سرویس پایه - از کلاس Session برای دریافت منطقه زمانی اسکریپت استفاده می‌کند. تقویم هنگام زمان‌بندی رویداد از این منطقه زمانی استفاده می‌کند.
  • سرویس Utilities - تاریخ رویداد تقویم را قالب‌بندی می‌کند و شناسه رویداد را برای کمک به دریافت URL رویداد کدگذاری می‌کند.

پیش‌نیازها

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

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

اگر هنوز باز نشده است، پروژه ابری که قصد دارید برای این نمونه استفاده کنید را باز کنید:

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

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

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

API را روشن کنید

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

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

  1. در کنسول گوگل کلود، به Menu > برویدGoogle Auth platform > برندسازی .

    به بخش برندسازی بروید

  2. اگر قبلاً تنظیمات را انجام داده‌اید Google Auth platformمی‌توانید تنظیمات صفحه رضایت OAuth زیر را در Branding ، Audience و Data Access پیکربندی کنید. اگر پیامی با این مضمون مشاهده کردید Google Auth platform هنوز پیکربندی نشده است ، روی شروع کار کلیک کنید:
    1. در قسمت اطلاعات برنامه ، در قسمت نام برنامه ، نامی برای برنامه وارد کنید.
    2. در ایمیل پشتیبانی کاربر ، یک آدرس ایمیل پشتیبانی انتخاب کنید که کاربران در صورت داشتن هرگونه سوال در مورد رضایت خود بتوانند با شما تماس بگیرند.
    3. روی بعدی کلیک کنید.
    4. در قسمت مخاطبان ، داخلی (Internal) را انتخاب کنید.
    5. روی بعدی کلیک کنید.
    6. در قسمت اطلاعات تماس ، یک آدرس ایمیل وارد کنید که از طریق آن بتوانید از هرگونه تغییر در پروژه خود مطلع شوید.
    7. روی بعدی کلیک کنید.
    8. در قسمت Finish ، سیاست داده‌های کاربر سرویس‌های API گوگل را مرور کنید و در صورت موافقت، گزینه «من با سیاست‌های داده‌های کاربر سرویس‌های API گوگل موافقم» را انتخاب کنید.
    9. روی ادامه کلیک کنید.
    10. روی ایجاد کلیک کنید.
  3. فعلاً می‌توانید از اضافه کردن محدوده‌ها صرف نظر کنید. در آینده، وقتی برنامه‌ای برای استفاده در خارج از سازمان Google Workspace خود ایجاد می‌کنید، باید نوع کاربر (User type) را به خارجی (External) تغییر دهید. سپس محدوده‌های مجوز مورد نیاز برنامه خود را اضافه کنید. برای کسب اطلاعات بیشتر، به راهنمای کامل پیکربندی رضایت OAuth مراجعه کنید.

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

پروژه Apps Script را ایجاد کنید

  1. برای باز کردن پروژه‌ی «زمان‌بندی جلسات از اسکریپت برنامه‌های چت گوگل» روی دکمه‌ی زیر کلیک کنید.
    پروژه را باز کنید
  2. روی نمای کلی کلیک کنید.
  3. در صفحه مرور کلی، روی «ایجاد کپی» کلیک کنید آیکون مربوط به کپی کردن .

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

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

پیکربندی API چت

  1. در کنسول گوگل کلود، به صفحه Chat API بروید.
    به API چت بروید
  2. روی پیکربندی کلیک کنید.
  3. API چت را با اطلاعات زیر پیکربندی کنید:
    • نام : Meeting Scheduler
    • آدرس آواتار : https://goo.gle/3SfMkjb .
    • شرح : Quickly create meetings.
    • عملکرد : هر دو کادر را علامت بزنید تا کاربران بتوانند مستقیماً به برنامه پیام دهند و آن را به فضاها اضافه کنند.
    • تنظیمات اتصال : روی Apps Script کلیک کنید و شناسه استقرار head را وارد کنید.
    • دستورات : با انجام مراحل زیر، دستورات اسلش را برای /help و /schedule_Meeting اضافه کنید:
      1. روی دستور Add کلیک کنید و آن را با اطلاعات زیر پیکربندی کنید:
        • شناسه دستور : 1 .
        • توضیحات : Learn what this app does.
        • نوع دستور : Slash command .
        • نام دستور اسلش : /help .
      2. دوباره روی Add command کلیک کنید و آن را با اطلاعات زیر پیکربندی کنید:
        • شناسه فرمان : 2 .
        • توضیحات : Schedule a meeting.
        • نوع دستور : Slash command .
        • نام دستور اسلش : /schedule_Meeting .
        • کادر محاوره‌ای Opens a را علامت بزنید.
    • مجوزها : افراد و گروه‌های خاص در دامنه خود را انتخاب کرده و آدرس ایمیل خود را وارد کنید.
  4. روی ذخیره کلیک کنید.

اسکریپت را اجرا کنید

  1. گوگل چت را باز کنید.

    به گوگل چت بروید

  2. روی شروع چت کلیک کنید.

  3. نام برنامه، Meeting Scheduler را جستجو کنید.

  4. برای درخواست مجوز، یک پیام اولیه، مانند hello ، ارسال کنید.

  5. وقتی برنامه پاسخ داد، روی پیکربندی کلیک کنید و برنامه را مجاز کنید. اگر صفحه رضایت OAuth هشدار « این برنامه تأیید نشده است» را نشان می‌دهد، با انتخاب Advanced > Go to {Project Name} (unsafe) ادامه دهید.

  6. /schedule_Meeting را به برنامه ارسال کنید.

  7. در کادر محاوره‌ای، حداقل یک آدرس ایمیل دعوت‌کننده اضافه کنید. می‌توانید فیلدهای دیگر را به‌روزرسانی کنید یا از ورودی‌های پیش‌فرض استفاده کنید.

  8. روی ارسال کلیک کنید.

  9. برای مشاهده جلسه، روی «باز کردن رویداد تقویم» کلیک کنید.

کد را مرور کنید

برای بررسی کد Apps Script برای این راهکار که در GitHub میزبانی شده است، کلیک کنید:

مشاهده در گیت‌هاب

مراحل بعدی