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

สร้างแอป 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 รุ่น 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 ให้ไปที่เมนู > API และบริการ > หน้าจอขอความยินยอม OAuth

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

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

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

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

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

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

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

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

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

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

เผยแพร่แอป Chat

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

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

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

   1. ป้อน Quickstart app ในช่องชื่อแอป
   2. ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png ในช่อง Avatar URL
   3. ป้อน Quickstart app ในช่องคำอธิบาย
   4. ในส่วนฟังก์ชันการทำงาน ให้เลือกรับข้อความแบบ 1:1 และเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
   5. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือก Apps Script
   6. ในช่อง Deployment ID ให้วางรหัสการทำให้ใช้งานได้ของส่วนหัวที่คุณคัดลอกไว้ก่อนหน้านี้
   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 แบบอินเทอร์แอกทีฟ เช่น ปุ่ม และสื่อสมบูรณ์ เช่น รูปภาพ ใช้ข้อความการ์ดเพื่อแสดงข้อมูลโดยละเอียดรวบรวมข้อมูลจากผู้ใช้ และแนะนําให้ผู้ใช้ดําเนินการในขั้นตอนถัดไป
• รองรับคำสั่งเครื่องหมายทับ - คำสั่งเครื่องหมายทับช่วยให้คุณลงทะเบียนและโฆษณาคำสั่งที่เฉพาะเจาะจงซึ่งผู้ใช้สามารถส่งไปยังแอปได้ด้วยการพิมพ์คำสั่งที่ขึ้นต้นด้วยเครื่องหมายทับ (/) เช่น /help
• เปิดกล่องโต้ตอบ - กล่องโต้ตอบเป็นอินเทอร์เฟซแบบการ์ดที่มีหน้าต่างซึ่งแอปสามารถเปิดเพื่อโต้ตอบกับผู้ใช้ การ์ดหลายใบสามารถต่อเรียงกันตามลำดับ ซึ่งช่วยให้ผู้ใช้ทำตามกระบวนการแบบหลายขั้นตอนได้ เช่น การกรอกข้อมูลในแบบฟอร์ม
• Codelab: พร้อมสร้างแอปแชทขั้นสูงขึ้นแล้วหรือยัง ดูความคิดเห็น แอป Chat จากโค้ดแล็บ สร้างแอปสำหรับ Google Chat ด้วย Gemini