الملحق الإضافي لـ Google Sheets

إضافة Stock Events لـ Google Sheets تجيب بيانات محفظتك مباشرة إلى Sheets. تقدر تشوف أسعار الأسهم الحية، مؤشرات الأرباح، محتويات المحفظة، وتفاصيل كل مركز — وكل شيء يتحدث تلقائيًا في جدولك.

تثبيت الإضافة

1. افتح التطبيق في المتجر
2. اضغط على "إضافة" للتثبيت.
3. بعد التثبيت، راح يظهر زر Stock Events في تبويب الإضافات في شريط أدوات Google Sheets.

تسجيل الدخول

الإضافة تستخدم طريقة تسجيل دخول عبر الجهاز. تسجل الدخول من المتصفح، والإضافة تلتقط الجلسة تلقائيًا.

1. اضغط على زر Stock Events في تبويب الصفحة الرئيسية لفتح لوحة المهام.
2. اضغط على تسجيل الدخول. راح يفتح لك نافذة متصفح.
3. سجل الدخول بحسابك في Stock Events من المتصفح. إذا كنت مسجل دخول مسبقًا، راح يتم الاتصال تلقائيًا.
4. ارجع إلى Sheets. راح تتحدث لوحة المهام وتعرض اسم المستخدم وقائمة محافظك.

تحتاج تسجل الدخول مرة واحدة فقط. الجلسة تبقى فعالة إلى أن تسجل خروجك أو تنتهي اشتراكك في Pro.

تسجيل الخروج

اضغط على تسجيل الخروج أسفل لوحة المهام. كل الدوال راح تتوقف عن عرض البيانات وتظهر #LOGIN! إلى أن تسجل الدخول مرة ثانية.

استخدام الدوال

كل الدوال تستخدم نطاق STOCKEVENTS. اكتب =STOCKEVENTS. في أي خلية وSheets راح يعرض لك كل الدوال المتاحة.

بيانات السوق

هذه الدوال تأخذ رمز السهم كمدخل.

=STOCKEVENTS_STOCK_PRICE("AAPL")
ترجع السعر الحالي للسهم.

=STOCKEVENTS_STOCK_CHANGE("AAPL")
ترجع نسبة التغير خلال 24 ساعة.

=STOCKEVENTS_STOCK_DIVIDEND_YIELD("AAPL")
ترجع عائد الأرباح السنوي.

=STOCKEVENTS_STOCK_NAME("AAPL")
ترجع الاسم الكامل للشركة (مثلاً: "Apple Inc.").

الأرباح

هذه الدوال تأخذ اسم المحفظة كمدخل وترجع مؤشرات الأرباح لتلك المحفظة.

=STOCKEVENTS_DIVIDENDS_INCOME("Watchlist")
ترجع إجمالي الدخل السنوي المتوقع من الأرباح.

=STOCKEVENTS_DIVIDENDS_YIELD("Watchlist")
ترجع العائد الحالي الموزون لكل المراكز.

=STOCKEVENTS_DIVIDENDS_YIELD_ON_COST("Watchlist")
ترجع العائد بناءً على متوسط سعر الشراء.

المقتنيات

هذه الدوال تأخذ اسم المحفظة كمدخل وترجع بيانات إجمالية للمحفظة.

=STOCKEVENTS_HOLDINGS_VALUE("Watchlist")
ترجع القيمة السوقية الحالية لكل المراكز.

=STOCKEVENTS_HOLDINGS_GAIN("Watchlisto")
ترجع إجمالي الأرباح أو الخسائر غير المحققة.

=STOCKEVENTS_HOLDINGS_LIST("Watchlist")
ترجع قائمة عمودية بكل رموز الأسهم في المحفظة. هذه مصفوفة ديناميكية — تمتد تلقائيًا للخلايا تحتها.

المراكز

هذه الدوال تأخذ رمز السهم واسم المحفظة، وترجع بيانات عن هذا المركز بالتحديد.

=STOCKEVENTS_POSITION_VALUE("AAPL"; "Watchlist")
ترجع القيمة السوقية الحالية للمركز.

=STOCKEVENTS_POSITION_SHARES("AAPL"; "Watchlist")
ترجع عدد الأسهم المملوكة.

=STOCKEVENTS_POSITION_GAIN("AAPL"; "Watchlist")
ترجع الأرباح أو الخسائر غير المحققة للمركز.

=STOCKEVENTS_POSITION_AVG_COST("AAPL"; "Watchlist")
ترجع متوسط سعر الشراء للسهم الواحد.

أسماء المحافظ

استخدم اسم المحفظة بالضبط كما يظهر في تطبيق Stock Events. بعد تسجيل الدخول، راح تعرض لوحة المهام كل محافظك — استخدم هذه الأسماء في الصيغ.

لجمع كل محافظك معًا، استخدم "Combined" كاسم المحفظة:

=STOCKEVENTS_HOLDINGS_VALUE("Combined")

الأخطاء

إذا ما قدرت الدالة ترجع بيانات، راح تظهر أحد القيم التالية:

LOGIN!
أنت غير مسجل الدخول. افتح لوحة المهام واضغط تسجيل الدخول.

INVALID_TICKER
رمز السهم غير معروف. تأكد من التهجئة واستخدم الرمز الصحيح للسوق.

PORTFOLIO_NOT_FOUND
ما في محفظة تطابق الاسم المدخل. افتح لوحة المهام لتشوف أسماء محافظك بالضبط.

ERROR!
حدثت مشكلة مؤقتة. الدالة راح تحاول مرة ثانية في التحديث القادم.

نصائح

• تقدر تشير إلى قيم خلايا بدل ما تكتب الرموز يدويًا. مثلاً، إذا الخلية A1 فيها "AAPL"، استخدم =STOCKEVENTS_STOCK_PRICE(A1).
• استخدم HOLDINGS_LIST لعرض كل رموزك في عمود، وبجانبها STOCK_PRICE أو POSITION_VALUE لبناء لوحة تحكم حية.

تحتاج مساعدة؟

إذا واجهت أي مشكلة، تواصل معنا على support@stockevents.app.