سكربت Google Apps Script يحمّل البيانات من API خدمة ما إلى جدول بيانات 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

عن هذه الخدمة

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

ما المشمول

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

كيف يعمل

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

ما نحتاجه منك

الخدمة ورابط إلى وثائق الـ API الخاصة بها، والطلب الذي تحتاجه (مثلًا الطلبات خلال آخر 30 يومًا)، والحقول التي يجب أن تصبح أعمدة. مثال على رد الـ API يساعد كثيرًا: انسخه من الوثائق أو من استدعاء تجريبي بعد إزالة القيم الخاصة. كم مرة يجب تحديث البيانات، وهل تُضاف صفوف جديدة أم يُعاد كتابة الجدول. لا ترسل أبدًا مفتاح API الحقيقي: يوضح ملف README مكان وضعه.

سنسألك:

• أي خدمة، وأين وثائق الـ API الخاصة بها؟
• ما البيانات التي تحتاجها؟
• كم مرة يجب أن يتحدّث؟

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

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

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