MCP Tools Reference: chatmcp.googleapis.com

Araç: list_memberships

Google Chat görüşmesindeki üyelikleri listeler.

Aşağıdaki kod örneğinde, list_memberships MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

ListMembershipsRequest

JSON gösterimi 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Alanlar
conversationId

string

Zorunlu. Üyeliklerin listeleneceği görüşmenin kimliği. Biçim: spaces/{space}
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum üyelik sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse veya pozitif olmayan bir değere ayarlanırsa varsayılan 20 değeri kullanılır. İzin verilen en yüksek değer 50'dir.
pageToken

string

İsteğe bağlı. Önceki bir list_memberships çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
membershipFilter

enum (MembershipFilter)

İsteğe bağlı. Döndürülecek üyeliklerin alt kümesini belirtir. Belirtilmezse yalnızca JOINED üyelikleri döndürülür.

MembershipFilter

Döndürülecek üyeliklerin alt kümesini belirtir.

Sıralamalar
MEMBERSHIP_FILTER_UNSPECIFIED Varsayılan değer. Belirtilmezse yalnızca KATILDI üyeliklerini döndürür.
JOINED_ONLY Yalnızca JOINED üyeliklerini döndürür.
JOINED_AND_INVITED JOINED ve INVITED üyeliklerini döndürür.

Çıkış şeması

Görüşmedeki üyeliklerin listesini içeren yanıt.

ListMembershipsResponse

JSON gösterimi 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Alanlar
memberships[]

object (Membership)

İstenen görüşmedeki üyeliklerin listesi.
nextPageToken

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Üyelik

JSON gösterimi 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Alanlar
member

object (User)

Üye olan kullanıcı.
state

enum (State)

Yalnızca çıkış. Üyeliğin durumu.
role

enum (Role)

Üyenin rolü.

Kullanıcı

JSON gösterimi 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Alanlar
userId

string

Chat kullanıcısının kaynak adı. Biçim: users/{user}.
displayName

string

Chat kullanıcısının görünen adı.
email

string

Kullanıcının e-posta adresi. Bu alan yalnızca kullanıcı türü HUMAN olduğunda doldurulur.
userType

enum (UserType)

Kullanıcının türü.

UserType

Google Chat kullanıcısının türü.

Sıralamalar
USER_TYPE_UNSPECIFIED Belirtilmedi.
HUMAN Gerçek bir kullanıcı.
APP Uygulama kullanıcısı.

Eyalet

Üyeliğin durumu.

Sıralamalar
STATE_UNSPECIFIED Belirtilmedi.
JOINED Kullanıcı, alanın üyesidir.
INVITED Kullanıcı, alana katılmaya davet edilir.

Rol

Üyenin rolü.

Sıralamalar
ROLE_UNSPECIFIED Belirtilmedi.
MEMBER Kullanıcı, alanın üyesidir.
MANAGER Kullanıcı, alanın yöneticisidir.
ASSISTANT_MANAGER Kullanıcı, alanın yardımcı yöneticisidir.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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