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

1. مقدمة

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

ما ستتعرَّف عليه

• كيفية تمثيل جداول البيانات والأوراق والنطاقات في "برمجة التطبيقات".
• كيفية الوصول إلى جدول البيانات النشط (المفتوح) وإنشاءه وإعادة تسميته من خلال الصفين SpreadsheetApp وSpreadsheet.
• كيفية تغيير اسم ورقة واتجاه الصف/النطاق في صف أو صف، باستخدام صف Sheet.
• كيفية تحديد مجموعة خلايا أو نطاق بيانات وتفعيلها ونقلها وترتيبها باستخدام صف Range.

قبل البدء

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

الأشياء التي تحتاج إليها

• فهم لمواضيع "برمجة تطبيقات Google" الأساسية التي تم استكشافها في الدرس التطبيقي السابق حول الترميز في قائمة التشغيل هذه
• دراية أساسية بمحرِّر "برمجة تطبيقات Google"
• إلمام أساسي بـ جداول بيانات Google
• إمكانية قراءة تدوين A1 في "جداول بيانات Google"
• الإلمام بأساسيات JavaScript وفئة String

يقدم القسم التالي الفئات الأساسية لخدمة جداول البيانات.

2. مقدمة عن خدمة جداول البيانات

تشمل أربعة صفوف أساس خدمة جداول البيانات: SpreadsheetApp وSpreadsheet وSheet وRange. يصف هذا القسم هذه الصفوف والأغراض التي يتم استخدامها.

فئة spreadsheetApp

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

جداول البيانات والأوراق وصفوفها

كعبارة جدول بيانات، جدول البيانات هو ملف في "جداول بيانات Google" (مخزّن في Google Drive) يحتوي على بيانات منظّمة حسب الصفوف والأعمدة. يُشار إلى جدول البيانات أحيانًا باسم "جدول بيانات Google"، ويُشار إليه أيضًا باسم "مستند Google".

يمكنك استخدام صف Spreadsheet للوصول إلى بيانات ملف "جداول بيانات Google" وتعديلها. يمكنك أيضًا استخدام هذا الصف للعمليات الأخرى على مستوى الملف، مثل إضافة المتعاونين.

تمثل الورقة** الصفحة الفردية لجدول بيانات، ويُشار إليها أحيانًا باسم &tab;tab." يمكن أن يحتوي كل جدول بيانات على ورقة واحدة أو أكثر. يمكنك استخدام صف Sheet** للوصول إلى البيانات والإعدادات على مستوى الورقة وتعديلها، مثل نقل الصفوف أو أعمدة البيانات.

نقطة رئيسية: بالإضافة إلى الاسم، تتضمن جداول البيانات أيضًا سلسلة رقم تعريف فريدة لهذه الورقة. رقم التعريف موجود في عنوان URL لجدول البيانات بالتنسيق التالي:

https://docs.google.com/spreadsheets/d/spreadsheetID/edit#gid=0

تتضمّن كل ورقة في جدول البيانات أيضًا رقم تعريف فريدًا له. يتم عشوائيًا رقم التعريف هذا، ولكن يمكنك أيضًا رؤيته في عنوان URL لجدول البيانات بالتنسيق:

https://docs.google.com/spreadsheets/d/spreadsheetID/edit#gid=sheetID

يمكنك الاطّلاع على كلا المعرّفين في نموذج عنوان URL التالي:

بما أنّ معرّفات جداول البيانات والأوراق فريدة (وأسماء جداول البيانات ليست كذلك)، يُفضَّل استخدام معرّفات it's لتحديد جداول البيانات والأوراق قدر الإمكان. على سبيل المثال، يمكنك إنشاء جداول بيانات متعددة بالاسم نفسه في Google Drive. باستخدام طرق النص البرمجي مثل SpreadsheetApp.openById(id) لفتح جداول البيانات، يمكنك تجنب إجراء تعديل غير صحيح للملف غير الصحيح.

تعرّف على مزيد من المعلومات حول المعرّفات في"جداول بيانات Google"من خلال الاطّلاع على مقدمة عن"جداول بيانات Google".

باختصار، تعمل الفئة Spreadsheet على مجموعة من الأوراق وتحدّد ملف "جداول بيانات Google" في Google Drive. تعمل صف Sheet على أوراق فردية داخل جدول بيانات.

فئة النطاق

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

الكلمة الرئيسية: في "برمجة التطبيقات"، تكون الورقة active هي الورقة المفتوحة حاليًا والمرئية في واجهة "جداول بيانات Google". وبالمثل، النطاق النشط هو مجموعة واحدة أو أكثر من الخلايا المميزة حاليًا داخل الورقة النشطة. الخلية النشطة هي الخلية المميزة المحددة ضمن الورقة النشطة مع التركيز على المؤشر.

تعرض العديد من طرق الصفوف العنصر النشط للفئة المطلوبة. على سبيل المثال، يؤدي تشغيل SpreadsheetApp.getActiveSpreadsheet() إلى عرض جدول البيانات النشط أو الحالي للمستخدم. من خلال الحصول على جدول البيانات النشط، يمكنك تطبيق العمليات على جدول البيانات هذا. وبالمثل، يمكن أن تؤدي طرق مثل طريقة Sheet.activate() إلى تغيير العنصر النشط.

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

يعرض الجزء المتبقي من الدرس التطبيقي أمثلة على النصوص البرمجية التي تعمل مع هذه الصفوف وأساليبها.

3- إعداد

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

يتم وضع نسخة من نموذج جدول البيانات لك لتستخدِمه في مجلد Google Drive باسم "نسخة من جدول بيانات بلا عنوان&&quot؛ استخدم جدول البيانات هذا لإكمال هذا الدرس التطبيقي حول الترميز.

كتذكير، يمكنك فتح محرر النص البرمجي من "جداول بيانات Google" بالنقر على الإضافات&gt؛ برمجة التطبيقات.

عند فتح مشروع "برمجة تطبيقات Google" في محرِّر النصوص البرمجية للمرة الأولى، ينشئ محرِّر النصوص البرمجية مشروع نص برمجي وملف نص برمجي لك.

يعرض لك القسم التالي كيفية استخدام الصف Spreadsheet لتحسين جدول البيانات هذا.

4. الوصول إلى جداول البيانات وتعديلها

في هذا القسم، يمكنك التعرّف على كيفية استخدام الصفين SpreadsheetApp وSpreadsheet للوصول إلى جداول البيانات وتعديلها. وعلى وجه التحديد، تعلمك التمارين كيفية إعادة تسمية جدول بيانات وتكرار الأوراق داخل جدول بيانات.

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

إعادة تسمية جدول البيانات النشط

لنفترض أنك أردت تغيير الاسم الافتراضي،"نسخة من جدول بيانات - بدون عنوان — إلى عنوان يعكس غرض جدول بياناتك بشكل أفضل. ويمكنك إجراء ذلك باستخدام صفوف SpreadsheetApp وSpreadsheet.

1. في محرِّر النص البرمجي، استبدِل المجموعة التلقائية للرموز في myFunction() بالرمز التالي:

function renameSpreadsheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  mySS.rename("2017 Avocado Prices in Portland, Seattle");
}

2. لحفظ النص البرمجي، انقر على رمز الحفظ .
3. لإعادة تسمية مشروع "برمجة التطبيقات"، انقر على مشروع بلا عنوان، وأدخِل أسعارًا&مظهرية، وما مِن "أسعار Avocado"؛ كاسم المشروع الجديد، ثم انقر على إعادة تسمية.
4. لتشغيل النص البرمجي، اختَر renameSpreadsheet من قائمة الدوال وانقر على تشغيل.
5. تفويض وحدة الماكرو باتّباع التعليمات الظاهرة على الشاشة. إذا ظهرت رسالة && في التطبيق، فلم يتم التحقق من صحته، انقر على خيارات متقدمة ثم انقر على الانتقال إلى أسعار الأفوكادو (غير آمن). في الشاشة التالية، انقر على السماح.

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

بعد تنفيذ الدالة، من المفترض أن يتغيّر اسم ملف جدول البيانات:

لنلقِ نظرة على الرمز الذي أدخلته. تعرض طريقة getActiveSpreadsheet() كائنًا يمثل جدول البيانات النشط، أي نسخة من جدول بيانات التمارين الذي أنشأته. يتم تخزين عنصر جدول البيانات هذا في المتغيّر mySS. يؤدي استدعاء rename(newName) في mySS إلى تغيير اسم ملف جدول البيانات في Google Drive إلى "أسعار أفوكادو" 2017 في بورتلاند، سياتل.

بما أنّ المتغيّر mySS هو مرجع لجدول البيانات، يمكنك جعل رمزك أكثر وضوحًا وكفاءة أكبر من خلال طلب أساليب Spreadsheet على mySS بدلاً من استدعاء getActiveSpreadsheet() بشكل متكرّر.

إنشاء نسخة طبق الأصل من الورقة النشطة

في جدول البيانات الحالي، لديك ورقة واحدة فقط. يمكنك استدعاء طريقة Spreadsheet.duplicateActiveSheet() لإنشاء نسخة من الورقة:

1. أضف الدالة الجديدة التالية أسفل الدالة renameSpreadsheet() الموجودة من قبل في مشروع النص البرمجي:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();
}

2. احفظ مشروع النص البرمجي.
3. لتشغيل النص البرمجي، اختَر duplicateAndOrganizeActiveSheet من قائمة الدوال وانقر على تشغيل.

ارجع إلى "جداول بيانات Google" للاطّلاع على علامة تبويب جديدة من نوع Sheet_Original&quot؛ تمت إضافة علامة تبويب الورقة إلى جدول البيانات.

في هذه الدالة الجديدة، تُنشئ طريقة duplicateActiveSheet() الورقة المكرّرة وتفعّلها وتعرضها في جدول البيانات. تم تخزين هذه الورقة الناتجة في duplicateSheet، لكن الرمز لم ينفذ أي إجراء باستخدام هذا المتغير حتى الآن.

في القسم التالي، ستستخدم الصف Sheet لإعادة تسمية الورقة المكرّرة وتنسيقها.

5. تنسيق جدول البيانات باستخدام صف البيانات

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

ملاحظة**: يشترك الصفان Spreadsheet** وSheet في عدة طرق شائعة للأوراق، مثل Spreadsheet.deleteColumn(columnPosition) وSheet.deleteColumn(columnPosition).

عند استدعاء Spreadsheet.deleteColumn(columnPosition)، تزيل الطريقة الأعمدة من الورقة (المفتوحة) النشطة حاليًا داخل جدول البيانات. يمكنك الحصول على النتيجة نفسها من خلال الاتصال بـ getActiveSheet() ثم Sheet.deleteColumn(columnPosition). سيوفر لك إصدار Spreadsheet الوقت.

تغيير اسم الورقة

عملية إعادة تسمية الأوراق بسيطة مثل إعادة تسمية جدول البيانات في renameSpreadsheet(). يتطلب الأمر استدعاء طريقة واحدة فقط.

1. في"جداول بيانات Google"، انقر على ورقة Sheet_Original لتفعيلها.
2. في "برمجة التطبيقات"، عدِّل الدالة duplicateAndOrganizeActiveSheet() لتطابق ما يلي:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());
}

3. حفظ الدالة وتشغيلها.

في "جداول بيانات Google"، يتم إنشاء ورقة مكررة وإعادة تسميتها عند تشغيل الدالة:

في الرمز المُضاف، تغيّر الطريقة setName(name) اسم duplicateSheet، باستخدام getSheetID() للحصول على رقم تعريف فريد للورقة. يربط عامل التشغيل + رقم تعريف الورقة في نهاية سلسلة "Sheet_".

تعديل أعمدة وصفوف جداول بيانات

يمكنك أيضًا استخدام صف Sheet لتنسيق جدول البيانات. على سبيل المثال، يمكننا تعديل دالة duplicateAndOrganizeActiveSheet() لتغيير حجم أعمدة الورقة المكرّرة أيضًا وإضافة صفوف مجمّدة:

1. في"جداول بيانات Google"، انقر على ورقة Sheet_Original لتفعيلها.
2. في "برمجة التطبيقات"، عدِّل الدالة duplicateAndOrganizeActiveSheet() لتطابق ما يلي:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);
}

3. حفظ الدالة وتشغيلها.

في "جداول بيانات Google"، يتم إنشاء ورقة مكررة وإعادة تسميتها وتفعيلها وتنسيقها:

يستخدم الرمز الذي أضفته autoResizeColumns(startColumn, numColumns) لتغيير حجم أعمدة الورقة لتسهيل القراءة. تجمّد طريقة setFrozenRows(rows) عدد الصفوف المحدّد (في هذه الحالة) الذي يحافظ على صفوف العنوان مرئية أثناء انتقال القارئ في جدول البيانات.

ملاحظة: عند العمل باستخدام مصفوفات في"برمجة تطبيقات Google"، عليك اتّباع القواعد التي تبدأ بها القائمة في الفهرس"0". ولكن عند العمل مع الصفوف والأعمدة، يبدأ الفهرس من 1. يتوافق هذا المنطق مع تنسيق جدول البيانات التقليدي، حيث تبدأ من الصف 1 والعمود "أ" في "جداول بيانات Google".

يُرجى مراعاة ذلك عند استخدام طرق ذات صلة بالأعمدة والصفوف، مثل autoResizeColumns(startColumn, numColumns). في ممارستنا الحالية، يتم إدخال 1 (وليس 0) كمعلمة للإشارة إلى العمود "أ" من duplicateSheet.

في القسم التالي، ستتعرّف على المزيد من المعلومات عن النطاقات ومعالجة البيانات الأساسية.

6- إعادة ترتيب البيانات باستخدام فئة النطاق

توفِّر فئة Range وأساليبها معظم خيارات معالجة البيانات وتنسيقها في خدمة جداول البيانات.

يعرِض هذا القسم معالجة البيانات الأساسية باستخدام النطاقات. وتركّز هذه التمارين على كيفية الاستفادة من النطاقات في "برمجة التطبيقات" بينما تتعمّق الدروس التطبيقية الأخرى حول الترميز في قائمة التشغيل هذه كيفية معالجة البيانات وتنسيقها بشكل أكبر.

نقل النطاقات

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

لنبدأ تحديث طريقة duplicateAndOrganizeActiveSheet() لنقل بعض البيانات أيضًا:

1. في "جداول بيانات Google"، انقر على ورقة Sheet_Original لتفعيلها.
2. في "برمجة التطبيقات"، عدِّل الدالة duplicateAndOrganizeActiveSheet() لتطابق ما يلي:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);

  // Move column F to column C.
  var myRange = duplicateSheet.getRange("F2:F");
  myRange.moveTo(duplicateSheet.getRange("C2"));
}

3. حفظ الدالة وتشغيلها.

عند تشغيل هذه الدالة، يتم إنشاء ورقة مكررة وتنشيطها وتنسيقها. ويتم نقل محتوى العمود "و" إلى العمود "ج":

يستخدم الرمز الجديد الطريقة getRange(a1Notation) لتحديد نطاق البيانات الذي سيتم نقله. من خلال إدخال التدوين A1 "F2:F" ومعلمة الطريقة's، فإنك تحدد العمود F (باستثناء F1). إذا كان النطاق المحدّد موجودًا، ستعرض الطريقة getRange(a1Notation) مثيل Range. يخزِّن الرمز المثيل في المتغيّر myRange لتسهيل الاستخدام.

بعد تحديد النطاق، تأخذ طريقة moveTo(target) محتوى myRange (كل من القيم والتنسيق) وتنقلها. يتم تحديد الوجهة (العمود C) باستخدام علامة A1 "C2". هذه خلية واحدة، بدلاً من عمود. عند نقل البيانات، لا تحتاج إلى مطابقة الأحجام مع النطاقات المستهدفة والوجهة. ويسهّل "برمجة التطبيقات" على الخلية الأولى لكل عنصر.

ملاحظة:عندما تكتب النصوص البرمجية بنفسك، احرص على اختبارها جيدًا للتأكد من أن بياناتك تنتهي في المكان الذي تريده. يستبدل "برمجة التطبيقات" قيم البيانات الحالية عند تغيير قيم الخلايا. إذا لم تكن حذرًا، يمكنك استبدال البيانات التي تريد الاحتفاظ بها. في هذا المثال، كان العمود "ج" فارغًا، ولكن في حال توفّر بيانات، تُزيل طريقة moveTo(target) هذه البيانات.

ترتيب النطاقات

تتيح لك صف Range قراءة مجموعات الخلايا وتعديلها وتنظيمها. على سبيل المثال، يمكنك ترتيب نطاق بيانات باستخدام الطريقة Range.sort(sortSpecObj):

1. في "جداول بيانات Google"، انقر على ورقة Sheet_Original لتفعيلها.
2. في "برمجة التطبيقات"، عدِّل الدالة duplicateAndOrganizeActiveSheet() لتطابق ما يلي:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);

  // Move column F to column C.
  var myRange = duplicateSheet.getRange("F2:F");
  myRange.moveTo(duplicateSheet.getRange("C2"));

  // Sort all the data using column C (Price information).
  myRange = duplicateSheet.getRange("A3:D55");
  myRange.sort(3);
}

3. حفظ الدالة وتشغيلها.

والآن، تتولى الدالة، بالإضافة إلى التنسيق السابق، ترتيب جميع البيانات في الجدول باستخدام معلومات السعر في العمود C:

يستخدم الرمز الجديد getRange(a1Notation) لتحديد نطاق جديد يغطي A3:D55 (الجدول بالكامل باستثناء رؤوس الأعمدة). وبعد ذلك يستدعي الرمز طريقة sort(sortSpecObj) لترتيب الجدول. هنا، المعلّمة sortSpecObj هي رقم العمود المطلوب استخدامه للترتيب. ترتّب الطريقة النطاق بحيث تنتقل قيم العمود المُشار إليها من الأدنى إلى الأعلى (القيم التصاعدية). يمكن أن تؤدي طريقة sort(sortSpecObj) إلى تنفيذ متطلبات ترتيب أكثر تعقيدًا، ولكنك لا تحتاج إليها هنا. يمكنك عرض كل الطرق المختلفة التي يمكنك من خلالها استدعاء نطاقات الترتيب في المستندات المرجعية للطريقة.

تهانينا، لقد أكملت جميع التدريبات بنجاح في الدرس التطبيقي حول الترميز. يراجع القسم التالي النقاط الأساسية في هذا الدرس التطبيقي حول الترميز ويعايِن الدرس التطبيقي التالي حول الترميز في قائمة التشغيل هذه.

7- الخلاصة

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

أنت مستعد للانتقال إلى الدرس التطبيقي التالي حول الترميز.

هل وجدت هذا الدرس التطبيقي مفيدًا؟

نعم لا

المواضيع التي تناولناها

• كيفية تمثيل جداول البيانات والأوراق والنطاقات في "برمجة التطبيقات".
• بعض الاستخدامات الأساسية للصفوف SpreadsheetApp وSpreadsheet وSheet وRange.

المفاهيم الرئيسية:

1. في برمجة التطبيقات، تتّبع كل المصفوفات الصيغة التي تبدأ بها القائمة في الفهرس 0. ومع ذلك، تتم فهرسة الصفوف والأعمدة بدءًا من 1.
2. في "برمجة التطبيقات"، تُعدّ الورقة المفتوحة حاليًا والنطاق المميّز والخلايا نشطة. تصل العديد من طرق "برمجة التطبيقات" إلى العنصر النشط أو تعدّله.
3. تشارك الصفوف Spreadsheet وSheet عدة طرق متعلقة بالورقة. إنّ الطرق المكرّرة في الفئة Spreadsheet مخصّصة للمستخدم فقط، لأنها عادةً ما تستهدف الورقة النشطة عند طلبها.
4. يحتوي كل جدول بيانات وورقة على معرّف فريد، ويمكنك العثور عليه في عنوان URL للمتصفح. تستخدم طرق جداول البيانات وفئة الورقة المعرّفات. يمكنك معرفة المزيد من المعلومات عن أرقام التعريف وعناوين URL في مقدمة عن "جداول بيانات Google".

المصطلحات الأساسية:

• نشط (الحالة): يشير إلى جدول البيانات أو الورقة أو النطاق أو الخلية المحددة هي العنصر الذي يعرضه جدول البيانات أو يحدده حاليًا.
• الخلية النشطة: الخلية الوحيدة المميّزة ضمن الورقة النشطة مع التركيز على المؤشر
• النطاق النشط: مجموعة من خلية واحدة أو أكثر محددة حاليًا داخل الورقة النشطة.
• التفويض: عملية منح المستخدم للأذونات للسماح "لبرمجة التطبيقات" بالوصول إلى بيانات المستخدم في خدمات Google ذات الصلة أو اتخاذ إجراءات نيابةً عن المستخدم.
• نص برمجي مرتبط بحاوية: أي نص برمجي مرتبط بمستند Google Workspace وتم إنشاؤه من خلال "جدول بيانات Google" أو "مستند Google".
• النطاق:** مجموعة من خلية مجاورة واحدة أو أكثر داخل ورقة. يمنحك صف Range** إمكانية قراءة النطاقات وتعديلها في ورقة.
• محرِّر النص البرمجي: محرِّر الرموز داخل المتصفّح في "برمجة تطبيقات Google".
• جدول البيانات**: صفحة واحدة من جدول البيانات (مشابه لأدلة Microsoft Excel's). يُستخدم أحيانًا للإشارة إلى ملف "جداول بيانات Google" في Google Drive. يسمح لك صف Sheet** بالوصول إلى الأوراق وتعديلها.
• SpreadsheetApp: تعمل هذه الفئة كصف رئيسي لخدمة جدول البيانات وتوفّر نقطة بداية للرمز الذي يقرأ بيانات "جداول بيانات Google" أو يتلاعب بها.
• جدول بيانات**: ملف متوفر في "جداول بيانات Google" داخل Google Drive يمكّنك صف Spreadsheet** من الوصول إلى جداول البيانات وتعديلها.
• خدمة جداول بيانات: خدمة برمجة تطبيقات تتيح النصوص البرمجية إنشاء ملفات في "جداول بيانات Google" والوصول إليها وتعديلها.

الخطوات التالية

يتناول الدرس التطبيقي التالي حول الترميز في قائمة التشغيل هذه كيفية قراءة البيانات وكتابتها وتعديلها في جدول بيانات.

ابحث عن الدرس التطبيقي التالي حول الترميز في التعامل مع البيانات.