تقويم Google

08-05-2026

في هذه الصفحة

كيفية إنشاء حساب خدمة
كيفية تنزيل ملف المفتاح
كيفية العثور على معرف التقويم
كيفية إنشاء تقويم جديد
كيفية الحصول على معلومات حول التقويم
كيفية الحصول على قائمة تقاويم حساب الخدمة
كيفية العمل مع الأحداث

كيفية إنشاء حساب خدمة

لذلك، تحتاج إلى إنشاء حسابك الخاص في خدمات Google.

انتقل إلى هذا الرابط وأنشئ مشروعًا جديدًا:

فكر في اسم للمشروع:

اضغط على "إنشاء" وانتظر قليلاً حتى يتم إنشاء المشروع.

أعد تحميل الصفحة ثم اضغط على المشروع الذي تم إنشاؤه للتو. تحقق من حالة وصولك في الحقل الموجود على اليسار - يجب أن تظهر "المالك (1)":

انتقل الآن إلى إعدادات حساب الخدمة:

هناك تحتاج إلى فتح قسم "حسابات الخدمة" والضغط على "+ إنشاء حساب خدمة":

أدخل اسم وعنوان البريد الإلكتروني لحساب الخدمة:

ثم اختر دور المالك:

اضغط على "تم" ثم على "إدارة المفاتيح" في المشروع المختار. ثم اضغط على "إنشاء مفتاح جديد":

اختر نوع المفتاح JSON واضغط على "إنشاء":

بعد إنشاء المفتاح، يتم حفظه تلقائيًا على جهاز الكمبيوتر الخاص بك:

ثم تحتاج إلى تنزيله على الاستضافة أو على Mavibot ومشاركة الرابط إليه في معلمات الطلب عن طريق مشاركة عنوان URL الذي تم الحصول عليه في معلمة creds_path.

الآن تحتاج أيضًا إلى إضافة عمليات تكامل API الخاصة بنا. للقيام بذلك، انتقل إلى هنا:

ثم تحتاج إلى تمكين واجهات برمجة التطبيقات والخدمات والبحث عن Google Calendar API في النافذة المفتوحة:

اضغط على نتيجة البحث ثم على "تمكين":

هذه الخطوة تنهي إنشاء حساب الخدمة الخاص بك.

كيفية تنزيل ملف المفتاح

انتقل إلى المشروع على Mavibot وقم بتنزيل ملف المفتاح الذي تم الحصول عليه في كتلة، على سبيل المثال، مثل هذا:

اضغط على "حفظ" وانتقل إلى نافذة الاختبار المجانية:

أدخل العبارة التي قمت بتعيينها كشرط (في هذه الحالة هي "123"). ستحصل على رابط للملف الذي يحتوي على المفاتيح كرد:

لا يمكنك حذف الكتلة، وإلا سيتم حذف الملف من الخادم وسيتعين عليك إضافته مرة أخرى.

لا تنسَ جعل الكتلة من نوع الحالة "ليس"، حتى لا تزعجك.

يمكنك حفظ هذا الرابط في متغير أو نقله في معلمة creds_path كما هو.

كيفية العثور على معرف التقويم

يمكنك العثور على معرف التقويم الحالي في إعداداته في قسم "دمج التقويم":

كيفية إنشاء تقويم جديد

يمكنك إنشاء تقويم جديد بإحدى طريقتين: يدويًا وباستخدام دالة.

إنشاء تقويم يدويًا:

لكي تتمكن من إضافة ملاحظات وتحرير تقويم موجود (أو تم إنشاؤه يدويًا)، يجب عليك منح حق الوصول إلى حساب الخدمة. للقيام بذلك، ما عليك سوى إضافة البريد الإلكتروني لحساب الخدمة في إعدادات التقويم المطلوب:

إنشاء تقويم باستخدام دالة

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - create
name - اسم التقويم
description - وصف التقويم

المعلمات الإضافية:

time_zone - المنطقة الزمنية للتقويم. معرف المنطقة الزمنية IANA. افتراضيًا هو Europe/Moscow (GMT+3)
location - موقع جغرافي للتقويم كنص ذي شكل حر

يمكنك أيضًا منح حق الوصول إلى حساب مختلف، على سبيل المثال، حسابك الرئيسي:

owner_email - البريد الإلكتروني للحساب الذي تتم إضافته كمالك للتقويم

افتراضيًا، سيتم إنشاء التقويم في حساب الخدمة. لتتمكن من تحرير التقويم بصريًا من حسابك الخاص، قم بنقل بريدك الإلكتروني في معلمة owner_email.

القيم المخزنة من رد JSON

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها:

{'kind': 'calendar#calendar', 'etag': '"WgASl9FY_5zrEmCZvrt4Qlh6tGQ"', 'id': '[email protected]', 'summary': 'اسم التقويم', 'timeZone': 'UTC'}

لنقم بتخزين معرف التقويم الذي تم إنشاؤه: id -> calendar_id

للاختبار، يمكنك عرض المتغير #{custom_answer}.

إذا تم نقل البريد الإلكتروني (owner_email)، فبعد الطلب الناجح، يجب الانتقال إلى صندوق البريد الإلكتروني الخاص بك وتأكيد إضافة التقويم إلى حسابك:

كيفية الحصول على معلومات حول التقويم

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - get_calendar;
calendar_id - معرف التقويم المختار

القيم المخزنة

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.

مثال لرد الدالة:

{'kind': 'calendar#calendar', 'etag': '"6KN4OTLeoqGGu7Nr5uNIQgCGYsU"', 'id': '[email protected]', 'summary': 'اسم التقويم', 'timeZone': 'UTC'}

كيفية الحصول على قائمة تقاويم حساب الخدمة

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - calendars_list

القيم المخزنة

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.

مثال لرد الدالة:

{
'kind': 'calendar#calendarList',
'etag': '"p32o8pm47rfqf20g"',
'nextSyncToken': 'CLCM2Ifb9PECEi5nc2hlZXRzQGdzaGVldHMtMjU0NzEzLmlhbS5nc2VydmljZWFjY291bnQuY29t',
'items': [
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235372775000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '17',
'backgroundColor': '#9a9cff',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
},
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235805096000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '21',
'backgroundColor': '#cca6ac',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
}
]
}

كيفية العمل مع الأحداث

إضافة حدث بسرعة

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - quick_add_event;
calendar_id - معرف التقويم المختار؛
event_name - اسم الحدث

مثال للمعلمات:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "quick_add_event","event_name": "حدث لا يصدق"}

القيم المخزنة

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها. لتتمكن من تحرير الحدث الذي تم إنشاؤه لاحقًا، يوصى بحفظ معرفه: id -> event_id.

مثال لرد الدالة:

{
'kind': 'calendar#event',
'etag': '"3253879667088000"',
'id': 'ljp7a3ocp8oorbov9u2cq221s0',
'status': 'confirmed',
'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw',
'created': '2021-07-22T07:43:53.000Z',
'updated': '2021-07-22T07:43:53.544Z',
'creator': {'email': '[email protected]'},
'organizer': {'email': '[email protected]',
'displayName': 'Testov',
'self': True},
'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'},
'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'},
'iCalUID': '[email protected]',
'sequence': 0,
'reminders': {'useDefault': True},
'eventType': 'default'
}

كيفية إضافة حدث

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - add_event
calendar_id - معرف التقويم المختار
event_name - اسم الحدث

تحتاج أيضًا إلى تعيين أحد خياري المعلمات: التاريخ أو التاريخ والوقت.

إذا كان الحدث يستمر طوال اليوم، فأنت بحاجة إلى تحديد التواريخ:

start_date - تاريخ بدء الحدث بتنسيق DD.MM.YYYY (مثال: 23.07.2010)
end_date - تاريخ انتهاء الحدث بتنسيق DD.MM.YYYY (مثال: 24.07.2010)

إذا كان الحدث يحدث في وقت محدد، فأنت بحاجة إلى تحديد التاريخ والوقت:

start_datetime - تاريخ ووقت بدء الحدث بتنسيق DD.MM.YYYY HH:MM (مثال: 23.07.2010 12:00)
end_datetime - تاريخ ووقت انتهاء الحدث بتنسيق DD.MM.YYYY HH:MM (مثال: 23.07.2010 13:00)
time_zone - المنطقة الزمنية للحدث. معرف المنطقة الزمنية IANA. افتراضيًا، هو Europe/Moscow (GMT+3)

إذا كانت المناطق الزمنية للتقويم والحدث مختلفة، فسيتم إضافة الحدث مع الوقت إلى المنطقة الزمنية للتقويم.

مثال:

التقويم في المنطقة الزمنية (tz) Europe/Kyiv +3، ويتم إضافة الحدث مع المنطقة الزمنية Europe/Berlin +2. سيتم إضافة وقت الحدث 12 ظهرًا (tz +2) إلى التقويم كـ 1 مساءً، لأنه في توقيت كييف، 1 مساءً هو 12 ظهرًا في المنطقة الزمنية +2.

المعلمات الإضافية:

event_description - وصف الحدث
location - الموقع الجغرافي للحدث كنص ذي شكل حر
email_minutes - الوقت بالدقائق قبل الحدث لإرسال إشعار إلى البريد الإلكتروني للمشاركين
popup_minutes - الوقت بالدقائق قبل الحدث لإرسال إشعار للمشاركين كمنبثق

مثال للمعلمات:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "add_event", "event_name": "أعظم حدث على الإطلاق", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00"}

القيم المخزنة من رد JSON:

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.

للتحرير المستقبلي للحدث الذي تم إنشاؤه، يوصى بحفظ معرفه:

id -> event_id

مثال لرد الدالة:

{'kind': 'calendar#event', 'etag': '"3254057128970000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:22:53.109Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Kyiv'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Kyiv'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}

تحرير الحدث

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات الإلزامية:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - update_event;
calendar_id - معرف التقويم؛
event_id - معرف الحدث الذي تحتاج إلى تحريره

المعلمات الاختيارية للتحديث:

يمكنك نقل معلمة واحدة، بالإضافة إلى عدة معلمات.

event_name - اسم الحدث
event_description - وصف الحدث
email_minutes - الوقت بالدقائق قبل الحدث لإرسال إشعار إلى البريد الإلكتروني للمشاركين
popup_minutes - الوقت بالدقائق قبل الحدث لإرسال إشعار للمشاركين كمنبثق

إذا كان الحدث يستمر طوال اليوم، فأنت بحاجة إلى تحديد التواريخ:

start_date - تاريخ بدء الحدث بتنسيق DD.MM.YYYY (مثال: 23.07.2010)
end_date - تاريخ انتهاء الحدث بتنسيق DD.MM.YYYY (مثال: 24.07.2010)

إذا كان الحدث يحدث في وقت محدد، فأنت بحاجة إلى تحديد التاريخ والوقت:

start_datetime - تاريخ ووقت بدء الحدث بتنسيق DD.MM.YYYY HH:MM (مثال: 23.07.2010 12:00)
end_datetime - تاريخ ووقت انتهاء الحدث بتنسيق DD.MM.YYYY HH:MM (مثال: 23.07.2010 13:00)
time_zone - المنطقة الزمنية للحدث. معرف المنطقة الزمنية IANA. افتراضيًا، هو Europe/Moscow (GMT+3)

مثال للمعلمات:

{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "event_id": "j1lcpm4q2p9c0cv705alv3brug", "command": "update_event", "event_name": "حدث محرر", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00","popup_minutes": "11","email_minutes": "22"}

القيم المخزنة من رد JSON:

بعد التنفيذ الناجح، ترجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.

مثال لرد الدالة:

{"kind":"calendar#event","etag":""3276713558524000"","id":"j1lcpm4q2p9c0cv705alv3brug","status":"confirmed","htmlLink":"https://www.google.com/calendar/event?eid=ajFsY3BtNHEycDljMGN2NzA1YWx2M2JydWcgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw","created":"2021-12-01T10:40:11.000Z","updated":"2021-12-01T10:43:16.738Z","summary":"Amazing","creator":{"email":"[email protected]"},"organizer":{"email":"[email protected]","displayName":"Test","self":true},"start":{"dateTime":"2021-12-28T09:00:00Z","timeZone":"Europe/Moscow"},"end":{"dateTime":"2021-12-29T11:00:00Z","timeZone":"Europe/Moscow"},"iCalUID":"[email protected]","sequence":0,"reminders":{"useDefault":false,"overrides":[{"method":"email","minutes":22},{"method":"popup","minutes":12}]},"eventType":"default","update_status":"ok"}

الحصول على قائمة الأحداث

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - get_event_list;
calendar_id - معرف التقويم

إذا لم تقم بنقل معلمات إضافية، فستكون النتيجة قائمة بأحداث اليوم

المعلمات الإضافية:

start_date - التاريخ الذي تريد البحث عن الأحداث منه بتنسيق DD.MM.YYYY (23.07.2021)
end_date - التاريخ الذي تريد البحث عن الأحداث حتى بتنسيق DD.MM.YYYY (24.07.2021)

مثال للمعلمات:

سيتم العثور على الحدث ليوم 23 يوليو

{'status': 'ok'}

كيفية إضافة مشارك إلى حدث

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - add_client;
calendar_id - معرف التقويم؛
event_id - معرف الحدث؛
client_email - البريد الإلكتروني للعميل الذي تريد إضافته

المعلمات الإضافية:

name - اسم الحدث؛
comment - تعليق المشارك

مثال للمعلمات:

{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "add_client",
"event_id": "#{event_id}",
"client_email": "[email protected]",
"name": "John",
"comment": "سأكون الأول!"
}

القيم المخزنة من رد JSON:

ترجع الدالة دائمًا الحالة add_status. يمكن أن تحمل إحدى ثلاث قيم:

ok - تمت إضافة العميل
exist - العميل موجود بالفعل
error - حدث خطأ أثناء عملية الإضافة، ثم بالإضافة إلى add_status سيكون هناك معلمة error_message مع نص الخطأ

مثال لرد الدالة في حالة النجاح:

{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', 'add_status': 'ok'}

كيفية حذف مشارك

رابط الدالة: https://store.salebot.ai/function/gcalendar
نوع الطلب: POST-json

المعلمات:

creds_path - رابط مفتاح الوصول لحساب الخدمة إلى API التقويم (تم الحصول عليه باستخدام التعليمات أعلاه)؛
command - remove_client;
calendar_id - معرف التقويم؛
event_id - معرف الحدث؛
client_email - البريد الإلكتروني للعميل

مثال للمعلمات:

{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "remove_client",
"event_id": "#{event_id}",
"client_email": "[email protected]"
}

القيم المخزنة من رد JSON:

ترجع الدالة دائمًا الحالة remove_status. يمكن أن تحمل إحدى ثلاث قيم:

1 - تمت إزالة العميل بنجاح
0 - لم يتم العثور على العميل
error - خطأ أثناء عملية الإزالة، ثم بالإضافة إلى remove_status سيكون هناك معلمة error_message مع نص الخطأ