- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงรายการกิจกรรมจากพื้นที่ใน Google Chat payloadของแต่ละเหตุการณ์จะมีทรัพยากร Chat เวอร์ชันล่าสุด ตัวอย่างเช่น หากคุณแสดงกิจกรรมเกี่ยวกับสมาชิกใหม่ของพื้นที่ทำงาน เซิร์ฟเวอร์จะแสดงผลทรัพยากร Membership
ที่มีรายละเอียดการเป็นสมาชิกล่าสุด หากสมาชิกใหม่ถูกนำออกในช่วงเวลาที่ขอ เพย์โหลดของเหตุการณ์จะมีทรัพยากร Membership
ที่ว่างเปล่า
ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ หากต้องการแสดงเหตุการณ์ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องเป็นสมาชิกของพื้นที่ทำงาน
ตัวอย่างเช่น โปรดดูแสดงรายการกิจกรรมจากพื้นที่ใน Google Chat
คำขอ HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ ชื่อทรัพยากรของพื้นที่ใน Google Chat ที่เกิดเหตุการณ์ รูปแบบ: |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageSize |
ไม่บังคับ จำนวนสูงสุดของกิจกรรมในพื้นที่ทำงานที่ส่งคืน บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าเชิงลบจะแสดงผลข้อผิดพลาด |
pageToken |
โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้เหตุการณ์ในพื้นที่รายการก่อนหน้า ระบุข้อมูลนี้เพื่อเรียกหน้าถัดไป เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุเพื่อแสดงรายการเหตุการณ์ในพื้นที่ทำงานต้องตรงกับการเรียกที่ระบุโทเค็นของหน้าเว็บ การส่งต่อค่าที่แตกต่างกันไปยังพารามิเตอร์อื่นๆ อาจทำให้เกิดผลลัพธ์ที่ไม่คาดคิด |
filter |
ต้องระบุ ตัวกรองข้อความค้นหา คุณต้องระบุประเภทเหตุการณ์ ( นอกจากนี้ คุณยังกรองตามเวลาเริ่มต้น (
หากต้องการระบุเวลาเริ่มต้นหรือสิ้นสุด ให้ใช้โอเปอเรเตอร์และรูปแบบ "เท่ากับ ตัวอย่างเช่น ข้อความค้นหาต่อไปนี้ถูกต้อง
การค้นหาต่อไปนี้ไม่ถูกต้อง
เซิร์ฟเวอร์ปฏิเสธการค้นหาที่ไม่ถูกต้องที่มีข้อผิดพลาด |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับการแสดงเหตุการณ์ในพื้นที่ทำงาน
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spaceEvents": [
{
object ( |
ช่อง | |
---|---|
spaceEvents[] |
ระบบจะแสดงผลลัพธ์ตามลำดับเวลา (เหตุการณ์เก่าสุดก่อน) |
nextPageToken |
โทเค็นความต่อเนื่องที่ใช้เพื่อดึงเหตุการณ์เพิ่มเติม หากเว้นช่องนี้ไว้ ก็จะไม่เห็นหน้าต่อๆ ไป |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์