MCP Tools Reference: calendarmcp.googleapis.com

ابزار: suggest_time

دوره‌های زمانی را در یک یا چند تقویم پیشنهاد می‌دهد. برای دسترسی به تقویم اصلی، عبارت «اصلی» را در فیلد attendee_emails اضافه کنید.

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

  • کی وقت همه ما برای جلسه آزاد است؟
  • یه وقت ۳۰ دقیقه‌ای پیدا کن که هر دومون بتونیم وقت داشته باشیم.
  • بررسی کنید که آیا jane.doe@google.com صبح دوشنبه رایگان است یا خیر.

مثال:

suggest_time(
            attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
            startTime='2024-09-10T00:00:00',
            endTime='2024-09-17T00:00:00',
            durationMinutes=60,
            preferences={
                'startHour': '09:00',
                'endHour': '17:00',
                'excludeWeekends': True
            }
        )
        # Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار suggest_time 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": "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، مانند America/Los_Angeles را می‌پذیرد. پیش‌فرض، منطقه زمانی تقویم اصلی کاربر است.

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

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

durationMinutes

integer

اختیاری. حداقل مدت زمان یک بازه زمانی آزاد به دقیقه. مقدار پیش‌فرض ۳۰ دقیقه است.

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

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

preferences

object ( Preferences )

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

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

نمایش JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

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

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

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

startHour

string

ساعت شروع ترجیحی روز (مثلاً 09:00 ).

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

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

endHour

string

ساعت پایانی ترجیحی روز (مثلاً 17:00 ).

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

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

excludeWeekends

boolean

اینکه آیا آخر هفته‌ها را مستثنی کنیم یا خیر.

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

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

pageSize

integer

حداکثر تعداد بازه‌های زمانی برای بازگشت. پیش‌فرض ۵ است.

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

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

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

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

object ( TimeSlot )

فهرست بازه‌های زمانی پیشنهادی

تایم‌اسلات

نمایش JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer
}
فیلدها
startTime

string

زمان شروع بازه زمانی آزاد به صورت یک مهر زمانی با فرمت ISO 8601.

endTime

string

زمان پایان بازه زمانی آزاد به صورت یک مهر زمانی با فرمت ISO 8601.

durationMinutes

integer

مدت زمان بازه زمانی آزاد بر حسب دقیقه.

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

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