MCP Tools Reference: calendarmcp.googleapis.com

Araç: suggest_time

Bir veya daha fazla takvimde zaman aralıkları önerir.

Aşağıdaki örnekte, suggest_time MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

SuggestTime için istek mesajı.

SuggestTimeRequest

JSON gösterimi 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
Alanlar
attendeeEmails[]

string

Zorunlu. Müsaitlik durumunu öğrenmek istediğiniz katılımcıların e-posta adresleri.
startTime

string

Zorunlu. Sorgu aralığının başlangıcı (ISO 8601).
endTime

string

Zorunlu. Sorgu aralığı sonu (ISO 8601).

_time_zone birleşik alanı.

_time_zone aşağıdakilerden yalnızca biri olabilir:
timeZone

string

İsteğe bağlı. Arama zamanları için saat dilimi (IANA kimliği, örneğin Europe/Zurich). Varsayılan: start_time'nin farkı, yoksa kullanıcının birincil saat dilimi.

_duration_minutes birleşik alanı.

_duration_minutes aşağıdakilerden yalnızca biri olabilir:
durationMinutes

integer

İsteğe bağlı. Ücretsiz yerin minimum süresi (dakika cinsinden). Varsayılan: 30.

_preferences birleşik alanı.

_preferences aşağıdakilerden yalnızca biri olabilir:
preferences

object (Preferences)

Önerilen zamanı bulma tercihleri

Tercihler

JSON gösterimi 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Alanlar

_start_hour birleşik alanı.

_start_hour aşağıdakilerden yalnızca biri olabilir:
startHour

string

Tercih edilen başlangıç saati "SS:dd" (24 saat biçimi) olarak.

_end_hour birleşik alanı.

_end_hour aşağıdakilerden yalnızca biri olabilir:
endHour

string

Tercih edilen bitiş saati "SS:dd" (24 saat biçimi) olarak.

_exclude_weekends birleşik alanı.

_exclude_weekends aşağıdakilerden yalnızca biri olabilir:
excludeWeekends

boolean

Hafta sonlarını hariç tutun.

_page_size birleşik alanı.

_page_size aşağıdakilerden yalnızca biri olabilir:
pageSize

integer

Döndürülecek maksimum yer sayısı. Varsayılan: 5.

Çıkış Şeması

SuggestTime için yanıt mesajı.

SuggestTimeResponse

JSON gösterimi 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Alanlar
timeSlots[]

object (TimeSlot)

Önerilen zaman aralıkları.

TimeSlot

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Alanlar
startTime
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine start kullanın.
endTime
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine end kullanın.
durationMinutes
(deprecated)

integer

Desteği sonlandırıldı: Süreyi hesaplamak için bunun yerine start ve end kullanın.
start

object (DateOrDateTime)

Zaman aralığının başlangıç zamanı.
end

object (DateOrDateTime)

Zaman aralığının bitiş zamanı.

DateOrDateTime

JSON gösterimi 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Alanlar
date

string

UTC saatine göre gece yarısı ISO 8601 tarihi (örneğin, '2019-11-20T00:00:00Z').
dateTime

string

ISO 8601 zaman damgası (örneğin, '2019-11-20T08:19:06-07:00').
timeZone

string

TZDB saat dilimi adı.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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