تهيئة Google Console
قبل أن تتمكن وحدة Google Workspace من التواصل مع خدمات Google، تحتاج إلى إنشاء مشروع Google Cloud وتفعيل واجهات API المطلوبة وإنشاء بيانات اعتماد OAuth. يرشدك هذا الدليل خلال كل خطوة.
الخطوة 1: إنشاء مشروع Google Cloud
- انتقل إلى Google API Console.
- انقر على Select a project في شريط التنقل العلوي، ثم انقر على New Project.
- أدخل اسم المشروع (مثال: "Concord CRM Integration").
- انقر على Create وانتظر حتى يتم إنشاء المشروع.
- تأكد من تحديد المشروع الجديد في القائمة المنسدلة للمشاريع.
إذا كان لديك بالفعل مشروع Google Cloud تريد إعادة استخدامه، حدده من قائمة المشاريع بدلاً من إنشاء مشروع جديد.
الخطوة 2: تفعيل واجهات API المطلوبة
مع تحديد مشروعك، فعّل كلاً من واجهات API التالية:
- انتقل إلى APIs & Services → Library.
- ابحث عن كل API وفعّله بشكل فردي:
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
لكل API:
- انقر على اسم API في نتائج البحث.
- انقر على Enable.
- انتظر التأكيد قبل المتابعة إلى التالي.
يجب تفعيل جميع واجهات API الأربع لكي تعمل الوحدة بشكل صحيح. إذا كان أي API مفقوداً، فلن تكون خدمة Google المقابلة متاحة من نظام CRM.
الخطوة 3: تهيئة شاشة موافقة OAuth
- انتقل إلى APIs & Services → OAuth consent screen.
- حدد نوع المستخدم:
- External -- مُوصى به لمعظم الإعدادات. يسمح لأي حساب Google بالتفويض.
- Internal -- متاح فقط لحسابات Google Workspace (المدفوعة). يقيّد الوصول للمستخدمين داخل مؤسستك.
- انقر على Create.
- املأ الحقول المطلوبة:
- App Name -- اسم يراه المستخدمون أثناء التفويض (مثال: "Concord CRM").
- User Support Email -- عنوان بريد الدعم الخاص بك.
- Developer Contact Information -- عنوان بريدك الإلكتروني.
- انقر على Save and Continue خلال خطوات Scopes وTest Users (لا حاجة لتغييرات في الإعداد الأساسي).
- انقر على Back to Dashboard من تبويب الملخص.
حالة النشر
| الحالة | HTTPS مطلوب | ملاحظات |
|---|---|---|
| Testing | لا | محدود بـ 100 مستخدم اختبار؛ يعرض تحذير موافقة إضافي |
| Production | نعم | متاح لجميع المستخدمين؛ يجب أن يستخدم موقعك HTTPS |
للإعداد والاختبار الأولي، أبقِ التطبيق في وضع Testing. بمجرد التحقق من أن كل شيء يعمل، انتقل إلى Production لتجربة تفويض سلسة.
الخطوة 4: إنشاء بيانات اعتماد OAuth
- انتقل إلى APIs & Services → Credentials.
- انقر على Create Credentials → OAuth client ID.
- حدد Web application كنوع التطبيق.
- أدخل اسماً لبيانات الاعتماد (مثال: "Concord CRM OAuth").
- ضمن Authorized redirect URIs، أضف التالي:
https://yourdomain.com/google-workspace/callback
استبدل yourdomain.com بالنطاق الفعلي الذي تم تثبيت Concord CRM عليه.
- انقر على Create.
- سيظهر مربع حوار يعرض Client ID وClient Secret. انسخ كلتا القيمتين.
يجب أن يتطابق عنوان URI لإعادة التوجيه مع عنوان URL لتثبيت Concord CRM بالضبط، بما في ذلك البروتوكول (HTTPS) والمسار. عنوان URI غير صحيح لإعادة التوجيه سيتسبب في فشل التفويض.
الخطوة 5: الاتصال بـ Concord CRM
- سجّل الدخول إلى Concord CRM كمسؤول.
- انتقل إلى إعدادات وحدة Google Workspace.
- الصق Client ID وClient Secret من الخطوة السابقة.
- انقر على Save & Authorize.
- ستظهر شاشة موافقة Google. حدد حساب Google الخاص بك وامنح الأذونات المطلوبة.
- سيتم إعادة توجيهك إلى Concord CRM. يجب أن تعرض حالة الاتصال Authorized.
إذا كان تطبيق Google Cloud في وضع Testing، سترى شاشة تحذير إضافية أثناء التفويض. انقر على Continue للمتابعة. لا يظهر هذا التحذير في وضع Production.
استكشاف الأخطاء
| المشكلة | الحل |
|---|---|
| "Error 400: redirect_uri_mismatch" | تحقق من أن عنوان URI لإعادة التوجيه في Google Cloud يتطابق مع عنوان URL لنظام CRM بالضبط |
| فشل التفويض بصمت | تأكد من تفعيل جميع واجهات API الأربع في مشروع Google Cloud |
| "Access blocked: App not verified" | انتقل إلى وضع Production أو أضف حسابك كمستخدم اختبار |
| انقطاع الاتصال بعد فترة | أعد التفويض من إعدادات الوحدة؛ تحقق من إعدادات تحديث الرمز المميز |
توصيات الأمان
- قيّد بيانات اعتماد OAuth لنطاقك المحدد باستخدام عناوين URI المصرح بها لإعادة التوجيه.
- استخدم HTTPS لتثبيت Concord CRM لحماية رموز OAuth أثناء النقل.
- راجع الوصول إلى API بشكل دوري في Google Cloud Console لضمان عدم منح أذونات غير ضرورية.
- قم بتدوير بيانات الاعتماد إذا كنت تشتبه في تعرضها للاختراق.
إذا كنت بحاجة إلى مساعدة في تهيئة مشروع Google Cloud، قم بزيارة منطقة تذاكر دعم Themesic للحصول على المساعدة.