MCP Tools Reference: calendarmcp.googleapis.com

الأداة: create_event

تنشئ هذه الطريقة حدثًا في التقويم المحدّد.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة create_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": "create_event",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب رسالة لـ CreateEvent

CreateEventRequest

تمثيل JSON 
{
  "summary": string,
  "startTime": string,
  "endTime": string,
  "attendeeEmails": [
    string
  ],
  "attendees": [
    {
      object (Attendee)
    }
  ],
  "recurrenceData": [
    string
  ],
  "overrideReminders": [
    {
      object (Reminder)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ],

  "calendarId": string

  "description": string

  "location": string

  "allDay": boolean

  "timeZone": string

  "notificationLevel": enum (NotificationLevel)

  "addGoogleMeetUrl": boolean

  "visibility": string

  "colorId": string

  "googleMeetUrl": string

  "guestPermissions": {
    object (GuestPermissions)
  }

  "availability": enum (Availability)

  "eventType": enum (EventType)

  "workingLocationProperties": {
    object (WorkingLocationProperties)
  }
}
الحقول
summary

string

الحقل مطلوب. العنوان
startTime

string

الحقل مطلوب. وقت البدء (ISO 8601، على سبيل المثال '2026-04-30T10:00:00Z')
endTime

string

الحقل مطلوب. وقت الانتهاء (ISO 8601، على سبيل المثال '2026-04-30T11:00:00Z')
attendeeEmails[]
(deprecated)

string

اختياريّ. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة attendees بدلاً منها.
attendees[]

object (Attendee)

اختياريّ. تمثّل هذه السمة المشاركين في الحدث. بالنسبة إلى الأحداث التي يتم إنشاؤها في التقويم الأساسي للمستخدم مع ضيف واحد على الأقل، ستتم إضافة المستخدم الحالي تلقائيًا كضيف إذا لم يكن مضمّنًا من قبل.
recurrenceData[]

string

اختياريّ. قواعد التكرار كسلاسل RRULE أو RDATE أو EXDATE (وفقًا لمعيار RFC 5545)
overrideReminders[]

object (Reminder)

اختياريّ. تتجاوز التذكيرات الإعدادات التلقائية للتقويم.
attachments[]

object (Attachment)

اختياريّ. الملفات المرفقة

حقل الربط _calendar_id

يمكن أن يكون التعليق _calendar_id إحدى القيم التالية فقط:
calendarId

string

اختياريّ. رقم تعريف التقويم الذي سيتم إنشاء الحدث فيه عنوان البريد الإلكتروني: يمكن حله باستخدام list_calendars. القيمة التلقائية: التقويم الأساسي.

حقل الربط _description

يمكن أن يكون التعليق _description إحدى القيم التالية فقط:
description

string

اختياريّ. الوصف. يمكن أن يحتوي على HTML.

حقل الربط _location

يمكن أن يكون التعليق _location إحدى القيم التالية فقط:
location

string

اختياريّ. الموقع الجغرافي.

حقل الربط _all_day

يمكن أن يكون التعليق _all_day إحدى القيم التالية فقط:
allDay

boolean

اختياريّ. تُستخدَم لتحديد ما إذا كان الحدث يمتد على مدار اليوم بأكمله. إذا كانت القيمة صحيحة، يتم التعامل مع وقتَي البدء والانتهاء على أنّهما منتصف الليل.

حقل الربط _time_zone

يمكن أن يكون التعليق _time_zone إحدى القيم التالية فقط:
timeZone

string

اختياريّ. اسم قاعدة بيانات المناطق الزمنية التابعة لهيئة IANA (على سبيل المثال، America/Los_Angeles). القيمة التلقائية: المنطقة الزمنية الأساسية للمستخدم. تتجاوز هذه السمة الإزاحات في start_time وend_time.

حقل الربط _notification_level

يمكن أن يكون التعليق _notification_level إحدى القيم التالية فقط:
notificationLevel

enum (NotificationLevel)

اختياريّ. تحديد نوع الإشعار الذي سيتم إرساله عبر البريد الإلكتروني بشأن تعديل هذا الحدث

حقل الربط _add_google_meet_url

يمكن أن يكون التعليق _add_google_meet_url إحدى القيم التالية فقط:
addGoogleMeetUrl

boolean

اختياريّ. إنشاء عنوان URL لاجتماع Google Meet وإضافته القيمة التلقائية: false

حقل الربط _visibility

يمكن أن يكون التعليق _visibility إحدى القيم التالية فقط:
visibility

string

اختياريّ. تمثّل هذه السمة مستوى رؤية الحدث. القيم المحتملة هي:

  • default: يتم استخدام إذن الوصول التلقائي للأحداث في التقويم. القيمة التلقائية
  • public: الحدث علني وتفاصيله مرئية لجميع قارئي التقويم.
  • private - يمكن للمشاركين في الحدث فقط الاطّلاع على تفاصيله.

حقل الربط _color_id

يمكن أن يكون التعليق _color_id إحدى القيم التالية فقط:
colorId

string

اختياريّ. تمثّل هذه السمة لون الحدث. للحصول على قائمة بأرقام تعريف الألوان، يُرجى الرجوع إلى مستندات مورد "الحدث".

حقل الربط _google_meet_url

يمكن أن يكون التعليق _google_meet_url إحدى القيم التالية فقط:
googleMeetUrl

string

اختياريّ. عنوان URL أو معرّف اجتماع محدّد في Google Meet عمليات الإلغاء add_google_meet_url

حقل الربط _guest_permissions

يمكن أن يكون التعليق _guest_permissions إحدى القيم التالية فقط:
guestPermissions

object (GuestPermissions)

اختياريّ. أذونات المدعوين

حقل الربط _availability

يمكن أن يكون التعليق _availability إحدى القيم التالية فقط:
availability

enum (Availability)

اختياريّ. إعدادات مدى التوفّر

حقل الربط _event_type

يمكن أن يكون التعليق _event_type إحدى القيم التالية فقط:
eventType

enum (EventType)

اختياريّ. تمثّل هذه السمة نوع الحدث.

حقل الربط _working_location_properties

يمكن أن يكون التعليق _working_location_properties إحدى القيم التالية فقط:
workingLocationProperties

object (WorkingLocationProperties)

اختياريّ. خصائص مكان العمل (إذا كانت القيمة eventType هي WORKING_LOCATION)

المشارك

تمثيل 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

الحقل مطلوب. عدد الدقائق لعرض التذكير مُقدمًا

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

اختياريّ. ما إذا كان بإمكان المدعوين الاطّلاع على المدعوين الآخرين

مرفق

تمثيل JSON 
{

  "fileUrl": string

  "title": string
}
الحقول

حقل الربط _file_url

يمكن أن يكون التعليق _file_url إحدى القيم التالية فقط:
fileUrl

string

الحقل مطلوب. رابط URL للمرفق

حقل الربط _title

يمكن أن يكون التعليق _title إحدى القيم التالية فقط:
title

string

اختياريّ. عنوان المرفق

WorkingLocationProperties

تمثيل JSON 
{

  "type": enum (WorkingLocationType)

  "customLocationLabel": string
}
الحقول

حقل الربط _type

يمكن أن يكون التعليق _type إحدى القيم التالية فقط:
type

enum (WorkingLocationType)

اختياريّ. تمثّل هذه السمة نوع مكان العمل.

حقل الربط _custom_location_label

يمكن أن يكون التعليق _custom_location_label إحدى القيم التالية فقط:
customLocationLabel

string

اختياريّ. تمثّل هذه السمة تصنيفًا لموقع جغرافي مخصّص. هذه السمة مطلوبة إذا كان النوع CUSTOM_LOCATION.

NotificationLevel

مستوى الإشعارات عبر البريد الإلكتروني بشأن آخر الأخبار

عمليات التعداد
NOTIFICATION_LEVEL_UNSPECIFIED تلقائي: يتم التعامل معها على أنّها ALL.
NONE ليست هناك أي إشعارات.
EXTERNAL_ONLY الضيوف الخارجيون فقط
ALL جميع الضيوف

مدى التوفّر

إعدادات مدى التوفّر لحدث معيّن

عمليات التعداد
AVAILABILITY_UNSPECIFIED تلقائي: يتم التعامل معها على أنّها BUSY.
AVAILABILITY_BUSY يحظر الوقت في التقويم.
AVAILABILITY_FREE لا يحظر الوقت.

EventType

نوع الحدث. لا يمكن تغييره بعد الإنشاء.

عمليات التعداد
EVENT_TYPE_UNSPECIFIED يتم التعامل معها على أنّها DEFAULT.
DEFAULT حدث منتظم القيمة التلقائية
OUT_OF_OFFICE حدث بأنّك خارج المكتب
FOCUS_TIME حدث "وقت التركيز"
WORKING_LOCATION حدث عن مكان العمل
BIRTHDAY حدث خاص يستمر ليوم كامل ويتكرر سنويًا.
FROM_GMAIL حدث من Gmail لا يمكن إنشاء هذا النوع من الأحداث.

WorkingLocationType

تمثّل هذه السمة نوع مكان العمل.

عمليات التعداد
WORKING_LOCATION_TYPE_UNSPECIFIED نوع موقع العمل غير محدَّد. سيتم التعامل معها على أنّها HOME_OFFICE.
HOME_OFFICE المكتب المنزلي
CUSTOM_LOCATION موقع جغرافي مخصّص

مخطط النتائج

الحدث

تمثيل 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"
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 في منتصف الليل بالتوقيت العالمي المنسّق (على سبيل المثال، '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

الحقل مطلوب. رابط URL للمرفق

حقل الربط _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

نوع الحدث. لا يمكن تغييره بعد الإنشاء.

عمليات التعداد
EVENT_TYPE_UNSPECIFIED يتم التعامل معها على أنّها DEFAULT.
DEFAULT حدث منتظم القيمة التلقائية
OUT_OF_OFFICE حدث بأنّك خارج المكتب
FOCUS_TIME حدث "وقت التركيز"
WORKING_LOCATION حدث عن مكان العمل
BIRTHDAY حدث خاص يستمر ليوم كامل ويتكرر سنويًا.
FROM_GMAIL حدث من Gmail لا يمكن إنشاء هذا النوع من الأحداث.

WorkingLocationType

تمثّل هذه السمة نوع مكان العمل.

عمليات التعداد
WORKING_LOCATION_TYPE_UNSPECIFIED نوع موقع العمل غير محدَّد. سيتم التعامل معها على أنّها HOME_OFFICE.
HOME_OFFICE المكتب المنزلي
CUSTOM_LOCATION موقع جغرافي مخصّص

مدى التوفّر

إعدادات مدى التوفّر لحدث معيّن

عمليات التعداد
AVAILABILITY_UNSPECIFIED تلقائي: يتم التعامل معها على أنّها BUSY.
AVAILABILITY_BUSY يحظر الوقت في التقويم.
AVAILABILITY_FREE لا يحظر الوقت.

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

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