MCP Tools Reference: chatmcp.googleapis.com

도구: list_memberships

Google Chat 대화의 멤버십을 나열합니다.

다음 코드 샘플은 curl을 사용하여 list_memberships MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_memberships",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ListMembershipsRequest

JSON 표현 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
필드
conversationId

string

필수 항목입니다. 멤버십을 나열할 대화의 ID입니다. 형식: spaces/{space}
pageSize

integer

선택사항입니다. 반환할 최대 멤버십 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정되지 않거나 양수가 아닌 값으로 설정된 경우 기본값 20이 사용됩니다. 허용되는 최댓값은 50입니다.
pageToken

string

선택사항입니다. 이전 list_memberships 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.
membershipFilter

enum (MembershipFilter)

선택사항입니다. 반환할 멤버십의 하위 집합을 지정합니다. 지정하지 않으면 JOINED 멤버십만 반환됩니다.

MembershipFilter

반환할 멤버십의 하위 집합을 지정합니다.

열거형
MEMBERSHIP_FILTER_UNSPECIFIED 기본값 지정하지 않으면 JOINED 멤버십만 반환됩니다.
JOINED_ONLY JOINED 멤버십만 반환합니다.
JOINED_AND_INVITED JOINED 및 INVITED 멤버십을 반환합니다.

출력 스키마

대화의 멤버십 목록이 포함된 응답입니다.

ListMembershipsResponse

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

object (Membership)

요청된 대화의 멤버십 목록입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

멤버십

JSON 표현 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
필드
member

object (User)

회원인 사용자입니다.
state

enum (State)

출력 전용입니다. 멤버십의 상태입니다.
role

enum (Role)

회원의 역할입니다.

사용자

JSON 표현 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
필드
userId

string

Chat 사용자의 리소스 이름입니다. 형식: users/{user}
displayName

string

Chat 사용자의 표시 이름입니다.
email

string

사용자의 이메일 주소입니다. 이 필드는 사용자 유형이 HUMAN인 경우에만 채워집니다.
userType

enum (UserType)

사용자의 유형입니다.

UserType

Google Chat 사용자의 유형입니다.

열거형
USER_TYPE_UNSPECIFIED 지정되지 않음.
HUMAN 인간 사용자입니다.
APP 앱 사용자입니다.

주

멤버십의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않음.
JOINED 사용자가 스페이스의 회원입니다.
INVITED 사용자가 스페이스에 참여하도록 초대되었습니다.

역할

회원의 역할입니다.

열거형
ROLE_UNSPECIFIED 지정되지 않음.
MEMBER 사용자가 스페이스의 회원입니다.
MANAGER 사용자가 스페이스의 관리자입니다.
ASSISTANT_MANAGER 사용자가 스페이스의 보조 관리자입니다.

도구 주석

도구 주석은 지정된 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만 확인 메시지를 사용자에게 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true이면 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true이면 도구가 파괴적인 작업을 실행할 수 있습니다. false이면 도구가 추가 작업만 실행할 수 있습니다. 기본값: true.
  • idempotentHint: true이면 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true이면 도구가 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구가 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌

승인 범위

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

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly