MCP Tools Reference: chatmcp.googleapis.com

Alat: list_memberships

Mencantumkan keanggotaan dalam percakapan Google Chat.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_memberships.

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

Skema Input

ListMembershipsRequest

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

string

Wajib. ID percakapan untuk mencantumkan keanggotaan. Format: spaces/{space}
pageSize

integer

Opsional. Jumlah maksimum langganan yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan atau ditetapkan ke nilai non-positif, nilai default 20 akan digunakan. Nilai maksimum yang diizinkan adalah 50.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan list_memberships sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.
membershipFilter

enum (MembershipFilter)

Opsional. Menentukan subset keanggotaan yang akan ditampilkan. Jika tidak ditentukan, hanya keanggotaan BERGABUNG yang ditampilkan.

MembershipFilter

Menentukan subset keanggotaan yang akan ditampilkan.

Enum
MEMBERSHIP_FILTER_UNSPECIFIED Nilai default. Jika tidak ditentukan, hanya menampilkan keanggotaan BERGABUNG.
JOINED_ONLY Hanya menampilkan langganan yang BERGABUNG.
JOINED_AND_INVITED Menampilkan keanggotaan BERGABUNG dan DIUNDANG.

Skema Output

Respons yang berisi daftar keanggotaan dalam percakapan.

ListMembershipsResponse

Representasi JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Kolom
memberships[]

object (Membership)

Daftar keanggotaan dalam percakapan yang diminta.
nextPageToken

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Langganan

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

object (User)

Pengguna yang merupakan anggota.
state

enum (State)

Hanya output. Status keanggotaan.
role

enum (Role)

Peran anggota.

Pengguna

Representasi JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Kolom
userId

string

Nama resource pengguna Chat. Format: users/{user}.
displayName

string

Nama tampilan pengguna Chat.
email

string

Alamat email pengguna. Kolom ini hanya diisi jika jenis pengguna adalah HUMAN.
userType

enum (UserType)

Jenis pengguna.

UserType

Jenis pengguna Google Chat.

Enum
USER_TYPE_UNSPECIFIED Tidak ditentukan.
HUMAN Pengguna manusia.
APP Pengguna aplikasi.

Negara bagian/Provinsi

Status keanggotaan.

Enum
STATE_UNSPECIFIED Tidak ditentukan.
JOINED Pengguna adalah anggota ruang.
INVITED Pengguna diundang untuk bergabung ke ruang.

Peran

Peran anggota.

Enum
ROLE_UNSPECIFIED Tidak ditentukan.
MEMBER Pengguna adalah anggota ruang.
MANAGER Pengguna adalah pengelola ruang.
ASSISTANT_MANAGER Pengguna adalah asisten pengelola ruang.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar (true), alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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