MCP Tools Reference: calendarmcp.googleapis.com

टूल: delete_event

इस तरीके का इस्तेमाल करके, दिए गए कैलेंडर से कोई इवेंट मिटाया जा सकता है.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके delete_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": "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

ज़रूरी है. मिटाए जाने वाले इवेंट का आईडी.

यूनियन फ़ील्ड _calendar_id.

_calendar_id इनमें से सिर्फ़ एक हो सकता है:
calendarId

string

ज़रूरी नहीं. उस कैलेंडर का आईडी जिसमें इवेंट मौजूद है. ईमेल पता - इसे list_calendars का इस्तेमाल करके ठीक किया जा सकता है. डिफ़ॉल्ट: मुख्य कैलेंडर.

यूनियन फ़ील्ड _notification_level.

_notification_level इनमें से सिर्फ़ एक हो सकता है:
notificationLevel

enum (NotificationLevel)

ज़रूरी नहीं. इस इवेंट के अपडेट के लिए, कौनसी ईमेल सूचना भेजी जानी चाहिए.

NotificationLevel

अपडेट के लिए ईमेल सूचना का लेवल.

Enums
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

सिर्फ़ आउटपुट के लिए. Google Calendar के वेब यूज़र इंटरफ़ेस (यूआई) में, इस इवेंट का पूरा लिंक.
created

string

सिर्फ़ आउटपुट के लिए. बनाए जाने का समय (आईएसओ 8601).
updated

string

सिर्फ़ आउटपुट के लिए. बदलाव का आखिरी समय (आईएसओ 8601).
summary

string

टाइटल.
description

string

ज़रूरी नहीं. ब्यौरा. इसमें एचटीएमएल शामिल हो सकता है.
location

string

ज़रूरी नहीं. जगह की जानकारी पर टैप करें.
creator

object (Principal)

सिर्फ़ आउटपुट के लिए. क्रिएटर.
organizer

object (Principal)

सिर्फ़ आउटपुट के लिए. आयोजक. अगर कोई व्यक्ति इवेंट में शामिल होता है, तो उसे शामिल होने वाले लोगों की सूची में भी दिखाया जाता है.
start

object (DateOrDateTime)

शुरू होने का समय (शामिल है). बार-बार होने वाले इवेंट के लिए, पहले इंस्टेंस का इस्तेमाल किया जाता है..
end

object (DateOrDateTime)

खत्म होने का समय (शामिल नहीं है). बार-बार होने वाले इवेंट के लिए, पहले इंस्टेंस का इस्तेमाल किया जाता है.
recurrence[]

string

आरएफ़सी 5545 के मुताबिक, दोहराव के नियम RRULE, EXRULE, RDATE या EXDATE स्ट्रिंग के तौर पर. इसे किसी खास इवेंट के लिए नहीं दिखाया जाता. शुरू और खत्म होने का समय, 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

आईएसओ 8601 फ़ॉर्मैट में, यूटीसी के हिसाब से आधी रात की तारीख (उदाहरण के लिए, '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

ज़रूरी है. अटैचमेंट का यूआरएल लिंक.

यूनियन फ़ील्ड _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

ईवेंट प्रकार. स्पेस बनाने के बाद, इसमें बदलाव नहीं किया जा सकता.

Enums
EVENT_TYPE_UNSPECIFIED DEFAULT के तौर पर माना जाता है.
DEFAULT सामान्य इवेंट. डिफ़ॉल्ट मान.
OUT_OF_OFFICE 'अभी मैं छुट्टी पर हूं' इवेंट.
FOCUS_TIME फ़ोकस टाइम इवेंट.
WORKING_LOCATION काम करने की जगह से जुड़ा इवेंट.
BIRTHDAY पूरे दिन चलने वाला खास इवेंट, जो हर साल होता है.
FROM_GMAIL Gmail का इवेंट. इस तरह का इवेंट नहीं बनाया जा सकता.

WorkingLocationType

काम करने की जगह का टाइप.

Enums
WORKING_LOCATION_TYPE_UNSPECIFIED काम करने की जगह के टाइप की जानकारी नहीं दी गई है. इसे HOME_OFFICE माना जाएगा.
HOME_OFFICE होम ऑफ़िस.
CUSTOM_LOCATION कस्टम लोकेशन.

उपलब्धता

किसी इवेंट के लिए उपलब्धता की सेटिंग.

Enums
AVAILABILITY_UNSPECIFIED डिफ़ॉल्ट. BUSY के तौर पर माना जाता है.
AVAILABILITY_BUSY कैलेंडर में समय ब्लॉक करता है.
AVAILABILITY_FREE इससे समय ब्लॉक नहीं होता.

टूल एनोटेशन

बदलाव करने वाला हिंट: ✅ | एक ही बार लागू होने वाला हिंट: ✅ | सिर्फ़ पढ़ने वाला हिंट: ❌ | ओपन वर्ल्ड हिंट: ❌