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
선택사항입니다. (이전 쿼리에서 재개하는 경우) 이전 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" )를 사용하여 유사한 필드를 조인합니다. 이모티콘과 사용자별로 반응을 필터링하려면 emoji.unicode = "🙂" AND user.name = "users/AAAAAA" 와 같은 AND 연산자를 사용합니다. 쿼리에서 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-02-27(UTC)
[null,null,["최종 업데이트: 2025-02-27(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"]]