MCP Tools Reference: chatmcp.googleapis.com

ツール: list_memberships

Google Chat の会話のメンバーシップを一覧表示します。

次のコードサンプルは、curl を使用して list_memberships MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

ListMembershipsRequest

JSON 表現 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
フィールド
conversationId

string

必須。メンバーシップを一覧表示する会話の ID。形式: spaces/{space}
pageSize

integer

省略可。返すメンバーシップの最大数。サービスが返す値はこれよりも少ないことがあります。指定しない場合、または 0 以下の値に設定した場合は、デフォルト値の 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 として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

メンバーシップ

JSON 表現 
{
  "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 の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌

認可スコープ

次の OAuth スコープのいずれかが必要です。

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