Method: spaces.messages.reactions.list

แสดงความรู้สึกที่มีต่อข้อความ ตัวอย่างเช่น ดูแสดงความรู้สึกต่อข้อความ ต้องมีการตรวจสอบสิทธิ์ผู้ใช้

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ข้อความที่ผู้ใช้แสดงความรู้สึก

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

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

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

integer

ไม่บังคับ จำนวนรีแอ็กชันสูงสุดที่แสดงผล บริการอาจแสดงรีแอ็กชันน้อยกว่าค่านี้ หากไม่ระบุ ค่าเริ่มต้นจะเป็น 25 ค่าสูงสุดคือ 200 ค่าที่มากกว่า 200 จะเปลี่ยนเป็น 200
pageToken

string

ไม่บังคับ (หากทำต่อจากคำค้นหาก่อนหน้า)

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

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

string

ไม่บังคับ ตัวกรองการค้นหา

คุณกรองรีแอ็กชันได้โดยใช้อีโมจิ (emoji.unicode หรือ emoji.custom_emoji.uid) และผู้ใช้ (user.name)

หากต้องการกรองรีแอ็กชันสำหรับอีโมจิหรือผู้ใช้หลายรายการ ให้ผนวกช่องที่คล้ายกันด้วยโอเปอเรเตอร์ OR เช่น emoji.unicode = "🙂" OR emoji.unicode = "👍" และ user.name = "users/AAAAAA" OR user.name = "users/BBBBBB"

หากต้องการกรองรีแอ็กชันตามอีโมจิและผู้ใช้ ให้ใช้โอเปอเรเตอร์ AND เช่น emoji.unicode = "🙂" AND user.name = "users/AAAAAA"

หากการค้นหาของคุณใช้ทั้ง AND และ OR ให้จัดกลุ่มโดยใช้วงเล็บ

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

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

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

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

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

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

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

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

ตอบกลับคำขอรีแอ็กชันรายการ

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

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

object (Reaction)

รายการรีแอ็กชันในหน้าที่ขอ (หรือหน้าแรก)
nextPageToken

string

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

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

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