MCP Tools Reference: chatmcp.googleapis.com

Công cụ: list_memberships

Liệt kê thành viên trong một cuộc trò chuyện trên Google Chat.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ list_memberships MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

ListMembershipsRequest

Biểu diễn dưới dạng JSON 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Trường
conversationId

string

Bắt buộc. Mã của cuộc trò chuyện cần liệt kê thành viên. Định dạng: spaces/{space}
pageSize

integer

Không bắt buộc. Số lượng gói thành viên tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định hoặc đặt thành một giá trị không dương, hệ thống sẽ sử dụng giá trị mặc định là 20. Giá trị tối đa được phép là 50.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi list_memberships trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.
membershipFilter

enum (MembershipFilter)

Không bắt buộc. Chỉ định nhóm nhỏ thành viên cần trả về. Nếu không chỉ định, chỉ những hội viên có trạng thái JOINED mới được trả về.

MembershipFilter

Chỉ định nhóm nhỏ thành viên cần trả về.

Enum
MEMBERSHIP_FILTER_UNSPECIFIED Giá trị mặc định. Nếu không chỉ định, chỉ trả về những hội viên có trạng thái JOINED.
JOINED_ONLY Chỉ trả về những gói thành viên mà người dùng đã THAM GIA.
JOINED_AND_INVITED Trả về các gói thành viên JOINED và INVITED.

Giản đồ đầu ra

Phản hồi chứa danh sách thành viên trong cuộc trò chuyện.

ListMembershipsResponse

Biểu diễn dưới dạng JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Trường
memberships[]

object (Membership)

Danh sách thành viên trong cuộc trò chuyện được yêu cầu.
nextPageToken

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

Gói thành viên

Biểu diễn dưới dạng JSON 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Trường
member

object (User)

Người dùng là thành viên.
state

enum (State)

Chỉ có đầu ra. Trạng thái của gói thành viên.
role

enum (Role)

Vai trò của thành viên.

Người dùng

Biểu diễn dưới dạng JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Trường
userId

string

Tên tài nguyên của một người dùng Chat. Định dạng: users/{user}.
displayName

string

Tên hiển thị của người dùng Chat.
email

string

Địa chỉ email của người dùng. Trường này chỉ được điền sẵn khi loại người dùng là HUMAN.
userType

enum (UserType)

Loại người dùng.

UserType

Loại người dùng Google Chat.

Enum
USER_TYPE_UNSPECIFIED Không xác định.
HUMAN Người dùng thực.
APP Người dùng ứng dụng.

Tiểu bang

Trạng thái của gói thành viên.

Enum
STATE_UNSPECIFIED Không xác định.
JOINED Người dùng là thành viên của không gian.
INVITED Người dùng được mời tham gia không gian.

Vai trò

Vai trò của thành viên.

Enum
ROLE_UNSPECIFIED Không xác định.
MEMBER Người dùng là thành viên của không gian.
MANAGER Người dùng là người quản lý không gian.
ASSISTANT_MANAGER Người dùng là người quản lý phụ của không gian.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

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.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly