Method: spaces.spaceEvents.list

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

ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ หากต้องการแสดงรายการเหตุการณ์ ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์จะต้องเป็นสมาชิกของพื้นที่ทำงาน

ดูตัวอย่างได้ที่แสดงรายการกิจกรรมจากพื้นที่ใน Google Chat

คำขอ HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ชื่อทรัพยากรของพื้นที่ใน Google Chat ที่เกิดเหตุการณ์

รูปแบบ: spaces/{space}

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ จำนวนเหตุการณ์ในพื้นที่ทำงานสูงสุดที่แสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้

ค่าลบแสดงผลข้อผิดพลาด INVALID_ARGUMENT

pageToken

string

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

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

filter

string

ต้องระบุ ตัวกรองการค้นหา

คุณต้องระบุประเภทเหตุการณ์อย่างน้อย 1 ประเภท (eventType) โดยใช้โอเปอเรเตอร์มี : หากต้องการกรองตามเหตุการณ์หลายประเภท ให้ใช้โอเปอเรเตอร์ OR ละเว้นประเภทเหตุการณ์แบบกลุ่มในตัวกรอง คำขอจะแสดงเหตุการณ์แบบกลุ่มที่เกี่ยวข้องโดยอัตโนมัติ เช่น หากกรองตามความรู้สึกใหม่ (google.workspace.chat.reaction.v1.created) เซิร์ฟเวอร์จะแสดงเหตุการณ์ความรู้สึกใหม่แบบกลุ่ม (google.workspace.chat.reaction.v1.batchCreated) ด้วย ดูรายการประเภทเหตุการณ์ที่รองรับได้ที่เอกสารประกอบอ้างอิงเกี่ยวกับ SpaceEvents

นอกจากนี้ คุณยังกรองตามเวลาเริ่มต้น (startTime) และเวลาสิ้นสุด (endTime) ได้อีกด้วย

  • startTime: การประทับเวลาสุดพิเศษสำหรับเริ่มระบุเหตุการณ์ในพื้นที่ทำงาน คุณระบุเหตุการณ์ที่เกิดขึ้นในช่วง 28 วันที่ผ่านมาได้ หากไม่ระบุ จะแสดงเหตุการณ์ในพื้นที่ทํางานในช่วง 28 วันที่ผ่านมา
  • endTime: การประทับเวลารวมจนกว่าจะระบุเหตุการณ์ในพื้นที่ทำงาน หากไม่ระบุ จะแสดงเหตุการณ์จนถึงเวลาที่ขอ

หากต้องการระบุเวลาเริ่มต้นหรือสิ้นสุด ให้ใช้โอเปอเรเตอร์เท่ากับ = และรูปแบบใน RFC-3339 หากต้องการกรองตามทั้ง startTime และ endTime ให้ใช้โอเปอเรเตอร์ AND

ตัวอย่างเช่น การค้นหาต่อไปนี้ถูกต้อง

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"
startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

การค้นหาต่อไปนี้ไม่ถูกต้อง

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"
eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

เซิร์ฟเวอร์ที่มีข้อผิดพลาด INVALID_ARGUMENT จะปฏิเสธการค้นหาที่ไม่ถูกต้อง

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับการแสดงกิจกรรมในพื้นที่ทำงาน

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
ช่อง
spaceEvents[]

object (SpaceEvent)

ผลลัพธ์จะแสดงตามลำดับเวลา (เหตุการณ์ที่เก่าสุดก่อน)

nextPageToken

string

ใช้โทเค็นต่อเนื่องเพื่อดึงข้อมูลเหตุการณ์เพิ่มเติม หากเว้นช่องนี้ไว้ จะไม่มีหน้าลำดับต่อมา

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์