MCP Reference: calendarmcp.googleapis.com

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

मुख्य सुविधाएं:

• कोई भी Calendar ID. यह उपयोगकर्ता का प्राइमरी कैलेंडर या कोई अन्य कैलेंडर हो सकता है.
• समयसीमा के हिसाब से फ़िल्टर करना.
• समय की पाबंदियों से मेल खाने वाले सभी इवेंट वापस लाता है.

अगर उपलब्ध हो, तो उपयोगकर्ता के मुख्य कैलेंडर में खोज करने के लिए, search_events टूल का इस्तेमाल करें. ऐसा तब करें, जब:

• आपने किसी विषय, कैटगरी या मकसद से मिलते-जुलते इवेंट के लिए क्वेरी की है. जैसे, 'दोपहर के खाने के दौरान होने वाली मीटिंग', 'प्रोजेक्ट सिंक'.
• आपको सभी इवेंट के बजाय, सबसे ज़्यादा काम के (टॉप K) इवेंट ढूंढने हैं.
• आपको कीवर्ड या सिमैंटिक सर्च की सुविधाओं की ज़रूरत होगी.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• मेरे कैलेंडर में कल के लिए क्या-क्या है?
• मेरे कैलेंडर पर 14 जुलाई, 2025 के लिए कौनसा इवेंट सेट है?
• अगले हफ़्ते मेरी कौन-कौनसी मीटिंग हैं?
• क्या आज दोपहर मेरी एक से ज़्यादा मीटिंग एक ही समय पर हैं?

• जॉन की कल कौनसी मीटिंग हैं?

उदाहरण:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.

यह फ़ंक्शन, दिए गए कैलेंडर से एक इवेंट दिखाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• टीम मीटिंग की जानकारी पाना.
• मुझे मेरे कैलेंडर में event123 आईडी वाला इवेंट दिखाओ.

उदाहरण:

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.

इससे उपयोगकर्ता की कैलेंडर सूची में मौजूद कैलेंडर दिखते हैं.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• मेरे सभी कैलेंडर कौन-कौनसे हैं?

उदाहरण:

list_calendars()
# Returns all calendars the authenticated user has access to.

यह एक या एक से ज़्यादा कैलेंडर में समय अवधि का सुझाव देता है. मुख्य कैलेंडर को ऐक्सेस करने के लिए, attendee_emails फ़ील्ड में 'primary' जोड़ें.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• हम सभी के लिए मीटिंग का सही समय क्या है?
• हमें 30 मिनट का ऐसा स्लॉट ढूँढो जिसमें हम दोनों उपलब्ध हों.
• देखें कि jane.doe@google.com सोमवार की सुबह उपलब्ध है या नहीं.

उदाहरण:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

कैलेंडर इवेंट बनाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• मेरे कैलेंडर में कल दोपहर 2 बजे के लिए, 'जेन के साथ मीटिंग' नाम का एक इवेंट बनाओ.
• अगले सोमवार को सुबह 10 बजे से 11 बजे तक, john.doe@google.com के साथ मीटिंग शेड्यूल करो.

उदाहरण:

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.

यह कैलेंडर इवेंट को अपडेट करता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• 'जेन के साथ मीटिंग' इवेंट को एक घंटे बाद के लिए अपडेट करो.
• john.doe@google.com को कल होने वाली मीटिंग में शामिल करो.

उदाहरण:

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.

यह कैलेंडर इवेंट को मिटाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• मेरे कैलेंडर से event123 आईडी वाला इवेंट मिटाओ.

किसी इवेंट को रद्द करने या अस्वीकार करने के लिए, respond_to_event टूल का इस्तेमाल करें.

उदाहरण:

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.

किसी इवेंट का जवाब देता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

• मेरे कैलेंडर में event123 आईडी वाले इवेंट को स्वीकार करो.
• जेन के साथ होने वाली मीटिंग को अस्वीकार करो.
• मेरी अगली मीटिंग रद्द करो.
• प्लानिंग मीटिंग के न्योते को अभी के लिए स्वीकार करें.

उदाहरण:

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.