Method: spaces.messages.reactions.list
메시지에 대한 반응을 표시합니다. 예를 보려면 메시지의 리액션 목록을 참고하세요.
다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다.
https://www.googleapis.com/auth/chat.messages.reactions.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.messages
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
선택사항입니다. (이전 쿼리에서 재개하는 경우) 이전 list reactions 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.
|
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
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-05-07(UTC)
[null,null,["최종 업데이트: 2025-05-07(UTC)"],[[["Lists reactions for a specific message within a Google Chat space."],["Allows filtering reactions by emoji (unicode or custom) and user, using operators like `AND` and `OR`."],["Supports pagination to retrieve large result sets with `pageSize` and `pageToken` parameters."],["Requires specific authorization scopes related to message and reaction access."],["Returns a list of reactions with details like user and emoji, along with a token for fetching further pages."]]],["This describes how to list reactions to a message using a `GET` request to `https://chat.googleapis.com/v1/{parent=spaces/*/messages/*}/reactions`. The `parent` path parameter specifies the message. Optional query parameters include `pageSize` (max reactions returned), `pageToken` (for pagination), and `filter` (to filter by emoji or user). The request body must be empty. The response body contains a list of `reactions` and an optional `nextPageToken` for pagination. User authentication and specific authorization scopes are required.\n"]]