MCP Tools Reference: calendarmcp.googleapis.com

Công cụ: suggest_time

Đề xuất khoảng thời gian trên một hoặc nhiều lịch.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP suggest_time.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho SuggestTime.

SuggestTimeRequest

Biểu diễn dưới dạng JSON 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
Trường
attendeeEmails[]

string

Bắt buộc. Email của người tham dự để tìm thời gian rảnh.
startTime

string

Bắt buộc. Thời điểm bắt đầu khoảng thời gian truy vấn (ISO 8601).
endTime

string

Bắt buộc. Thời điểm kết thúc khoảng thời gian truy vấn (ISO 8601).

Trường nhóm _time_zone.

_time_zone chỉ có thể là một trong những trạng thái sau:
timeZone

string

Không bắt buộc. Múi giờ cho thời gian tìm kiếm (mã nhận dạng IANA, ví dụ: Europe/Zurich). Mặc định: độ lệch của start_time, nếu không có thì là múi giờ chính của người dùng.

Trường nhóm _duration_minutes.

_duration_minutes chỉ có thể là một trong những trạng thái sau:
durationMinutes

integer

Không bắt buộc. Thời lượng tối thiểu của khung giờ trống (tính bằng phút). Mặc định: 30.

Trường nhóm _preferences.

_preferences chỉ có thể là một trong những trạng thái sau:
preferences

object (Preferences)

Lựa chọn ưu tiên để tìm thời gian đề xuất.

Tùy chọn

Biểu diễn dưới dạng JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Trường

Trường nhóm _start_hour.

_start_hour chỉ có thể là một trong những trạng thái sau:
startHour

string

Giờ bắt đầu ưu tiên ở định dạng "HH:mm" (định dạng 24 giờ).

Trường nhóm _end_hour.

_end_hour chỉ có thể là một trong những trạng thái sau:
endHour

string

Giờ kết thúc ưu tiên ở định dạng "HH:mm" (định dạng 24 giờ).

Trường nhóm _exclude_weekends.

_exclude_weekends chỉ có thể là một trong những trạng thái sau:
excludeWeekends

boolean

Loại trừ các ngày cuối tuần.

Trường nhóm _page_size.

_page_size chỉ có thể là một trong những trạng thái sau:
pageSize

integer

Số lượng vị trí tối đa cần trả về. Mặc định: 5.

Giản đồ đầu ra

Thông báo phản hồi cho SuggestTime.

SuggestTimeResponse

Biểu diễn dưới dạng JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Trường
timeSlots[]

object (TimeSlot)

Khung giờ được đề xuất.

TimeSlot

Biểu diễn dưới dạng JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Trường
startTime
(deprecated)

string

Không dùng nữa: hãy sử dụng start.
endTime
(deprecated)

string

Không dùng nữa: hãy sử dụng end.
durationMinutes
(deprecated)

integer

Không dùng nữa: thay vào đó, hãy dùng start và end để tính toán thời lượng.
start

object (DateOrDateTime)

Thời gian bắt đầu của khung giờ.
end

object (DateOrDateTime)

Thời gian kết thúc của khung giờ.

DateOrDateTime

Biểu diễn dưới dạng JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Trường
date

string

Ngày theo tiêu chuẩn ISO 8601 vào nửa đêm theo giờ UTC (ví dụ: '2019-11-20T00:00:00Z').
dateTime

string

Dấu thời gian ISO 8601 (ví dụ: '2019-11-20T08:19:06-07:00').
timeZone

string

Tên múi giờ TZDB.

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • 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