سكربت Google Apps Script يحفظ المرفقات من Gmail الخاص بك في مجلدات Google Drive حسب المرسل أو التاريخ أو النوع

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

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

عن هذه الخدمة

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

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم كود Apps Script وملف README يوضح كيفية إضافته إلى حسابك ومنح الصلاحيات وتشغيله؛ ويُعرض الكود أيضًا في صفحة الطلب.
• البريد عبر بحث Gmailمثلًا: from:@supplier.example has:attachment
• مجلدات على طريقتكمجلد واحد، أو حسب المرسل أو الشهر أو النوع
• أسماء ملفات واضحةالتاريخ والمرسل مضافان إلى الاسم
• لا شيء مرتينالبريد المحفوظ يحصل على تصنيف ويُتخطى في المرة التالية
• كود مقروءمع تعليقات، ليسهل إضافة مجلد لاحقًا

كيف يعمل

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

ما نحتاجه منك

البريد المطلوب: المرسلون أو النطاقات، أو كلمات في الموضوع، أو أنواع الملفات، أو نطاق تاريخ، أو بحث Gmail تستخدمه بالفعل. كيف تُرتَّب مجلدات Drive وتُسمّى، وكيف تُسمّى الملفات، وما الذي يُتخطى (صور التواقيع، الملفات الأصغر من حجم معين). العدد التقريبي للرسائل ذات المرفقات حاليًا وكم مرة تصل رسائل جديدة، وهل تستخدم Gmail مجانيًا أم Google Workspace.

سنسألك:

• ما المرفقات التي تحتاجها؟
• كيف يجب ترتيب المجلدات؟
• كيف يجب تسمية الملفات؟
• البريد القديم أيضًا، وكم مرة؟

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

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

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