ส่วนนี้อธิบายวิธีที่แอป Google Chat โทรออก Chat API ซึ่งช่วยให้แอป Chat ทำสิ่งต่างๆ ได้ เช่น สร้างพื้นที่ทำงาน เพิ่มผู้คนไปยังพื้นที่ทำงาน และโพสต์ข้อความโดยไม่ได้รับการแจ้งจาก เหตุการณ์การโต้ตอบของแอป Chat
การตรวจสอบสิทธิ์
การเรียกใช้ Chat API แบบไม่พร้อมกันต้องมีการตรวจสอบสิทธิ์ ชิ้น เมธอด Chat API ต้องใช้วิธีใดวิธีหนึ่ง การตรวจสอบสิทธิ์ผู้ใช้ (เพื่อดำเนินการหรือเข้าถึง ข้อมูลในนามของผู้ใช้) หรือ การตรวจสอบสิทธิ์แอป (เพื่อดำเนินการต่างๆ หรือเข้าถึงข้อมูลในฐานะแอป Chat) ใช้บ้าง รองรับทั้งการตรวจสอบสิทธิ์ผู้ใช้และการตรวจสอบสิทธิ์แอป
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ใน Chat ได้ที่ ภาพรวมการตรวจสอบสิทธิ์
ทรัพยากรและเมธอดของ API
ทรัพยากรและวิธีการ REST จะให้สิทธิ์เข้าถึง Chat แบบไม่พร้อมกัน พื้นที่ทำงาน สมาชิกในพื้นที่ทำงาน ข้อความ รีแอ็กชันข้อความ และไฟล์แนบของข้อความ
- พื้นที่ทำงาน
พื้นที่ทำงานคือที่ที่ผู้คนและแอปสามารถสนทนาและแชร์ไฟล์ได้ มี คือพื้นที่ทำงานหลายประเภท ข้อความส่วนตัว (DM) คือการสนทนาแบบ 1:1 ระหว่างผู้ใช้ 2 คนหรือผู้ใช้ 1 คนกับแอป Chat กลุ่ม คือการสนทนาระหว่างผู้ใช้ 3 คนขึ้นไปและ แอปแชท พื้นที่ทำงานที่มีชื่อคือสถานที่ถาวรที่ผู้ใช้ส่ง ข้อความ แชร์ไฟล์ และทำงานร่วมกัน
แหล่งข้อมูล
spaces
รายการ หมายถึงการเว้นวรรคพื้นที่ทำงานรองรับเมธอดต่อไปนี้
- สร้างพื้นที่ทำงาน ที่ผู้คนและแอปสามารถสนทนาและแชร์ไฟล์ได้
- ตั้งค่าพื้นที่ทำงาน เพื่อสร้างพื้นที่ทำงาน รวมถึงเพิ่มบุคคลและแอป Chat ลงในพื้นที่ทำงานดังกล่าว พื้นที่ทำงาน
- เลือกพื้นที่ทำงาน เพื่อดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- ระบุพื้นที่ทำงาน เพื่อดูรายการพื้นที่ทำงานที่มีการแบ่งหน้าและสามารถกรองได้
- อัปเดตพื้นที่ทำงาน เพื่อเปลี่ยนแอตทริบิวต์เกี่ยวกับพื้นที่ทำงาน เช่น ชื่อที่แสดงที่ผู้ใช้มองเห็นได้ คำอธิบายและหลักเกณฑ์
- ลบพื้นที่ทำงาน เมื่อไม่จำเป็นต้องใช้แล้ว
- ค้นหาข้อความส่วนตัว (DM) เพื่อส่งคืน DM ระหว่างผู้ใช้ 2 คน หรือ DM ระหว่างผู้ใช้กับการโทร แอปแชท
- สมาชิก
สมาชิก คือผู้ใช้และแอป Chat ที่เข้าร่วมหรือ ได้รับเชิญไปยังพื้นที่ทำงาน
แหล่งข้อมูล
spaces.members
รายการ เป็นตัวแทนของสมาชิกสมาชิกจะรองรับวิธีการต่อไปนี้
- สร้างการเป็นสมาชิก เพื่อเพิ่มผู้ใช้หรือแอปในพื้นที่ทำงาน
- สมัครสมาชิก เพื่อดูรายละเอียดเกี่ยวกับการเป็นสมาชิก
- แสดงการเป็นสมาชิก เพื่อดูรายการการเป็นสมาชิกที่มีเลขหน้าและสามารถกรองได้ในพื้นที่ทำงาน
- อัปเดตการเป็นสมาชิก เปลี่ยนแอตทริบิวต์เกี่ยวกับการเป็นสมาชิก เช่น เปลี่ยนสมาชิกในพื้นที่ทำงานเป็น ผู้จัดการพื้นที่ทำงาน หรือเปลี่ยนผู้จัดการพื้นที่ทำงานเป็นสมาชิกพื้นที่ทำงาน
- ลบการเป็นสมาชิก ในการนำผู้ใช้หรือแอปออกจากพื้นที่ทำงาน
- ข้อความ
ข้อความประกอบด้วย ข้อความ และ การ์ด ที่โพสต์ในพื้นที่ทำงาน สามารถแนบไฟล์ไปกับข้อความได้ ผู้ใช้จะแสดงความรู้สึกต่อข้อความได้โดยการใส่อีโมจิต่อท้าย
แหล่งข้อมูล
spaces.messages
รายการ แสดงถึงข้อความข้อความรองรับวิธีการต่อไปนี้
- สร้างข้อความ เพื่อโพสต์ข้อความ หรือ ข้อความการ์ด นอกจากนี้คุณยัง เริ่มต้นหรือตอบกลับชุดข้อความ
- รับข้อความ เพื่อดูรายละเอียดเกี่ยวกับข้อความ เช่น เวลาที่ส่งหรือสิ่งที่เขียน
- แสดงข้อความ เพื่อดูรายการข้อความที่ใส่เลขหน้าที่กรองได้ในพื้นที่ทำงาน
- อัปเดตข้อความ เพื่อเปลี่ยนแอตทริบิวต์ของข้อความ เช่น ข้อมูลที่บอก คุณยังเพิ่มข้อความต่อท้ายได้ด้วย เป็น ข้อความในการ์ด หรือการ์ดไปยัง ข้อความ
- ลบข้อความ เมื่อไม่จำเป็นต้องใช้แล้ว
- รีแอ็กชัน
รีแอ็กชันจะแสดงอีโมจิที่ผู้คนใช้แสดงความรู้สึกต่อข้อความ เช่น 👍, 🚲 และ 🌞
แหล่งข้อมูล
spaces.messages.reactions
รายการ แสดงถึงรีแอ็กชันการแสดงความรู้สึกรองรับวิธีการต่อไปนี้
- สร้างรีแอ็กชัน เพื่อเพิ่มอีโมจิในข้อความ
- แสดงรีแอ็กชัน เพื่อดูรายการรีแอ็กชันที่ใส่เลขหน้าและสามารถกรองข้อความได้
- ลบรีแอ็กชัน เพื่อนำอีโมจิออกจากข้อความ
- สื่อและไฟล์แนบ
สื่อหมายถึงไฟล์ที่อัปโหลดไปยัง Google Chat เช่น รูปภาพ วิดีโอ และ เอกสาร
แหล่งข้อมูล
media
รายการ หมายถึงสื่อที่แนบมากับข้อความไฟล์แนบเป็นสื่อ (ไฟล์) ที่แนบมากับข้อความ
แหล่งข้อมูล
spaces.messages.attachments
รายการ หมายถึงไฟล์แนบ ไฟล์แนบประกอบด้วยสื่อและเนื้อหาที่เกี่ยวข้อง ข้อมูลเมตาที่แนบไปกับข้อความสื่อและไฟล์แนบรองรับวิธีการต่อไปนี้
- อัปโหลดสื่อเป็นไฟล์แนบ เพื่ออัปโหลดสื่อไปยัง Google Chat แล้วแนบไปกับข้อความ
- ดาวน์โหลดสื่อเป็นไฟล์แนบ เพื่อดาวน์โหลดสื่อจาก Google Chat เป็นไฟล์ไบนารี
- รับไฟล์แนบ เพื่อเรียกข้อมูลเมตาเกี่ยวกับไฟล์แนบของข้อความ
- กิจกรรมใน Space
เหตุการณ์ในพื้นที่ทำงานแสดงถึงการเปลี่ยนแปลงของพื้นที่ทำงานหรือพื้นที่ทำงาน ทรัพยากรย่อย รวมถึงสมาชิก ข้อความ และรีแอ็กชัน
แหล่งข้อมูลของ
spaces.spaceEvent
แสดงถึงกิจกรรมในพื้นที่ทำงานกิจกรรมในพื้นที่ทำงานรองรับวิธีการต่อไปนี้
- จัดกิจกรรมเกี่ยวกับพื้นที่ทำงาน เพื่อแสดงรายละเอียดเกี่ยวกับเหตุการณ์ที่เกิดขึ้นในพื้นที่ทำงาน
- ระบุเหตุการณ์ในพื้นที่ทำงาน เพื่อดูรายการเหตุการณ์ที่เกิดขึ้นในพื้นที่ทำงาน
- สถานะการอ่านของผู้ใช้
สถานะการอ่านของผู้ใช้คือทรัพยากรแบบ Singleton ที่แสดงรายละเอียดเกี่ยวกับ ข้อความที่อ่านล่าสุดของผู้ใช้ในพื้นที่ใน Google Chat หรือข้อความ ชุดข้อความ
แหล่งข้อมูลของ
users.spaces
แสดงสถานะการอ่านของผู้ใช้ในพื้นที่ทำงานแหล่งข้อมูลของ
users.spaces.threads
แสดงสถานะการอ่านของผู้ใช้ในชุดข้อความสถานะการอ่านของผู้ใช้รองรับเมธอดต่อไปนี้
- รับสถานะการอ่านพื้นที่ทำงาน เพื่อแสดงรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในพื้นที่ทำงาน
- อัปเดตสถานะการอ่านพื้นที่ทำงาน เพื่ออัปเดตสถานะการอ่านของผู้ใช้ภายในพื้นที่ทำงาน
- รับสถานะการอ่านชุดข้อความ เพื่อแสดงรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในชุดข้อความ