MCP Tools Reference: calendarmcp.googleapis.com

ابزار: list_calendars

تقویم‌های موجود در لیست تقویم کاربر را برمی‌گرداند.

از این ابزار برای سوالاتی مانند موارد زیر استفاده کنید:

  • تقویم‌های من چی؟

مثال:

list_calendars()
        # Returns all calendars the authenticated user has access to.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار list_calendars MCP را نشان می‌دهد.

درخواست کرل 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_calendars",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست لیست تقویم‌ها

نمایش JSON 
{

  "pageSize": integer

  "pageToken": string
}
فیلدها

فیلد یونیون _page_size .

_page_size می‌تواند فقط یکی از موارد زیر باشد:

pageSize

integer

اختیاری. حداکثر تعداد ورودی‌های نمایش داده شده در یک صفحه نتیجه. به طور پیش‌فرض مقدار ۱۰۰ ورودی است. اندازه صفحه هرگز نمی‌تواند بزرگتر از ۲۵۰ ورودی باشد.

فیلد یونیون _page_token .

_page_token فقط می‌تواند یکی از موارد زیر باشد:

pageToken

string

اختیاری. توکنی که مشخص می‌کند کدام صفحه نتیجه برگردانده شود.

طرحواره خروجی

پاسخ‌های ListCalendars

نمایش JSON 
{
  "calendars": [
    {
      object (Calendar)
    }
  ],

  "nextPageToken": string
}
فیلدها
calendars[]

object ( Calendar )

فهرست تقویم‌ها در فهرست تقویم.

فیلد مشترک _next_page_token .

_next_page_token فقط می‌تواند یکی از موارد زیر باشد:

nextPageToken

string

توکن مورد استفاده برای دسترسی به صفحه بعدی این نتیجه. در صورت عدم وجود نتایج بیشتر، حذف می‌شود.

تقویم

نمایش JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
فیلدها
id

string

شناسه. شناسه تقویم.

summary

string

عنوان تقویم. فقط خواندنی.

description

string

شرح تقویم. اختیاری. فقط خواندنی.

timeZone

string

منطقه زمانی تقویم. اختیاری. فقط خواندنی.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌