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

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

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

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

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

إليك بعض الإجراءات التي يمكنك تنفيذها باستخدام إضافة توسِّع "جداول بيانات Google":

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

بنية الورقة

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

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

أسباب طلب المساعدة

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

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

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

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

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

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

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

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

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

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

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

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