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

หมายเหตุ: คู่มือนี้อธิบายวิธีสร้างแอป Chat แบบอินเทอร์แอกทีฟ โดยใช้เหตุการณ์การโต้ตอบของ Chat API นอกจากนี้ คุณยังสร้างแอป Chat เป็นส่วนเสริมของ Google Workspace ได้ด้วย ดูว่าควรใช้เฟรมเวิร์กใดได้ที่หัวข้อสร้างแอป Google Chat แบบอินเทอร์แอกทีฟ

สร้างแอป Google Chat ที่คุณสามารถส่งข้อความโดยตรงและตอบกลับด้วยการแสดงข้อความของคุณซ้ำ

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

ในแผนภาพก่อนหน้า ผู้ใช้ที่โต้ตอบกับแอป 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 Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
• โปรเจ็กต์ Google Cloud หากต้องการสร้าง ให้ดูสร้างโปรเจ็กต์ Google Cloud

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

เปิดโปรเจ็กต์ Cloud ใน Google Cloud Console

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

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

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

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

เปิดใช้ Chat API

ก่อนใช้ Google API คุณต้องเปิดใช้ API ในโปรเจ็กต์ Google Cloud คุณเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้

• เปิดใช้ Google Chat API ในคอนโซล Google Cloud

  เปิดใช้ API

กำหนดค่าหน้าจอขอความยินยอม OAuth

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

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

   ไปที่การสร้างแบรนด์

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

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

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

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

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

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

1. ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > การตั้งค่า

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

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

ตั้งค่าโปรเจ็กต์ Cloud ของโปรเจ็กต์ Apps Script

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

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

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

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

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

หากต้องการรับรหัสการทำให้ใช้งานได้ล่าสุด ให้ทำดังนี้

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

เผยแพร่แอป Chat

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

1. ในคอนโซล ให้ค้นหา 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. ในส่วนฟังก์ชันการทำงาน ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
   5. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือก Apps Script
   6. ในช่องรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของ Head ที่คุณคัดลอกไว้ก่อนหน้านี้
   7. ในส่วนระดับการแชร์ ให้เลือกบุคคลและกลุ่มที่เฉพาะเจาะจงในโดเมน แล้วป้อนอีเมล

4. คลิกบันทึก

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

ทดสอบแอป Chat

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

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

   ไปที่ Google Chat

2. คลิก แชทใหม่
3. ในช่องเพิ่มบุคคลอย่างน้อย 1 คน ให้พิมพ์ชื่อแอป Chat

4. เลือกแอป Chat จากผลการค้นหา ข้อความส่วนตัวจะเปิดขึ้น

   หมายเหตุ: หากไม่เห็นแอป Chat ในรายการผลการค้นหา ให้ตรวจสอบว่าคุณได้รวมบัญชี Google Workspace ไว้ในการตั้งค่าระดับการมองเห็นของหน้าการกำหนดค่า Chat API ใน Google Cloud Console แล้ว

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

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

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

แก้ปัญหา

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

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

ล้างข้อมูล

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

ข้อควรระวัง: การลบโปรเจ็กต์จะมีผลดังต่อไปนี้

• ระบบจะลบทุกอย่างในโปรเจ็กต์ หากใช้โปรเจ็กต์ที่มีอยู่สำหรับบทแนะนำนี้ เมื่อลบโปรเจ็กต์ คุณจะลบงานอื่นๆ ที่ทำในโปรเจ็กต์ด้วย
• รหัสโปรเจ็กต์ที่กำหนดเองจะหายไป เมื่อสร้างโปรเจ็กต์นี้ คุณอาจสร้างรหัสโปรเจ็กต์ที่กำหนดเองซึ่งต้องการใช้ในอนาคต หากต้องการเก็บ URL ที่ใช้รหัสโปรเจ็กต์ เช่น URL ใน appspot.com ให้ลบทรัพยากรที่เลือกภายในโปรเจ็กต์แทนการลบทั้งโปรเจ็กต์

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

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

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

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

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

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