Google Calendar
كيفية إنشاء حساب خدمة
لأجل هذا، تحتاج إلى إنشاء حسابك الخاص في خدمات Google.
اذهب إلى هذا الرابط وقم بإنشاء مشروع جديد:
فكّر في اسم للمشروع:
اضغط على «إنشاء» وانتظر قليلًا بينما يتم إنشاء المشروع.
أعد تحميل الصفحة ثم اضغط على المشروع الذي تم إنشاؤه للتو. تحقّق في الحقل على اليسار من حالة وصولك - يجب أن تظهر «المالك (1)»:
الآن انتقل إلى إعدادات حساب الخدمة:
هناك تحتاج إلى فتح قسم «حسابات الخدمة» والضغط على «+ إنشاء حساب خدمة»:
أدخل اسم حساب الخدمة وبريده الإلكتروني:
ثم اختر دور المالك:
اضغط على «تم» ثم على «إدارة المفاتيح» في المشروع المختار. ثم اضغط على «إنشاء مفتاح جديد»
اختر نوع المفتاح JSON واضغط على «إنشاء»
بعد إنشاء المفتاح، يتم حفظه تلقائيًا على جهاز الكمبيوتر الخاص بك
ثم تحتاج إلى تنزيله إلى الاستضافة أو إلى Salebot ومشاركة الرابط إليه في معلمات الطلب عبر مشاركة عنوان URL الذي تم الحصول عليه في المعلمة creds_path.
الآن تحتاج أيضًا إلى إضافة تكاملات API الخاصة بنا. للقيام بذلك، اذهب هنا:
ثم تحتاج إلى تفعيل APIs والخدمات والبحث عن Google Calendar API في النافذة المفتوحة:
اضغط على نتيجة البحث ثم على «تفعيل»:
تُكمل هذه الخطوة إنشاء حساب الخدمة الخاص بك.
كيفية تنزيل ملف المفتاح
انتقل إلى المشروع على Salebot وقم بتنزيل ملف المفتاح الذي تم الحصول عليه داخل كتلة، على سبيل المثال، هكذا:
اضغط على «حفظ» وانتقل إلى نافذة الاختبار المجانية:
أدخل العبارة التي ضبطتها كشرط (في هذه الحالة هي «123»). ستحصل على رابط إلى الملف الذي يحتوي على المفاتيح كإجابة:
لا يمكنك حذف الكتلة، وإلا فسيتم حذف الملف من الخادم وسيتعين عليك إضافته مرة أخرى.
لا تنسَ أن تجعل الكتلة من نوع الحالة Not، حتى لا تزعجك.
يمكنك حفظ هذا الرابط في متغيّر أو تمريره كما هو في المعلمة creds_path.
كيفية العثور على معرّف التقويم
يمكنك العثور على معرّف التقويم الموجود في إعداداته في قسم «دمج التقويم»:
كيفية إنشاء تقويم جديد
يمكنك إنشاء تقويم جديد بإحدى طريقتين: يدويًا أو باستخدام دالة.
إنشاء تقويم يدويًا:
حتى تتمكن من إضافة ملاحظات وتعديل تقويم موجود (أو تم إنشاؤه يدويًا)، يجب أن تمنح الوصول لحساب الخدمة. للقيام بذلك، ما عليك سوى إضافة البريد الإلكتروني لحساب الخدمة في إعدادات التقويم المطلوب:
إنشاء التقويم باستخدام دالة
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - 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)، فبعد الطلب الناجح، يلزم الانتقال إلى صندوق البريد الإلكتروني الخاص بك وتأكيد إضافة التقويم إلى حسابك:
كيفية الحصول على معلومات حول التقويم
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - get_calendar; calendar_id - معرّف التقويم المختار
القيم المخزنة
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
رابط example من ردّ الدالة:
{'kind': 'calendar#calendar', 'etag': '"6KN4OTLeoqGGu7Nr5uNIQgCGYsU"', 'id': '[email protected]', 'summary': 'اسم التقويم', 'timeZone': 'UTC'}
كيفية الحصول على قائمة تقاويم حساب الخدمة
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - calendars_list
القيم المخزنة
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
رابط example من ردّ الدالة:
{
'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': [
]
}
]
}
كيفية العمل مع الأحداث
إضافة حدث بسرعة
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - quick_add_event; calendar_id - معرّف التقويم المختار; event_name - اسم الحدث
رابط example من المعلمات:
{"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": "Incredible Event"}
القيم المخزنة
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها. ولتمكين تعديل الحدث الذي تم إنشاؤه لاحقًا، يُنصح بحفظ معرّفه: id -> event_id.
رابط example من ردّ الدالة:
{
'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'
}

كيفية إضافة حدث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - 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. سيتم إضافة وقت الحدث 12pm (tz +2) إلى التقويم على أنه 1pm، لأن 1pm في توقيت كييف يساوي 12pm في المنطقة الزمنية +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": "The greatest event of all time", "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'}
تحرير الحدث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات الإلزامية:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - 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": "Edited event", "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"}
الحصول على قائمة بالأحداث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - get_event_list; calendar_id - معرّف التقويم
إذا لم تمرّر معلمات إضافية، فستكون النتيجة قائمة بأحداث اليوم
معلمات إضافية:
start_date - التاريخ الذي تريد البحث عن الأحداث ابتداءً منه بصيغة DD.MM.YYYY (23.07.2021) end_date - التاريخ الذي تريد البحث عن الأحداث حتى وصولًا إليه بصيغة DD.MM.YYYY (24.07.2021)
مثال على المعلمات:
سيتم العثور على حدث 23 يوليو
{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "get_event_list", "start_date": "22.07.2021", "end_date": "23.07.2021"}
القيم المخزنة من ردّ JSON:
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
يمكن حفظ قائمة الأحداث التي تم العثور عليها في متغير:
items -> event_list
مثال على ردّ الدالة:
{'kind': 'calendar#events', 'etag': '"p33odnesrinsv20g"', 'summary': 'Test', 'description': 'Test description', 'updated': '2021-07-23T12:13:05.686Z', 'timeZone': 'UTC', 'accessRole': 'owner', 'defaultReminders': [], 'items': [{'kind': 'calendar#event', 'etag': '"3254084771372000"', 'id': '6d8rocb9e2r21ue37jgsa0v06i', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=NmQ4cm9jYjllMnIyMXVlMzdqZ3NhMHYwNmkgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T12:11:13.000Z', 'updated': '2021-07-23T12:13:05.686Z', 'summary': 'DDDDDDDDD', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Testov', 'self': True}, 'start': {'date': '2021-07-20'}, 'end': {'date': '2021-07-21'}, 'transparency': 'transparent', 'iCalUID': '[email protected]', 'sequence': 0, 'reminders': {'useDefault': False}, 'eventType': 'default'}]}
كيفية نقل الأحداث إلى تقويم مختلف
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - move_event; calendar_id - معرّف التقويم الذي يُنقل منه الحدث; event_id - معرّف الحدث; destination_calendar_id - معرّف التقويم الذي يُنقل إليه الحدث;
القيم المخزنة من ردّ JSON:
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
مثال على ردّ الدالة:
{'kind': 'calendar#event', 'etag': '"3253880350568000"', 'id': 'ljp7a3ocp8oorbov9u2cq221s0', 'status': 'cancelled', 'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-22T07:43:53.000Z', 'updated': '2021-07-22T07:49:35.284Z', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Тестовый календарь'}, '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'}
كيفية الحصول على معلومات حول الحدث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - get_event; calendar_id - معرّف التقويم; event_id - معرّف الحدث
القيم المخزنة من ردّ JSON:
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
مثال على ردّ الدالة:
{'kind': 'calendar#event', 'etag': '"3254067331414000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T11:12:55.553Z', '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'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}
كيفية حذف حدث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - remove_event; calendar_id - معرّف التقويم; event_id - معرّف الحدث الذي تريد حذفه
القيم المخزنة من ردّ JSON:
بعد التنفيذ الناجح، تُرجع الدالة هذه المعلمات التالية التي يمكنك حفظها وتخزينها.
مثال على ردّ الدالة:
{'status': 'ok'}
كيفية إضافة مشارك إلى الحدث
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - 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'}
كيفية حذف مشارك
عنوان URL للدالة: https://store.salebot.ai/function/gcalendar نوع الطلب: POST-json
المعلمات:
creds_path - رابط مفتاح الوصول لحساب الخدمة إلى واجهة برمجة تطبيقات التقويم (تم الحصول عليه باستخدام التعليمات أعلاه); الأمر - 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 تحتوي على نص الخطأ
إجابة الدالة في حال النجاح:
{'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', 'remove_status': '1'}
Last updated