سكربت Google Apps Script يحمّل أسعار الصرف التي تحتاجها إلى جدول بيانات Google لديك من مصدر تختاره

مثال على النتيجة

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  المجلد: sales/2026-10، عُثر على 9 ملفات
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 صفًا
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 صفًا
2026-11-02 09:14:04 WARN  shop-07.csv: تُخطّيت 3 صفوف بلا سعر (الأسطر 88، 412، 913)
2026-11-02 09:14:05 INFO  تم: 10,412 صفًا -> report-2026-10.xlsx (الورقتان «المبيعات» و«الإجماليات»)

[columns]
date = التاريخ, تاريخ البيع, اليوم
product = المنتج, الصنف, الاسم
quantity = الكمية, العدد, قطع
price = السعر, سعر الوحدة

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """يقرأ ملف متجر واحد ويمنح أعمدته أسماء أعمدة التقرير."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: لا يوجد عمود لـ «{name}» (جرى البحث عن: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

عن هذه الخدمة

إن كانت أسعارك أو فواتيرك أو تقاريرك تعتمد على أسعار الصرف، فمن السهل أن تنسى كتابتها كل صباح. يقرأ سكربت Google Apps Script هذا الأسعار من مصدر عام تختاره، مثل الأسعار التي ينشرها البنك المركزي في بلدك أو خدمة أسعار تحصل فيها على مفتاحك الخاص، ويكتب العملات التي تحتاجها في جدول بيانات Google لديك مع التاريخ. بدءًا من الباقة القياسية يحتفظ بتبويب للسجل التاريخي بصف لكل يوم، لتتمكن معادلاتك من البحث عن السعر في أي تاريخ؛ وتضيف الباقة المميزة مصدرًا ثانيًا إن لم يستجب الأول، وتملأ التواريخ السابقة. تتضمن جداول بيانات Google دالتها الخاصة GOOGLEFINANCE لبعض العملات؛ أما هذا السكربت فلحين تحتاج إلى مصدر معين أو سجل تاريخي محفوظ. الأسعار أسعار المصدر؛ ولا نقدم نصائح مالية.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم كود Apps Script وملف README يوضح كيفية إضافته إلى جدولك ومنح الصلاحيات وضبطه للعمل يوميًا؛ ويُعرض الكود أيضًا في صفحة الطلب.
• مصدركالأسعار الرسمية أو أسعار الخدمة التي تختارها
• عملاتكالتي تحتاجها فقط، مقابل عملتك الأساسية
• سجل تاريخي مؤرخبدءًا من الباقة القياسية، صف لكل يوم للبحث
• المفتاح خارج الكودإن احتاج المصدر إلى مفتاح، تضعه بنفسك
• كود مقروءمع تعليقات، ليسهل إضافة عملة لاحقًا

كيف يعمل

1. 1
   المصدرتحدد العملات والمصدر الذي تثق به
2. 2
   الكودنكتب السكربت وفق وثائق المصدر ودليل التثبيت
3. 3
   جرّبهتشغّله في نسخة من الجدول وتقارن بموقع المصدر
4. 4
   التعديلاتتطلب التعديلات ضمن باقتك وترسل أي رسالة خطأ

ما نحتاجه منك

العملات التي تحتاجها وعملتك الأساسية، والمصدر الذي تريد استخدامه (رابط إلى الصفحة أو الوثائق التي ينشر فيها الأسعار، أو دعنا نقترح مصادر عامة لتختار منها)، وكم مرة تحتاج إلى الأسعار وفي أي وقت، وأين توضع في جدولك. إن كنت تحتاج إلى تواريخ سابقة (الباقة المميزة)، فمنذ أي تاريخ. إن طلب المصدر مفتاحًا، فأنشئه في حسابك؛ ولا ترسله إلينا أبدًا.

سنسألك:

• ما العملات التي تحتاجها؟
• أي مصدر يجب أن يستخدم؟
• كم مرة وبحلول متى؟
• هل تحتاج إلى تواريخ سابقة؟

قارن بين الباقات

الأسئلة والأجوبة

لم تجد إجابتك؟ اسألنا