MCP Tools Reference: chatmcp.googleapis.com

Tool: list_memberships

Listet die Mitgliedschaften in einer Google Chat-Unterhaltung auf.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool list_memberships aufzurufen.

cURL-Anfrage 
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
}'

Eingabeschema

ListMembershipsRequest

JSON-Darstellung 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Felder
conversationId

string

Erforderlich. Die ID der Unterhaltung, für die Mitgliedschaften aufgelistet werden sollen. Format: spaces/{space}
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Mitgliedschaften. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben oder auf einen nicht positiven Wert festgelegt, wird der Standardwert 20 verwendet. Der maximal zulässige Wert beträgt 50.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Aufruf von `list_memberships` empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
membershipFilter

enum (MembershipFilter)

Optional. Gibt die Teilmenge der zurückzugebenden Mitgliedschaften an. Wenn nicht angegeben, werden nur JOINED-Mitgliedschaften zurückgegeben.

MembershipFilter

Gibt die Teilmenge der zurückzugebenden Mitgliedschaften an.

Enums
MEMBERSHIP_FILTER_UNSPECIFIED Standardwert. Wenn nicht angegeben, werden nur JOINED-Mitgliedschaften zurückgegeben.
JOINED_ONLY Gibt nur JOINED-Mitgliedschaften zurück.
JOINED_AND_INVITED Gibt JOINED- und INVITED-Mitgliedschaften zurück.

Ausgabeschema

Antwort mit der Liste der Mitgliedschaften in der Unterhaltung.

ListMembershipsResponse

JSON-Darstellung 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Felder
memberships[]

object (Membership)

Liste der Mitgliedschaften in der angeforderten Unterhaltung.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Mitgliedschaft

JSON-Darstellung 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Felder
member

object (User)

Der Nutzer, der Mitglied ist.
state

enum (State)

Nur Ausgabe. Status der Mitgliedschaft.
role

enum (Role)

Rolle des Mitglieds.

Nutzer

JSON-Darstellung 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Felder
userId

string

Ressourcenname eines Chat-Nutzers. Format: users/{user}.
displayName

string

Der Anzeigename eines Chat-Nutzers.
email

string

Die E-Mail-Adresse des Nutzers. Dieses Feld wird nur ausgefüllt, wenn der Nutzertyp HUMAN ist.
userType

enum (UserType)

Der Typ des Nutzers.

UserType

Der Typ eines Google Chat-Nutzers.

Enums
USER_TYPE_UNSPECIFIED Nicht angegeben
HUMAN Menschlicher Nutzer
APP App-Nutzer

Bundesland

Status der Mitgliedschaft.

Enums
STATE_UNSPECIFIED Nicht angegeben
JOINED Der Nutzer ist Mitglied des Bereichs.
INVITED Der Nutzer wurde eingeladen, dem Bereich beizutreten.

Rolle

Rolle des Mitglieds.

Enums
ROLE_UNSPECIFIED Nicht angegeben
MEMBER Der Nutzer ist Mitglied des Bereichs.
MANAGER Der Nutzer ist Manager des Bereichs.
ASSISTANT_MANAGER Der Nutzer ist stellvertretender Manager des Bereichs.

Toolanmerkungen

Toolanmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring werden die folgenden booleschen Hinweise wie folgt definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise eine offene Welt, ein Speichertool jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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