MCP Tools Reference: calendarmcp.googleapis.com

الأداة: suggest_time

تقترح هذه الدالة فترات زمنية على مستوى تقويم واحد أو أكثر.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة suggest_time MCP.

طلب Curl 
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

SuggestTimeRequest

تمثيل 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

ساعة البدء المفضّلة بتنسيق "سس:د د" (تنسيق 24 ساعة).

حقل الربط _end_hour

يمكن أن يكون التعليق _end_hour إحدى القيم التالية فقط:
endHour

string

ساعة النهاية المفضّلة بالتنسيق "سس:دد" (تنسيق 24 ساعة)

حقل الربط _exclude_weekends

يمكن أن يكون التعليق _exclude_weekends إحدى القيم التالية فقط:
excludeWeekends

boolean

استبعاد عطلات نهاية الأسبوع

حقل الربط _page_size

يمكن أن يكون التعليق _page_size إحدى القيم التالية فقط:
pageSize

integer

الحدّ الأقصى لعدد الفترات الزمنية المطلوب عرضها. القيمة التلقائية: 5

مخطط النتائج

رسالة الردّ على SuggestTime

SuggestTimeResponse

تمثيل JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
الحقول
timeSlots[]

object (TimeSlot)

الفترات الزمنية المقترَحة

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)

تمثّل هذه السمة وقت انتهاء الفترة الزمنية.

DateOrDateTime

تمثيل JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
الحقول
date

string

تاريخ ISO 8601 في منتصف الليل بالتوقيت العالمي المنسّق (على سبيل المثال، '2019-11-20T00:00:00Z')
dateTime

string

طابع زمني بتنسيق ISO 8601 (مثلاً، '2019-11-20T08:19:06-07:00')
timeZone

string

اسم المنطقة الزمنية في قاعدة بيانات المناطق الزمنية (TZDB)

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

نطاقات التفويض

يجب توفير أحد نطاقات 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