MCP Tools Reference: calendarmcp.googleapis.com

เครื่องมือ: delete_event

ลบกิจกรรมในปฏิทินที่ระบุ

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ delete_event MCP

คำขอ 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": "delete_event",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ DeleteEvent

DeleteEventRequest

การแสดง JSON 
{
  "eventId": string,

  "calendarId": string

  "notificationLevel": enum (NotificationLevel)
}
ช่อง
eventId

string

ต้องระบุ รหัสของกิจกรรมที่จะลบ

ฟิลด์ Union _calendar_id

_calendar_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
calendarId

string

ไม่บังคับ รหัสปฏิทินที่มีกิจกรรม อีเมล - สามารถแก้ไขได้โดยใช้ list_calendars ค่าเริ่มต้น: ปฏิทินหลัก

ฟิลด์ Union _notification_level

_notification_level ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
notificationLevel

enum (NotificationLevel)

ไม่บังคับ ควรส่งการแจ้งเตือนทางอีเมลใดสำหรับการอัปเดตกิจกรรมนี้

NotificationLevel

ระดับการแจ้งเตือนทางอีเมลสำหรับการอัปเดต

Enum
NOTIFICATION_LEVEL_UNSPECIFIED ค่าเริ่มต้น ถือเป็น ALL
NONE ไม่มีการแจ้งเตือน
EXTERNAL_ONLY เฉพาะผู้เข้าร่วมภายนอก
ALL ผู้เข้าร่วมทั้งหมด

สคีมาเอาต์พุต

กิจกรรม

การแสดง 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

เอาต์พุตเท่านั้น ลิงก์ที่แน่นอนไปยังกิจกรรมนี้ในเว็บ UI ของ 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
}
ช่อง

ฟิลด์ Union _id

_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
id

string

เอาต์พุตเท่านั้น รหัสโปรไฟล์

ฟิลด์ Union _email

_email ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
email

string

ต้องระบุ อีเมลของผู้เข้าร่วม

ฟิลด์ Union _display_name

_display_name ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
displayName

string

ไม่บังคับ ชื่อ

ฟิลด์ Union _organizer

_organizer ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
organizer

boolean

เอาต์พุตเท่านั้น ระบุว่าผู้เข้าร่วมเป็นผู้จัดหรือไม่ ค่าเริ่มต้น: false

ฟิลด์ Union _self

_self ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
self

boolean

เอาต์พุตเท่านั้น ไม่ว่ารายการนี้จะแสดงปฏิทินที่สำเนากิจกรรมนี้ปรากฏหรือไม่ ค่าเริ่มต้น: false

ฟิลด์ Union _resource

_resource ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
resource

boolean

ไม่บังคับ ผู้เข้าร่วมเป็นทรัพยากร (เช่น ห้อง) หรือไม่ เปลี่ยนแปลงไม่ได้ ตั้งค่าได้เมื่อเพิ่มผู้เข้าร่วมในครั้งแรกเท่านั้น ค่าเริ่มต้น: false

ฟิลด์ Union _optional_attendee

_optional_attendee ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
optionalAttendee

boolean

ไม่บังคับ ผู้เข้าร่วมเป็นแบบไม่บังคับหรือไม่ ค่าเริ่มต้น: false

ฟิลด์ Union _response_status

_response_status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
responseStatus

string

ไม่บังคับ สถานะคำตอบ ค่าที่เป็นไปได้มีดังนี้

  • needsAction - ผู้เข้าร่วมยังไม่ได้ตอบรับคำเชิญ (แนะนำสำหรับกิจกรรมใหม่)
  • declined - ผู้เข้าร่วมปฏิเสธคำเชิญ
  • tentative - ผู้เข้าร่วมตอบรับคำเชิญชั่วคราว
  • accepted - ผู้เข้าร่วมยอมรับคำเชิญแล้ว

ฟิลด์ Union _comment

_comment ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
comment

string

เอาต์พุตเท่านั้น ความคิดเห็นตอบกลับ

ฟิลด์ Union _additional_guests

_additional_guests ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
additionalGuests

integer

ไม่บังคับ จำนวนแขกเพิ่มเติม ค่าเริ่มต้น: 0

การช่วยเตือน

การแสดง JSON 
{

  "method": string

  "minutes": integer
}
ช่อง

ฟิลด์ Union _method

_method ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
method

string

ต้องระบุ วิธีการนำส่ง ค่าที่เป็นไปได้มีดังนี้

  • email - ระบบจะส่งการช่วยเตือนทางอีเมล
  • popup - ระบบจะส่งการช่วยเตือนผ่านป๊อปอัป UI

ฟิลด์ Union _minutes

_minutes ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
minutes

integer

ต้องระบุ เวลาแจ้งเตือนล่วงหน้าเป็นนาที

ไฟล์แนบ

การแสดง JSON 
{

  "fileUrl": string

  "title": string
}
ช่อง

ฟิลด์ Union _file_url

_file_url ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fileUrl

string

ต้องระบุ ลิงก์ URL ไปยังไฟล์แนบ

ฟิลด์ Union _title

_title ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
title

string

ไม่บังคับ ชื่อไฟล์แนบ

GuestPermissions

การแสดง JSON 
{

  "guestsCanInviteOthers": boolean

  "guestsCanModify": boolean

  "guestsCanSeeGuests": boolean
}
ช่อง

ฟิลด์ Union _guests_can_invite_others

_guests_can_invite_others ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
guestsCanInviteOthers

boolean

ไม่บังคับ ผู้เข้าร่วมเชิญผู้อื่นได้หรือไม่

ฟิลด์ Union _guests_can_modify

_guests_can_modify ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
guestsCanModify

boolean

ไม่บังคับ ผู้เข้าร่วมแก้ไขกิจกรรมได้หรือไม่

ฟิลด์ Union _guests_can_see_guests

_guests_can_see_guests ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
guestsCanSeeGuests

boolean

ไม่บังคับ ผู้เข้าร่วมจะดูผู้เข้าร่วมคนอื่นๆ ได้หรือไม่

WorkingLocationProperties

การแสดง JSON 
{

  "type": enum (WorkingLocationType)

  "customLocationLabel": string
}
ช่อง

ฟิลด์ Union _type

_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
type

enum (WorkingLocationType)

ไม่บังคับ ประเภทสถานที่ทำงาน

ฟิลด์ Union _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 ไม่ได้บล็อกเวลา

คำอธิบายประกอบเครื่องมือ

คำใบ้ที่ทำลายล้าง: ✅ | คำใบ้ที่ทำซ้ำได้: ✅ | คำใบ้แบบอ่านอย่างเดียว: ❌ | คำใบ้แบบโลกเปิด: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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