MCP Tools Reference: chatmcp.googleapis.com

Strumento: list_memberships

Elenca le appartenenze in una conversazione di Google Chat.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP list_memberships.

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

Schema di input

ListMembershipsRequest

Rappresentazione JSON 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Campi
conversationId

string

Obbligatorio. L'ID della conversazione per cui elencare le appartenenze. Formato: spaces/{space}
pageSize

integer

Facoltativo. Il numero massimo di appartenenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non viene specificato o viene impostato su un valore non positivo, viene utilizzato il valore predefinito 20. Il valore massimo consentito è 50.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata list_memberships. Forniscilo per recuperare la pagina successiva.
membershipFilter

enum (MembershipFilter)

Facoltativo. Specifica il sottoinsieme di appartenenze da restituire. Se non viene specificato, vengono restituite solo le appartenenze JOINED.

MembershipFilter

Specifica il sottoinsieme di appartenenze da restituire.

Enum
MEMBERSHIP_FILTER_UNSPECIFIED Valore predefinito. Se non viene specificato, vengono restituite solo le appartenenze JOINED.
JOINED_ONLY Restituisce solo le appartenenze JOINED.
JOINED_AND_INVITED Restituisce le appartenenze JOINED e INVITED.

Schema di output

Risposta contenente l'elenco delle appartenenze nella conversazione.

ListMembershipsResponse

Rappresentazione JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Campi
memberships[]

object (Membership)

Elenco delle appartenenze nella conversazione richiesta.
nextPageToken

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Membership

Rappresentazione JSON 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Campi
member

object (User)

L'utente che è membro.
state

enum (State)

Solo output. Stato dell'appartenenza.
role

enum (Role)

Ruolo del membro.

User

Rappresentazione JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Campi
userId

string

Nome risorsa di un utente di Chat. Formato: users/{user}.
displayName

string

Il nome visualizzato di un utente di Chat.
email

string

L'indirizzo email dell'utente. Questo campo viene compilato solo quando il tipo di utente è HUMAN.
userType

enum (UserType)

Il tipo di utente.

UserType

Il tipo di utente di Google Chat.

Enum
USER_TYPE_UNSPECIFIED Non specificato.
HUMAN Utente umano.
APP Utente dell'app.

State

Stato dell'appartenenza.

Enum
STATE_UNSPECIFIED Non specificato.
JOINED L'utente è membro dello spazio.
INVITED L'utente è invitato a partecipare allo spazio.

Role

Ruolo del membro.

Enum
ROLE_UNSPECIFIED Non specificato.
MEMBER L'utente è membro dello spazio.
MANAGER L'utente è un gestore dello spazio.
ASSISTANT_MANAGER L'utente è un gestore assistente dello spazio.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare un prompt di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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