MCP Tools Reference: calendarmcp.googleapis.com

ابزار: suggest_time

دوره‌های زمانی را در یک یا چند تقویم پیشنهاد می‌دهد.

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

درخواست کرل 
curl --location 'https://calendarmcp.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": "suggest_time",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

درخواست پیام برای SuggestTime.

پیشنهادزماندرخواست

نمایش JSON 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
فیلدها
attendeeEmails[]

string

الزامی. برای پیدا کردن وقت آزاد، به شرکت‌کنندگان ایمیل بزنید.

startTime

string

الزامی. شروع بازه زمانی پرس‌وجو (ISO 8601).

endTime

string

الزامی. پایان بازه پرس‌وجو (ISO 8601).

فیلد اتحادیه _time_zone .

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

timeZone

string

اختیاری. منطقه زمانی برای زمان‌های جستجو (شناسه IANA، برای مثال Europe/Zurich ). پیش‌فرض: فاصله start_time ، در صورت عدم وجود، منطقه زمانی اصلی کاربر.

فیلد اتحادیه _duration_minutes .

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

durationMinutes

integer

اختیاری. حداقل مدت زمان خالی بودن اسلات به دقیقه. پیش‌فرض: 30

فیلد اتحادیه _preferences .

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

preferences

object ( Preferences )

تنظیمات برگزیده برای یافتن زمان پیشنهادی.

تنظیمات برگزیده

نمایش JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
فیلدها

ساعت _start_hour اتحادیه.

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

startHour

string

ساعت شروع ترجیحی "HH:mm" (فرمت ۲۴ ساعته) باشد.

فیلد اتحادیه _end_hour .

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

endHour

string

ساعت پایان ترجیحی "HH:mm" (فرمت ۲۴ ساعته) باشد.

فیلد اتحادیه _exclude_weekends .

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

excludeWeekends

boolean

آخر هفته‌ها را حذف کنید.

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

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

pageSize

integer

حداکثر تعداد اسلات‌ها برای بازگشت. پیش‌فرض: 5 .

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

پیام پاسخ برای SuggestTime.

پیشنهادزمانپاسخ

نمایش JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
فیلدها
timeSlots[]

object ( TimeSlot )

بازه‌های زمانی پیشنهادی.

تایم‌اسلات

نمایش JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
فیلدها
startTime
(deprecated)

string

منسوخ شده: به جای آن start استفاده کنید.

endTime
(deprecated)

string

منسوخ شده: به جای آن end استفاده کنید.

durationMinutes
(deprecated)

integer

منسوخ شده: به جای آن start و end برای محاسبه مدت زمان استفاده کنید.

start

object ( DateOrDateTime )

زمان شروع بازه زمانی.

end

object ( DateOrDateTime )

زمان پایان بازه زمانی.

تاریخ یا تاریخ و زمان

نمایش JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
فیلدها
date

string

تاریخ ISO 8601 در نیمه شب UTC (برای مثال، '2019-11-20T00:00:00Z' ).

dateTime

string

مهر زمانی ISO 8601 (برای مثال، '2019-11-20T08:19:06-07:00' ).

timeZone

string

نام منطقه زمانی TZDB.

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

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

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.freebusy
  • https://www.googleapis.com/auth/calendar.freebusy