ابزار: update_event
یک رویداد را در تقویم داده شده بهروزرسانی میکند.
نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار update_event MCP را نشان میدهد.
| درخواست کرل |
|---|
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": "update_event", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
طرحواره ورودی
پیام درخواست برای UpdateEvent. فیلدهایی که تنظیم نشدهاند، بهروزرسانی نخواهند شد.
درخواست بهروزرسانی
| نمایش JSON |
|---|
{ "eventId": string, "addedAttendeeEmails": [ string ], "addedAttendees": [ { object ( |
| فیلدها | |
|---|---|
eventId | الزامی. شناسه رویداد. |
addedAttendeeEmails[] | اختیاری. منسوخ شده: به جای آن |
addedAttendees[] | اختیاری. شرکتکنندگانی که میتوانند به رویداد اضافه شوند. |
removedAttendeeEmails[] | اختیاری. شرکتکنندگان رویداد که باید حذف شوند، مانند آدرسهای ایمیل. |
overrideReminders[] | اختیاری. در صورت تنظیم، جایگزین تمام یادآوریهای موجود برای رویداد میشود. |
addedAttachments[] | اختیاری. فایلهای پیوست برای افزودن به رویداد. |
removedAttachmentFileUrls[] | اختیاری. فایلهای پیوست را برای حذف از رویداد وارد کنید. |
فیلد یونیون | |
calendarId | اختیاری. شناسه تقویم حاوی رویداد. آدرس ایمیل - میتواند با استفاده از |
فیلد اتحادیه | |
summary | اختیاری. عنوان جدید. |
فیلد اتحادیه | |
description | اختیاری. توضیحات جدید. میتواند شامل HTML باشد. |
میدان اتحادیه | |
location | اختیاری. مکان جدید. |
فیلد اتحادیه | |
startTime | اختیاری. زمان شروع جدید (ISO 8601). اگر بهروزرسانی فقط شروع را در نظر بگیرد، مدت زمان را حفظ میکند. |
فیلد اتحادیه | |
endTime | اختیاری. زمان پایان جدید (ISO 8601). |
میدان یونیون | |
allDay | اختیاری. رویداد را به تمام روز تغییر میدهد. در صورت تنظیم، |
فیلد اتحادیه | |
timeZone | اختیاری. نام پایگاه داده منطقه زمانی IANA (برای مثال، |
فیلد اتحادیه | |
notificationLevel | اختیاری. ارسال ایمیل اطلاع رسانی برای این بروزرسانی رویداد. پیشفرض: |
فیلد یونیون | |
addGoogleMeetUrl | اختیاری. اگر درست باشد، یک نشانی وب Google Meet برای رویداد ایجاد یا بهروزرسانی میکند. در صورت غیرفعال بودن Meet، نادیده گرفته میشود. |
میدان اتحادیه | |
visibility | اختیاری. نمایش جدید رویداد. مقادیر ممکن عبارتند از:
|
فیلد یونیون | |
colorId | اختیاری. رنگ جدید رویداد. برای فهرستی از شناسههای رنگ، به مستندات منبع رویداد مراجعه کنید. |
فیلد یونیون | |
googleMeetUrl | اختیاری. امکان پیوست کردن یک URL یا شناسه جلسه موجود در Google Meet را به رویداد فراهم میکند. مقدار |
فیلد مشترک | |
guestPermissions | اختیاری. تنظیمات مجوز مهمان برای این رویداد. |
فیلد اتحادیه | |
availability | اختیاری. اینکه آیا رویداد، زمان را در تقویم مسدود میکند یا خیر. |
شرکت کننده
| نمایش JSON |
|---|
{ "id": string "email": string "displayName": string "organizer": boolean "self": boolean "resource": boolean "optionalAttendee": boolean "responseStatus": string "comment": string "additionalGuests": integer } |
| فیلدها | |
|---|---|
فیلد یونیون | |
id | فقط خروجی. شناسه پروفایل. |
فیلد اتحادیه | |
email | الزامی. آدرس ایمیل شرکتکننده. |
فیلد متحد | |
displayName | اختیاری. نام. |
میدان اتحادیه | |
organizer | فقط خروجی. اینکه آیا شرکتکننده، برگزارکننده است یا خیر. پیشفرض: |
میدان اتحادیه | |
self | فقط خروجی. اینکه آیا این ورودی، تقویمی را نشان میدهد که این کپی از رویداد در آن نمایش داده میشود یا خیر. پیشفرض: |
فیلد اتحادیه | |
resource | اختیاری. اینکه آیا شرکتکننده یک منبع است یا خیر (مثلاً اتاق). تغییرناپذیر، فقط زمانی که شرکتکننده برای اولین بار اضافه میشود، قابل تنظیم است. پیشفرض: |
فیلد اتحادیه | |
optionalAttendee | اختیاری. اینکه آیا شرکتکننده اختیاری است یا خیر. پیشفرض: |
| |
responseStatus | اختیاری. وضعیت پاسخ. مقادیر ممکن عبارتند از:
|
فیلد اتحادیه | |
comment | فقط خروجی. نظر پاسخ. |
| |
additionalGuests | اختیاری. تعداد مهمانان اضافی. پیشفرض: |
یادآوری
| نمایش JSON |
|---|
{ "method": string "minutes": integer } |
| فیلدها | |
|---|---|
| |
method | الزامی. روش تحویل. مقادیر ممکن عبارتند از:
|
فیلد اتحادیه | |
minutes | الزامی. چند دقیقه قبل از فعال شدن یادآوری. |
پیوست
| نمایش JSON |
|---|
{ "fileUrl": string "title": string } |
| فیلدها | |
|---|---|
فیلد یونیون | |
fileUrl | الزامی. لینک به پیوست. |
فیلد اتحادیه | |
title | اختیاری. عنوان پیوست. |
مجوزهای مهمان
| نمایش JSON |
|---|
{ "guestsCanInviteOthers": boolean "guestsCanModify": boolean "guestsCanSeeGuests": boolean } |
| فیلدها | |
|---|---|
فیلد اتحادیه | |
guestsCanInviteOthers | اختیاری. اینکه آیا مهمانان میتوانند دیگران را دعوت کنند یا خیر. |
فیلد اتحادیه | |
guestsCanModify | اختیاری. اینکه آیا مهمانان میتوانند رویداد را تغییر دهند یا خیر. |
| |
guestsCanSeeGuests | اختیاری. اینکه آیا مهمانان میتوانند مهمانان دیگر را ببینند یا خیر. |
سطح اعلان
سطح اطلاع رسانی ایمیل برای به روز رسانی ها.
| انومها | |
|---|---|
NOTIFICATION_LEVEL_UNSPECIFIED | پیشفرض. به عنوان ALL در نظر گرفته میشود. |
NONE | بدون اعلان. |
EXTERNAL_ONLY | فقط شرکتکنندگان خارجی. |
ALL | همه حاضرین. |
در دسترس بودن
تنظیم در دسترس بودن برای یک رویداد.
| انومها | |
|---|---|
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 ( |
| فیلدها | |
|---|---|
id | شناسه منحصر به فرد. |
status | اختیاری. وضعیت. مقادیر ممکن عبارتند از:
|
htmlLink | فقط خروجی. پیوند مطلق به این رویداد در رابط کاربری وب تقویم گوگل. |
created | فقط خروجی. زمان ایجاد (ISO 8601). |
updated | فقط خروجی. آخرین زمان اصلاح (ISO 8601). |
summary | عنوان. |
description | اختیاری. توضیحات. میتواند شامل HTML باشد. |
location | اختیاری. مکان. |
creator | فقط خروجی. خالق. |
organizer | فقط خروجی. برگزارکننده. در صورت حضور، در فهرست شرکتکنندگان نیز ذکر شده است. |
start | زمان شروع (شامل). برای رویدادهای تکرارشونده، اولین نمونه استفاده میشود. |
end | زمان پایان (منحصراً). برای رویدادهای تکرارشونده، اولین نمونه استفاده میشود. |
recurrence[] | قوانین تکرار به صورت رشتههای |
recurringEventId | شناسه رویداد تکرارشونده والد برای نمونههایی از رویدادهای تکرارشونده. |
originalStartTime | زمان شروع اولیه نمونههای تکرارشونده. این زمانی است که این نمونه طبق دادههای تکرارشونده شروع میشود. |
transparency | اختیاری. منسوخ شده: به جای آن |
visibility | اختیاری. میزان دیده شدن رویداد. مقادیر ممکن عبارتند از:
|
attendees[] | حاضرین. |
conferenceUrl | لینک ویدئو کنفرانس. |
colorId | رنگ رویداد. فقط روی نمای تقویم شما تأثیر میگذارد. این یک شناسه است که به یک ورودی در پالت رنگ تقویم اشاره میکند (رشتههای
|
overrideReminders[] | یادآوریها. در صورت عدم تنظیم، به پیشفرضهای تقویم برمیگردد. |
attachments[] | پیوستهای فایل. |
guestPermissions | مجوزهای مهمان. |
eventType | نوع رویداد. |
workingLocationProperties | ویژگیهای مکان کار. فقط زمانی که |
availability | اختیاری. تنظیمات در دسترس بودن. |
مدیر مدرسه
| نمایش JSON |
|---|
{ "email": string, "displayName": string, "self": boolean } |
| فیلدها | |
|---|---|
email | ایمیل. |
displayName | نام. |
self | فقط خروجی. اینکه آیا این پارامتر اصلی با تقویمی که این کپی از رویداد در آن نمایش داده میشود، مطابقت دارد یا خیر. پیشفرض: |
تاریخ یا تاریخ و زمان
| نمایش JSON |
|---|
{ "date": string, "dateTime": string, "timeZone": string } |
| فیلدها | |
|---|---|
date | تاریخ ISO 8601 در نیمه شب UTC (برای مثال، |
dateTime | مهر زمانی ISO 8601 (برای مثال، |
timeZone | نام منطقه زمانی TZDB. |
شرکت کننده
| نمایش JSON |
|---|
{ "id": string "email": string "displayName": string "organizer": boolean "self": boolean "resource": boolean "optionalAttendee": boolean "responseStatus": string "comment": string "additionalGuests": integer } |
| فیلدها | |
|---|---|
فیلد یونیون | |
id | فقط خروجی. شناسه پروفایل. |
فیلد اتحادیه | |
email | الزامی. آدرس ایمیل شرکتکننده. |
فیلد متحد | |
displayName | اختیاری. نام. |
میدان اتحادیه | |
organizer | فقط خروجی. اینکه آیا شرکتکننده، برگزارکننده است یا خیر. پیشفرض: |
میدان اتحادیه | |
self | فقط خروجی. اینکه آیا این ورودی، تقویمی را نشان میدهد که این کپی از رویداد در آن نمایش داده میشود یا خیر. پیشفرض: |
فیلد اتحادیه | |
resource | اختیاری. اینکه آیا شرکتکننده یک منبع است یا خیر (مثلاً اتاق). تغییرناپذیر، فقط زمانی که شرکتکننده برای اولین بار اضافه میشود، قابل تنظیم است. پیشفرض: |
فیلد اتحادیه | |
optionalAttendee | اختیاری. اینکه آیا شرکتکننده اختیاری است یا خیر. پیشفرض: |
| |
responseStatus | اختیاری. وضعیت پاسخ. مقادیر ممکن عبارتند از:
|
فیلد اتحادیه | |
comment | فقط خروجی. نظر پاسخ. |
| |
additionalGuests | اختیاری. تعداد مهمانان اضافی. پیشفرض: |
یادآوری
| نمایش JSON |
|---|
{ "method": string "minutes": integer } |
| فیلدها | |
|---|---|
| |
method | الزامی. روش تحویل. مقادیر ممکن عبارتند از:
|
فیلد اتحادیه | |
minutes | الزامی. چند دقیقه قبل از فعال شدن یادآوری. |
پیوست
| نمایش JSON |
|---|
{ "fileUrl": string "title": string } |
| فیلدها | |
|---|---|
فیلد یونیون | |
fileUrl | الزامی. لینک به پیوست. |
فیلد اتحادیه | |
title | اختیاری. عنوان پیوست. |
مجوزهای مهمان
| نمایش JSON |
|---|
{ "guestsCanInviteOthers": boolean "guestsCanModify": boolean "guestsCanSeeGuests": boolean } |
| فیلدها | |
|---|---|
فیلد اتحادیه | |
guestsCanInviteOthers | اختیاری. اینکه آیا مهمانان میتوانند دیگران را دعوت کنند یا خیر. |
فیلد اتحادیه | |
guestsCanModify | اختیاری. اینکه آیا مهمانان میتوانند رویداد را تغییر دهند یا خیر. |
| |
guestsCanSeeGuests | اختیاری. اینکه آیا مهمانان میتوانند مهمانان دیگر را ببینند یا خیر. |
ویژگیهای موقعیت مکانی کاری
| نمایش JSON |
|---|
{
"type": enum ( |
| فیلدها | |
|---|---|
فیلد یونیون | |
type | اختیاری. نوع محل کار. |
فیلد یونیون | |
customLocationLabel | اختیاری. برچسب برای یک مکان سفارشی. در صورتی که نوع |
نوع رویداد
نوع رویداد: پس از ایجاد، تغییرناپذیر.
| انومها | |
|---|---|
EVENT_TYPE_UNSPECIFIED | به عنوان DEFAULT در نظر گرفته میشود. |
DEFAULT | رویداد منظم. مقدار پیشفرض. |
OUT_OF_OFFICE | رویداد خارج از دفتر. |
FOCUS_TIME | رویداد زمان تمرکز. |
WORKING_LOCATION | رویداد محل کار. |
BIRTHDAY | رویداد ویژه تمام روز با تکرار سالانه. |
FROM_GMAIL | رویداد از Gmail. این نوع رویداد قابل ایجاد نیست. |
نوع محل کار
نوع محل کار.
| انومها | |
|---|---|
WORKING_LOCATION_TYPE_UNSPECIFIED | نوع محل کار نامشخص. به عنوان HOME_OFFICE در نظر گرفته خواهد شد. |
HOME_OFFICE | دفتر کار خانگی. |
CUSTOM_LOCATION | مکان سفارشی. |
در دسترس بودن
تنظیم در دسترس بودن برای یک رویداد.
| انومها | |
|---|---|
AVAILABILITY_UNSPECIFIED | پیشفرض. به عنوان BUSY در نظر گرفته میشود. |
AVAILABILITY_BUSY | زمان را در تقویم مسدود میکند. |
AVAILABILITY_FREE | زمان را مسدود نمیکند. |
حاشیهنویسی ابزار
راهنمایی مخرب: ❌ | راهنمایی بیاثر: ✅ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/calendar -
https://www.googleapis.com/auth/calendar.events