หน้านี้แสดงภาพรวมของ Google Chat API และแอป Google Chat
ภาพรวม Google Chat API
Chat API ประกอบด้วย บริการ gRPC หรือทรัพยากรและเมธอด REST ที่ให้สิทธิ์เข้าถึง Chat ซึ่งรวมถึงพื้นที่ทำงาน สมาชิกในพื้นที่ทำงาน ข้อความ รีแอ็กชันต่อข้อความ ไฟล์แนบของข้อความ เหตุการณ์ในพื้นที่ทำงาน และสถานะการอ่านของผู้ใช้
แนวคิด
ส่วนต่อไปนี้จะกำหนดบริการ ทรัพยากร และเมธอดสำหรับ Chat API
- พื้นที่ทำงาน
พื้นที่ทำงานเป็นพื้นที่ที่ผู้คนและแอปสามารถสนทนาและแชร์ไฟล์ได้ พื้นที่ทำงานมีหลายประเภท ข้อความส่วนตัว (DM) คือการสนทนาแบบ 1:1 ระหว่างผู้ใช้ 2 คนหรือผู้ใช้กับแอป Chat ส่วนแชทกลุ่ม คือการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปกับ แอป Chat พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ถาวรที่ผู้ใช้ส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้
การอ้างอิงแหล่งข้อมูล:
ดูตัวอย่างการใช้งานได้ที่
- สมาชิก
สมาชิกคือผู้ใช้และแอป Chat ที่เข้าร่วมหรือได้รับเชิญให้เข้าร่วมพื้นที่ทำงาน
การอ้างอิงแหล่งข้อมูล:
ดูตัวอย่างการใช้งานได้ที่
- ข้อความ
ข้อความประกอบด้วย ข้อความ และ การ์ด การสื่อสารที่โพสต์ในพื้นที่ทำงาน ข้อความสามารถมีไฟล์แนบได้ ผู้ใช้สามารถรีแอ็กต่อข้อความได้โดยการเพิ่มอีโมจิลงในข้อความ
การอ้างอิงแหล่งข้อมูล:
ดูตัวอย่างการใช้งานได้ที่
- รีแอ็กชัน
รีแอ็กชันแสดงถึงอีโมจิที่ผู้คนใช้เพื่อรีแอ็กกับข้อความ เช่น 👍, 🚲 และ 🌞
การอ้างอิงแหล่งข้อมูล
ดูตัวอย่างการใช้งานได้ที่
- อีโมจิที่กำหนดเอง
อีโมจิที่กำหนดเองแสดงถึงอีโมจิที่กำหนดเองซึ่งสร้างและแชร์ภายใน องค์กรใน Google Chat คุณสามารถใส่อีโมจิที่กำหนดเองในเนื้อหาของ ข้อความหรือใช้เพื่อรีแอ็กชันต่อข้อความได้
การอ้างอิงแหล่งข้อมูล
- สื่อและไฟล์แนบ
สื่อหมายถึงไฟล์ที่อัปโหลดไปยัง Google Chat เช่น รูปภาพ วิดีโอ และ เอกสาร
การอ้างอิงแหล่งข้อมูลสื่อ (ไม่พร้อมใช้งานใน RPC)
ไฟล์แนบคืออินสแตนซ์ของสื่อ (ไฟล์) ที่แนบกับข้อความ
การอ้างอิงแหล่งข้อมูล:
ดูตัวอย่างการใช้งานได้ที่
- กิจกรรมใน Space
กิจกรรมในพื้นที่ทำงานแสดงถึงการเปลี่ยนแปลงในพื้นที่ทำงานหรือทรัพยากรย่อย ซึ่งรวมถึงสมาชิก ข้อความ และรีแอ็กชัน
การอ้างอิงแหล่งข้อมูล
ดูตัวอย่างการใช้งานได้ที่
- สถานะการอ่านของผู้ใช้
สถานะการอ่านของผู้ใช้คือทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับข้อความที่ผู้ใช้ที่ระบุอ่านล่าสุดในพื้นที่ทำงานของ Google Chat หรือเธรดข้อความ
ข้อมูลอ้างอิงทรัพยากรสถานะการอ่านของพื้นที่ทำงาน
การอ้างอิงทรัพยากรสถานะการอ่านของเธรด
ดูตัวอย่างการใช้งานได้ที่
- การตั้งค่าการแจ้งเตือนในพื้นที่ทำงานของผู้ใช้
การตั้งค่าการแจ้งเตือนพื้นที่ทำงานของผู้ใช้เป็นทรัพยากรแบบ Singleton ที่แสดงถึงการตั้งค่าการแจ้งเตือนของผู้ใช้ที่ระบุในพื้นที่ทำงาน Google Chat
การอ้างอิงแหล่งข้อมูล:
การตรวจสอบสิทธิ์
การเรียกใช้ Chat API ต้องมีการตรวจสอบสิทธิ์ เมธอด Chat API แต่ละรายการต้องมีการตรวจสอบสิทธิ์ผู้ใช้ (เพื่อดำเนินการหรือเข้าถึงข้อมูลในนามของผู้ใช้) หรือการตรวจสอบสิทธิ์แอป (เพื่อดำเนินการหรือเข้าถึงข้อมูลในฐานะแอป Chat) บางวิธีรองรับทั้งการตรวจสอบสิทธิ์ผู้ใช้และการตรวจสอบสิทธิ์แอป
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ใน Chat ได้ที่ภาพรวมการตรวจสอบสิทธิ์
ไลบรารีของไคลเอ็นต์
วิธีที่แนะนำสำหรับนักพัฒนาซอฟต์แวร์ส่วนใหญ่ในการเรียกใช้ Google Chat API คือการใช้ ไลบรารีของไคลเอ็นต์ Cloud ที่เรารองรับอย่างเป็นทางการสำหรับภาษาที่คุณต้องการ เช่น Python, Java หรือ Node.js
หากคุณเขียนโค้ดด้วย Google Apps Script ให้ใช้ บริการ Chat ขั้นสูง แทนการติดตั้งไลบรารีของไคลเอ็นต์
สร้างแอปใน Chat
Chat API ช่วยให้คุณสร้างแอป Google Chat ที่นำบริการและทรัพยากรของคุณมาไว้ใน Google Chat ได้โดยตรง คุณสร้างแอป Chat เพื่อทำสิ่งต่อไปนี้ได้
- ดึงข้อมูลตามการค้นหาข้อความที่มีโครงสร้างหรือข้อความอิสระที่ผู้ใช้ป้อน
- สร้างรายงานเหตุการณ์หรืออาร์ติแฟกต์อื่นๆ โดยใช้ข้อมูลที่ผู้ใช้ให้ไว้
- เพิ่มประสิทธิภาพการทำงานร่วมกันในทีม เช่น การจัด "หน่วยความจำของทีม" หรือการจัดตารางเวลา ทรัพยากร
คุณออกแบบแอปแชทได้โดยใช้รูปแบบสถาปัตยกรรมที่หลากหลาย ซึ่งรวมถึงรูปแบบต่อไปนี้
- แอปแบบอินเทอร์แอกทีฟ: ตอบสนองต่อการโต้ตอบของผู้ใช้ เช่น การกล่าวถึงด้วย @หรือคำสั่งเครื่องหมายทับ และแสดงข้อมูลหรือแนะนำผู้ใช้ผ่านเวิร์กโฟลว์ด้วย การ์ดและกล่องโต้ตอบ
- แอปบรรทัดคำสั่งหรือ Webhook: ส่งข้อความเชิงรุก เช่น การปลุก หรือการแจ้งเตือน จากระบบอื่นไปยังพื้นที่ทำงาน ผู้ใช้จะโต้ตอบกับแอปประเภทนี้โดยตรงไม่ได้
- แอปที่ขับเคลื่อนด้วยเหตุการณ์: ติดตามและตอบสนองต่อกิจกรรมในพื้นที่ทำงานของ Chat เช่น มีสมาชิกใหม่เข้าร่วม เมื่อมีการตอบสนองต่อ เหตุการณ์ แอปจะส่งข้อความหรือดำเนินการอื่นได้
โปรดดูรายละเอียดเกี่ยวกับการออกแบบแอป Chat ที่หัวข้อ เลือกสถาปัตยกรรมแอป Google Chat
หัวข้อที่เกี่ยวข้อง
หากต้องการดูการทำงานของ Google Chat API
ช่องนักพัฒนาแอป Google Workspace มีวิดีโอเกี่ยวกับเคล็ดลับ
กลเม็ด และฟีเจอร์ล่าสุด
|