- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงรายการกิจกรรมจากพื้นที่ใน Google Chat เพย์โหลดจะมีทรัพยากร Chat เวอร์ชันล่าสุดสำหรับแต่ละเหตุการณ์ ตัวอย่างเช่น หากคุณแสดงรายการเหตุการณ์เกี่ยวกับสมาชิกใหม่ในพื้นที่ทำงาน เซิร์ฟเวอร์จะแสดงผลทรัพยากร Membership
ที่มีรายละเอียดการเป็นสมาชิกล่าสุด หากนำสมาชิกใหม่ออกในช่วงระยะเวลาที่ขอ เพย์โหลดของเหตุการณ์จะมีทรัพยากร Membership
ที่ว่างเปล่า
ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ หากต้องการแสดงรายการเหตุการณ์ ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์จะต้องเป็นสมาชิกของพื้นที่ทำงาน
ดูตัวอย่างได้ที่แสดงรายการกิจกรรมจากพื้นที่ใน Google Chat
คำขอ HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ ชื่อทรัพยากรของพื้นที่ใน Google Chat ที่เกิดเหตุการณ์ รูปแบบ: |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageSize |
ไม่บังคับ จำนวนเหตุการณ์ในพื้นที่ทำงานสูงสุดที่แสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าลบแสดงผลข้อผิดพลาด |
pageToken |
โทเค็นของหน้าเว็บที่ได้รับจากการเรียกใช้กิจกรรมรายการพื้นที่ทำงานก่อนหน้า ระบุพารามิเตอร์นี้เพื่อเรียกข้อมูลหน้าถัดไป เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุเพื่อแสดงรายการเหตุการณ์ในพื้นที่ทำงานต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ การส่งต่อค่าที่แตกต่างกันไปยังพารามิเตอร์อื่นๆ อาจทำให้เกิดผลลัพธ์ที่ไม่คาดคิด |
filter |
ต้องระบุ ตัวกรองการค้นหา คุณต้องระบุประเภทเหตุการณ์อย่างน้อย 1 ประเภท ( นอกจากนี้ คุณยังกรองตามเวลาเริ่มต้น (
หากต้องการระบุเวลาเริ่มต้นหรือสิ้นสุด ให้ใช้โอเปอเรเตอร์เท่ากับ ตัวอย่างเช่น การค้นหาต่อไปนี้ถูกต้อง
การค้นหาต่อไปนี้ไม่ถูกต้อง
เซิร์ฟเวอร์ที่มีข้อผิดพลาด |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับการแสดงกิจกรรมในพื้นที่ทำงาน
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง 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
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์