สร้างแอป Google Chat ที่รับส่งข้อความได้โดยตรงและโต้ตอบด้วยการสะท้อนข้อความ
แผนภาพต่อไปนี้จะแสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ
ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับแอปแชทของ Apps Script จะมีโฟลว์ข้อมูลดังต่อไปนี้
- ผู้ใช้ส่งข้อความไปยังแอปใน Chat ไม่ว่าจะเป็นข้อความส่วนตัวหรือในพื้นที่ใน Chat
- ตรรกะของแอป Chat ที่ใช้งานใน Apps Script ซึ่งอยู่ใน Google Cloud จะรับและประมวลผลข้อความ
- ตรรกะของแอป Chat อาจผสานรวมกับบริการของ Google Workspace เช่น ปฏิทินหรือชีต หรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube ได้
- ตรรกะของแอป Chat จะส่งการตอบกลับไปยังบริการแอป 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 คุณต้องเปลี่ยนประเภทผู้ใช้เป็นภายนอก จากนั้นจึงเพิ่มขอบเขตการให้สิทธิ์ที่แอปของคุณต้องการ
- ตรวจสอบสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากการลงทะเบียนแอปถูกต้องแล้ว ให้คลิกกลับไปที่หน้าแดชบอร์ด
ตั้งค่าสคริปต์
หากต้องการตั้งค่าสคริปต์ ให้ใช้เทมเพลตแล้วตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน 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 ให้คลิกทำให้ใช้งานได้ > ทดสอบการทำให้ใช้งานได้
- คัดลอกรหัสการทำให้ใช้งานได้ของส่วนหัวเพื่อใช้ในขั้นตอนถัดไป แล้วคลิกเสร็จสิ้น
เผยแพร่แอป Chat
เผยแพร่แอป Chat จากคอนโซล Google Cloud
- ใน Google Cloud Console ให้ค้นหา
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 ที่คุณให้ไว้เมื่อเพิ่มตัวคุณเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- ในช่องเพิ่มผู้คนอย่างน้อย 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