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