MCP Tools Reference: calendarmcp.googleapis.com

Araç: update_event

Belirtilen takvimdeki bir etkinliği günceller.

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

Giriş Şeması

UpdateEvent için istek mesajı. Ayarlanmayan alanlar güncellenmez.

UpdateEventRequest

JSON gösterimi 
{
  "eventId": string,
  "addedAttendeeEmails": [
    string
  ],
  "addedAttendees": [
    {
      object (Attendee)
    }
  ],
  "removedAttendeeEmails": [
    string
  ],
  "overrideReminders": [
    {
      object (Reminder)
    }
  ],
  "addedAttachments": [
    {
      object (Attachment)
    }
  ],
  "removedAttachmentFileUrls": [
    string
  ],

  "calendarId": string

  "summary": string

  "description": string

  "location": string

  "startTime": string

  "endTime": string

  "allDay": boolean

  "timeZone": string

  "notificationLevel": enum (NotificationLevel)

  "addGoogleMeetUrl": boolean

  "visibility": string

  "colorId": string

  "googleMeetUrl": string

  "guestPermissions": {
    object (GuestPermissions)
  }

  "availability": enum (Availability)
}
Alanlar
eventId

string

Zorunlu. Etkinlik kimliği.
addedAttendeeEmails[]
(deprecated)

string

İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine added_attendees kullanın.
addedAttendees[]

object (Attendee)

İsteğe bağlı. Etkinliğe eklenecek katılımcılar.
removedAttendeeEmails[]

string

İsteğe bağlı. Kaldırılacak etkinlik katılımcıları (e-posta adresleri olarak).
overrideReminders[]

object (Reminder)

İsteğe bağlı. Ayarlanırsa etkinlik için mevcut tüm hatırlatıcıların yerini alır.
addedAttachments[]

object (Attachment)

İsteğe bağlı. Etkinliğe eklenecek dosya ekleri.
removedAttachmentFileUrls[]

string

İsteğe bağlı. Etkinlikten kaldırılacak dosya ekleri.

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

_summary birleşik alanı.

_summary aşağıdakilerden yalnızca biri olabilir:
summary

string

İsteğe bağlı. Yeni başlık.

_description birleşik alanı.

_description aşağıdakilerden yalnızca biri olabilir:
description

string

İsteğe bağlı. Yeni açıklama. HTML içerebilir.

_location birleşik alanı.

_location aşağıdakilerden yalnızca biri olabilir:
location

string

İsteğe bağlı. Sadece yeri değişti.

_start_time birleşik alanı.

_start_time aşağıdakilerden yalnızca biri olabilir:
startTime

string

İsteğe bağlı. Yeni başlangıç saati (ISO 8601). Yalnızca başlangıç güncelleniyorsa süreyi korur.

_end_time birleşik alanı.

_end_time aşağıdakilerden yalnızca biri olabilir:
endTime

string

İsteğe bağlı. Yeni bitiş zamanı (ISO 8601).

_all_day birleşik alanı.

_all_day aşağıdakilerden yalnızca biri olabilir:
allDay

boolean

İsteğe bağlı. Etkinliği tüm gün süren etkinlik olarak değiştirir. Ayarlanırsa start_time/end_time da sağlanmalıdır.

_time_zone birleşik alanı.

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

string

İsteğe bağlı. IANA Saat Dilimi Veritabanı adı (örneğin, America/Los_Angeles). Varsayılan: kullanıcının birincil saat dilimi. start_time ve end_time içindeki ofsetleri geçersiz kılar.

_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 gönderilecek e-posta bildirimi. Varsayılan: ALL.

_add_google_meet_url birleşik alanı.

_add_google_meet_url aşağıdakilerden yalnızca biri olabilir:
addGoogleMeetUrl

boolean

İsteğe bağlı. Doğruysa etkinlik için bir Google Meet URL'si oluşturur veya günceller. Meet devre dışı bırakılmışsa yok sayılır.

_visibility birleşik alanı.

_visibility aşağıdakilerden yalnızca biri olabilir:
visibility

string

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

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

_color_id birleşik alanı.

_color_id aşağıdakilerden yalnızca biri olabilir:
colorId

string

İsteğe bağlı. Etkinliğin yeni rengi. Renk kimliklerinin listesi için Etkinlik kaynağının belgelerine bakın.

_google_meet_url birleşik alanı.

_google_meet_url aşağıdakilerden yalnızca biri olabilir:
googleMeetUrl

string

İsteğe bağlı. Mevcut bir Google Meet URL'sinin veya toplantı kimliğinin etkinliğe eklenmesine izin verir. addGoogleMeetUrl değerini geçersiz kılar.

_guest_permissions birleşik alanı.

_guest_permissions aşağıdakilerden yalnızca biri olabilir:
guestPermissions

object (GuestPermissions)

İsteğe bağlı. Bu etkinliğin davetli izni ayarları.

_availability birleşik alanı.

_availability aşağıdakilerden yalnızca biri olabilir:
availability

enum (Availability)

İsteğe bağlı. Etkinliğin takvimde zamanı engelleyip engellemediği.

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

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.

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.

Çı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ı ipucu: ❌ | İdempotent ipucu: ✅ | Salt okunur ipucu: ❌ | Açık dünya ipucu: ❌

Yetkilendirme Kapsamları

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

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.events