Lorixen.
AR

نموذج موقعك إلى Google Sheets مباشرة: Apps Script بخطوات بسيطة

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

ما الذي تحتاجه

  • حساب Google وجدول جديد بورقة اسمها Messages أو أي اسم تفضله.
  • نموذج HTML في موقعك يرسل الحقول بطريقة POST أو عبر fetch.
  • مساحة صغيرة في إعدادات السكربت لحفظ الرمز السري.

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

الخطوة الأولى: إنشاء السكربت

من داخل الجدول افتح محرر السكربت عبر قائمة الإضافات. ستظهر لك صفحة فيها ملف اسمه Code.gs، فامسح محتواه والصق الكود التالي:

function doPost(e) {
  const lock = LockService.getScriptLock();
  lock.waitLock(5000);
  try {
    const secret = PropertiesService.getScriptProperties().getProperty('FORM_SECRET');
    const p = e.parameter;
    if (!secret || p.token !== secret) {
      return ContentService.createTextOutput('forbidden');
    }
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Messages');
    sheet.appendRow([new Date(), p.name || '', p.phone || '', p.message || '']);
    return ContentService.createTextOutput('ok');
  } finally {
    lock.releaseLock();
  }
}

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

الخطوة الثانية: حفظ الرمز السري

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

الخطوة الثالثة: النشر كتطبيق ويب

من زر النشر اختر "نشر جديد"، ثم حدد النوع تطبيق ويب. في الإعدادات:

  • تنفيذ التطبيق بصفتي: أنا، أي حسابك.
  • من يملك حق الوصول: أي شخص، لأن الموقع يرسل من زوار لا يملكون حساب Google.

ستحصل على رابط ينتهي بكلمة exec، وهو العنوان الذي يُرسل إليه النموذج. انسخه واحفظه، ولا تعتبره سراً، فالرابط يظهر في شيفرة الصفحة لكل زائر.

الخطوة الرابعة: ربط النموذج

في الصفحة، أضف حقلاً مخفياً يحمل الرمز، ثم أرسل البيانات عبر fetch:

<meta charset="UTF-8">
<form id="contact">
  <input name="name" placeholder="الاسم">
  <input name="phone" type="tel" placeholder="رقم الجوال">
  <textarea name="message" placeholder="رسالتك"></textarea>
  <input type="hidden" name="token" value="ضع-الرمز-هنا">
  <button type="submit">إرسال</button>
</form>

ثم في الجافاسكربت، أرسل البيانات بطريقة form-urlencoded لتصل إلى e.parameter بسهولة. انتبه إلى أن أي قيمة توضع في الصفحة مرئية للزوار، لذلك الرمز هنا يمنع الإرسال العشوائي البسيط فقط، وليس حماية حقيقية. لا تستخدم هذا النمط لأي معلومة حساسة.

مشكلة الحروف العربية

أكثر ما يربك المطورين المبتدئين هو ظهور حروف مشوهة في الجدول. الأسباب المعتادة:

  1. الصفحة مكتوبة بترميز غير UTF-8، لذلك أضف <meta charset="UTF-8"> في أعلى الصفحة، واحفظ الملف بالترميز نفسه.
  2. الرسالة أُرسلت بترميز يختلف عن الصفحة، لذلك تأكد من أن النموذج يرسل النص كما هو دون تحويل.

اختبر بجملة عربية كاملة فيها أرقام وعلامات ترقيم قبل الإطلاق، وراجعها في الجدول بعينك.

عند تعديل السكربت

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

حدود الحل

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

إذا تجاوزت هذه الحدود، أو احتجت حفظ بيانات دفع أو هوية، فالخيار الأنسب وقتها خادم يتولى الحماية، مع قاعدة بيانات مرتبة. وهذا الانتقال لا يلغي ما تعلمته هنا، فالحقول والتحقق سيبقيان كما هما في الواجهة.

رسالة شكر بعد الإرسال

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

التحقق من الحقول قبل الإرسال

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

اختبار قبل النشر للجميع

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

قائمة تحقق

  • ☐ السكربت منشور كتطبيق ويب بخيار الوصول للجميع.
  • ☐ الرمز السري محفوظ في خصائص السكربت وليس في الكود.
  • ☐ الصفحة فيها meta charset بترميز UTF-8.
  • ☐ تم اختبار جملة عربية كاملة وظهرت صحيحة في الجدول.
  • ☐ عند كل تعديل أُنشئ نشر جديد وحُدّث الرابط في الصفحة.

أسئلة شائعة

هل يحتاج الزائر إلى حساب Google؟

لا، شرط أن يكون النشر بخيار "أي شخص". لكن هذا يعني أن أي شخص يستطيع إرسال طلبات إلى الرابط، لذلك استخدم الرمز وراقب الجدول بانتظام.

هل يمكن إرسال ملف مرفق عبر هذا الحل؟

الحل مناسب للنصوص. الملفات تحتاج معالجة إضافية في Google Drive، ويفضل تقييم الأمر بعناية قبل بنائه.

لماذا يظهر الصف مكرراً؟

غالباً يرسل النموذج الطلب مرتين، لأن الزر يُضغط مرتين أو لأن الكود يعيد المحاولة عند تأخر الرد. عطّل الزر بعد أول ضغطة، وأضف معرّفاً للطلب إن احتجت منع التكرار بدقة.

هل أحتاج مبرمجاً؟

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

أرسل لنا وصف موقعك ونموذجك عبر صفحة التواصل، ونقترح معك ما يناسب حجم الرسائل عندك.

المصادر

WhatsAppاحجز مكالمة