MCP Tools Reference: calendarmcp.googleapis.com

টুল: suggest_time

এক বা একাধিক ক্যালেন্ডার জুড়ে সময়কাল প্রস্তাব করে। প্রাথমিক ক্যালেন্ডারটি অ্যাক্সেস করতে, attendee_emails ফিল্ডে 'primary' যোগ করুন।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • মিটিংয়ের জন্য আমরা সবাই কখন ফ্রি থাকব?
  • ৩০ মিনিটের এমন একটা সময় খুঁজে বের করুন যখন আমরা দুজনেই উপস্থিত থাকতে পারব।
  • সোমবার সকালে 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.

নিম্নলিখিত নমুনাটি দেখায় কিভাবে suggest_time MCP টুলটি চালু করতে 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": "suggest_time",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

SuggestTime-এর জন্য অনুরোধ বার্তা।

সময় অনুরোধ প্রস্তাব করুন

JSON উপস্থাপনা 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
ক্ষেত্র
attendeeEmails[]

string

প্রয়োজনীয়। অংশগ্রহণকারী তার অবসর সময় খুঁজে পাওয়ার জন্য ইমেল করেন।

startTime

string

প্রয়োজনীয়। ISO 8601 অনুযায়ী ফরম্যাট করা কোয়েরির জন্য ব্যবধানের শুরু।

endTime

string

প্রয়োজনীয়। কোয়েরির জন্য ব্যবধানের শেষ সীমা ISO 8601 অনুযায়ী ফরম্যাট করা হয়েছে।

ইউনিয়ন ফিল্ড _time_zone .

_time_zone নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

timeZone

string

ঐচ্ছিক। সময়ের মানগুলির জন্য ব্যবহৃত সময় অঞ্চল। এই ফিল্ডটি IANA টাইম জোন ডাটাবেসের নাম গ্রহণ করে, যেমন, America/Los_Angeles । ডিফল্ট হলো ব্যবহারকারীর প্রাথমিক ক্যালেন্ডারের সময় অঞ্চল।

ইউনিয়ন ফিল্ড _duration_minutes .

_duration_minutes নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

durationMinutes

integer

ঐচ্ছিক। একটি খালি সময়ের সর্বনিম্ন সময়কাল (মিনিটে)। ডিফল্ট হলো ৩০ মিনিট।

ইউনিয়ন ফিল্ড _preferences ।

_preferences নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

preferences

object ( Preferences )

প্রস্তাবিত সময় খুঁজে বের করার জন্য পছন্দগুলো।

পছন্দ

JSON উপস্থাপনা 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _start_hour .

_start_hour নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

startHour

string

দিনের পছন্দের শুরুর সময় (যেমন, 09:00 )।

ইউনিয়ন ফিল্ড _end_hour ।

_end_hour নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

endHour

string

দিনের পছন্দের শেষ সময় (যেমন, 17:00 )।

ইউনিয়ন ফিল্ড _exclude_weekends .

_exclude_weekends নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

excludeWeekends

boolean

সপ্তাহান্তের দিনগুলো বাদ দেওয়া হবে কিনা।

ইউনিয়ন ফিল্ড _page_size .

_page_size নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

pageSize

integer

ফিরে আসার জন্য সর্বাধিক টাইম স্লটের সংখ্যা। ডিফল্ট হলো ৫।

আউটপুট স্কিমা

SuggestTime-এর জন্য প্রতিক্রিয়া বার্তা।

SuggestTimeResponse

JSON উপস্থাপনা 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
ক্ষেত্র
timeSlots[]

object ( TimeSlot )

প্রস্তাবিত সময়সূচীর তালিকা।

টাইম স্লট

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer
}
ক্ষেত্র
startTime

string

খালি সময়সূচির শুরুর সময়টি একটি ISO 8601 ফরম্যাটের টাইমস্ট্যাম্প হিসাবে।

endTime

string

খালি সময় স্লটের শেষ সময়টি একটি ISO 8601 ফরম্যাটের টাইমস্ট্যাম্প হিসাবে।

durationMinutes

integer

বিনামূল্যের সময়টির সময়কাল মিনিটে।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌