พัฒนาด้วย Google Chat

หน้านี้แสดงภาพรวมของ 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):

ไฟล์แนบคืออินสแตนซ์ของสื่อ (ไฟล์) ที่แนบกับข้อความ

การอ้างอิงแหล่งข้อมูล

ดูตัวอย่างการใช้งานได้ที่

กิจกรรมใน Space

กิจกรรมในพื้นที่ทำงานแสดงถึงการเปลี่ยนแปลงในพื้นที่ทำงานหรือทรัพยากรย่อย ซึ่งรวมถึงสมาชิก ข้อความ และรีแอ็กชัน

การอ้างอิงแหล่งข้อมูล

ดูตัวอย่างการใช้งานได้ที่

สถานะการอ่านของผู้ใช้

สถานะการอ่านของผู้ใช้คือทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับข้อความล่าสุดที่ผู้ใช้ที่ระบุอ่านในพื้นที่ใน Chat ของ Google Chat หรือชุดข้อความ

การอ้างอิงทรัพยากรสถานะการอ่านของพื้นที่ทำงาน

การอ้างอิงทรัพยากรสถานะการอ่านเธรด

ดูตัวอย่างการใช้งานได้ที่

การตั้งค่าการแจ้งเตือนในพื้นที่ของผู้ใช้

การตั้งค่าการแจ้งเตือนของพื้นที่ทำงานของผู้ใช้เป็นทรัพยากรแบบ Singleton ที่แสดงถึงการตั้งค่าการแจ้งเตือนของผู้ใช้ที่ระบุในพื้นที่ใน 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 เพื่อทำสิ่งต่อไปนี้ได้

  • ดึงข้อมูลตามการค้นหาข้อความที่มีโครงสร้างหรือข้อความอิสระที่ผู้ใช้ป้อน
  • สร้างรายงานเหตุการณ์หรืออาร์ติแฟกต์อื่นๆ โดยใช้ข้อมูลที่ผู้ใช้ให้ไว้
  • ปรับปรุงการทำงานร่วมกันของทีม เช่น การจัด "หน่วยความจำของทีม" หรือการจัดตารางเวลา ทรัพยากร

คุณออกแบบแอปแชทได้โดยใช้รูปแบบสถาปัตยกรรมที่หลากหลาย ซึ่งรวมถึงรูปแบบต่อไปนี้

  • แอปแบบอินเทอร์แอกทีฟ: ตอบสนองต่อการโต้ตอบของผู้ใช้ เช่น การกล่าวถึงด้วย @หรือคำสั่งเครื่องหมายทับ และแสดงข้อมูลหรือแนะนำผู้ใช้ผ่านเวิร์กโฟลว์ด้วย การ์ดและกล่องโต้ตอบ
  • แอปบรรทัดคำสั่งหรือเว็บฮุก: ส่งข้อความเชิงรุก เช่น การปลุก หรือการแจ้งเตือน จากระบบอื่นไปยังพื้นที่ทำงาน ผู้ใช้จะโต้ตอบกับแอปประเภทนี้โดยตรงไม่ได้
  • แอปที่ขับเคลื่อนด้วยเหตุการณ์: ติดตามและตอบสนองต่อกิจกรรมในพื้นที่ใน Chat เช่น มีสมาชิกใหม่เข้าร่วม เมื่อเกิดเหตุการณ์ แอปจะส่งข้อความหรือดำเนินการอื่นได้

โปรดดูรายละเอียดเกี่ยวกับการออกแบบแอป Chat ที่หัวข้อ เลือกสถาปัตยกรรมแอป Google Chat

หากต้องการดูการทำงานของ Google Chat API
ช่องนักพัฒนาแอป Google Workspace มีวิดีโอเกี่ยวกับเคล็ดลับ กลเม็ด และฟีเจอร์ล่าสุด