MCP Tools Reference: chatmcp.googleapis.com

Herramienta: list_memberships

Muestra las membresías en una conversación de Google Chat.

En la siguiente muestra de código, se explica cómo usar curl para llamar a la herramienta list_memberships del MCP.

Solicitud 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
}'

Esquema de entrada

ListMembershipsRequest

Representación JSON 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Campos
conversationId

string

Obligatorio. El ID de la conversación para la que se mostrarán las membresías. Formato: spaces/{space}
pageSize

integer

Es opcional. Cantidad máxima de membresías que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica o se establece en un valor no positivo, se usa un valor predeterminado de 20. El valor máximo permitido es 50.
pageToken

string

Es opcional. Token de página, recibido desde una llamada a list_memberships anterior. Proporciona esto para recuperar la página siguiente.
membershipFilter

enum (MembershipFilter)

Es opcional. Especifica el subconjunto de membresías que se devolverán. Si no se especifica, solo se devuelven las membresías JOINED.

MembershipFilter

Especifica el subconjunto de membresías que se devolverán.

Enums
MEMBERSHIP_FILTER_UNSPECIFIED Valor predeterminado Si no se especifica, solo se devuelven las membresías JOINED.
JOINED_ONLY Solo devuelve las membresías JOINED.
JOINED_AND_INVITED Devuelve las membresías JOINED y INVITED.

Esquema de salida

Respuesta que contiene la lista de membresías en la conversación.

ListMembershipsResponse

Representación JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Campos
memberships[]

object (Membership)

Lista de membresías en la conversación solicitada.
nextPageToken

string

Un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Membresía

Representación JSON 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Campos
member

object (User)

El usuario que es miembro.
state

enum (State)

Solo salida. Estado de la membresía.
role

enum (Role)

Rol del miembro.

Usuario

Representación JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Campos
userId

string

Nombre del recurso de un usuario de Chat. Formato: users/{user}.
displayName

string

El nombre visible de un usuario de Chat.
email

string

Dirección de correo electrónico del usuario. Este campo solo se completa cuando el tipo de usuario es HUMAN.
userType

enum (UserType)

El tipo de usuario.

UserType

El tipo de usuario de Google Chat.

Enums
USER_TYPE_UNSPECIFIED Sin especificar.
HUMAN Usuario humano.
APP Usuario de la app.

Estado

Estado de la membresía.

Enums
STATE_UNSPECIFIED Sin especificar.
JOINED El usuario es miembro del espacio.
INVITED Se invitó al usuario a unirse al espacio.

Rol

Rol del miembro.

Enums
ROLE_UNSPECIFIED Sin especificar.
MEMBER El usuario es miembro del espacio.
MANAGER El usuario es administrador del espacio.
ASSISTANT_MANAGER El usuario es administrador asistente del espacio.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes del MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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