توسيع جداول بيانات Google باستخدام الإضافات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

جداول بيانات Google هي خدمة تقدّم جداول بيانات مستندة إلى السحابة الإلكترونية وتتضمّن التعاون في الوقت الفعلي وأدوات فعّالة لعرض البيانات ومعالجتها ومعالجتها.

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

يمكنك الاطّلاع على إضافات "جداول بيانات Google" التي أنشأها المستخدمون الآخرون على Google Workspace Marketplace.

الإجراءات التي يمكنك اتّخاذها

إليك بعض المزايا التي يمكنك الاستفادة منها في إضافة "جداول بيانات Google":

تم إنشاء إضافات "جداول بيانات Google" باستخدام "برمجة تطبيقات Google". لمعرفة المزيد من المعلومات حول كيفية الوصول إلى "جداول بيانات Google" وإدارتها باستخدام "برمجة تطبيقات Google"، يمكنك الاطّلاع على توسيع "جداول بيانات Google".

بنية الورقة

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

توفّر خدمة جداول البيانات في "برمجة تطبيقات Google" عدّة صفوف لتمثيل البنيات التنظيمية في "جداول بيانات Google" (مثل Sheet وRange). يمكنك استخدام هذه الصفوف لقراءة بيانات "جداول بيانات Google" وسلوكها.

الكائن Triggers

تسمح مشغّلات برمجة التطبيقات بتنفيذ نص برمجي محدّد عند استيفاء شروط معيّنة، مثل فتح جدول بيانات أو تثبيت إضافة.

راجِع عوامل تشغيل الإضافات للحصول على مزيد من المعلومات حول العوامل التي يمكن استخدامها مع إضافات "جداول بيانات Google" والقيود التي تنطبق على استخدامها.

الدوال المخصّصة

تتضمن "جداول بيانات Google" عددًا من الوظائف المضمَّنة مثل SUM وAVERAGE التي يمكن استدعاءها من داخل خلية في جدول بيانات Google. يمكن أن تحدّد إضافات "جداول بيانات Google" وظائف مخصّصة إضافية لتتكامل مع هذه الدوال المُدمَجة. عندما يثبّت المستخدم الإضافة، تصبح أي دوال مخصّصة محدّدة مضمّنة في هذه الإضافة متاحة على الفور. من الممكن أن تتألف الإضافة من تعريفات دوال مخصصة فقط. تتم مشاركة تعريفات الدوال المخصصة مع الآخرين بشكل أساسي من خلال نشر إضافة تحتوي على التعريفات.

إنشاء دوال مخصّصة للإضافة

يمكن استخدام أي دالة محدّدة في مشروع نص برمجي للإضافة كدالة مخصّصة. بعد تنفيذ الدالة وتثبيت الإضافة، يمكنك استدعاء الدالة المخصصة مثل أي دالة مضمّنة أخرى في "جداول بيانات Google": في خلية جدول البيانات، أدخِل = متبوعًا باسم الدالة وأي معلّمات مطلوبة. إذا لم تكن هناك أخطاء، يتم وضع النتيجة التي تعرضها الدالة في خلية جدول البيانات، بحيث تفيض الخلايا إلى العناصر المجاورة حسب الضرورة.

عند إنشاء دوال مخصّصة في إضافة، عليك اتّباع الإرشادات العامة للدوال المخصّصة:

بالإضافة إلى ذلك، هناك بعض الاعتبارات الخاصة للدوال المخصصة المحددة في الإضافات:

  • عند تسمية الدالة، جرِّب إنشاء اسم فريد، ربما يكون مرتبطًا باسم الإضافة. إذا كان هناك إضافتان مُثبَّتتان أو أكثر تحدد الدوال المخصّصة التي تحمل الاسم نفسه، يمكن للمستخدمين استخدام واحدة منها فقط.
  • يجب أن توضّح إضافتك بوضوح الوظائف المخصّصة التي تقدّمها. تأكَّد من توفير تعليقات JSDoc دقيقة للدوال المخصصة حتى يتمكن "برمجة التطبيقات" من تقديم معلومات الإكمال التلقائي للمستخدم. بالإضافة إلى ذلك، يمكنك تقديم مستندات إضافية للدوال المخصّصة إما في الإضافة نفسها أو في صفحة ويب لدعم الإضافة.
  • الدوال المخصّصة التي لا تكتمل خلال أقل من 30 ثانية تتعذّر إتمامها مع حدوث خطأ Internal error executing the custom function. يمكنك تقديم تجربة جيدة للمستخدم من خلال تقليل حجم المعالجة التي تجريها في وظيفة مخصّصة. حسِّن الدالة حيث يمكنك ذلك.
  • لا يمكن للدوال المخصّصة استخدام خدمات"برمجة تطبيقات Google"التي تتطلّب تفويضًا، وتتعذّر إتمامها مع ظهور خطأ You do not have permission to call X service إذا تمت محاولة إجراء ذلك. استخدِم الخدمات المسموح بها في الدالة المخصّصة فقط.
  • وتؤدي كل دالة مخصّصة إلى ورقة إلى استدعاء منفصل إلى خوادم برمجة التطبيقات. إذا حاول أحد المستخدمين استخدام دوال مخصصة في عدد كبير جدًا من الخلايا، قد يتم تنفيذ الدوال ببطء. للحد من هذه المشكلة، عليك إبقاء وظائفك المخصّصة بسيطة قدر الإمكان. وإذا كنت بحاجة إلى الدالة لتنفيذ معالجة معقدة أو موسّعة، لا تستخدم دالة مخصّصة، بل قدِّم هذه الوظيفة عبر عنصر في القائمة أو مربّع حوار أو تفاعل في الشريط الجانبي بدلاً من ذلك.

وحدات ماكرو لجداول البيانات

تتيح لك وحدات الماكرو تسجيل الإجراءات التي يتم اتخاذها في "جداول بيانات Google" وتكرارها لاحقًا باستخدام اختصار لوحة المفاتيح. عند إنشاء وحدة ماكرو في ورقة، تتم إضافتها باعتبارها دالة ماكرو في مشروع برمجة تطبيقات مرتبط بهذه الورقة. لمزيد من المعلومات عن وحدات الماكرو، يُرجى الاطّلاع على وحدات ماكرو "جداول بيانات Google".

للأسف، يتم توزيع وحدات ماكرو "جداول بيانات Google" can't مع إضافات. في حال تضمين تعريف وحدة ماكرو في بيان الإضافة، لن يكون متوفرًا لمستخدمي هذه الإضافة.