#إعدادات جوجل

#المتطلبات الأساسية

لتمكين المستخدمين من ربط حسابات بريد جوجل الخاصة بهم بـ NocoBase، يجب نشر NocoBase على خادم يدعم الوصول إلى خدمات جوجل، حيث ستقوم الواجهة الخلفية (backend) باستدعاء Google API.

#تسجيل حساب

1. افتح https://console.cloud.google.com/welcome للانتقال إلى Google Cloud.
2. عند دخولك للمرة الأولى، ستحتاج إلى الموافقة على الشروط والأحكام ذات الصلة.

#إنشاء تطبيق

1. انقر على "Select a project" في الأعلى.

2. انقر على زر "NEW PROJECT" في النافذة المنبثقة.

3. املأ معلومات المشروع.

4. بعد إنشاء المشروع، قم بتحديده.

#تمكين Gmail API

1. انقر على زر "APIs & Services".

2. انتقل إلى لوحة تحكم APIs & Services.

3. ابحث عن "mail".

4. انقر على زر "ENABLE" لتمكين Gmail API.

#تهيئة شاشة موافقة OAuth

1. انقر على قائمة "OAuth consent screen" على اليسار.

2. اختر "External".

3. املأ معلومات المشروع (ستظهر هذه المعلومات في صفحة التفويض لاحقًا) ثم انقر على حفظ.

4. املأ معلومات الاتصال بالمطور (Developer contact information) وانقر على متابعة.

5. انقر على متابعة.

6. أضف مستخدمين اختباريين للاختبار قبل نشر التطبيق.

7. انقر على متابعة.

8. راجع معلومات الملخص ثم عد إلى لوحة التحكم.

#إنشاء بيانات الاعتماد (Credentials)

1. انقر على قائمة "Credentials" على اليسار.

2. انقر على زر "CREATE CREDENTIALS" واختر "OAuth client ID".

3. اختر "Web application".

4. املأ معلومات التطبيق.

5. أدخل نطاق النشر النهائي للمشروع (المثال هنا هو عنوان اختبار NocoBase).

6. أضف عنوان URI لإعادة التوجيه المعتمد. يجب أن يكون على الشكل التالي: النطاق + "/admin/settings/mail/oauth2". مثال: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. انقر على إنشاء لعرض معلومات OAuth.

8. انسخ كلاً من Client ID و Client secret والصقهما في صفحة إعدادات البريد الإلكتروني.

9. انقر على حفظ لإكمال الإعدادات.

#نشر التطبيق

بعد إكمال العملية المذكورة أعلاه واختبار الميزات مثل تسجيل دخول المستخدم التجريبي وتفويض إرسال البريد الإلكتروني، يمكنك نشر التطبيق.

1. انقر على قائمة "OAuth consent screen".

2. انقر على زر "EDIT APP"، ثم انقر على زر "SAVE AND CONTINUE" في الأسفل.

3. انقر على زر "ADD OR REMOVE SCOPES" لتحديد نطاقات أذونات المستخدم.

4. ابحث عن "Gmail API"، ثم حدد "Gmail API" (تأكد أن قيمة النطاق (Scope) هي "https://mail.google.com/" لـ Gmail API).

5. انقر على زر "UPDATE" في الأسفل للحفظ.

6. انقر على زر "SAVE AND CONTINUE" في أسفل كل صفحة، وأخيرًا انقر على زر "BACK TO DASHBOARD" للعودة إلى صفحة لوحة التحكم.

7. بعد النقر على زر "PUBLISH APP"، ستظهر صفحة تأكيد النشر، والتي تسرد المعلومات المطلوبة للنشر. ثم انقر على زر "CONFIRM".

8. عد إلى صفحة وحدة التحكم، وسترى أن حالة النشر هي "In production".

9. انقر على زر "PREPARE FOR VERIFICATION"، املأ المعلومات المطلوبة، ثم انقر على زر "SAVE AND CONTINUE" (البيانات في الصورة هي لأغراض توضيحية فقط).

10. استمر في ملء المعلومات الضرورية ذات الصلة (البيانات في الصورة هي لأغراض توضيحية فقط).

11. انقر على زر "SAVE AND CONTINUE".

12. انقر على زر "SUBMIT FOR VERIFICATION" لتقديم طلب التحقق (Verification).

13. انتظر نتيجة الموافقة.

14. في حال لم تتم الموافقة بعد، يمكن للمستخدمين النقر على الرابط غير الآمن (unsafe link) لتفويض وتسجيل الدخول.