GOOGLE_SETUP.md

إعداد Google Docs للتصدير المباشر

الخطوات المطلوبة:

1. إنشاء مشروع Google Cloud

1. اذهب إلى Google Cloud Console
2. أنشئ مشروع جديد أو اختر مشروع موجود
3. اكتب اسم المشروع (مثل: "SyncMaster Export")

2. تفعيل Google Docs API

1. في القائمة الجانبية، اذهب إلى "APIs & Services" > "Library"
2. ابحث عن "Google Docs API"
3. اضغط على "Enable"

3. إنشاء بيانات الاعتماد

1. اذهب إلى "APIs & Services" > "Credentials"
2. اضغط على "Create Credentials" > "OAuth 2.0 Client ID"
3. إذا لم تكن قد أعددت شاشة الموافقة، ستحتاج لإعدادها:
   • اختر "External" للمستخدمين العاديين
   • املأ المعلومات المطلوبة (اسم التطبيق، إيميل الدعم)
   • أضف نطاقات Google Docs
4. اختر "Desktop application" كنوع التطبيق
5. اكتب اسم العميل (مثل: "SyncMaster Desktop")
6. اضغط "Create"

4. تحميل ملف بيانات الاعتماد

1. بعد إنشاء بيانات الاعتماد، اضغط على أيقونة التحميل
2. احفظ الملف باسم credentials.json
3. ضع الملف في نفس مجلد التطبيق

5. تشغيل التطبيق

1. شغل التطبيق: streamlit run app.py
2. اضغط على زر "📤 تصدير إلى Google Docs"
3. ستفتح نافذة متصفح للمصادقة مع Google
4. سجل دخول بحساب Google الخاص بك
5. امنح الصلاحيات المطلوبة
6. ارجع للتطبيق وستجد رابط المستند الجديد

ملاحظات مهمة:

• يتم حفظ بيانات المصادقة في ملف token.json لاستخدامها لاحقاً
• لا تشارك ملفات credentials.json أو token.json مع أحد
• يمكنك إلغاء الصلاحيات من إعدادات حساب Google في أي وقت

استكشاف الأخطاء:

• إذا ظهر خطأ "credentials.json not found"، تأكد من وضع الملف في المجلد الصحيح
• إذا فشلت المصادقة، احذف ملف token.json وحاول مرة أخرى
• تأكد من تفعيل Google Docs API في مشروعك