หน้านี้จะอธิบายวิธีสร้างแอปใน Chat แบบ HTTP คุณใช้สถาปัตยกรรมนี้ได้หลายวิธี ใน Google Cloud คุณ สามารถใช้ Cloud Functions, Cloud Run และ App Engine ได้ ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะ เขียนและทำให้ Cloud Function ที่แอป Chat ใช้ตอบข้อความของผู้ใช้
เมื่อใช้สถาปัตยกรรมนี้ คุณจะกำหนดค่า Chat เพื่อผสานรวมกับ Google Cloud หรือเซิร์ฟเวอร์ภายในองค์กรโดยใช้ HTTP ดังที่แสดงใน แผนภาพต่อไปนี้
ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับ HTTP แอป Chat มีขั้นตอนข้อมูลต่อไปนี้
- ผู้ใช้ส่งข้อความใน Chat ไปยัง แอปแชท ทั้งในข้อความส่วนตัวหรือใน พื้นที่ใน Chat
- คำขอ HTTP ถูกส่งไปยังเว็บเซิร์ฟเวอร์ที่เป็นระบบคลาวด์หรือ ระบบภายในองค์กรที่มีแอป Chat
- (ไม่บังคับ) ตรรกะของแอป Chat จะผสานรวมกับ บริการของ Google Workspace (เช่น ปฏิทินและ ชีต) บริการอื่นๆ ของ Google (เช่น Maps, YouTube และ Vertex AI) หรือบริการบนเว็บอื่นๆ (เช่น โปรเจ็กต์) ) หรือเครื่องมือจำหน่ายตั๋ว)
- เว็บเซิร์ฟเวอร์จะส่งการตอบกลับ HTTP กลับไปยัง บริการแอปใน Chat ใน Chat
- ระบบจะส่งคำตอบให้กับผู้ใช้
- (ไม่บังคับ) แอป Chat สามารถเรียกใช้ Chat API เพื่อโพสต์ข้อความแบบไม่พร้อมกันหรือดำเนินการอื่นๆ
สถาปัตยกรรมนี้ให้ความยืดหยุ่นในการใช้ไลบรารีที่มีอยู่และ ที่มีอยู่ในระบบของคุณอยู่แล้วเนื่องจาก คุณออกแบบแอปแชทโดยใช้ภาษาโปรแกรมที่แตกต่างกันได้
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างและทำให้ Cloud Function ใช้งานได้
- เผยแพร่แอปไปยัง Chat
- ทดสอบแอป
ข้อกำหนดเบื้องต้น
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- โปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน หากต้องการตรวจสอบว่าโปรเจ็กต์ที่มีอยู่เปิดใช้การเรียกเก็บเงินหรือไม่ ดูตรวจสอบ สถานะการเรียกเก็บเงินของโปรเจ็กต์ หากต้องการสร้างโปรเจ็กต์และตั้งค่าการเรียกเก็บเงิน โปรดดู สร้างโปรเจ็กต์ Google Cloud
ตั้งค่าสภาพแวดล้อม
ก่อนใช้ Google APIs คุณต้องเปิดใช้ API เหล่านี้ในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API ได้ตั้งแต่ 1 รายการขึ้นไปในโปรเจ็กต์ Google Cloud เดียวในคอนโซล Google Cloud ให้เปิดใช้ Google Chat API, Cloud Build API, Cloud Functions API Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API และ Cloud Run API
สร้างและทำให้ Cloud Function ใช้งานได้
สร้างและติดตั้งใช้งาน Cloud Function ที่สร้างการ์ด Chat ด้วยชื่อที่แสดงและรูปโปรไฟล์ของผู้ส่ง เมื่อ แอปแชทจะได้รับข้อความ ซึ่งจะเรียกใช้ฟังก์ชันนั้น และ ตอบกลับด้วยการ์ด
หากต้องการสร้างและทำให้ฟังก์ชันใช้งานได้สำหรับแอป Chat ทำตามขั้นตอนต่อไปนี้
Node.js
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าโปรเจ็กต์สำหรับแอป Chat ของคุณ ไว้
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ใน Runtime ให้เลือก Node.js เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
avatarApp
แทนที่เนื้อหาของ
index.js
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
Python
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าโปรเจ็กต์สำหรับแอป Chat ของคุณ ไว้
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ในรันไทม์ ให้เลือก Python เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
avatar_app
แทนที่เนื้อหาของ
main.py
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
Java
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าโปรเจ็กต์สำหรับแอป Chat ของคุณ ไว้
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ใน Runtime ให้เลือก Java เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
App
เปลี่ยนชื่อ
src/main/java/com/example/Example.java
เป็นsrc/main/java/App.java
แทนที่เนื้อหาของ
App.java
ด้วยรหัสต่อไปนี้แทนที่เนื้อหาของ
pom.xml
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
หน้ารายละเอียดฟังก์ชันระบบคลาวด์จะเปิดขึ้น และฟังก์ชันจะปรากฏขึ้นโดยมี สัญญาณบอกสถานะความคืบหน้า: สัญญาณหนึ่งสําหรับบิลด์และอีกอันสําหรับบริการ เมื่อทั้ง 2 กรณี สัญญาณบอกสถานะความคืบหน้าจะหายไปและแทนที่ด้วยเครื่องหมายถูก ซึ่งเป็นฟังก์ชัน และพร้อมใช้งาน
ให้สิทธิ์ Google Chat เพื่อเรียกใช้ฟังก์ชัน
หากต้องการให้สิทธิ์ Google Chat เรียกใช้ฟังก์ชัน ให้เพิ่ม Google Chat บัญชีบริการที่มีบทบาทผู้เรียกใช้ Cloud Run
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Run แล้วดำเนินการดังนี้
ในรายการบริการ Cloud Run ให้เลือกช่องทำเครื่องหมายข้างกล่องรับ (อย่าคลิกที่ฟังก์ชัน)
คลิกสิทธิ์ แผงสิทธิ์จะเปิดขึ้น
คลิกเพิ่มผู้ใช้หลัก
ในผู้ใช้หลักใหม่ ให้ป้อน
chat@system.gserviceaccount.com
ในส่วนเลือกบทบาท ให้เลือก Cloud Run > ผู้เรียกใช้ Cloud Run
คลิกบันทึก
เผยแพร่แอปไปยัง Google Chat
หลังจากทำให้ Cloud Function ใช้งานได้แล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อเปลี่ยนให้เป็น แอป Google Chat:
ในคอนโซล Google Cloud ให้คลิกเมนู > Cloud Functions
ตรวจสอบว่าโปรเจ็กต์ที่คุณเปิดใช้ Cloud Functions ไว้ ไว้
คลิก QuickStartChatApp ในรายการฟังก์ชัน
คลิกแท็บทริกเกอร์
คัดลอก URL ในส่วน HTTPS
ค้นหา "Google Chat API" แล้วคลิก Google Chat API จากนั้นคลิกจัดการ
คลิกการกำหนดค่าและตั้งค่าแอป Google Chat ดังนี้
- ป้อน
Quickstart App
ในชื่อแอป - ใน URL รูปโปรไฟล์ ให้ป้อน
https://developers.google.com/chat/images/quickstart-app-avatar.png
- ในคำอธิบาย ให้ป้อน
Quickstart app
- ในส่วนฟังก์ชัน ให้เลือกรับข้อความแบบ 1:1 และ เข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
- ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือก URL ของแอป แล้ววาง URL สำหรับ ทริกเกอร์ Cloud Function ในช่อง
- เลือก URL ของแอปในกลุ่มเป้าหมายการตรวจสอบสิทธิ์
- ในส่วนระดับการเข้าถึง ให้เลือก ทำให้แอป Google Chat นี้ใช้งานได้เฉพาะบางคนและ กลุ่มในโดเมนและป้อนอีเมล
- เลือกบันทึกข้อผิดพลาดในการบันทึกในส่วนบันทึก
- ป้อน
คลิกบันทึก
แอป Chat พร้อมที่จะรับและตอบกลับ ข้อความใน Chat
ทดสอบแอปใน Chat
หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ข้อความส่วนตัวด้วย แล้วส่งข้อความในแอป Chat
เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณ ที่ให้ไว้เมื่อคุณเพิ่มตัวเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- ในช่องเพิ่มผู้คนอย่างน้อย 1 คน ให้พิมพ์ชื่อ แอป Chat
เลือกแอปใน Chat จากผลการค้นหา โดยตรง ข้อความจะเปิดขึ้น
- ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์
Hello
แล้วกดenter
การตอบกลับของแอป Chat จะมี ข้อความของการ์ดที่แสดง ชื่อและรูปโปรไฟล์ของผู้ส่งดังที่แสดงในรูปภาพต่อไปนี้
หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดู ทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับ แอป Google Chat
แก้ปัญหา
เมื่อแอป Google Chat หรือ card จะแสดงผลข้อผิดพลาด อินเทอร์เฟซ Chat แสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณ" บางครั้ง UI ของ Chat ไม่แสดงข้อความแสดงข้อผิดพลาดใดๆ แต่แอป Chat หรือ ทำให้เกิดผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจ ปรากฏขึ้น
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของแชท มีข้อความแสดงข้อผิดพลาดและข้อมูลบันทึกที่สื่อความหมายเพื่อช่วยคุณแก้ไขข้อผิดพลาด เมื่อมีการเปิดข้อผิดพลาดในการบันทึกสำหรับแอป Chat หากต้องการความช่วยเหลือในการดู การแก้ไขข้อบกพร่องและการแก้ไขข้อผิดพลาด โปรดดู แก้ปัญหาข้อผิดพลาดของ Google Chat
ล้างข้อมูล
เพื่อเลี่ยงไม่ให้เกิดการเรียกเก็บเงินกับบัญชี Google Cloud ของคุณตาม ซึ่งใช้ในบทแนะนำนี้ เราขอแนะนำให้คุณลบ โปรเจ็กต์ที่อยู่ในระบบคลาวด์
- ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และ ผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเครื่องเพื่อลบ ให้กับโครงการ
หัวข้อที่เกี่ยวข้อง
หากต้องการเพิ่มฟีเจอร์เพิ่มเติมในแอป Chat โปรดดูที่ ดังต่อไปนี้: