สร้างแอป Google Chat ที่คุณส่งข้อความได้โดยตรงและโต้ตอบด้วยการสะท้อนข้อความ
แผนภาพต่อไปนี้จะแสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ
ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับแอปใน Chat ของ Apps Script จะมีโฟลว์ข้อมูลต่อไปนี้
- ผู้ใช้ส่งข้อความไปยังแอป Chat ทั้งในข้อความส่วนตัวหรือในพื้นที่ใน Chat
- ตรรกะของแอป Chat ที่ใช้ใน Apps Script ซึ่งอยู่ใน Google Cloud จะรับและประมวลผลข้อความ
- ตรรกะของแอป Chat จะผสานรวมกับบริการของ Google Workspace เช่น ปฏิทินหรือชีต หรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube ได้
- ตรรกะของแอป Chat จะส่งการตอบกลับกลับไปยังบริการแอปใน Chat
- คําตอบจะส่งไปยังผู้ใช้
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อมของคุณ
- ตั้งค่าสคริปต์
- เผยแพร่แอป Chat
- ทดสอบแอป Chat
ข้อกำหนดเบื้องต้น
- บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Chat
- โปรเจ็กต์ Google Cloud
ตั้งค่าสภาพแวดล้อมของคุณ
เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในคอนโซล Google Cloud
หากยังไม่ได้เปิด ให้เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ต้องการใช้สำหรับตัวอย่างนี้
- ในคอนโซล Google Cloud ให้ไปที่หน้าเลือกโปรเจ็กต์
- เลือกโปรเจ็กต์ Google Cloud ที่ต้องการใช้ หรือคลิกสร้างโปรเจ็กต์ แล้วทำตามวิธีการบนหน้าจอ หากสร้างโปรเจ็กต์ Google Cloud คุณอาจต้องเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์
เปิดใช้ Chat API
ก่อนใช้ Google APIs คุณต้องเปิดใช้ API ในโปรเจ็กต์ Google Cloud คุณเปิด API ได้มากกว่า 1 รายการในโปรเจ็กต์ Google Cloud เดียวเปิดใช้ Google Chat API ในคอนโซล Google Cloud
กำหนดค่าหน้าจอขอความยินยอม OAuth
แอปทั้งหมดที่ใช้ OAuth 2.0 ต้องกำหนดค่าหน้าจอขอความยินยอม การกำหนดค่าหน้าจอคำยินยอม OAuth ของแอปจะกำหนดสิ่งที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป และลงทะเบียนแอปเพื่อให้เผยแพร่ได้ในภายหลัง
- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > หน้าจอขอความยินยอม OAuth
- สำหรับประเภทผู้ใช้ ให้เลือกภายใน แล้วคลิกสร้าง
- กรอกแบบฟอร์มการลงทะเบียนแอปให้เสร็จสมบูรณ์ แล้วคลิกบันทึกและดำเนินการต่อ
สำหรับตอนนี้ คุณอาจข้ามการเพิ่มขอบเขต แล้วคลิกบันทึกและต่อไป ในอนาคต เมื่อสร้างแอปเพื่อใช้นอกองค์กร Google Workspace คุณจะต้องเปลี่ยนประเภทผู้ใช้เป็นภายนอก จากนั้นจึงเพิ่มขอบเขตการให้สิทธิ์ที่แอปต้องการ
- ดูสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากการลงทะเบียนแอปถูกต้องแล้ว ให้คลิกกลับไปยังหน้าแดชบอร์ด
ตั้งค่าสคริปต์
หากต้องการตั้งค่าสคริปต์ ให้ใช้เทมเพลตแล้วตั้งค่าโปรเจ็กต์ Cloud ใน Apps Script
สร้างสคริปต์จากเทมเพลต
- ไปที่หน้าเริ่มต้นใช้งาน Apps Script
- คลิกเทมเพลตแอปใน Chat คุณอาจต้องเลื่อนลงเพื่อดูเทมเพลตนี้
- คลิกโปรเจ็กต์ที่ไม่มีชื่อ พิมพ์
Quickstart app
แล้วคลิกเปลี่ยนชื่อ
คัดลอกหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์
- ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > การตั้งค่า
- คัดลอกค่าในช่องหมายเลขโปรเจ็กต์
ตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของโปรเจ็กต์ Apps Script
- ในโปรเจ็กต์ Apps Script ของแอป Chat ให้คลิกการตั้งค่าโปรเจ็กต์
- ในส่วนโครงการ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโครงการ
- วางหมายเลขโปรเจ็กต์ Google Cloud ในหมายเลขโปรเจ็กต์ GCP
- คลิกตั้งค่าโครงการ
ตอนนี้คุณมีโค้ดของแอปที่ใช้งานได้ซึ่งสามารถลองใช้ได้แล้ว (ตามที่อธิบายไว้ในขั้นตอนต่อไปนี้) จากนั้นจึงปรับแต่งเพื่อให้เป็นไปตามข้อกำหนด
ตรวจสอบว่าคุณได้ลงชื่อเข้าใช้บัญชี Google ที่ถูกต้องเมื่อเปิดเทมเพลต Apps Script บางครั้งบัญชีปัจจุบันอาจเปลี่ยนไปใช้ บัญชีเริ่มต้นโดยที่คุณไม่ทราบ
สร้างการทำให้ใช้งานได้ทดสอบ
คุณต้องมีรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์ Apps Script นี้เพื่อใช้ในขั้นตอนถัดไป
หากต้องการรับรหัสการติดตั้งใช้งานส่วนหัว ให้ทำดังนี้
- ในโปรเจ็กต์ Apps Script ของแอป Chat ให้คลิกทำให้ใช้งานได้ > ทดสอบการทำให้ใช้งานได้
- คัดลอกรหัสการทำให้ใช้งานได้ของ Head เพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น
เผยแพร่แอป Chat
เผยแพร่แอป Chat จากคอนโซล Google Cloud
- ในคอนโซล Google Cloud ให้ค้นหา
Google Chat API
แล้วคลิก Google Chat API - คลิกจัดการ
คลิกการกำหนดค่าแล้วตั้งค่าแอป Chat โดยทำดังนี้
- ในช่องชื่อแอป ให้ป้อน
Quickstart app
- ในช่อง URL ของรูปโปรไฟล์ ให้ป้อน
https://developers.google.com/chat/images/quickstart-app-avatar.png
- ในช่องคำอธิบาย ให้ป้อน
Quickstart app
- ในส่วนฟังก์ชันการทำงาน ให้เลือกรับข้อความแบบ 1:1 และ เข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
- ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโปรเจ็กต์ Apps Script
- ในช่องรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของส่วนหัวที่คุณคัดลอกไว้ก่อนหน้านี้
- ในส่วน "การเปิดเผย" ให้เลือกบุคคลและกลุ่มเฉพาะในโดเมน และป้อนอีเมล
- ในช่องชื่อแอป ให้ป้อน
คลิกบันทึก
แอป Chat พร้อมที่จะตอบกลับข้อความแล้ว
ทดสอบแอป Chat
หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ข้อความส่วนตัวด้วยแอป Chat แล้วส่งข้อความ ดังนี้
เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณให้ไว้เมื่อเพิ่มตัวคุณเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- พิมพ์ชื่อแอป Chat ในช่องเพิ่มผู้คนอย่างน้อย 1 คน
เลือกแอป Chat จากผลการค้นหา ข้อความส่วนตัวจะเปิดขึ้น
ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์
Hello
แล้วกดenter
แอป Chat ขอบคุณสำหรับการเพิ่มรูปภาพและสะท้อนข้อความของคุณ
หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดูทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับแอป Google Chat
แก้ปัญหา
เมื่อแอปหรือการ์ด Google Chat แสดงผลข้อผิดพลาด อินเทอร์เฟซ Chat จะแสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณ" บางครั้ง UI ของ Chat ไม่แสดงข้อความแสดงข้อผิดพลาด แต่แอปหรือการ์ด Chat จะให้ผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความการ์ดอาจไม่ปรากฏ
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของ Chat แต่ก็จะมีข้อความแสดงข้อผิดพลาดที่สื่อความหมายและข้อมูลบันทึกพร้อมช่วยคุณแก้ไขข้อผิดพลาดเมื่อเปิดการบันทึกข้อผิดพลาดสำหรับแอป Chat ไว้ หากต้องการความช่วยเหลือในการดู แก้ไขข้อบกพร่อง และการแก้ไขข้อผิดพลาด โปรดดูหัวข้อแก้ปัญหาและแก้ไขข้อผิดพลาดของ Google Chat
ล้างข้อมูล
เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินในบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้
- ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิกลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเพื่อลบโปรเจ็กต์
ขั้นตอนถัดไป
- สร้างการ์ดแบบอินเทอร์แอกทีฟ ข้อความการ์ดรองรับเลย์เอาต์ที่กำหนดไว้ องค์ประกอบ UI แบบอินเทอร์แอกทีฟ เช่น ปุ่ม และริชมีเดียอย่างรูปภาพ ใช้ข้อความในการ์ดเพื่อนำเสนอข้อมูลโดยละเอียด รวบรวมข้อมูลจากผู้ใช้ และแนะนำผู้ใช้ให้ไปยังขั้นตอนถัดไป
- คำสั่งเครื่องหมายทับ - คำสั่งเครื่องหมายทับช่วยให้คุณลงทะเบียนและโฆษณาคำสั่งเฉพาะที่ผู้ใช้สามารถให้แอปของคุณได้
โดยพิมพ์คำสั่งที่ขึ้นต้นด้วยเครื่องหมายทับ (
/
) เช่น/help
- กล่องโต้ตอบการเปิดใช้ - กล่องโต้ตอบเป็นหน้าต่างแบบอินเทอร์เฟซ ที่ใช้การ์ดซึ่งแอปของคุณสามารถเปิดเพื่อโต้ตอบกับผู้ใช้ได้ สามารถต่อบัตรหลายใบเข้าด้วยกันตามลำดับได้ ซึ่งช่วยให้ผู้ใช้ทำตามขั้นตอนหลายขั้นตอน เช่น การกรอกข้อมูลในแบบฟอร์ม
- สร้างแอปสำหรับ Google Chat ด้วย Gemini Codelab: หากพร้อมสร้างแอป Chat ขั้นสูงขึ้นแล้ว ดูความคิดเห็น แอป Chat จาก Codelab