MCP Tools Reference: calendarmcp.googleapis.com

כלי: update_event

מעדכן אירוע ביומן שצוין.

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

בקשת Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--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
}'

סכימת הקלט

הודעת בקשה ל-UpdateEvent. שדות שלא מוגדרים לא יעודכנו.

UpdateEventRequest

ייצוג JSON 
{
  "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)
}
שדות
eventId

string

חובה. מזהה האירוע.
addedAttendeeEmails[]
(deprecated)

string

אופציונלי. הוצא משימוש: במקומו צריך להשתמש ב-added_attendees.
addedAttendees[]

object (Attendee)

אופציונלי. המשתתפים שרוצים להוסיף לאירוע.
removedAttendeeEmails[]

string

אופציונלי. המשתתפים באירוע שרוצים להסיר, ככתובות אימייל.
overrideReminders[]

object (Reminder)

אופציונלי. אם הפרמטר מוגדר, הוא מחליף את כל התזכורות הקיימות לאירוע.
addedAttachments[]

object (Attachment)

אופציונלי. קבצים שמצורפים לאירוע.
removedAttachmentFileUrls[]

string

אופציונלי. קבצים מצורפים שצריך להסיר מהאירוע.

שדה איחוד _calendar_id.

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

string

אופציונלי. המזהה של היומן שמכיל את האירוע. כתובת אימייל – אפשר לפתור את הבעיה באמצעות list_calendars. ברירת מחדל: היומן הראשי.

שדה איחוד _summary.

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

string

אופציונלי. שם חדש.

שדה איחוד _description.

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

string

אופציונלי. תיאור חדש. יכול להכיל HTML.

שדה איחוד _location.

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

string

אופציונלי. מיקום חדש.

שדה איחוד _start_time.

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

string

אופציונלי. שעת התחלה חדשה (בפורמט ISO 8601). אם מעדכנים רק את שעת ההתחלה, משך האירוע נשמר.

שדה איחוד _end_time.

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

string

אופציונלי. שעת סיום חדשה (בפורמט ISO 8601).

שדה איחוד _all_day.

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

boolean

אופציונלי. האירוע ישתנה לאירוע של יום שלם. אם מגדירים את start_time, צריך לספק גם את start_time/end_time.

שדה איחוד _time_zone.

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

string

אופציונלי. השם של אזור הזמן במסד הנתונים של IANA (לדוגמה, America/Los_Angeles). ברירת מחדל: אזור הזמן הראשי של המשתמש. החלפת ההיסטים ב-start_time וב-end_time.

שדה איחוד _notification_level.

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

enum (NotificationLevel)

אופציונלי. התראה באימייל שתישלח לגבי העדכון הזה באירוע. ברירת מחדל: ALL.

שדה איחוד _add_google_meet_url.

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

boolean

אופציונלי. אם הערך הוא true, נוצרת או מתעדכנת כתובת URL של Google Meet לאירוע. המערכת תתעלם מההגדרה אם Meet מושבת.

שדה איחוד _visibility.

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

string

אופציונלי. הרשאת הגישה החדשה לאירוע. הערכים האפשריים הם:

  • ‫default – נעשה שימוש בהרשאות הגישה שמוגדרות כברירת מחדל לאירועים ביומן. ערך ברירת המחדל.
  • public – כל מי שיש לו הרשאת קריאה ביומן יכול לראות את פרטי האירוע.
  • ‫private – האירוע פרטי ורק המשתתפים יכולים לראות את הפרטים שלו.

שדה איחוד _color_id.

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

string

אופציונלי. הצבע החדש של האירוע. רשימה של מזהי צבעים מופיעה במסמכי העזרה של משאב האירוע.

שדה איחוד _google_meet_url.

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

string

אופציונלי. מאפשרת לצרף לאירוע כתובת URL קיימת של Google Meet או מזהה פגישה. הפונקציה מחליפה את הערך של addGoogleMeetUrl.

שדה איחוד _guest_permissions.

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

object (GuestPermissions)

אופציונלי. הגדרות ההרשאות של האורחים באירוע הזה.

שדה איחוד _availability.

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

enum (Availability)

אופציונלי. האם האירוע חוסם זמן ביומן.

משתתפים

ייצוג JSON 
{

  "id": string

  "email": string

  "displayName": string

  "organizer": boolean

  "self": boolean

  "resource": boolean

  "optionalAttendee": boolean

  "responseStatus": string

  "comment": string

  "additionalGuests": integer
}
שדות

שדה איחוד _id.

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

string

פלט בלבד. מזהה הפרופיל.

שדה איחוד _email.

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

string

חובה. כתובת האימייל של המשתתף.

שדה איחוד _display_name.

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

string

אופציונלי. שם.

שדה איחוד _organizer.

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

boolean

פלט בלבד. האם המשתתף הוא המארגן. ברירת מחדל: false.

שדה איחוד _self.

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

boolean

פלט בלבד. האם הרשומה הזו מייצגת את היומן שבו מופיעה העותק הזה של האירוע. ברירת מחדל: false.

שדה איחוד _resource.

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

boolean

אופציונלי. האם המשתתף הוא משאב (למשל חדר). אי אפשר לשנות את הערך שלו, ואפשר להגדיר אותו רק כשמוסיפים את המשתתף בפעם הראשונה. ברירת מחדל: false.

שדה איחוד _optional_attendee.

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

boolean

אופציונלי. אם המשתתף הוא אופציונלי. ברירת מחדל: false.

שדה איחוד _response_status.

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

string

אופציונלי. סטטוס התגובה. הערכים האפשריים הם:

  • ‫needsAction – המשתתף לא הגיב להזמנה (מומלץ לאירועים חדשים).
  • ‫declined – המשתתף דחה את ההזמנה.
  • ‫tentative – המשתתף אישר את ההזמנה באופן זמני.
  • accepted – המשתתף אישר את ההזמנה.

שדה איחוד _comment.

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

string

פלט בלבד. תגובה לתשובה.

שדה איחוד _additional_guests.

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

integer

אופציונלי. מספר האורחים הנוספים. ברירת מחדל: 0.

תזכורת

ייצוג JSON 
{

  "method": string

  "minutes": integer
}
שדות

שדה איחוד _method.

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

string

חובה. שיטת הצגת המודעות. הערכים האפשריים הם:

  • ‫email – התזכורות נשלחות באימייל.
  • ‫popup – התזכורות נשלחות באמצעות חלון קופץ בממשק המשתמש.

שדה איחוד _minutes.

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

integer

חובה. מספר הדקות לפני האירוע שבו התזכורת מופעלת.

קובץ מצורף

ייצוג JSON 
{

  "fileUrl": string

  "title": string
}
שדות

שדה איחוד _file_url.

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

string

חובה. כתובת URL לקישור לקובץ המצורף.

שדה איחוד _title.

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

string

אופציונלי. שם הקובץ המצורף.

GuestPermissions

ייצוג JSON 
{

  "guestsCanInviteOthers": boolean

  "guestsCanModify": boolean

  "guestsCanSeeGuests": boolean
}
שדות

שדה איחוד _guests_can_invite_others.

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

boolean

אופציונלי. האם המשתתפים יכולים להזמין אנשים אחרים.

שדה איחוד _guests_can_modify.

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

boolean

אופציונלי. האם האורחים יכולים לשנות את האירוע.

שדה איחוד _guests_can_see_guests.

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

boolean

אופציונלי. אם המשתתפים יכולים לראות את רשימת המוזמנים.

NotificationLevel

רמת ההתראה באימייל על עדכונים.

טיפוסים בני מנייה (enum)
NOTIFICATION_LEVEL_UNSPECIFIED ברירת מחדל. הסיווג הוא ALL.
NONE אין התראות.
EXTERNAL_ONLY רק משתתפים חיצוניים.
ALL כל המשתתפים.

זמינות

הגדרת הזמינות של אירוע.

טיפוסים בני מנייה (enum)
AVAILABILITY_UNSPECIFIED ברירת מחדל. הסיווג הוא BUSY.
AVAILABILITY_BUSY חסימת זמן ביומן.
AVAILABILITY_FREE לא חוסם זמן.

סכימת הפלט

אירוע

ייצוג JSON 
{
  "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)
}
שדות
id

string

מזהה ייחודי.
status

string

אופציונלי. סטטוס. הערכים האפשריים הם:

  • ‫confirmed – האירוע אושר (ברירת מחדל).
  • tentative – האירוע אושר באופן זמני.
  • ‫cancelled – האירוע בוטל או נמחק.
htmlLink

string

פלט בלבד. קישור מוחלט לאירוע הזה בממשק המשתמש האינטרנטי של יומן Google.
created

string

פלט בלבד. זמן יצירה (ISO 8601).
updated

string

פלט בלבד. שעת השינוי האחרון (ISO 8601).
summary

string

שם.
description

string

אופציונלי. תיאור. יכול להכיל HTML.
location

string

אופציונלי. מיקום.
creator

object (Principal)

פלט בלבד. יוצר/ת.
organizer

object (Principal)

פלט בלבד. מארגן. המשתתפים מופיעים גם ברשימת המשתתפים אם הם משתתפים.
start

object (DateOrDateTime)

שעת ההתחלה (כולל). באירועים חוזרים, המערכת משתמשת במופע הראשון.
end

object (DateOrDateTime)

שעת הסיום (לא כולל). באירועים חוזרים, המערכת משתמשת במופע הראשון.
recurrence[]

string

כללי חזרה בתור מחרוזות RRULE,‏ EXRULE,‏ RDATE או EXDATE (לפי RFC 5545). השדה הזה לא מאוכלס באירועים בודדים. צריך להגדיר את שעת ההתחלה ושעת הסיום בשדות start ו-end.
recurringEventId

string

מזהה האירוע החוזר הראשי של מופעים של אירועים חוזרים.
originalStartTime

object (DateOrDateTime)

זמן ההתחלה המקורי של מופעים חוזרים. זהו הזמן שבו המופע הזה יתחיל לפי נתוני החזרה.
transparency
(deprecated)

string

אופציונלי. הוצא משימוש: במקומו צריך להשתמש ב-availability.
visibility

string

אופציונלי. הרשאות הגישה לאירוע. הערכים האפשריים הם:

  • ‫default – נעשה שימוש בהרשאות הגישה שמוגדרות כברירת מחדל לאירועים ביומן. זהו ערך ברירת המחדל.
  • public – כל מי שיש לו הרשאת קריאה ביומן יכול לראות את פרטי האירוע.
  • ‫private – רק משתתפים באירוע יכולים לראות את פרטי האירוע.

attendees[]

object (Attendee)

משתתפים.
conferenceUrl

string

קישור לשיחת הוועידה בווידאו.
colorId

string

הצבע של האירוע. השינוי יתעדכן רק ביומן שלכם. מזהה שמפנה לרשומה בפלטת הצבעים של היומן (מחרוזת '1'-'11'):

  • ‫1: לבנדר
  • 2: מרווה
  • 3: ענבים
  • 4: פלמינגו
  • 5: בננה
  • ‫6: קלמנטינה
  • ‫7: Peacock
  • 8: גרפיט
  • 9: אוכמניות
  • 10: בזיליקום
  • ‫11: עגבנייה.

overrideReminders[]

object (Reminder)

תזכורות. אם לא מוגדרת ברירת מחדל, המערכת חוזרת לברירות המחדל של היומן.
attachments[]

object (Attachment)

קבצים מצורפים.
guestPermissions

object (GuestPermissions)

הרשאות למשתתפים.
eventType

enum (EventType)

סוג האירוע.
workingLocationProperties

object (WorkingLocationProperties)

מאפיינים של מיקום העבודה. השדה הזה מאוכלס רק אם הערך של event_type הוא WORKING_LOCATION.
availability

enum (Availability)

אופציונלי. הגדרת הזמינות.

חשבון משתמש

ייצוג JSON 
{
  "email": string,
  "displayName": string,
  "self": boolean
}
שדות
email

string

אימייל.
displayName

string

שם.
self

boolean

פלט בלבד. האם הגורם הזה תואם ליומן שבו מופיעה העותק הזה של האירוע. ברירת מחדל: false.

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.

משתתפים

ייצוג JSON 
{

  "id": string

  "email": string

  "displayName": string

  "organizer": boolean

  "self": boolean

  "resource": boolean

  "optionalAttendee": boolean

  "responseStatus": string

  "comment": string

  "additionalGuests": integer
}
שדות

שדה איחוד _id.

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

string

פלט בלבד. מזהה הפרופיל.

שדה איחוד _email.

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

string

חובה. כתובת האימייל של המשתתף.

שדה איחוד _display_name.

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

string

אופציונלי. שם.

שדה איחוד _organizer.

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

boolean

פלט בלבד. האם המשתתף הוא המארגן. ברירת מחדל: false.

שדה איחוד _self.

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

boolean

פלט בלבד. האם הרשומה הזו מייצגת את היומן שבו מופיעה העותק הזה של האירוע. ברירת מחדל: false.

שדה איחוד _resource.

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

boolean

אופציונלי. האם המשתתף הוא משאב (למשל חדר). אי אפשר לשנות את הערך שלו, ואפשר להגדיר אותו רק כשמוסיפים את המשתתף בפעם הראשונה. ברירת מחדל: false.

שדה איחוד _optional_attendee.

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

boolean

אופציונלי. אם המשתתף הוא אופציונלי. ברירת מחדל: false.

שדה איחוד _response_status.

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

string

אופציונלי. סטטוס התגובה. הערכים האפשריים הם:

  • ‫needsAction – המשתתף לא הגיב להזמנה (מומלץ לאירועים חדשים).
  • ‫declined – המשתתף דחה את ההזמנה.
  • ‫tentative – המשתתף אישר את ההזמנה באופן זמני.
  • accepted – המשתתף אישר את ההזמנה.

שדה איחוד _comment.

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

string

פלט בלבד. תגובה לתשובה.

שדה איחוד _additional_guests.

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

integer

אופציונלי. מספר האורחים הנוספים. ברירת מחדל: 0.

תזכורת

ייצוג JSON 
{

  "method": string

  "minutes": integer
}
שדות

שדה איחוד _method.

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

string

חובה. שיטת הצגת המודעות. הערכים האפשריים הם:

  • ‫email – התזכורות נשלחות באימייל.
  • ‫popup – התזכורות נשלחות באמצעות חלון קופץ בממשק המשתמש.

שדה איחוד _minutes.

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

integer

חובה. מספר הדקות לפני האירוע שבו התזכורת מופעלת.

קובץ מצורף

ייצוג JSON 
{

  "fileUrl": string

  "title": string
}
שדות

שדה איחוד _file_url.

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

string

חובה. כתובת URL לקישור לקובץ המצורף.

שדה איחוד _title.

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

string

אופציונלי. שם הקובץ המצורף.

GuestPermissions

ייצוג JSON 
{

  "guestsCanInviteOthers": boolean

  "guestsCanModify": boolean

  "guestsCanSeeGuests": boolean
}
שדות

שדה איחוד _guests_can_invite_others.

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

boolean

אופציונלי. האם המשתתפים יכולים להזמין אנשים אחרים.

שדה איחוד _guests_can_modify.

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

boolean

אופציונלי. האם האורחים יכולים לשנות את האירוע.

שדה איחוד _guests_can_see_guests.

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

boolean

אופציונלי. אם המשתתפים יכולים לראות את רשימת המוזמנים.

WorkingLocationProperties

ייצוג JSON 
{

  "type": enum (WorkingLocationType)

  "customLocationLabel": string
}
שדות

שדה איחוד _type.

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

enum (WorkingLocationType)

אופציונלי. סוג מיקום העבודה.

שדה איחוד _custom_location_label.

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

string

אופציונלי. התווית של מיקום מותאם אישית. חובה אם סוג המבצע הוא CUSTOM_LOCATION.

EventType

סוג האירוע. אי אפשר לשנות אותו אחרי שהפרויקט נוצר.

טיפוסים בני מנייה (enum)
EVENT_TYPE_UNSPECIFIED הסיווג הוא DEFAULT.
DEFAULT אירוע רגיל. ערך ברירת המחדל.
OUT_OF_OFFICE אירוע מסוג 'לא בעבודה'.
FOCUS_TIME אירוע מסוג 'זמן לעצמי'.
WORKING_LOCATION אירוע בעבודה.
BIRTHDAY אירוע מיוחד שנמשך יום שלם וחוזר מדי שנה.
FROM_GMAIL אירוע מ-Gmail. אי אפשר ליצור אירועים מהסוג הזה.

WorkingLocationType

סוג מיקום העבודה.

טיפוסים בני מנייה (enum)
WORKING_LOCATION_TYPE_UNSPECIFIED סוג מיקום העבודה לא צוין. המערכת תתייחס אליו כאל HOME_OFFICE.
HOME_OFFICE משרד ביתי.
CUSTOM_LOCATION מיקום מותאם אישית.

זמינות

הגדרת הזמינות של אירוע.

טיפוסים בני מנייה (enum)
AVAILABILITY_UNSPECIFIED ברירת מחדל. הסיווג הוא BUSY.
AVAILABILITY_BUSY חסימת זמן ביומן.
AVAILABILITY_FREE לא חוסם זמן.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌