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

หน้านี้จะอธิบายวิธีสร้างส่วนเสริมของ Google Workspace ที่ทำงานใน Google Chat โดยใช้ Google Apps Script ใน Google Chat ส่วนเสริมจะปรากฏต่อผู้ใช้เป็นแอป Google Chat ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการขยาย Google Chat

แอป 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. ระบบจะส่งคำตอบไปยังผู้ใช้

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

• ตั้งค่าสภาพแวดล้อม
• ตั้งค่าสคริปต์
• กำหนดค่าส่วนเสริม Google Workspace สำหรับแอป Chat
• ทดสอบแอป Chat

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

• บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์ Google Cloud

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

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

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

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

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

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

เปิดใช้ Chat API

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

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

  เปิดใช้ API

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

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

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

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

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

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

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

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

หากต้องการตั้งค่าสคริปต์ ให้ทำสำเนาโปรเจ็กต์เริ่มต้นใช้งาน จากนั้นตั้งค่าโปรเจ็กต์ Cloud ใน Apps Script

ทำสำเนาโปรเจ็กต์เริ่มต้นใช้งาน

1. คลิกปุ่มต่อไปนี้เพื่อเปิดส่วนเสริมใน Google Chat โปรเจ็กต์ Apps Script
   เปิดโปรเจ็กต์
2. คลิก info_outline ภาพรวม
3. ในหน้าภาพรวม ให้คลิก ทำสำเนา

4. ตั้งชื่อสําเนาของโปรเจ็กต์ Apps Script

   1. คลิกสำเนาของส่วนเสริม Chat App

   2. ในชื่อโปรเจ็กต์ ให้พิมพ์ Add-on Chat app

   3. คลิกเปลี่ยนชื่อ

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

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

   ไปที่การตั้งค่า 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. คัดลอกรหัสการติดตั้งใช้งานส่วนกลางเพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น

กำหนดค่าส่วนเสริม

ใช้การติดตั้งใช้งาน Apps Script โดยทําตามขั้นตอนต่อไปนี้เพื่อสร้างส่วนเสริมและติดตั้งใช้งานแอป Google Chat

1. ในคอนโซล ให้ค้นหา Google Chat API แล้วคลิก Google Chat API
2. คลิกจัดการ

3. คลิกการกําหนดค่าและตั้งค่าแอป Chat โดยทำดังนี้

   1. ป้อน Add-on Chat app ในช่องชื่อแอป
   2. ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png ในช่อง Avatar URL
   3. ป้อน Add-on Chat app ในช่องคำอธิบาย
   4. ในส่วนฟังก์ชันการทำงาน ให้เลือกรับข้อความแบบ 1:1 และเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
   5. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโปรเจ็กต์ Apps Script
   6. ในช่อง Deployment ID ให้วางรหัสการทำให้ใช้งานได้หลักที่คุณคัดลอกไว้ก่อนหน้านี้
   7. ในส่วน "ระดับการเข้าถึง" ให้เลือกบุคคลและกลุ่มเฉพาะในโดเมน แล้วป้อนอีเมล

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

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

ทดสอบแอป Chat

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

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

   ไปที่ Google Chat

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

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

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

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

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

แก้ปัญหา

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

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

ล้างข้อมูล

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

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

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

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