سكربت Google Apps Script ينسخ السجلات بين قاعدة Airtable لديك وجدول بيانات 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

عن هذه الخدمة

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

ما المشمول

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

كيف يعمل

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

ما نحتاجه منك

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

سنسألك:

• ما الذي في قاعدة Airtable؟
• أي اتجاه تحتاج؟
• ما الحقول التي يجب نقلها؟
• كم مرة يجب أن يعمل؟

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

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

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