Google Apps Script: دليل عملي لأتمتة جوجل شيت بمشروع حقيقي

محرر سحابي واحد مجاني، مربوط بكل تطبيقات Workspace: هذا هو الأساس الذي تُبنى عليه سلسلة الـ48 جزءًا كاملةً.

هذا الدليل يأخذك من الصفر إلى أول أتمتة حقيقية تعمل على جوجل شيت — سكربتات فعلية تكتب البيانات، تنسّق الخلايا، تحسب بدالة مخصصة من صنعك، وتعمل تلقائيًا حسب جدول زمني بينما أنت نائم. Google Apps Script هي منصة JavaScript سحابية مجانية من جوجل، وهي مدمجة أصلًا في Sheets وGmail وDrive وDocs وCalendar. لا تثبيت، لا استضافة، ولا أي تكلفة.

إذا كان أسبوعك لا يزال يتكرر فيه نفس المشهد — نسخ بيانات بين الأوراق، إعادة تنسيق نفس الأعمدة كل يوم اثنين، وكتابة نفس إيميل الحالة يدويًا — فأنت تقوم بعمل يستطيع سكربت من عشرة أسطر أن يؤديه بدلًا منك. الاستثمار هنا بسيط: ساعة واحدة مركّزة مع هذا الدليل تخرج منها بثلاث أتمتة تعمل فعليًا، وسجل مصروفات يبني نفسه بنفسه، وخريطة واضحة لبقية الرحلة.

أنا مصطفى أمان، مسؤول تقنية معلومات أول (Senior IT Officer) بخبرة تتجاوز 16 عامًا في إدارة البنية التحتية المؤسسية — من أنظمة التصوير الطبي، إلى شبكات الفروع المتعددة، وسيرفرات Windows وLinux، وعمليات التجارة الإلكترونية — واستخدمت Google Apps Script لسنوات لإلغاء المهام المتكررة عبر Google Workspace. أول مرة سلّمني فيها سكربت مجدول تقريرًا كاملًا دون أن ألمس لوحة المفاتيح، تقلّص وقت تقريري الأسبوعي إلى خمس دقائق مراجعة فقط. هذا المقال هو نقطة الارتكاز لكل السلسلة؛ كل جزء لاحق سيربط عودةً إلى هنا.

الإجابة السريعة: ما هي Google Apps Script؟

هذه هي النسخة المختصرة. بقية هذا الدليل تُريك كيف تبدو تلك الجملة عمليًا: أين يعيش المحرر، ثلاثة سكربتات جاهزة للنسخ يمكنك تشغيلها اليوم، متى تتفوق ميزات الجداول الجاهزة على الكود، وكيف تحوّل الأجزاء الـ47 المتبقية هذه الأساسيات إلى نظام أتمتة متكامل لـ Workspace.

ما هي Google Apps Script؟ لنرَ المثال أولًا ثم نشرح

تخيّل صباح يوم الاثنين الذي صُمِّمت هذه الأداة من أجله. إيصالات المصروفات متكدسة في البريد، وورقة السجل تحتاج نفس الأعمدة الخمسة بنفس التنسيق للأسبوع التاسع على التوالي، والمدير ينتظر ملخصًا حسب الفئة. في سيناريو العمل اليدوي، هذا يعني ثلاثة تطبيقات، عشرين دقيقة، وفرصتين للصق في الصف الخطأ. مع Apps Script، الأمر كله دالة واحدة — ابنِ السجل، اجمع الفئات، أرسل الملخص — تنتهي قبل أن تنتهي من فنجان قهوتك.

من الداخل، Google Apps Script هي منصة تطوير سريعة مبنية على JavaScript الحديثة (محرك V8، نفس عائلة المحرك خلف Chrome وNode.js). سكربتاتك تعيش في Google Drive الخاص بك وتُنفَّذ على سيرفرات جوجل نفسها، مع خدمات مدمجة لكل منتج من منتجات Workspace. وفقًا لـ الصفحة الرسمية لنظرة عامة على Apps Script من جوجل، هذا يعني أنك تستطيع:

• قراءة وكتابة وإعادة تنسيق البيانات في جوجل شيت تلقائيًا — وهذا هو محور هذا المقال.
• إرسال رسائل Gmail مخصصة يُشغّلها محتوى الجدول أو جدول زمني.
• توليد مستندات Google Docs وعروض Slides من قوالب — عند الطلب أو بمؤقّت.
• جدولة السكربتات بمشغّلات (Triggers) — يوميًا، كل ساعة، أو عند حدوث تعديل.
• إضافة قوائم وحوارات وأشرطة جانبية مخصصة إلى Sheets وDocs.
• سحب بيانات من APIs خارجية مباشرة إلى جدول بيانات، أو نشر السكربتات كتطبيقات ويب.

هناك تفصيلان يوقعان المبتدئين في الحيرة، فلنوضحهما الآن. أولًا، السكربتات تأتي بنوعين: سكربتات مرتبطة (Bound) بجدول بيانات واحد، كما هو الحال معنا اليوم، وسكربتات مستقلة (Standalone) — مشاريع منفصلة تتحدث مع ملفات كثيرة، وهي تطبيقات الويب التي سنصل إليها في المرحلة السادسة. ثانيًا، إذا سبق أن استخدمت أدوات بصرية بدون كود، فأنت تعرف هذا المجال بالفعل: قارنّا Apps Script بمنصات سير العمل في دليل أتمتة n8n، والخلاصة الصريحة أن Apps Script تتفوق في السعر وعمق الوصول لـ Workspace وحرية التخصيص — مقابل كتابة كود بدلًا من رسم مخططات سير العمل.

كيف تفتح المحرر وتشغّل أول سكربت (5 خطوات)

المحرر ليس ملفًا تُحمّله — إنه يعيش داخل جوجل شيت. اتبع هذه الخطوات الخمس بالضبط وستكون لديك شيفرة تعمل خلال عشر دقائق، حتى لو لم تكتب سطر JavaScript واحدًا من قبل.

الخطوة 1 — افتح محرر السكربت. أنشئ جدول بيانات جديدًا في Google Sheets (سيكون هذا هو دفتر مصروفات السلسلة)، ثم اختر الإضافات ← Apps Script من شريط القوائم. يفتح المحرر في تبويب متصفح جديد، مرتبطًا مباشرةً بهذا الجدول بالتحديد.

الإضافات ← Apps Script: بيئة التطوير الكاملة مدمجة أصلًا في جوجل شيت — بلا تثبيت وبلا إعداد.

الخطوة 2 — سمِّ المشروع وتعرَّف على Code.gs. اضغط على "Untitled project" أعلى الصفحة وسمِّه باسم ستتذكره بعد سنة، مثل أتمتة المصروفات — السلسلة. يمنحك المحرر ملفًا واحدًا باسم Code.gs، وهو المكان الذي تعيش فيه شيفرة JavaScript الخاصة بنا. تضيف جوجل الآن أيضًا لوحة مساعد Gemini مباشرةً داخل بيئة التطوير لشرح وتوليد الكود — رفيق إكمال تلقائي مفيد حقًا، رغم أن الجزء 003 من هذه السلسلة سيقدّم جولة كاملة في المحرر.

الخطوة 3 — الصق السكربت الأول. احذف محتوى Code.gs الافتراضي والصق هذا السكربت الكامل والمُعلَّق. إنه يبني سجل مصروفات السلسلة من الصفر: عنوان، صفوف بيانات تجريبية، تنسيق عملة، عمود "شامل الضريبة" يستخدم الدالة المخصصة التي ستضيفها لاحقًا، وصف عنوان مُجمَّد.

/**
 * يبني سجل مصروفات السلسلة من الصفر.
 * شغّله يدويًا من المحرر الآن — قائمة مخصصة
 * ستصل في الجزء 007 من السلسلة.
 */
function setupExpenseLedger() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName('Expenses') || ss.insertSheet('Expenses');

  // امسح أي محتوى سابق ليكون السكربت متكررًا وآمنًا عند إعادة التشغيل
  sheet.clearContents();

  // 1) صف العنوان: نص أبيض عريض على خلفية باللون الأخضر المميز للمدونة
  sheet.getRange('A1:F1')
       .setValues([['التاريخ', 'الوصف', 'الفئة', 'المبلغ (USD)', 'طريقة الدفع', 'شامل الضريبة']])
       .setFontWeight('bold')
       .setBackground('#13b981')
       .setFontColor('#ffffff');

  // 2) صفوف مصروفات تجريبية — مكتوبة كلها في استدعاء واحد فقط
  sheet.getRange('A2:E6').setValues([
    [new Date(), 'غداء فريق العمل — زيارة عميل', 'وجبات',    48.50,  'بطاقة الشركة'],
    [new Date(), 'تاكسي — نقل من المطار',        'مواصلات',  32.00,  'نقدًا'],
    [new Date(), 'اشتراك برمجي',                 'برمجيات',  120.00, 'بطاقة الشركة'],
    [new Date(), 'مستلزمات مكتبية',              'مستلزمات', 26.75,  'نقدًا'],
    [new Date(), 'تذكرة مؤتمر',                   'تدريب',    250.00, 'بطاقة الشركة']
  ]);

  // 3) عمود الضريبة — يستخدم الدالة المخصصة EXPENSEVAT من هذا المشروع
  sheet.getRange('F2:F6').setFormulas([
    ['=EXPENSEVAT(D2)'],
    ['=EXPENSEVAT(D3)'],
    ['=EXPENSEVAT(D4)'],
    ['=EXPENSEVAT(D5)'],
    ['=EXPENSEVAT(D6)']
  ]);

  // 4) تنسيق عملة لعمودي المبالغ معًا
  sheet.getRange('D2:D1000').setNumberFormat('$#,##0.00');
  sheet.getRange('F2:F1000').setNumberFormat('$#,##0.00');

  // 5) تجميد صف العنوان وتوسيع الأعمدة تلقائيًا لسهولة القراءة
  sheet.setFrozenRows(1);
  sheet.autoResizeColumns(1, 6);

  Logger.log('سجل المصروفات جاهز.');
}

الخطوة 4 — احفظ وشغّل. اضغط Ctrl+S، ثم اضغط Run في شريط الأدوات مع اختيار setupExpenseLedger. في أول تشغيل، ستطلب جوجل تصريحًا — الشاشة التي يسألني عنها كل مبتدئ. بعد انتهائه، سيُظهر العمود F أخطاء #NAME? — وهذا متوقع، لأن الدالة المخصصة EXPENSEVAT غير موجودة بعد. ستضيفها في قسم الدوال المخصصة أدناه، وبمجرد إضافتها ستتحدث هذه الخلايا تلقائيًا.

الخطوة 5 — تحقق من النتيجة. ارجع إلى تبويب جدول البيانات: ستجد ورقة Expenses بعنوان أخضر وبيانات تجريبية منسّقة وعمودًا سادسًا بعنوان "شامل الضريبة" (يظهر #NAME? مؤقتًا — سيُحل تلقائيًا بمجرد لصق دالة EXPENSEVAT أدناه). في المحرر، افتح Executions (أو View ← Logs) لترى سجل التشغيل وسطر "سجل المصروفات جاهز." — هذه اللوحة هي مكانك لتشخيص أي فشل مستقبلي.

النتيجة: سجل مصروفات منسّق بعمود "شامل الضريبة" — بُني خلال ثوانٍ، ويعيد بناء نفسه مطابقًا في كل مرة يعمل فيها السكربت.

قراءة وكتابة البيانات: العادة الواحدة التي تفصل السكربتات السريعة عن البطيئة

الآن بعد أن أصبح السجل موجودًا، لنجعل السكربت يفعل شيئًا مفيدًا به: جمع المصروفات حسب الفئة. في الطريق ستتعلم أهم عادة أداء في Apps Script — لأن الفرق بين سكربت ينتهي خلال ثانية وآخر يزحف ليس في ذكاء الكود، بل في طريقة حديثك مع جدول البيانات.

/**
 * يقرأ السجل باستدعاء واحد فقط ويجمع المصروفات حسب الفئة.
 * الملخص المُعاد سيغذّي الحوارات والإيميلات والتقارير
 * في أجزاء لاحقة من السلسلة.
 */
function summarizeExpenses() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Expenses');
  const lastRow = sheet.getLastRow();

  // حماية: لا يوجد شيء لتلخيصه بعد
  if (lastRow < 2) {
    Logger.log('ورقة Expenses فارغة — شغّل setupExpenseLedger أولًا.');
    return 'لا توجد مصروفات مسجّلة بعد.';
  }

  // اقرأ مرة واحدة: اسحب كل الصفوف إلى الذاكرة معًا، وليس خلية بخلية
  const data = sheet.getRange(2, 1, lastRow - 1, 4).getValues();

  const totals = {};
  for (const row of data) {
    const category = row[2]; // العمود C
    const amount = row[3];   // العمود D
    if (category && amount) {
      totals[category] = (totals[category] || 0) + amount;
    }
  }

  let summary = 'المصروفات حسب الفئة:\n';
  for (const category in totals) {
    summary += '  ' + category + ': $' + totals[category].toFixed(2) + '\n';
  }

  Logger.log(summary);
  return summary;
}

شغّله، ثم افتح سجل التنفيذ: وجبات: 48.50$، برمجيات: 120.00$… محسوبة خلال أجزاء من الثانية. غرفة المحرك هنا هي getValues()، التي تسحب النطاق كاملًا إلى الذاكرة كمصفوفة JavaScript برحلة واحدة فقط. الخطأ الشائع الذي أراه في كود المبتدئين هو استدعاء getValue() داخل حلقة — كل استدعاء هو محادثة منفصلة مع سيرفرات جوجل، وبعد بضع مئات من الصفوف يصبح السكربت بطيئًا أو متعطلًا. القاعدة التي تصمد أمام كل درس أداء في هذه السلسلة (يقيسها الجزء 008 حيًا): اقرأ مرة، احسب في الذاكرة، اكتب مرة.

ميزات جوجل شيت الجاهزة مقابل Apps Script: اختيار الأداة الصحيحة

السؤال الأول الذي يجب أن يطرحه كل مبتدئ ليس "كيف أُبرمج هذا؟" بل "هل يستحق البرمجة أصلًا؟". جوجل شيت يأتي أصلًا بأدوات جاهزة قوية، واللجوء إلى الكود حيث توجد ميزة بنقرتين فقط يضيف عبء صيانة بلا داعٍ. هذه المقارنة هي عدسة القرار المتكررة في السلسلة — سنعود إليها في كل مرحلة.

القاعدة التي أعطيها لكل فريق: إذا كان شخص يعيد بناء المهمة كل فترة، برمجها؛ وإذا كانت تجيب عن سؤال لمرة واحدة، فالميزات الجاهزة تفوز. صيغ جوجل شيت لها أيضًا سقف — لا صيغة يمكنها إرسال إيميل، أو إنشاء مستند، أو الاستجابة لإرسال نموذج — وهذا السقف بالضبط هو حيث يبدأ باقي هذا الدليل.

الدوال المخصصة: صيغك الخاصة داخل جدول البيانات

Apps Script لا يكتفي بتحريك البيانات — يمكنه أيضًا توسيع شريط الصيغ نفسه. الدالة المخصصة هي سكربت تستدعيه من خلية تمامًا مثل =SUM()، وهو مثالي للحسابات التي يعيد فريقك إنشاءها باستمرار. إليك واحدة لدفتر مصروفاتنا: دالة تضيف الضريبة يمكنك استخدامها كـ =EXPENSEVAT(120) أو =EXPENSEVAT(120, 0.05).

/**
 * يضيف ضريبة القيمة المضافة إلى مبلغ مصروف صافٍ.
 * يعمل مع رقم واحد أو نطاق كامل،
 * مثال: =EXPENSEVAT(120) أو =EXPENSEVAT(D2:D10).
 * @param {number} amount المبلغ الصافي أو نطاق من المبالغ.
 * @param {number} [rate] نسبة الضريبة كرقم عشري (الافتراضي 0.15).
 * @return المبلغ (أو المبالغ) بعد إضافة الضريبة.
 * @customfunction
 */
function EXPENSEVAT(amount, rate) {
  // اعتبر "عدم التمرير" كأنه النسبة الافتراضية 15%
  rate = (rate === undefined || rate === null || rate === '') ? 0.15 : rate;

  // العملية الحسابية المطبَّقة على كل قيمة
  function applyVat(value) {
    const number = parseFloat(value);
    if (isNaN(number)) {
      return 'أدخل رقمًا، مثال: =EXPENSEVAT(120)';
    }
    return number * (1 + rate);
  }

  // النطاق يصل كمصفوفة ثنائية الأبعاد — طبّق الضريبة على كل خلية
  if (Array.isArray(amount)) {
    return amount.map(function (row) {
      return row.map(applyVat);
    });
  }
  return applyVat(amount);
}

الصقها في نفس المشروع واحفظ (Ctrl+S). إذا كنت قد شغّلت setupExpenseLedger() بالفعل، أعد تشغيلها الآن: العمود F ("شامل الضريبة") سيمتلئ فورًا بالمبالغ شاملة الضريبة — 55.78$، 36.80$، وهكذا — لأن سكربت السجل يكتب صيغ =EXPENSEVAT(D2) في هذا العمود تلقائيًا. يمكنك أيضًا كتابة =EXPENSEVAT(120) في أي خلية فارغة للتأكد: 138.00. تعليقات JSDoc (أسطر @param و@customfunction) ليست زخرفة — إنها ما يجعل الإكمال التلقائي يعرض دالتك وتلميحاتها داخل جدول البيانات. الدالة تقبل أيضًا نطاقًا كاملًا (=EXPENSEVAT(D2:D10)) وتتعامل مع الخلايا الفارغة أو الخاطئة بلطف بدل تعطيل الصيغة.

=EXPENSEVAT(120) يُعيد 138.00 — صيغتك الخاصة، مُعرَّفة في أسطر قليلة، قابلة للاستخدام من أي شخص يفتح الجدول.

للدوال المخصصة حدود موثّقة تستحق معرفتها من اليوم الأول، وفقًا لـ دليل الدوال المخصصة من جوجل: يمكنها فقط إعادة قيمة — لا إرسال إيميل، لا فتح حوارات، لا خدمات تتطلب تصريحًا — والنتائج تُعاد حسابها عند تغيّر محتوى الجدول، وهذا قد يتراكم على الجداول الكبيرة. صمّم كل دالة لتُستدعى مرة واحدة لكل نطاق بدل سحبها عبر ألف خلية. الجزء 005 يبني هذا الموضوع في درس كامل بدوال تحويل عملة خاصة بالسلسلة.

المشغّلات (Triggers): أتمتة تعمل وأنت نائم

كل ما سبق يعمل عندما تضغط Run. القوة الخارقة الحقيقية تبدأ عندما تُشغِّل السكربتات نفسها. يسمّي Apps Script هذه المشغّلات، وهي على نوعين. المشغّلات البسيطة (Simple) — دوال باسم onOpen() أو onEdit() — تعمل تلقائيًا لكن بصلاحيات محدودة: لا تستطيع إرسال إيميل أو لمس خدمات تتطلب تصريحًا. المشغّلات القابلة للتثبيت (Installable) تُنشأ من صفحة Triggers، وتعمل بصلاحياتك المُعتمَدة، وتدعم أحداثًا أكثر، منها إرسال النماذج والجداول الزمنية. هذا الفرق مهم للتصميم، ويُشرَّح كل نوع مشغّل بالتفصيل في الجزء 009.

لنُوصِّل المثال الكلاسيكي: إيميل ملخص صباحي. أضف هذه الدالة إلى المشروع.

/**
 * يعمل تلقائيًا كل صباح عبر مشغّل زمني.
 * يرسل إيميلًا واحدًا بملخص المصروفات — تحقق من حصص
 * الإيميل الرسمية قبل توسيع هذا لفريق كبير.
 */
function sendDailyExpenseSummary() {
  const summary = summarizeExpenses(); // إعادة استخدام الدالة التي بنيتها بالفعل
  MailApp.sendEmail(
    Session.getEffectiveUser().getEmail(), // إيميل صاحب المشغّل — أو ثبّت إيميلك، مثل '[email protected]'
    'ملخص المصروفات اليومي',
    summary
  );
}

ثم، في المحرر، اضغط أيقونة Triggers (الساعة، في الشريط الجانبي) ← Add Trigger ← اختر sendDailyExpenseSummary، مصدر الحدث Time-driven، النوع Day timer، الساعة 7–8 صباحًا ← Save. صرِّح مرة واحدة، ومن صباح الغد سيصلك الملخص في بريدك دون أي تدخل من أحد. تفصيل متعمَّد واحد: السكربت يستخدم Session.getEffectiveUser() — هوية صاحب المشغّل — لأن الدالة المشابهة getActiveUser() قد تُعيد عنوانًا فارغًا للحسابات الشخصية، ما قد يُعطِّل استدعاء الإيميل. إذا كنت تفضّل عدم الغموض تمامًا، استبدل هذا الوسيط بعنوانك الخاص بين علامتي اقتباس. لأنه يعمل على سيرفرات جوجل، يستمر حتى لو كان جهازك مغلقًا — لكن لاحظ أن تطبيق Sheets للجوال لا يستطيع تشغيل سكربتات أو الضغط على أزرار مخصصة عند الطلب؛ فقط المشغّلات التي تعمل من جهة السيرفر تستمر أثناء التنقل.

لوحة Triggers: دالة واحدة، جدول زمني واحد، والأتمتة تتوقف عن الاعتماد على أن يتذكّر أحد تشغيلها.

الأخطاء الأربعة التي يقع فيها كل مبتدئ أولًا (وحلولها)

بعد سنوات من إعداد السكربتات لزملاء غير تقنيين، أستطيع التنبؤ أين سيخطئ الأسبوع الأول. أصلح هذه الأربعة الآن وستتجنب معظم الإحباط.

1. الذعر عند شاشة التصريح

أول تشغيل لأي سكربت يطلب صلاحية، وتحذير "لم تتحقق جوجل من هذا التطبيق" يُقنع كثيرًا من القرّاء أنهم كسروا شيئًا. أنت لم تكسر شيئًا. بالنسبة لسكربتاتك الخاصة، اتبع Advanced ← Go to project مرة واحدة لكل سكربت. ما يستحق الحذر فعلًا هو سكربت أرسله لك شخص آخر — اقرأ قائمة الصلاحيات قبل الموافقة على أي شيء لا تستطيع تفسيره.

2. تعديل الكود وتشغيل الدالة الخطأ

المحرر يُشغِّل أي دالة مُختارة في القائمة المنسدلة بشريط الأدوات، وبعد لصق عدة دوال يستمر المبتدئون في إعادة تشغيل الدالة القديمة ويتساءلون لماذا لم يتغيّر شيء. قبل الضغط على Run، تحقق من القائمة المنسدلة. هذه العادة الواحدة تمنع معظم رسائل "الكود عندي معطّل".

3. التحدث مع جدول البيانات داخل حلقة

قابلت هذا الخطأ أعلاه، لكنه يستحق التكرار لأنه يسبب سكربتات بطيئة وأخطاء حصص معًا: كل getValue() أو setValue() داخل حلقة هو رحلة سيرفر منفصلة. اجمع بـ getValues() وsetValues()، احسب في الذاكرة، واكتب النتيجة مرة واحدة.

4. الاختبار على بيانات حية ومشتركة

النسخة الأولى من أي سكربت يجب أن تعمل على نسخة من جدول البيانات، وليس أبدًا على السجل الذي يستخدمه محاسبك بالفعل. التجارب المدمِّرة (حذف صفوف، الكتابة فوق نطاقات، إيميلات جماعية) مكانها نسخة اختبار — وحين تجدول لاحقًا مهامًا مدمِّرة، نمط "التشغيل التجريبي" في الجزء 020 سيحميك.

خريطة السلسلة: 8 مراحل من أول سكربت إلى أتمتة Workspace كاملة

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

على طول الطريق، تُصدر كل مرحلة دعمًا قابلًا للتنزيل — جداول بيانات بداية، مكتبات مقتطفات كود، قوالب مستندات، واختبارات مرحلية — يُعلَن عنها داخل الأجزاء المعنية فور نشرها. مستخدمو Gmail يحصلون على مكافأة مبكرة أيضًا: عندما تصل المرحلة الثالثة، سنربطها بدليل تصنيفات وفلاتر Gmail الموجود بالفعل على المدونة، حتى يمتلك غير المبرمجين في فريقك طريقًا أيضًا.

اختبار سريع وتحدٍ عملي

قبل الملخص، تمرينان قصيران لتحويل هذا المقال من مادة قراءة إلى ذاكرة عضلية. الأول يختبر مفهوم المشغّل؛ الثاني يُجهِّز المادة الخام للجزء 002.

الملخص وقائمة التحقق العملية

تمتلك الآن الأساس الكامل للسلسلة: نموذج المنصة، بيئة تطوير تعمل، ثلاثة سكربتات جاهزة للاستخدام الفعلي، والحكمة لمعرفة متى لا تُبرمج. قبل الانتقال، تأكد من كل نقطة:

• فتحت المحرر من الإضافات ← Apps Script داخل دفتر مصروفاتك.
• شغّلت setupExpenseLedger()، صرّحت مرة واحدة، ورأيت السجل المنسَّق يظهر.
• شغّلت summarizeExpenses() وقرأت إجماليات الفئات في سجل التنفيذ.
• حافظت على وصول مُجمَّع للبيانات — استدعاء واحد لـ getValues()، لا حلقة من getValue().
• أضفت EXPENSEVAT() واستخدمتها داخل خلية حقيقية كدالة مخصصة.
• جدولت مشغّلًا زمنيًا واحدًا وتأكدت من التشغيل في لوحة Triggers/Executions.
• تحققت من صفحة الحصص الرسمية قبل التفكير في أي شيء يُرسل إيميلات أو يعمل طويلًا.
• حفظت هذا المقال في المفضلة — إنه نقطة الارتكاز التي يعود إليها كل جزء لاحق.

كل جزء مستقبلي يفترض تحقق هذه النقاط الثماني. إذا شعرت بعدم اليقين في أي منها، أعد تشغيل الخطوة المطابقة — السكربتات مصمَّمة لتكون متكررة وآمنة، فإعادة بناء السجل لا تكلّفك شيئًا.

الأسئلة الشائعة

الخلاصة: سكربت واحد، ساعات ترجع إليك

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

خطوتك التالية متعمَّدة، لا عشوائية: أحضر مهامك الثلاث الأكثر تكرارًا في جدول البيانات إلى الجزء 002: دوال الجداول مقابل Google Apps Script (قادم قريبًا)، حيث نحسم — ببناءات جنبًا إلى جنب — متى تكون الصيغة الإجابة الصحيحة ومتى يستحق الكود مكانه. العادة التي تُثبِّتها اليوم، برمجة الأشياء التي يعيد شخص بناءها كل فترة، هي نفس العادة التي توسّعها سلسلة الـ48 جزءًا بالكامل إلى نظام أتمتة متكامل لـ Workspace.