MCP Tools Reference: calendarmcp.googleapis.com

Araç: delete_event

Belirtilen takvimdeki bir etkinliği siler.

Aşağıdaki örnekte, delete_event 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": "delete_event",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

DeleteEvent için istek mesajı.

DeleteEventRequest

JSON gösterimi 
{
  "eventId": string,

  "calendarId": string

  "notificationLevel": enum (NotificationLevel)
}
Alanlar
eventId

string

Zorunlu. Silinecek etkinliğin kimliği.

_calendar_id birleşik alanı.

_calendar_id aşağıdakilerden yalnızca biri olabilir:
calendarId

string

İsteğe bağlı. Etkinliği içeren takvimin kimliği. E-posta adresi: list_calendars kullanılarak çözümlenebilir. Varsayılan: birincil takvim.

_notification_level birleşik alanı.

_notification_level aşağıdakilerden yalnızca biri olabilir:
notificationLevel

enum (NotificationLevel)

İsteğe bağlı. Bu etkinlik güncellemesi için hangi e-posta bildirimi gönderilmelidir?

NotificationLevel

Güncellemeler için e-posta bildirimi düzeyi.

Sıralamalar
NOTIFICATION_LEVEL_UNSPECIFIED Varsayılan. ALL olarak değerlendirilir.
NONE Bildirim yok.
EXTERNAL_ONLY Yalnızca kuruluş dışı katılımcılar.
ALL Tüm katılımcılar.

Çıkış Şeması

Etkinlik

JSON gösterimi 
{
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": string,
  "updated": string,
  "summary": string,
  "description": string,
  "location": string,
  "creator": {
    object (Principal)
  },
  "organizer": {
    object (Principal)
  },
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  },
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    object (DateOrDateTime)
  },
  "transparency": string,
  "visibility": string,
  "attendees": [
    {
      object (Attendee)
    }
  ],
  "conferenceUrl": string,
  "colorId": string,
  "overrideReminders": [
    {
      object (Reminder)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "guestPermissions": {
    object (GuestPermissions)
  },
  "eventType": enum (EventType),
  "workingLocationProperties": {
    object (WorkingLocationProperties)
  },
  "availability": enum (Availability)
}
Alanlar
id

string

Benzersiz tanımlayıcı.
status

string

İsteğe bağlı. Durum'a dokunun. Olası değerler:

  • confirmed - Etkinlik onaylandı (varsayılan).
  • tentative: Etkinlik geçici olarak onaylandı.
  • cancelled - Etkinlik iptal edildi veya silindi.
htmlLink

string

Yalnızca çıkış. Google Takvim web kullanıcı arayüzünde bu etkinliğe giden mutlak bağlantı.
created

string

Yalnızca çıkış. Oluşturulma zamanı (ISO 8601).
updated

string

Yalnızca çıkış. Son değiştirme zamanı (ISO 8601).
summary

string

Başlık.
description

string

İsteğe bağlı. Açıklama. HTML içerebilir.
location

string

İsteğe bağlı. Konum'a dokunun.
creator

object (Principal)

Yalnızca çıkış. İçerik üretici.
organizer

object (Principal)

Yalnızca çıkış. Düzenleyen. Katılımcılar listesinde de gösterilir.
start

object (DateOrDateTime)

Başlangıç zamanı (dahil). Yinelenen etkinliklerde ilk örnek kullanılır.
end

object (DateOrDateTime)

Bitiş zamanı (dahil değil). Düzenli etkinliklerde ilk örnek kullanılır.
recurrence[]

string

Yinelenme kuralları RRULE, EXRULE, RDATE veya EXDATE dizeleri (RFC 5545'e göre) olarak. Tek seferlik etkinlikler için atlanır. Başlangıç/bitiş zamanları start/end alanlarında ayarlanmalıdır.
recurringEventId

string

Düzenli etkinlik örnekleri için üst düzenli etkinlik kimliği.
originalStartTime

object (DateOrDateTime)

Tekrarlanan örneklerin orijinal başlangıç zamanı. Bu, yinelenme verilerine göre bu örneğin başlayacağı zamandır.
transparency
(deprecated)

string

İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine availability kullanın.
visibility

string

İsteğe bağlı. Etkinliğin görünürlüğü. Olası değerler:

  • default: Takvimdeki etkinlikler için varsayılan görünürlüğü kullanır. Bu, varsayılan değerdir.
  • public - Etkinlik ayrıntıları, takvimin tüm okuyucuları tarafından görülebilir.
  • private - Etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görüntüleyebilir.

attendees[]

object (Attendee)

Katılımcılar
conferenceUrl

string

Video konferans bağlantısı.
colorId

string

Etkinliğin rengi. Yalnızca kendi takvim görünümünüzü etkiler. Bu, takvimin renk paletindeki bir girişi ifade eden kimliktir (dize '1'-'11'):

  • 1: Lavanta
  • 2: Adaçayı
  • 3: Üzüm
  • 4: Flamingo
  • 5: Muz
  • 6: Mandalina
  • 7: Peacock
  • 8: Grafit
  • 9: Yaban mersini
  • 10: Fesleğen
  • 11: Domates.

overrideReminders[]

object (Reminder)

Hatırlatıcılar'a dokunun. Ayarlanmamışsa takvim varsayılanlarına geri döner.
attachments[]

object (Attachment)

Dosya ekleri
guestPermissions

object (GuestPermissions)

Davetli izinleri
eventType

enum (EventType)

Etkinlik türü.
workingLocationProperties

object (WorkingLocationProperties)

Çalışma yeri özellikleri. Yalnızca event_type WORKING_LOCATION olduğunda doldurulur.
availability

enum (Availability)

İsteğe bağlı. Kullanılabilirlik ayarı.

Ana hesap

JSON gösterimi 
{
  "email": string,
  "displayName": string,
  "self": boolean
}
Alanlar
email

string

E-posta'yı tıklayın.
displayName

string

Ad.
self

boolean

Yalnızca çıkış. Bu asıl kullanıcının, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Varsayılan: false.

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ı.

Katılımcı

JSON gösterimi 
{

  "id": string

  "email": string

  "displayName": string

  "organizer": boolean

  "self": boolean

  "resource": boolean

  "optionalAttendee": boolean

  "responseStatus": string

  "comment": string

  "additionalGuests": integer
}
Alanlar

_id birleşik alanı.

_id aşağıdakilerden yalnızca biri olabilir:
id

string

Yalnızca çıkış. Profil kimliği.

_email birleşik alanı.

_email aşağıdakilerden yalnızca biri olabilir:
email

string

Zorunlu. Katılımcının e-posta adresi.

_display_name birleşik alanı.

_display_name aşağıdakilerden yalnızca biri olabilir:
displayName

string

İsteğe bağlı. Ad.

_organizer birleşik alanı.

_organizer aşağıdakilerden yalnızca biri olabilir:
organizer

boolean

Yalnızca çıkış. Katılımcının düzenleyici olup olmadığı. Varsayılan: false.

_self birleşik alanı.

_self aşağıdakilerden yalnızca biri olabilir:
self

boolean

Yalnızca çıkış. Bu giriş, etkinliğin bu kopyasının göründüğü takvimi temsil edip etmediği. Varsayılan: false.

_resource birleşik alanı.

_resource aşağıdakilerden yalnızca biri olabilir:
resource

boolean

İsteğe bağlı. Katılımcının kaynak (ör. oda) olup olmadığı. Değiştirilemez, yalnızca katılımcı ilk kez eklendiğinde ayarlanabilir. Varsayılan: false.

_optional_attendee birleşik alanı.

_optional_attendee aşağıdakilerden yalnızca biri olabilir:
optionalAttendee

boolean

İsteğe bağlı. Katılımcının isteğe bağlı olup olmadığı. Varsayılan: false.

_response_status birleşik alanı.

_response_status aşağıdakilerden yalnızca biri olabilir:
responseStatus

string

İsteğe bağlı. Yanıt durumu. Olası değerler:

  • needsAction - Katılımcı davetiye yanıt vermedi (yeni etkinlikler için önerilir).
  • declined: Katılımcı davetiyeyi reddetti.
  • tentative: Katılımcı, daveti geçici olarak kabul etti.
  • accepted: Katılımcı daveti kabul etti.

_comment birleşik alanı.

_comment aşağıdakilerden yalnızca biri olabilir:
comment

string

Yalnızca çıkış. Yanıt yorumu.

_additional_guests birleşik alanı.

_additional_guests aşağıdakilerden yalnızca biri olabilir:
additionalGuests

integer

İsteğe bağlı. Ek davetli sayısı. Varsayılan: 0.

Hatırlatma

JSON gösterimi 
{

  "method": string

  "minutes": integer
}
Alanlar

_method birleşik alanı.

_method aşağıdakilerden yalnızca biri olabilir:
method

string

Zorunlu. Yayınlanma yöntemi. Olası değerler:

  • email - Hatırlatıcılar e-postayla gönderilir.
  • popup: Hatırlatmalar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir.

_minutes birleşik alanı.

_minutes aşağıdakilerden yalnızca biri olabilir:
minutes

integer

Zorunlu. Hatırlatıcının kaç dakika önce tetikleneceği

Ek

JSON gösterimi 
{

  "fileUrl": string

  "title": string
}
Alanlar

_file_url birleşik alanı.

_file_url aşağıdakilerden yalnızca biri olabilir:
fileUrl

string

Zorunlu. Ekin URL bağlantısı.

_title birleşik alanı.

_title aşağıdakilerden yalnızca biri olabilir:
title

string

İsteğe bağlı. Ek başlığı

GuestPermissions

JSON gösterimi 
{

  "guestsCanInviteOthers": boolean

  "guestsCanModify": boolean

  "guestsCanSeeGuests": boolean
}
Alanlar

_guests_can_invite_others birleşik alanı.

_guests_can_invite_others aşağıdakilerden yalnızca biri olabilir:
guestsCanInviteOthers

boolean

İsteğe bağlı. Davetlilerin başkalarını davet edip edemeyeceği

_guests_can_modify birleşik alanı.

_guests_can_modify aşağıdakilerden yalnızca biri olabilir:
guestsCanModify

boolean

İsteğe bağlı. Davetlilerin etkinliği değiştirip değiştiremeyeceği

_guests_can_see_guests birleşik alanı.

_guests_can_see_guests aşağıdakilerden yalnızca biri olabilir:
guestsCanSeeGuests

boolean

İsteğe bağlı. Davetlilerin diğer davetlileri görüp göremeyeceği

WorkingLocationProperties

JSON gösterimi 
{

  "type": enum (WorkingLocationType)

  "customLocationLabel": string
}
Alanlar

_type birleşik alanı.

_type aşağıdakilerden yalnızca biri olabilir:
type

enum (WorkingLocationType)

İsteğe bağlı. Çalışma yeri türü.

_custom_location_label birleşik alanı.

_custom_location_label aşağıdakilerden yalnızca biri olabilir:
customLocationLabel

string

İsteğe bağlı. Özel konumun etiketi. Tür CUSTOM_LOCATION ise zorunludur.

EventType

Etkinlik türü. Oluşturulduktan sonra değiştirilemez.

Sıralamalar
EVENT_TYPE_UNSPECIFIED DEFAULT olarak değerlendirilir.
DEFAULT Normal etkinlik. Varsayılan değer.
OUT_OF_OFFICE Ofis dışında etkinliği.
FOCUS_TIME Odaklanma zamanı etkinliği.
WORKING_LOCATION Çalışma yeri etkinliği.
BIRTHDAY Yılda bir kez düzenlenen, tüm gün süren özel etkinlik.
FROM_GMAIL Gmail'den alınan etkinlikler. Bu tür etkinlikler oluşturulamaz.

WorkingLocationType

Çalışma yerinin türü.

Sıralamalar
WORKING_LOCATION_TYPE_UNSPECIFIED Çalışma yeri türü belirtilmedi. HOME_OFFICE olarak kabul edilir.
HOME_OFFICE Ev ofisi.
CUSTOM_LOCATION Özel konum.

Kullanılabilirlik

Bir etkinlik için müsaitlik durumu ayarı.

Sıralamalar
AVAILABILITY_UNSPECIFIED Varsayılan. BUSY olarak değerlendirilir.
AVAILABILITY_BUSY Takvimde zaman engeller.
AVAILABILITY_FREE Zamanı engellemez.

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.events