หน้านี้ให้ภาพรวมของ 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 โดยมีส่วนของระบบที่กำหนดไว้ล่วงหน้าและส่วนที่กำหนดเองซึ่งผู้ใช้กำหนด
ข้อมูลอ้างอิงทรัพยากร
ตัวอย่างการใช้งาน
- สื่อและไฟล์แนบ
สื่อ แสดงถึงไฟล์ที่อัปโหลดไปยัง Google Chat เช่น รูปภาพ วิดีโอ และเอกสาร
ข้อมูลอ้างอิงทรัพยากรสื่อ (ไม่พร้อมใช้งานใน RPC)
ไฟล์แนบ คืออินสแตนซ์ของสื่อ (ไฟล์) ที่แนบกับข้อความ
ข้อมูลอ้างอิงทรัพยากร
ตัวอย่างการใช้งาน
- เหตุการณ์ในพื้นที่ทำงาน
เหตุการณ์ในพื้นที่ทำงาน แสดงถึงการเปลี่ยนแปลงในพื้นที่ทำงานหรือทรัพยากรย่อย ซึ่งรวมถึงสมาชิก ข้อความ และรีแอ็กชัน
ข้อมูลอ้างอิงทรัพยากร
ตัวอย่างการใช้งาน
- สถานะการอ่านของผู้ใช้
สถานะการอ่านของผู้ใช้ คือทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับข้อความที่อ่านล่าสุดของผู้ใช้ที่ระบุในพื้นที่ใน Chat ของ Google Chat หรือชุดข้อความ
ข้อมูลอ้างอิงทรัพยากรสถานะการอ่านพื้นที่ทำงาน
ข้อมูลอ้างอิงทรัพยากรสถานะการอ่านชุดข้อความ
ตัวอย่างการใช้งาน
- การตั้งค่าการแจ้งเตือนพื้นที่ทำงานของผู้ใช้
การตั้งค่าการแจ้งเตือนพื้นที่ใน Chat ของผู้ใช้ คือทรัพยากรแบบ Singleton ที่แสดงการตั้งค่าการแจ้งเตือนของผู้ใช้ที่ระบุในพื้นที่ใน Chat ของ Google Chat
ข้อมูลอ้างอิงทรัพยากร
การตรวจสอบสิทธิ์
การเรียกใช้ Chat API ต้องมีการตรวจสอบสิทธิ์ เมธอด Chat API แต่ละเมธอดต้องมีการตรวจสอบสิทธิ์ของผู้ใช้ (เพื่อดำเนินการหรือเข้าถึง ข้อมูลในนามของผู้ใช้) หรือ การตรวจสอบสิทธิ์ของแอป (เพื่อดำเนินการหรือเข้าถึงข้อมูลในฐานะแอป Chat) บางเมธอดรองรับทั้งการตรวจสอบสิทธิ์ของผู้ใช้และการตรวจสอบสิทธิ์ของแอป
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ใน Chat ได้ที่ ภาพรวมการตรวจสอบสิทธิ์
ไลบรารีของไคลเอ็นต์
วิธีที่แนะนำสำหรับนักพัฒนาซอฟต์แวร์ส่วนใหญ่ในการเรียกใช้ Google Chat API คือการใช้ Cloud Client Libraries ที่รองรับอย่างเป็นทางการสำหรับภาษาที่คุณต้องการ เช่น Python, Java หรือ Node.js
หากคุณเขียนโค้ดด้วย Google Apps Script ให้ใช้ บริการ Chat ขั้นสูง แทนการติดตั้งไลบรารีของไคลเอ็นต์
สร้างแอปใน Chat
Chat API ช่วยให้คุณสร้างแอป Google Chat ที่นำบริการและทรัพยากรของคุณมาไว้ใน Google Chat ได้โดยตรง คุณสามารถสร้างแอปใน Chat เพื่อทำสิ่งต่อไปนี้ได้
- ดึงข้อมูลตามการค้นหาข้อความที่มีโครงสร้างหรือข้อความอิสระที่ผู้ใช้ป้อน
- สร้างรายงานเหตุการณ์หรืออาร์ติแฟกต์อื่นๆ โดยใช้ข้อมูลที่ผู้ใช้ให้
- ปรับปรุงการทำงานร่วมกันของทีม เช่น การจัดหา "หน่วยความจำของทีม" หรือการจัดกำหนดการทรัพยากร
คุณสามารถออกแบบแอปใน Chat ได้โดยใช้สถาปัตยกรรมหลายรูปแบบ ซึ่งรวมถึงรูปแบบต่อไปนี้
- แอปแบบโต้ตอบ: ตอบสนองต่อการโต้ตอบของผู้ใช้ เช่น @การพูดถึงหรือคำสั่ง Slash และนำเสนอข้อมูลหรือแนะนำผู้ใช้ตลอดเวิร์กโฟลว์ด้วย การ์ดและกล่องโต้ตอบ
- แอปบรรทัดคำสั่งหรือเว็บฮุค: ส่งข้อความเชิงรุก เช่น การปลุก หรือการแจ้งเตือน จากระบบอื่นไปยังพื้นที่ทำงาน ผู้ใช้ไม่สามารถโต้ตอบกับแอปประเภทนี้ได้โดยตรง
- แอปที่ขับเคลื่อนด้วยเหตุการณ์: สมัครรับข้อมูลและตอบสนองต่อกิจกรรมในพื้นที่ใน Chat เช่น สมาชิกใหม่เข้าร่วม แอปสามารถส่งข้อความหรือดำเนินการอื่นๆ เพื่อตอบสนองต่อเหตุการณ์ได้
ดูรายละเอียดเกี่ยวกับการออกแบบแอปใน Chat ได้ที่ เลือกสถาปัตยกรรมแอป Google Chat
หัวข้อที่เกี่ยวข้อง
 |
ต้องการดูการทำงานของ Google Chat API ไหม
ช่องนักพัฒนาซอฟต์แวร์ Google Workspace มีวิดีโอเกี่ยวกับเคล็ดลับ
เทคนิค และฟีเจอร์ล่าสุด
|