พัฒนาด้วย Google Chat

หน้านี้แสดงภาพรวมของ Google Chat API และแอป Google Chat

ภาพรวม Google Chat API

Chat API ประกอบด้วย บริการ gRPC หรือทรัพยากรและเมธอด REST ที่ให้สิทธิ์เข้าถึง Chat ซึ่งรวมถึงพื้นที่ทำงาน สมาชิกในพื้นที่ทำงาน ข้อความ รีแอ็กชันต่อข้อความ ไฟล์แนบของข้อความ เหตุการณ์ในพื้นที่ทำงาน และสถานะการอ่านของผู้ใช้

แนวคิด

ส่วนต่อไปนี้จะกำหนดบริการ ทรัพยากร และเมธอดสำหรับ Chat API

พื้นที่ทำงาน

พื้นที่ทำงานเป็นพื้นที่ที่ผู้คนและแอปสามารถสนทนาและแชร์ไฟล์ได้ พื้นที่ทำงานมีหลายประเภท ข้อความส่วนตัว (DM) คือการสนทนาแบบ 1:1 ระหว่างผู้ใช้ 2 คนหรือผู้ใช้กับแอป Chat ส่วนแชทกลุ่ม คือการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปกับ แอป Chat พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ถาวรที่ผู้ใช้ส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• สร้างพื้นที่ทำงาน
• ตั้งค่าพื้นที่ทำงาน
• รับพื้นที่
• แสดงพื้นที่ทำงาน
• อัปเดตพื้นที่ทำงาน
• ลบพื้นที่ทำงาน
• ค้นหาข้อความส่วนตัว (DM)

สมาชิก

สมาชิกคือผู้ใช้และแอป Chat ที่เข้าร่วมหรือได้รับเชิญให้เข้าร่วมพื้นที่ทำงาน

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• สร้างการเป็นสมาชิก
• สมัครเป็นสมาชิก
• แสดงรายการการเป็นสมาชิก
• อัปเดตการเป็นสมาชิก
• ลบการเป็นสมาชิก

ข้อความ

ข้อความประกอบด้วย ข้อความ และ การ์ด การสื่อสารที่โพสต์ในพื้นที่ทำงาน ข้อความสามารถมีไฟล์แนบได้ ผู้ใช้สามารถรีแอ็กต่อข้อความได้โดยการเพิ่มอีโมจิลงในข้อความ

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• สร้างข้อความ
• รับข้อความ
• แสดงข้อความ
• อัปเดตข้อความ
• ลบข้อความ

รีแอ็กชัน

รีแอ็กชันแสดงถึงอีโมจิที่ผู้คนใช้เพื่อรีแอ็กกับข้อความ เช่น 👍, 🚲 และ 🌞

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• สร้างรีแอ็กชัน
• รีแอ็กชันของรายการ
• ลบรีแอ็กชัน

อีโมจิที่กำหนดเอง

อีโมจิที่กำหนดเองแสดงถึงอีโมจิที่กำหนดเองซึ่งสร้างและแชร์ภายใน องค์กรใน Google Chat คุณสามารถใส่อีโมจิที่กำหนดเองในเนื้อหาของ ข้อความหรือใช้เพื่อรีแอ็กชันต่อข้อความได้

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

สื่อและไฟล์แนบ

สื่อหมายถึงไฟล์ที่อัปโหลดไปยัง Google Chat เช่น รูปภาพ วิดีโอ และ เอกสาร

การอ้างอิงแหล่งข้อมูลสื่อ (ไม่พร้อมใช้งานใน RPC)

• ข้อมูลอ้างอิง REST

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

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• อัปโหลดสื่อเป็นไฟล์แนบ
• ดาวน์โหลดสื่อเป็นไฟล์แนบ
• รับไฟล์แนบ

กิจกรรมใน Space

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

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• รับสถานะการอ่านของพื้นที่ทำงาน
• อัปเดตสถานะการอ่านของพื้นที่ทำงาน
• รับสถานะการอ่านชุดข้อความ

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

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

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

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

• รับสถานะการอ่านของพื้นที่ทำงาน
• อัปเดตสถานะการอ่านของพื้นที่ทำงาน
• รับสถานะการอ่านชุดข้อความ

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

การตั้งค่าการแจ้งเตือนพื้นที่ทำงานของผู้ใช้เป็นทรัพยากรแบบ Singleton ที่แสดงถึงการตั้งค่าการแจ้งเตือนของผู้ใช้ที่ระบุในพื้นที่ทำงาน Google Chat

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

• เอกสารอ้างอิง RPC
• ข้อมูลอ้างอิง REST

การตรวจสอบสิทธิ์

การเรียกใช้ 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
• สร้างแอป Google Chat แบบอินเทอร์แอกทีฟ
• เลือกสถาปัตยกรรมแอป Google Chat

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