MCP Tools Reference: calendarmcp.googleapis.com

כלי: suggest_time

מציע תקופות זמן בכמה יומנים.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ suggest_time.

בקשת 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

שעת ההתחלה המועדפת בפורמט 'HH:mm' (פורמט של 24 שעות).

שדה איחוד _end_hour.

הערך _end_hour יכול להיות רק אחד מהבאים:
endHour

string

שעת הסיום המועדפת בפורמט 'HH:mm' (שעון 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 בחצות לפי שעון 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