Method: spaces.messagePins.list

스페이스의 메시지 고정 목록을 표시합니다. 사용자는 스페이스에서 중요한 메시지를 고정하여 쉽게 액세스할 수 있습니다. 자세한 내용은 Google Chat에서 대화 고정 또는 고정 해제를 참고하세요.

다음 승인 범위 중 하나를 사용하여 사용자 인증이 필요합니다.

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 고정된 항목 컬렉션을 소유한 상위 스페이스입니다. 형식: spaces/{space}

쿼리 매개변수

파라미터
pageSize

integer

선택사항입니다. 반환되는 최대 메시지 고정 수입니다. 서비스에서 이 값보다 적은 메시지를 반환할 수 있습니다. 최댓값은 100입니다. 100보다 큰 값을 사용하면 자동으로 100으로 변경됩니다. 지정하지 않으면 최대 100개의 메시지 고정이 반환됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.
pageToken

string

선택사항입니다. 이전 목록 메시지 고정 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다.

페이지로 나누는 경우 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예기치 않은 결과가 발생할 수 있습니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

메시지 고정 목록에 대한 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
필드
messagePins[]

object (MessagePin)

지정된 스페이스에서 고정된 메시지입니다.
nextPageToken

string

토큰을 pageToken으로 전송하여 결과의 다음 페이지를 검색할 수 있습니다. 비어 있으면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

자세한 내용은 승인 가이드를 참고하세요.