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