Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

MCP Tools Reference: chatmcp.googleapis.com

Инструмент: `list_memberships`

Возвращает список участников чата в Google Chat.

В примере кода ниже показано, как использовать curl для вызова инструмента MCP list_memberships.

Запрос 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 MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

Запрос 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

ListMembershipsRequest

JSON-представление
{ "conversationId": string, "pageSize": integer, "pageToken": string, "membershipFilter": enum (`MembershipFilter`) }

Поля
`conversationId`	`string` Обязательно. Идентификатор чата, для которого нужно получить список участников. Формат: 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`, чтобы получить следующую страницу. Если это поле отсутствует, значит последующих страниц нет.

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)` Роль участника.

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, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Области авторизации

Требует одной из следующих областей применения OAuth:

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