View source for GitHub - Google Apps Script Projects

```wiki
== GitHub - مشاريع Google Apps Script ==

'''مقدمة'''

Google Apps Script (GAS) هو لغة برمجة سكريبت تعتمد على JavaScript، تسمح لك بأتمتة المهام و توسيع وظائف تطبيقات Google Workspace (مثل Google Sheets، Google Docs، Google Forms، Gmail، وغيرها).  قد تجد نفسك بحاجة إلى مشاركة مشاريع GAS الخاصة بك مع الآخرين، أو التعاون في مشاريع أكبر، أو الاحتفاظ بنسخ احتياطية آمنة وشاملة. هنا يأتي دور GitHub.  GitHub هو منصة استضافة للتحكم في الإصدار باستخدام Git، ويوفر أدوات قوية لإدارة المشاريع والتعاون. يتيح لك GitHub تخزين مشاريع GAS الخاصة بك، وتتبع التغييرات، والعودة إلى الإصدارات السابقة، والعمل مع مطورين آخرين بكفاءة.  هذا المقال موجه للمبتدئين ويهدف إلى شرح كيفية استخدام GitHub مع مشاريع Google Apps Script بالتفصيل.

== لماذا استخدام GitHub مع Google Apps Script؟ ==

هناك العديد من الفوائد لاستخدام GitHub لإدارة مشاريع GAS الخاصة بك:

*   '''التحكم في الإصدار:''' Git، نظام التحكم في الإصدار الذي يعتمد عليه GitHub، يسمح لك بتتبع كل تغيير تقوم به في مشروعك. يمكنك العودة إلى أي إصدار سابق من مشروعك إذا لزم الأمر، مما يقلل من خطر فقدان البيانات أو إفساد الكود.
*   '''التعاون:''' GitHub يسهل التعاون بين المطورين. يمكن لعدة أشخاص العمل على نفس المشروع في نفس الوقت، ودمج التغييرات بسهولة.
*   '''النسخ الاحتياطي:''' GitHub يوفر نسخة احتياطية آمنة من مشروعك. حتى إذا فقدت الكود الخاص بك على جهاز الكمبيوتر الخاص بك، يمكنك استعادته من GitHub.
*   '''إدارة المشاريع:''' GitHub يوفر أدوات لإدارة المشاريع، مثل تتبع المشكلات وإدارة المهام.
*   '''المشاركة:''' يمكنك مشاركة مشروعك مع الآخرين بسهولة، سواء كان ذلك من خلال جعله عامًا أو من خلال دعوة متعاونين محددين.
*   '''التكامل مع أدوات التطوير الأخرى:''' GitHub يتكامل مع العديد من أدوات التطوير الأخرى، مما يسهل عملية التطوير.

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

قبل البدء، تأكد من أن لديك ما يلي:

*   '''حساب GitHub:''' قم بإنشاء حساب مجاني على [https://github.com/ GitHub].
*   '''Git مثبت على جهاز الكمبيوتر الخاص بك:''' قم بتنزيل وتثبيت Git من [https://git-scm.com/downloads Git].
*   '''معرفة أساسية بـ Google Apps Script:''' يجب أن تكون على دراية بكيفية كتابة وتشغيل سكريبتات GAS.
*   '''معرفة أساسية بسطر الأوامر (Command Line):''' بعض العمليات تتطلب استخدام سطر الأوامر.

== الخطوات الأساسية ==

1.  '''إنشاء مستودع GitHub جديد (New Repository):'''
    *   سجل الدخول إلى حسابك على GitHub.
    *   انقر على زر "+" في الزاوية العلوية اليمنى وحدد "New repository".
    *   أدخل اسمًا للمستودع الخاص بك.  اختر اسمًا وصفيًا يعكس طبيعة مشروعك.
    *   أضف وصفًا للمستودع.
    *   اختر ما إذا كان المستودع عامًا (Public) أو خاصًا (Private).  إذا كنت تخطط لمشاركة مشروعك مع الآخرين، فاجعله عامًا. وإلا، فاجعله خاصًا.
    *   تأكد من تحديد "Initialize this repository with a README" (تهيئة هذا المستودع بملف README).
    *   انقر على "Create repository".

2.  '''تنزيل مشروع Google Apps Script الخاص بك:'''
    *   افتح مشروع GAS الخاص بك في محرر سكريبت Google Apps Script.
    *   انقر على "File" (ملف) > "Download" (تنزيل) > "Download project as .zip" (تنزيل المشروع كملف .zip).  سيؤدي ذلك إلى تنزيل ملف ZIP يحتوي على جميع ملفات مشروعك.

3.  '''ربط المستودع المحلي بالمستودع البعيد (GitHub):'''
    *   افتح نافذة سطر الأوامر (Command Prompt أو Terminal) و انتقل إلى الدليل الذي تم فيه تنزيل ملف ZIP الخاص بمشروعك.
    *   فك ضغط ملف ZIP.
    *   داخل الدليل الذي تم فك ضغطه، افتح نافذة سطر الأوامر مرة أخرى.
    *   قم بتهيئة مستودع Git محلي: `git init`
    *   أضف جميع الملفات إلى منطقة التدريج: `git add .`
    *   قم بتثبيت التغييرات: `git commit -m "Initial commit"` (استبدل "Initial commit" برسالة وصفية).
    *   أضف المستودع البعيد (GitHub) كمصدر: `git remote add origin <URL المستودع الخاص بك على GitHub>` (استبدل `<URL المستودع الخاص بك على GitHub>` بعنوان URL الخاص بمستودع GitHub الذي أنشأته).  يمكنك العثور على عنوان URL هذا في صفحة المستودع على GitHub.
    *   ادفع التغييرات إلى المستودع البعيد: `git push -u origin master` (أو `git push -u origin main` إذا كان فرعك الرئيسي يسمى "main"). قد يُطلب منك إدخال اسم المستخدم وكلمة المرور الخاصين بـ GitHub.

4.  '''العمل مع GitHub:'''
    *   الآن، يمكنك إجراء تغييرات على مشروعك محليًا.
    *   بعد إجراء التغييرات، أضفها إلى منطقة التدريج: `git add .`
    *   قم بتثبيت التغييرات: `git commit -m "وصف التغييرات"`
    *   ادفع التغييرات إلى المستودع البعيد: `git push`

== التعامل مع ملفات .gapp و .gs ==

ملفات `.gapp` هي ملفات تعريف المشاريع الخاصة بـ Google Apps Script، وتحتوي على معلومات حول إعدادات المشروع. لا تحتاج عادةً إلى تتبع هذه الملفات في GitHub، لأنها خاصة ببيئة Google Apps Script.  بدلاً من ذلك، يمكنك التركيز على تتبع ملفات `.gs` التي تحتوي على الكود الفعلي.

يمكنك إضافة `.gapp` إلى ملف `.gitignore` لتجاهل هذه الملفات.  لإنشاء ملف `.gitignore`، قم بإنشاء ملف نصي جديد باسم `.gitignore` في الدليل الجذر لمشروعك وأضف السطر التالي:

```
.gapp
```

== استيراد مشروع من GitHub إلى Google Apps Script ==

1.  '''استنساخ المستودع (Clone the Repository):'''
    *   في GitHub، انتقل إلى المستودع الذي تريد استيراده.
    *   انقر على زر "Code" (الكود) وانسخ عنوان URL للمستودع.
    *   افتح نافذة سطر الأوامر وانتقل إلى الدليل الذي تريد استنساخ المستودع إليه.
    *   قم بتشغيل الأمر التالي: `git clone <URL المستودع>`
2.  '''إنشاء مشروع جديد في Google Apps Script:'''
    *   افتح محرر سكريبت Google Apps Script.
    *   انقر على "File" (ملف) > "New" (جديد) > "Project" (مشروع).
3.  '''استيراد ملفات .gs:'''
    *   انسخ جميع ملفات `.gs` من الدليل الذي تم استنساخه إلى محرر سكريبت Google Apps Script.
4.  '''تحديث اسم المشروع:'''
    *   تأكد من أن اسم المشروع في Google Apps Script يتطابق مع اسم المستودع على GitHub.

== استراتيجيات الخيارات الثنائية والتحليل الفني ذات الصلة ==

على الرغم من أن GitHub و Google Apps Script لا يرتبطان بشكل مباشر بالخيارات الثنائية، يمكنك استخدام GAS لأتمتة عمليات التحليل الفني و تنفيذ استراتيجيات تداول الخيارات الثنائية.  إليك بعض المفاهيم والاستراتيجيات ذات الصلة:

*   '''تحليل الاتجاه (Trend Analysis):''' استخدم GAS لتحليل بيانات الأسعار وتحديد اتجاهات السوق.
*   '''مؤشر المتوسط المتحرك (Moving Average):''' قم ببرمجة مؤشر المتوسط المتحرك في GAS لتحديد نقاط الدخول والخروج المحتملة.
*   '''مؤشر القوة النسبية (RSI):''' استخدم GAS لحساب مؤشر القوة النسبية وتحديد مناطق ذروة الشراء والبيع.
*   '''استراتيجية الاختراق (Breakout Strategy):''' قم بأتمتة استراتيجية الاختراق باستخدام GAS.
*   '''استراتيجية الارتداد (Bounce Strategy):'''  استخدم GAS لتحديد فرص الارتداد.
*   '''تحليل حجم التداول (Volume Analysis):''' حلل حجم التداول باستخدام GAS لتأكيد الاتجاهات.
*   '''أنماط الشموع اليابانية (Candlestick Patterns):'''  قم ببرمجة GAS للتعرف على أنماط الشموع اليابانية.
*   '''استراتيجية مارتينجال (Martingale Strategy):''' (تحذير: استراتيجية عالية المخاطر) قم بتنفيذ استراتيجية مارتينجال باستخدام GAS (مع الانتباه إلى المخاطر).
*   '''استراتيجية فيبوناتشي (Fibonacci Strategy):''' استخدم GAS لرسم مستويات فيبوناتشي وتحديد نقاط الدعم والمقاومة.
*   '''استراتيجية بولينجر باندز (Bollinger Bands Strategy):''' قم ببرمجة مؤشر بولينجر باندز في GAS.
*   '''التحليل الفني باستخدام البيانات التاريخية (Technical Analysis with Historical Data):'''  استخدم GAS لجلب البيانات التاريخية وتحليلها.
*   '''استراتيجيات التداول الآلي (Automated Trading Strategies):'''  قم بتطوير وتنفيذ استراتيجيات تداول آلية باستخدام GAS (مع الانتباه إلى المخاطر).
*   '''إدارة المخاطر (Risk Management):'''  قم ببرمجة GAS لإدارة المخاطر وتنفيذ أوامر وقف الخسارة وجني الأرباح.
*   '''تحليل الارتباط (Correlation Analysis):'''  استخدم GAS لتحليل الارتباط بين الأصول المختلفة.
*   '''استراتيجية التداول المتأرجح (Swing Trading Strategy):'''  قم بأتمتة استراتيجية التداول المتأرجح.
*   '''استراتيجية التداول اليومي (Day Trading Strategy):'''  استخدم GAS لتنفيذ استراتيجية التداول اليومي.
*   '''مؤشر MACD (Moving Average Convergence Divergence):''' قم ببرمجة مؤشر MACD في GAS.
*   '''مؤشر ستوكاستيك (Stochastic Oscillator):''' استخدم GAS لحساب مؤشر ستوكاستيك.
*   '''استراتيجية التداول بناءً على الأخبار (News-Based Trading Strategy):''' استخدم GAS لجلب الأخبار وتحليلها لاتخاذ قرارات التداول.
*   '''التحليل الأساسي (Fundamental Analysis):'''  استخدم GAS لجمع وتحليل البيانات الأساسية.
*   '''استراتيجية التداول العكسي (Reversal Trading Strategy):'''  استخدم GAS لتحديد فرص التداول العكسي.
*   '''استراتيجية التداول القصير الأجل (Short-Term Trading Strategy):'''  قم بأتمتة استراتيجية التداول القصير الأجل.
*   '''استراتيجية التداول الطويل الأجل (Long-Term Trading Strategy):'''  استخدم GAS لتنفيذ استراتيجية التداول الطويل الأجل.
*   '''تحليل العرض والطلب (Supply and Demand Analysis):'''  استخدم GAS لتحليل العرض والطلب في السوق.

'''هام:''' تداول الخيارات الثنائية يحمل مخاطر عالية.  استخدم GAS بحذر وقم دائمًا بإدارة المخاطر بشكل صحيح.  لا تعتمد على GAS لاتخاذ قرارات التداول نيابة عنك.  هذه الاستراتيجيات مقدمة لأغراض تعليمية فقط.

== نصائح إضافية ==

*   '''استخدم ملف README:''' قم بتضمين ملف README في مستودع GitHub الخاص بك لشرح مشروعك وكيفية استخدامه.
*   '''استخدم التعليقات:''' قم بتضمين تعليقات واضحة وموجزة في الكود الخاص بك لتسهيل فهمه.
*   '''التزم بمعايير الترميز:''' اتبع معايير الترميز لضمان أن الكود الخاص بك سهل القراءة والصيانة.
*   '''اختبر الكود الخاص بك:''' اختبر الكود الخاص بك جيدًا قبل نشره للتأكد من أنه يعمل بشكل صحيح.

== الخلاصة ==

باستخدام GitHub مع Google Apps Script، يمكنك إدارة مشاريعك بشكل فعال، والتعاون مع الآخرين، والاحتفاظ بنسخ احتياطية آمنة من الكود الخاص بك.  هذا المقال يوفر لك الأساسيات اللازمة للبدء.  تذكر أن الممارسة هي المفتاح لإتقان هذه الأدوات.  استكشف المزيد من ميزات GitHub و Google Apps Script لتعزيز إنتاجيتك وقدراتك البرمجية.

[[Google Apps Script]]
[[Git]]
[[GitHub]]
[[Google Workspace]]
[[JavaScript]]
[[محرر سكريبت Google Apps Script]]
[[التحكم في الإصدار]]
[[التعاون في البرمجة]]
[[استنساخ المستودع]]
[[ملف README]]
[[الخيارات الثنائية]]
[[التحليل الفني]]
[[تحليل حجم التداول]]
[[مؤشر المتوسط المتحرك]]
[[مؤشر القوة النسبية]]
[[استراتيجية الاختراق]]
[[استراتيجية الارتداد]]
[[أنماط الشموع اليابانية]]
```

== ابدأ التداول الآن ==
[https://affiliate.iqbroker.com/redir/?aff=1085&instrument=options_WIKI سجّل في IQ Option] (الحد الأدنى للإيداع 10 دولار)
[http://redir.forex.pm/pocketo افتح حساباً في Pocket Option] (الحد الأدنى للإيداع 5 دولار)
=== انضم إلى مجتمعنا ===
اشترك في قناة Telegram الخاصة بنا [https://t.me/strategybin @strategybin] لتصلك:
✓ إشارات تداول يومية
✓ تحليلات استراتيجية حصرية
✓ تنبيهات اتجاهات السوق
✓ مواد تعليمية للمبتدئين
[[Category:Google Apps Script]]