شرح Google Apps Script للمبتدئين: أتمتة جداول بيانات جوجل بخطوات بسيطة (تحديث 2026)

شرح Google Apps Script وكيفية استخدامها لأتمتة جداول بيانات جوجل للمبتدئين

هل سبق أن وجدت نفسك تكرر نفس الإجراءات يدوياً في جداول بيانات جوجل يوماً بعد يوم؟ نسخ بيانات، تنسيق أعمدة، إرسال رسائل بريد إلكتروني بناءً على محتوى الجدول... من تجربتي، هذا النوع من العمل المتكرر هو بالضبط ما صُمِّم Google Apps Script لحله. ببضعة أسطر من كود JavaScript، يمكنك تحويل جداول بيانات جوجل إلى أداة أتمتة تعمل تلقائياً دون أن تتدخل أنت.

أنا مصطفى أمان، وفي هذا الدليل ستتعلم: ما هو Apps Script، كيف تفتحه وتكتب أول سكربت، وكيف تستخدمه مع جداول بيانات جوجل (Google Sheets) — كل ذلك خطوة بخطوة مع أمثلة كود جاهزة للنسخ.

إقرأ أيضاً: خارطة الطريق لتعلم البرمجة للمبتدئين

ما هو Google Apps Script؟

Google Apps Script هو منصة برمجة سحابية مجانية مقدَّمة من Google، تعتمد على لغة JavaScript وتعمل مباشرةً من المتصفح دون الحاجة لتثبيت أي برنامج. الميزة الكبرى هي أنه مدمج بالكامل مع تطبيقات Google Workspace مثل: جداول البيانات (Sheets)، والبريد (Gmail)، والمستندات (Docs)، والتقويم (Calendar).

لاحظت أن كثيراً من المبتدئين يخافون من كلمة "برمجة" هنا، لكن الحقيقة أن Apps Script لا يحتاج خبرة عميقة — إذا كنت تعرف أساسيات JavaScript أو حتى أي لغة برمجة، ستبدأ بسهولة.

أبرز ما يتيحه Apps Script:

• قراءة بيانات تطبيقات Google Workspace وتحديثها ومعالجتها تلقائياً.
• كتابة السكربتات من المتصفح مباشرةً — لا حاجة لتثبيت أي محرر كود خارجي.
• جدولة المهام لتعمل تلقائياً في أوقات محددة (Triggers).
• إنشاء وإدارة مشاريع كاملة مع فريقك دون مغادرة بيئة Google.

إقرأ أيضاً: كيف أتعلم البرمجة

ما الجديد في Google Apps Script 2025–2026؟

بعد تجربة عدة تحديثات على Apps Script خلال الفترة الماضية، هذه أبرز التحسينات التي أضافها Google ويجب أن تعرفها:

• تكامل مع Gemini AI: أصبح بإمكانك استدعاء Gemini API مباشرة من داخل سكربتاتك لمعالجة البيانات بالذكاء الاصطناعي — مثلاً: تلخيص محتوى خلية أو توليد نص تلقائي.
• تحسينات في محرر الكود: إكمال تلقائي أسرع وتنسيق أفضل للكود (Code Formatting).
• رفع حدود التنفيذ اليومية: زيادة في الحصص المسموح بها لحسابات Workspace مما يعني مهام أتمتة أطول وأكثر.
• تكامل أسهل مع مستودعات GitHub: بفضل الواجهة الجديدة لمحرر السكريبت (New IDE)، أصبح بإمكانك إدارة إصدارات الكود وربط مشاريعك بمستودعات الأكواد بسهولة أكبر.

كيفية فتح محرر Google Apps Script من جداول البيانات

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

1. افتح أي ملف في Google Sheets.
2. من القائمة العلوية، اضغط على الامتدادات (Extensions).
3. اختر Apps Script.
4. سيفتح محرر الكود في نافذة/تبويب جديد.
5. ستجد دالة فارغة جاهزة تُسمى myFunction() — هنا تبدأ الكتابة.

إقرأ أيضاً: الدوال الجديدة في جداول بيانات جوجل

Google Apps Script مع جداول بيانات جوجل

يمكنك استخدام Apps Script مع جداول بيانات جوجل لتوفير الوقت والجهد، مما يسمح للسكربتات بالتفاعل مع ملفات Google Sheets والبيانات التي تحتوي عليها.

أبرز المهام التي يمكنك أتمتتها:

• إنشاء جداول بيانات جديدة أو تعديل جداول موجودة تلقائياً.
• قراءة وتحديث بيانات الخلايا والصيغ والتنسيق.
• إنشاء أزرار وقوائم مخصصة تظهر في واجهة الجدول.
• استيراد وتصدير البيانات من تطبيقات Google الأخرى أو من APIs خارجية.
• المشاركة والتحكم في صلاحيات الوصول برمجياً.

أول سكربت Apps Script: كتابة بيانات في الخلايا

بدلاً من البدء بالنظرية، دعنا نكتب كوداً حقيقياً يعمل فوراً. هذا المثال يكتب نصاً في الخلية A1 من الورقة الأولى:

function writeToSheet() {
  // الحصول على جدول البيانات النشط
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  // الحصول على الورقة الأولى
  const sheet = spreadsheet.getActiveSheet();

  // الكتابة في الخلية A1
  sheet.getRange('A1').setValue('مرحباً من Apps Script!');

  // كتابة رقم في الخلية B1
  sheet.getRange('B1').setValue(2025);

  // عرض رسالة تأكيد
  SpreadsheetApp.getUi().alert('تمت الكتابة بنجاح!');
}

كيفية تشغيل الكود:

1. الصق الكود في محرر Apps Script.
2. اضغط على زر حفظ (Save) أو Ctrl+S.
3. اضغط على زر تشغيل (Run) ▶
4. في أول تشغيل، سيطلب Google منك منح الأذونات — اقبلها.
5. عد إلى جدول البيانات وستجد النص في الخلية A1.

إرسال بريد إلكتروني واكتشاف الأخطاء (Debugging)

من أكثر المهام المطلوبة هي إرسال بريد إلكتروني تلقائي. يمكنك فعل ذلك بسهولة بسطر واحد فقط من خلال خدمة GmailApp. لكن أثناء كتابتك للكود، قد تواجه بعض الأخطاء أو ترغب في عرض قيم المتغيرات. هنا يأتي دور console.log() للتحقق من سير العمل في سجل التنفيذ (Execution log) أسفل المحرر.

function testEmailAndLogging() {
  const emailAddress = "[email protected]";
  const subject = "إشعار من جوجل شيت";
  const body = "تم تنفيذ السكربت بنجاح!";

  // طباعة رسالة في سجل التنفيذ لمساعدتك في التتبع (Debugging)
  console.log("جاري إرسال البريد إلى: " + emailAddress);

  // إرسال البريد الإلكتروني
  GmailApp.sendEmail(emailAddress, subject, body);
}

إقرأ أيضاً: أي لغة برمجة يجب أن تتعلمها أولاً؟

مفهومان أساسيان: وحدات الماكرو والدوال المخصصة

يركز هذا الدليل على مفهومين يشكّلان العمود الفقري للاستخدام اليومي لـ Apps Script:

• وحدات الماكرو (Macros): سلسلة من الإجراءات المسجّلة داخل جداول البيانات. بمجرد التسجيل يمكنك تشغيلها لاحقاً بنقرة واحدة أو بمفتاح اختصار. يمكنك إنشاؤها وتحديثها من جداول بيانات جوجل مباشرةً أو من محرر Apps Script.
• الدوال المخصصة (Custom Functions): على غرار الدوال المضمنة مثل SUM وAVERAGE، يمكنك كتابة دوالك الخاصة واستخدامها في صيغ الخلايا تماماً كأي دالة مضمنة.

مثال عملي: دالة مخصصة لحساب نسبة مئوية

/**
 * تحسب نسبة مئوية من قيمة إجمالية
 * @param {number} value القيمة الجزئية
 * @param {number} total القيمة الكلية
 * @return {string} النسبة المئوية مع علامة %
 * @customfunction
 */
function PERCENTAGE(value, total) {
  if (total === 0) return 'خطأ: لا يمكن القسمة على صفر';
  const percent = (value / total * 100).toFixed(2);
  return percent + '%';
}

بعد حفظ هذا الكود، يمكنك استخدامه مباشرةً في أي خلية: =PERCENTAGE(A1, B1)

إقرأ أيضاً: كيف تصبح مطور ويب

المشغلات (Triggers): كيف تجعل السكربت يعمل تلقائياً؟

السر الحقيقي وراء الأتمتة هو المشغلات (Triggers). بفضلها، لست مضطراً لتشغيل السكربت يدوياً في كل مرة.

• من القائمة الجانبية في محرر Apps Script، اضغط على أيقونة المنبه (Triggers).
• اضغط على "إضافة مشغل" (Add Trigger) أسفل يمين الشاشة.
• يمكنك إعداد السكربت ليعمل بناءً على الوقت (Time-driven) (مثلاً كل يوم الساعة 8 صباحاً).
• أو بناءً على الحدث (Event-driven) (مثلاً عند قيام المستخدم بتعديل خلية معينة في الجدول).

ماذا ستحتاج للبدء

• الإلمام الأساسي بلغة البرمجة JavaScript.
• الإلمام الأساسي بـ Google Sheets (جداول بيانات جوجل).

إن كنت جديداً في JavaScript، ستجد في مدونتنا مقالات تغطي أي لغة برمجة تبدأ بها وكيف تتعلم البرمجة من الصفر — ابدأ بهما قبل الغوص في Apps Script.

كما يمكنك الاستفادة من مقالتنا حول تعلم قواعد البيانات مع Python لفهم كيف تعمل البيانات البرمجية بشكل عام.

إقرأ أيضاً: أدوات مهمة لمطوري الواجهات الأمامية

دورة Google Apps Script الكاملة — المحاور الستة

فيما يلي نظرة عامة على المحاور الستة الرئيسية التي يغطيها هذا الدليل. سيتم نشر مقالة مستقلة ومفصّلة لكل محور — يمكنك متابعة الروابط أولاً بأول فور إضافتها.

الدرس الأول: أساسيات Apps Script مع جداول بيانات جوجل

ستتعرف على مفاهيم محرر السكربت، وتتعلم إنشاء وتعديل وحدات الماكرو والدوال المخصصة. وتكتب أول سكربت لتحويل الدولار الأمريكي إلى العملة المحلية.

الدرس الثاني: التعامل مع جداول البيانات والأوراق والنطاقات

نتعمق في خدمة Spreadsheet Service لقراءة البيانات وكتابتها ومعالجتها. ستتعرف على الـ Classes والمصطلحات الأساسية التي تمكّنك من التحكم الدقيق في قيم البيانات وعرضها.

الدرس الثالث: العمل مع البيانات في جداول بيانات جوجل

التعمق في قراءة وكتابة وتعديل البيانات داخل الجدول. بعد إكمال هذا الدرس ستمتلك مهارة معالجة البيانات وإنشاء القوائم المخصصة.

الدرس الرابع: استدعاء واجهة برمجة تطبيقات API عامة

ستتعلم كيفية استرداد بيانات من أي API عام وملء الخلايا الفارغة ببيانات مستمدة منه، وتحليل بيانات JSON المستردة.

الدرس الخامس: تنسيق البيانات داخل جداول بيانات جوجل

ستتعلم تنسيق بيانات الجدول برمجياً وكتابة دوال مخصصة لإنشاء جداول بيانات منظمة مليئة بالبيانات المنسقة المجلوبة من API.

الدرس السادس: الرسوم البيانية وعرضها في Google Slides

ستتعلم إنشاء رسم بياني (Chart) لمجموعة بياناتك وتصديره تلقائياً إلى عرض تقديمي جديد في Google Slides.

إقرأ أيضاً: خارطة طريق لتعلم أساسيات Python

Apps Script مقارنةً بأدوات الأتمتة الأخرى

سؤال يتكرر كثيراً: "لماذا Apps Script وليس Make أو Zapier أو n8n؟" إليك المقارنة المختصرة:

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

أسئلة شائعة حول Google Apps Script

خاتمة

Google Apps Script هو من أكثر الأدوات التي وفّرت لي وقتاً في عملي اليومي. الميزة الحقيقية ليست في القوة التقنية فحسب، بل في أنه مجاني تماماً ولا يحتاج إعداداً معقداً — كل ما تحتاجه هو متصفح وحساب Google.

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

إقرأ أيضاً: البرمجة بلغة Python للمبتدئين

إقرأ أيضاً: أدوات Google الأساسية لمستخدمي Windows