تخطَّ إلى المحتوى

التكاملات22‏/10‏/2026مدة القراءة: 4 دقائق

تقويم Google

يتصل Mitra بتقويم Google عبر CalDAV، كما يتصل بأي خادم تقويم آخر. والفرق في تسجيل الدخول: إذ لا يقبل Google كلمة سر، بل يطلب منك منح الإذن على صفحته الخاصة. ولذلك يحتاج Google إلى معرفة خادم Mitra الخاص بك، فيسجّله مسؤول الخادم لدى Google مرة واحدة، ويعطي Mitra معرّف العميل والمفتاح السري اللذين يصدرهما Google.

بعد ذلك، يربط كل من يستخدم Mitra حسابه في Google من داخل التطبيق، ولكل منهم إذنه الخاص. ويتم الإعداد في ثلاث خطوات:

  1. تسجيل Mitra لدى Google.
  2. إعطاء Mitra معرّف العميل والمفتاح السري.
  3. ربط حساب.

تقوم بالخطوتين الأوليين مرة واحدة لكل خادم Mitra.

  1. أنشئ مشروعًا في Google Cloud console، وفعّل CalDAV API من APIs & Services.

  2. اضبط OAuth consent screen. إما أن تضيف نفسك وكل من سيربط حسابًا بصفة test user، أو أن تنشر التطبيق.

  3. أنشئ OAuth client من النوع Web application. وفي authorized redirect URI، أدخل عنوان خادم Mitra متبوعًا بالمسار /api/integrations/google/callback:

    https://mitra.example.com/api/integrations/google/callback
  4. انسخ client ID وclient secret اللذين يعرضهما Google.

CAUTION

ما دامت شاشة الموافقة في وضع الاختبار، ينهي Google كل إذن بعد 7 أيام، ويضطر الجميع إلى ربط حساباتهم من جديد كل أسبوع. انشر التطبيق لتبقى الأذونات سارية دائمًا.

إعطاء Mitra معرّف العميل والمفتاح السري

Section titled “إعطاء Mitra معرّف العميل والمفتاح السري”

اضبطهما كمتغيرات بيئة، مع MITRA_URL، وهو عنوان خادمك:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com'
MITRA_GOOGLE_CLIENT_SECRET: '…'
# …

ثم أعد تشغيل Mitra:

Terminal window
docker compose up -d

اضبط المتغيرين معًا أو لا تضبط أيًّا منهما. إذ يرفض Mitra البدء إذا وُجد معرّف العميل دون المفتاح السري، حتى لا يمرّ إعداد ناقص دون أن تلاحظه.

يجب أن يطابق MITRA_URL العنوان الموجود في عنوان إعادة التوجيه. وبدونه يستخدم Mitra العنوان الذي فتحته منه، وهذا يكفي لتجربته على localhost. ولا يقبل Google لأي عنوان غير localhost إلا عناوين إعادة توجيه تبدأ بالبادئة https://، لذا يحتاج الخادم الفعلي إلى HTTPS وإلى MITRA_URL. وتجد كل المتغيرات في الإعداد.

  1. اختر إضافة تكامل أسفل الشريط الجانبي، ثم تقويم Google.
  2. انقر على المتابعة باستخدام Google. يطلب منك Google اختيار حساب، والسماح لتطبيق Mitra برؤية تقويماتك وتغييرها.
  3. عند العودة إلى Mitra، تظهر تقويمات الحساب كلها مفعّلة. ألغِ تفعيل ما لا تريده منها، ثم انقر على حفظ.

إذا ربطت حساب Google نفسه مرة أخرى، يتجدد إذنه بدلًا من إضافته مرة ثانية.

يحدّ Google من عدد المرات التي يمكن فيها للتطبيقات الاتصال به، لذلك يزامن Mitra حسابات Google مرة واحدة في الدقيقة تقريبًا (راجع طريقة عمل المزامنة).

التقويمات المشتركة معك

Section titled “التقويمات المشتركة معك”

تظهر التقويمات التي تملكها بمجرد الربط. أما التقويمات التي شاركها معك آخرون، مثل تقويم فريق أو زميل، فلا تصل إلى التطبيقات الأخرى إلا بعد أن تسمح بذلك في إعدادات Google:

  1. بعد تسجيل الدخول إلى Google، افتح calendar.google.com/calendar/syncselect.
  2. ضمن Shared Calendars، حدّد كل تقويم تريده في Mitra، ثم انقر على Save.
  3. في Mitra، افتح قائمة ⋯ للحساب في الشريط الجانبي، واختر تعديل، ثم انقر على تحديث.
  4. فعّل التقويمات التي تظهر، ثم انقر على حفظ.

التقويم الذي تمت مشاركته معك بصلاحية See all event details يكون للقراءة فقط في Mitra: ترى كل ما فيه، لكن لا يمكنك إضافة أحداث أو تغييرها أو حذفها. وإذا منحك مالكه لاحقًا صلاحية Make changes to events، يتاح التعديل مع المزامنة التالية. راجع التقويمات للقراءة فقط.

تتم مزامنة كل شيء كما في CalDAV، باستثناء العلاقات بين العناصر، إذ يحذفها Google من نسخته من الحدث، ولذلك لا يتيحها Mitra في تقويمات Google.

المرفقات في تقويم Google هي ملفات Google Drive التي ترفقها في تقويم Google. يعرضها Mitra، ويفتح كلًّا منها في Drive، لكنه لا يستطيع إضافة مرفقات أو إزالتها: إذ لا يحتفظ Google إلا بملفات Drive، ويحذف أي مرفق يضيفه تطبيق آخر.

التوفر الذي تحدده على أنه مشغول في تقويم Google يُضاف إلى ذلك التقويم كأحداث مشغولة، فيرى الآخرون أن ذلك الوقت محجوز. ويعمل كما هو موضح في CalDAV.

الرمز الذي يصدره Google لا يغادر الخادم أبدًا. فمتصفحك يمر فقط عبر صفحة Google لمنح الإذن. ويحتفظ Mitra بالرمز مع الحساب، ويستخدمه للحصول على وصول قصير الأمد كلما أجرى المزامنة.

اختر حذف من قائمة ⋯ للحساب لإزالته مع رمزه من Mitra. ولسحب إذن Mitra من جهة Google أيضًا، أزل Mitra من اتصالات الجهات الخارجية في حسابك على Google. وإذا اكتفيت بذلك فقط، تتوقف المزامنة أيضًا: يبقى الحساب في Mitra، لكن كل مزامنة تفشل حتى تربطه من جديد.

استكشاف الأخطاء وإصلاحها

Section titled “استكشاف الأخطاء وإصلاحها”
  • إذا ظهرت عند اختيار تقويم Google ملاحظة تفيد بأنه غير مضبوط على هذا الخادم بدلًا من زر المتابعة باستخدام Google، فهذا يعني أن MITRA_GOOGLE_CLIENT_ID وMITRA_GOOGLE_CLIENT_SECRET غير مضبوطين، أو أن Mitra لم يُعَد تشغيله منذ ضبطهما.
  • إذا ردّ Google بالخطأ redirect_uri_mismatch، فإن عنوان إعادة التوجيه في Google Cloud console لا يطابق MITRA_URL متبوعًا بالمسار /api/integrations/google/callback. ويجب أن يطابقه تمامًا، بما في ذلك https:// ودون شرطة مائلة في النهاية.
  • إذا توقفت الحسابات عن المزامنة بعد 7 أيام، فشاشة الموافقة لا تزال في وضع الاختبار. انشر التطبيق، ثم اربط الحسابات من جديد.