Method: spaces.messages.reactions.list

Liệt kê các phản ứng với một tin nhắn. Yêu cầu xác thực người dùng và phạm vi chat.messages, chat.messages.readonly, chat.messages.reactions hoặc chat.messages.reactions.readonly.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
parent

string

Bắt buộc. Tin nhắn mà người dùng đã bày tỏ cảm xúc.

Định dạng: space/{space}/message/{message}

Tham số truy vấn

Các tham số
pageSize

integer

Không bắt buộc. Số lượng phản ứng tối đa được trả về. Dịch vụ có thể trả về ít phản ứng hơn giá trị này. Nếu bạn không chỉ định thì giá trị mặc định sẽ là 25. Giá trị tối đa là 200; các giá trị trên 200 được thay đổi thành 200.
pageToken

string

Không bắt buộc. (Nếu tiếp tục từ truy vấn trước đó.)

Mã thông báo trang nhận được từ một lệnh gọi phản ứng trong danh sách trước đó. Hãy cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, giá trị bộ lọc phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Việc chuyển một giá trị khác có thể dẫn đến kết quả không mong muốn.
filter

string

Không bắt buộc. Bộ lọc truy vấn.

Bạn có thể lọc phản ứng theo biểu tượng cảm xúc (emoji.unicode hoặc emoji.custom_emoji.uid) và người dùng (user.name).

Để lọc phản ứng theo nhiều biểu tượng cảm xúc hoặc người dùng, hãy kết nối với các trường tương tự bằng toán tử OR, chẳng hạn như emoji.unicode = "🙂" OR emoji.unicode = "👍" và user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Để lọc phản ứng theo biểu tượng cảm xúc và người dùng, hãy sử dụng toán tử AND, chẳng hạn như emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Nếu truy vấn của bạn sử dụng cả AND và OR, hãy nhóm các dấu ngoặc đơn đó với dấu ngoặc đơn.

Ví dụ: các truy vấn sau đây là hợp lệ:

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}"

Các truy vấn sau đây không hợp lệ:

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}"

Máy chủ từ chối những truy vấn không hợp lệ do lỗi INVALID_ARGUMENT.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
Các trường
reactions[]

object (Reaction)

Danh sách phản ứng trong trang yêu cầu (hoặc đầu tiên).
nextPageToken

string

Mã thông báo tiếp tục để truy xuất trang kết quả tiếp theo. Giá trị này sẽ trống cho trang kết quả cuối cùng.

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.