สร้างแอป Google Chat ด้วย Google Apps Script

สร้างแอป Google Chat ที่รับส่งข้อความได้โดยตรง ตอบกลับด้วยการพูดข้อความ

แผนภาพต่อไปนี้จะแสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ

สถาปัตยกรรมของแอป Chat ที่ใช้งานร่วมกับ Apps Script

ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับ Apps Script แอป Chat มีขั้นตอนข้อมูลต่อไปนี้

  1. ผู้ใช้ส่งข้อความไปยังแอปใน Chat ไม่ว่าจะผ่าน ข้อความส่วนตัวหรือในพื้นที่ใน Chat
  2. ตรรกะของแอป Chat ที่ใช้ใน Apps Script ที่อยู่ใน Google Cloud จะได้รับ และประมวลผลข้อความ
  3. (ไม่บังคับ) ตรรกะของแอป Chat จะผสานรวมกับ บริการของ Google Workspace เช่น ปฏิทิน หรือ ชีตหรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube
  4. ตรรกะของแอป Chat จะส่งคำตอบกลับไปยัง บริการแอปใน Chat ใน Chat
  5. ระบบจะส่งคำตอบให้กับผู้ใช้

วัตถุประสงค์

  • ตั้งค่าสภาพแวดล้อมของคุณ
  • ตั้งค่าสคริปต์
  • เผยแพร่แอป Chat
  • ทดสอบแอป Chat

ข้อกำหนดเบื้องต้น

ตั้งค่าสภาพแวดล้อมของคุณ

เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในคอนโซล Google Cloud

หากยังไม่ได้เปิด ให้เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ต้องการใช้ สำหรับตัวอย่างนี้

  1. ในคอนโซล Google Cloud ให้ไปที่หน้าเลือกโปรเจ็กต์

    เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

  2. เลือกโปรเจ็กต์ Google Cloud ที่ต้องการใช้ หรือคลิกสร้างโปรเจ็กต์แล้วทำตามวิธีการบนหน้าจอ หากสร้างโปรเจ็กต์ Google Cloud คุณอาจต้องเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์

เปิด Chat API

ก่อนใช้ Google APIs คุณต้องเปิดใช้ API เหล่านี้ในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API ได้ตั้งแต่ 1 รายการขึ้นไปในโปรเจ็กต์ Google Cloud เดียว

แอปทั้งหมดที่ใช้ OAuth 2.0 ต้องมีการกำหนดค่าหน้าจอคำยินยอม กำลังกำหนดค่า หน้าจอขอความยินยอม OAuth ของแอปจะกำหนดสิ่งที่แสดงต่อผู้ใช้และแอป ผู้ตรวจสอบ และลงทะเบียนแอปของคุณเพื่อให้เผยแพร่ในภายหลังได้

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และ บริการ > หน้าจอขอความยินยอม OAuth

    ไปที่หน้าจอขอความยินยอม OAuth

  2. เลือกประเภทผู้ใช้เป็นภายใน แล้วคลิกสร้าง
  3. กรอกแบบฟอร์มการลงทะเบียนแอป แล้วคลิกบันทึกและดำเนินการต่อ
  4. ในตอนนี้ คุณสามารถข้ามการเพิ่มขอบเขต แล้วคลิกบันทึกและดำเนินการต่อได้ ในอนาคต เมื่อคุณสร้างแอปสำหรับใช้นอก ในองค์กร Google Workspace คุณต้องเปลี่ยนประเภทผู้ใช้เป็นภายนอก จากนั้น เพิ่มขอบเขตการให้สิทธิ์ที่แอปของคุณต้องการ

  5. ตรวจสอบสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากแอป การลงทะเบียนถูกต้องแล้ว ให้คลิกกลับไปที่หน้าแดชบอร์ด

ตั้งค่าสคริปต์

ในการตั้งค่าสคริปต์ ให้ใช้เทมเพลต แล้วตั้งค่า โปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Apps Script

สร้างสคริปต์จากเทมเพลต

  1. ไปที่หน้า หน้าเริ่มต้นใช้งาน Apps Script
  2. คลิกเทมเพลตแอป Chat คุณอาจต้องเลื่อนลง เพื่อดูเทมเพลตนี้
  3. คลิกโปรเจ็กต์ที่ไม่มีชื่อ พิมพ์ Quickstart app และ คลิกเปลี่ยนชื่อ

คัดลอกหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และ ผู้ดูแลระบบ > การตั้งค่า

    ไปที่ IAM และ การตั้งค่าของผู้ดูแลระบบ

  2. คัดลอกค่าในช่องหมายเลขโปรเจ็กต์

ตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของโปรเจ็กต์ Apps Script

  1. ในโปรเจ็กต์ Apps Script ของแอป Chat คลิกการตั้งค่าโปรเจ็กต์ ไอคอนสำหรับการตั้งค่าโปรเจ็กต์
  2. ในส่วนโครงการ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโครงการ
  3. วางหมายเลขโปรเจ็กต์ Google Cloud ในหมายเลขโปรเจ็กต์ GCP
  4. คลิกตั้งค่าโปรเจ็กต์

ตอนนี้คุณมีโค้ดแอปที่ใช้งานได้ซึ่งสามารถลองใช้ได้ (ตามที่อธิบายไว้ใน ต่อไปนี้) และปรับแต่งให้ตรงกับความต้องการของคุณ

โปรดตรวจสอบว่าคุณได้ลงชื่อเข้าใช้บัญชี Google ที่ถูกต้องเมื่อเปิด เทมเพลต Apps Script บางครั้งบัญชีปัจจุบันอาจเปลี่ยนเป็น บัญชีเริ่มต้นของคุณโดยที่คุณไม่ทราบ

สร้างการทดสอบการทำให้ใช้งานได้

คุณต้องมีรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์ Apps Script นี้เพื่อให้ คุณสามารถใช้ในขั้นตอนถัดไปได้

ในการรับรหัสการทำให้ใช้งานได้ของส่วนหัว ให้ทำดังนี้

  1. ในโปรเจ็กต์ Apps Script ของแอป Chat คลิกทำให้ใช้งานได้ > ทดสอบการติดตั้งใช้งาน
  2. คัดลอกรหัสการทำให้ใช้งานได้ของส่วนหัวเพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น

เผยแพร่แอป Chat

เผยแพร่แอป Chat จากคอนโซล Google Cloud

  1. ใน Google Cloud Console ค้นหา Google Chat API แล้วคลิก Google Chat API
  2. คลิกจัดการ
  3. คลิกการกำหนดค่า แล้วตั้งค่าแอป 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. ในช่องรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของส่วนหัวที่คุณ ที่คัดลอกไว้ก่อนหน้านี้
    7. ภายใต้ "การเปิดเผย" ให้เลือก บุคคลและกลุ่มที่เฉพาะเจาะจงใน โดเมน แล้วป้อนอีเมลของคุณ
  4. คลิกบันทึก

แอป Chat พร้อมตอบกลับข้อความแล้ว

ทดสอบแอป Chat

หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ข้อความส่วนตัวด้วย แล้วส่งข้อความในแอป Chat

  1. เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณ ที่ให้ไว้เมื่อคุณเพิ่มตัวเองเป็นผู้ทดสอบที่เชื่อถือได้

    ไปที่ Google Chat

  2. คลิก แชทใหม่
  3. ในช่องเพิ่มผู้คนอย่างน้อย 1 คน ให้พิมพ์ชื่อ แอป Chat
  4. เลือกแอปใน Chat จากผลการค้นหา โดยตรง ข้อความจะเปิดขึ้น

  5. ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์ Hello และ กด enter

    แอป Chat ขอขอบคุณที่เพิ่มและเปิดเสียงก้อง ข้อความของคุณ

หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดู ทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับ แอป Google Chat

แก้ปัญหา

เมื่อแอป Google Chat หรือ card จะแสดงผลข้อผิดพลาด อินเทอร์เฟซ Chat แสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณ" บางครั้ง UI ของ Chat ไม่แสดงข้อความแสดงข้อผิดพลาดใดๆ แต่แอป Chat หรือ ทำให้เกิดผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจ ปรากฏขึ้น

แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของแชท มีข้อความแสดงข้อผิดพลาดและข้อมูลบันทึกที่สื่อความหมายเพื่อช่วยคุณแก้ไขข้อผิดพลาด เมื่อมีการเปิดข้อผิดพลาดในการบันทึกสำหรับแอป Chat หากต้องการความช่วยเหลือในการดู การแก้ไขข้อบกพร่องและการแก้ไขข้อผิดพลาด โปรดดู แก้ปัญหาข้อผิดพลาดของ Google Chat

ล้างข้อมูล

เพื่อเลี่ยงไม่ให้เกิดการเรียกเก็บเงินกับบัญชี Google Cloud ของคุณตาม ซึ่งใช้ในบทแนะนำนี้ เราขอแนะนำให้คุณลบ โปรเจ็กต์ที่อยู่ในระบบคลาวด์

  1. ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และ ผู้ดูแลระบบ > จัดการทรัพยากร

    ไปที่เครื่องมือจัดการทรัพยากร

  2. ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
  3. ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเครื่องเพื่อลบ ให้กับโครงการ

ขั้นตอนถัดไป

  • สร้างการ์ดแบบอินเทอร์แอกทีฟ - การ์ด ข้อความรองรับเลย์เอาต์ที่กำหนดไว้ องค์ประกอบ UI แบบอินเทอร์แอกทีฟ เช่น ปุ่ม และ สื่อสมบูรณ์ เช่น รูปภาพ ใช้ข้อความการ์ดเพื่อนำเสนอข้อมูลโดยละเอียด รวบรวมข้อมูลจากผู้ใช้และแนะนำผู้ใช้ให้ดำเนินการในขั้นตอนถัดไป
  • รองรับคําสั่งเครื่องหมายทับ - คําสั่งเครื่องหมายทับจะทำให้ ที่คุณลงทะเบียนและโฆษณาคำสั่งที่เจาะจงซึ่งผู้ใช้สามารถให้แอปของคุณได้ โดยพิมพ์คำสั่งที่ขึ้นต้นด้วยเครื่องหมายทับ (/) เช่น /help
  • กล่องโต้ตอบการเปิดตัว - กล่องโต้ตอบจะอยู่ในหน้าต่างตามการ์ด ที่แอปของคุณสามารถเปิดขึ้นเพื่อโต้ตอบกับผู้ใช้ บัตรหลายใบ สามารถเรียงต่อกันตามลำดับ ซึ่งช่วยให้ผู้ใช้ทำหลายๆ ขั้นตอนได้ เช่น กรอกข้อมูลแบบฟอร์ม
  • Codelab: พร้อมที่จะสร้าง มีแอปแชทไหม ดูความคิดเห็น แอป Chat จาก Codelab สร้างแอปสำหรับ Google Chat ด้วย Gemini