الوصول إلى أوراق البيانات وتعديلها تتم عادةً إعادة تسمية ورقة البيانات والوصول إلى كائنات النطاق من ورقة البيانات.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
activate() | Sheet | تفعيل ورقة البيانات هذه. |
addDeveloperMetadata(key) | Sheet | تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى ورقة البيانات. |
addDeveloperMetadata(key, visibility) | Sheet | تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد وحق الوصول إلى ورقة البيانات. |
addDeveloperMetadata(key, value) | Sheet | تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة المحدّدين إلى ورقة البيانات. |
addDeveloperMetadata(key, value, visibility) | Sheet | تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة وإمكانية الوصول إلى ورقة البيانات. |
appendRow(rowContents) | Sheet | لإلحاق صف إلى أسفل منطقة البيانات الحالية في ورقة البيانات |
asDataSourceSheet() | DataSourceSheet | تعرض ورقة البيانات باعتبارها DataSourceSheet إذا كانت ورقة البيانات من النوع SheetType.DATASOURCE ، أو null بخلاف ذلك. |
autoResizeColumn(columnPosition) | Sheet | لضبط عرض العمود المحدّد ليلائم محتواه. |
autoResizeColumns(startColumn, numColumns) | Sheet | لضبط عرض جميع الأعمدة بدءًا من موضع العمود المحدد لتناسب محتواها. |
autoResizeRows(startRow, numRows) | Sheet | لضبط ارتفاع جميع الصفوف بدءًا من موضع الصف المحدد لتناسب محتواها. |
clear() | Sheet | محو ورقة المحتوى وتنسيق التنسيق |
clear(options) | Sheet | لمحو ورقة المحتوى و/أو التنسيق، كما هو محدد بالخيارات المتقدمة المحددة |
clearConditionalFormatRules() | void | يزيل كل قواعد التنسيق الشرطي من ورقة البيانات. |
clearContents() | Sheet | لمحو ورقة المحتوى مع الاحتفاظ بمعلومات التنسيق. |
clearFormats() | Sheet | لمحو ورقة التنسيق، مع الاحتفاظ بالمحتوى |
clearNotes() | Sheet | محو ورقة جميع الملاحظات |
collapseAllColumnGroups() | Sheet | تصغير كل مجموعات الأعمدة في ورقة البيانات |
collapseAllRowGroups() | Sheet | تصغير كل مجموعات الصفوف في ورقة البيانات |
copyTo(spreadsheet) | Sheet | يؤدّي هذا الإجراء إلى نسخ جدول البيانات إلى جدول بيانات معيّن، ويمكن أن يكون جدول البيانات نفسه الذي يكون فيه المصدر. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | تعرض DeveloperMetadataFinder للبحث عن البيانات الوصفية لمطوّر البرامج ضمن نطاق ورقة البيانات هذه. |
createTextFinder(findText) | TextFinder | يؤدّي هذا الإجراء إلى إنشاء أداة البحث عن نص في ورقة البيانات، والتي يمكنها البحث عن النص واستبداله في ورقة البيانات. |
deleteColumn(columnPosition) | Sheet | حذف العمود في موضع العمود المعني |
deleteColumns(columnPosition, howMany) | void | حذف عدد الأعمدة التي تبدأ في موضع الأعمدة المحدّد |
deleteRow(rowPosition) | Sheet | حذف الصف في موضع الصف المحدد |
deleteRows(rowPosition, howMany) | void | حذف عدد من الصفوف بدءًا من موضع الصف المحدّد. |
expandAllColumnGroups() | Sheet | توسيع كل مجموعات الأعمدة في ورقة البيانات. |
expandAllRowGroups() | Sheet | توسيع كل مجموعات الصفوف في ورقة البيانات. |
expandColumnGroupsUpToDepth(groupDepth) | Sheet | توسيع جميع مجموعات الأعمدة إلى العمق المحدد، وتصغير جميع المجموعات الأخرى |
expandRowGroupsUpToDepth(groupDepth) | Sheet | تعمل على توسيع كل مجموعات الصفوف حتى العمق المحدّد، وكذلك تصغير كل المجموعات الأخرى. |
getActiveCell() | Range | لعرض الخلية النشطة في ورقة البيانات هذه. |
getActiveRange() | Range | يعرض النطاق المحدد في الورقة النشطة أو null إذا لم يكن هناك نطاق نشط. |
getActiveRangeList() | RangeList | يعرض قائمة النطاقات النشطة في ورقة البيانات النشطة أو null في حال عدم توفّر نطاقات نشطة. |
getBandings() | Banding[] | تعرض جميع النطاقات في هذه الورقة. |
getCharts() | EmbeddedChart[] | تعرض صفيفًا من الرسومات البيانية في هذه الورقة. |
getColumnGroup(columnIndex, groupDepth) | Group | لعرض مجموعة الأعمدة بالمؤشر المحدد وعمق المجموعة. |
getColumnGroupControlPosition() | GroupControlTogglePosition | تعرض GroupControlTogglePosition لجميع مجموعات الأعمدة في ورقة البيانات. |
getColumnGroupDepth(columnIndex) | Integer | لعرض عمق المجموعة في العمود على الفهرس المحدد. |
getColumnWidth(columnPosition) | Integer | للحصول على العرض بالبكسل للعمود المحدّد. |
getConditionalFormatRules() | ConditionalFormatRule[] | يمكنك الحصول على جميع قواعد التنسيق الشرطي في ورقة البيانات هذه. |
getCurrentCell() | Range | لعرض الخلية الحالية في ورقة البيانات النشطة أو null إذا لم تكن هناك خلية حالية. |
getDataRange() | Range | تعرِض Range المقابلة للأبعاد التي تتوفّر بها البيانات. |
getDataSourceFormulas() | DataSourceFormula[] | تحصل على جميع صيغ مصدر البيانات. |
getDataSourcePivotTables() | DataSourcePivotTable[] | الحصول على جميع الجداول المحورية لمصدر البيانات |
getDataSourceTables() | DataSourceTable[] | الحصول على جميع جداول مصادر البيانات |
getDeveloperMetadata() | DeveloperMetadata[] | الحصول على جميع البيانات الوصفية لمطوّري البرامج المرتبطة بهذه الورقة. |
getDrawings() | Drawing[] | تعرض صفيفًا من الرسومات في ورقة البيانات. |
getFilter() | Filter | يتم عرض الفلتر في ورقة البيانات هذه أو null في حال عدم توفّر فلتر. |
getFormUrl() | String | تعرض عنوان URL للنموذج الذي يرسل ردوده على ورقة البيانات هذه، أو null إذا لم تكن ورقة البيانات هذه تحتوي على نموذج مرتبط. |
getFrozenColumns() | Integer | لعرض عدد الأعمدة المجمّدة. |
getFrozenRows() | Integer | لعرض عدد الصفوف المجمّدة. |
getImages() | OverGridImage[] | لعرض جميع الصور المعروضة على الشبكة في ورقة البيانات. |
getIndex() | Integer | للحصول على موضع جدول البيانات في جدول البيانات الرئيسي |
getLastColumn() | Integer | لعرض موضع العمود الأخير الذي يتضمن محتوى. |
getLastRow() | Integer | لعرض موضع الصف الأخير الذي يتضمن محتوى. |
getMaxColumns() | Integer | لعرض العدد الحالي من الأعمدة في ورقة البيانات، بغض النظر عن المحتوى. |
getMaxRows() | Integer | لعرض العدد الحالي من الصفوف في ورقة البيانات، بغض النظر عن المحتوى. |
getName() | String | تعرض اسم ورقة البيانات. |
getNamedRanges() | NamedRange[] | تحصل على جميع النطاقات المُعنوَنة في ورقة البيانات هذه. |
getParent() | Spreadsheet | تعرض Spreadsheet التي تحتوي على ورقة البيانات هذه. |
getPivotTables() | PivotTable[] | تعرض جميع الجداول المحورية في ورقة البيانات هذه. |
getProtections(type) | Protection[] | تحصل على مصفوفة من العناصر التي تمثل جميع النطاقات المحمية في ورقة البيانات، أو مصفوفة من عنصر واحد تمثل الحماية على ورقة البيانات نفسها. |
getRange(row, column) | Range | لعرض النطاق مع الخلية العلوية اليسرى بالإحداثيات المحددة. |
getRange(row, column, numRows) | Range | تعرض النطاق مع الخلية العلوية اليسرى في الإحداثيات المحددة، وبعدد محدد من الصفوف. |
getRange(row, column, numRows, numColumns) | Range | تعرض النطاق مع الخلية العلوية اليمنى بالإحداثيات المحددة مع العدد المحدّد من الصفوف والأعمدة. |
getRange(a1Notation) | Range | تعرض النطاق المحدد في تدوين A1 أو تدوين R1C1. |
getRangeList(a1Notations) | RangeList | تعرض المجموعة RangeList التي تمثل النطاقات في ورقة البيانات نفسها المحدّدة من خلال قائمة غير فارغة من علامات A1 أو علامات R1C1. |
getRowGroup(rowIndex, groupDepth) | Group | لعرض مجموعة الصفوف وفقًا لعمق المجموعة والمجموعة المحدّدة. |
getRowGroupControlPosition() | GroupControlTogglePosition | تعرض GroupControlTogglePosition لجميع مجموعات الصفوف في ورقة البيانات. |
getRowGroupDepth(rowIndex) | Integer | لعرض عمق المجموعة للصف في الفهرس المحدد. |
getRowHeight(rowPosition) | Integer | للحصول على الارتفاع بالبكسل للصف المحدّد. |
getSelection() | Selection | لعرض Selection الحالية في جدول البيانات. |
getSheetId() | Integer | تعرض رقم تعريف الورقة التي يمثّلها هذا العنصر. |
getSheetName() | String | يعرض اسم الورقة. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | تعرض شبكة القيم المستطيلة لهذا النطاق بدءًا من الإحداثيات المحددة. |
getSlicers() | Slicer[] | تعرض صفيفًا على قطاعات شرائح في الورقة. |
getTabColorObject() | Color | الحصول على لون علامة تبويب ورقة البيانات، أو null إذا لم تكن علامة تبويب الورقة تحتوي على لون. |
getType() | SheetType | تعرض نوع الورقة. |
hasHiddenGridlines() | Boolean | عرض true إذا كانت خطوط الشبكة في الورقة مخفية، أو عرض false . |
hideColumn(column) | void | إخفاء العمود أو الأعمدة في النطاق المحدّد |
hideColumns(columnIndex) | void | إخفاء عمود واحد في الفهرس المحدّد |
hideColumns(columnIndex, numColumns) | void | إخفاء عمود واحد أو أكثر من الأعمدة المتتابعة بدءًا من الفهرس المحدد. |
hideRow(row) | void | إخفاء الصفوف في النطاق المحدّد |
hideRows(rowIndex) | void | إخفاء الصف في الفهرس المحدّد |
hideRows(rowIndex, numRows) | void | إخفاء صف واحد متتالي أو أكثر بدءًا من الفهرس المحدّد. |
hideSheet() | Sheet | إخفاء ورقة البيانات هذه. |
insertChart(chart) | void | لإضافة رسم بياني جديد إلى هذه الورقة. |
insertColumnAfter(afterPosition) | Sheet | إدراج عمود بعد موضع العمود المحدّد. |
insertColumnBefore(beforePosition) | Sheet | إدخال عمود قبل موضع العمود المحدد. |
insertColumns(columnIndex) | void | إدراج عمود فارغ في ورقة بيانات في المكان المحدّد |
insertColumns(columnIndex, numColumns) | void | إدراج عمود فارغ واحد أو أكثر من الأعمدة الفارغة في جدول بيانات بدءًا من الموقع المحدد. |
insertColumnsAfter(afterPosition, howMany) | Sheet | إدراج عدد من الأعمدة بعد موضع العمود المحدد. |
insertColumnsBefore(beforePosition, howMany) | Sheet | إدراج عدد من الأعمدة قبل موضع العمود المحدد. |
insertImage(blobSource, column, row) | OverGridImage | إدراج BlobSource كصورة في المستند في صف وعمود معيّن. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | يتم إدراج BlobSource كصورة في المستند في صف وعمود معيّن، مع إزاحة بكسل. |
insertImage(url, column, row) | OverGridImage | إدراج صورة في المستند في صف وعمود محدد. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | إدراج صورة في المستند في صف وعمود محدد، مع إزاحة بكسل. |
insertRowAfter(afterPosition) | Sheet | إدراج صف بعد موضع الصف المحدّد. |
insertRowBefore(beforePosition) | Sheet | إدخال صف قبل موضع الصف المحدّد. |
insertRows(rowIndex) | void | إدراج صف فارغ في ورقة في الموقع المحدد |
insertRows(rowIndex, numRows) | void | إدراج صف فارغ واحد أو أكثر متتاليين في جدول بيانات يبدأ من الموقع المحدد. |
insertRowsAfter(afterPosition, howMany) | Sheet | إدراج عدد من الصفوف بعد موضع الصف المحدّد. |
insertRowsBefore(beforePosition, howMany) | Sheet | إدراج عدد من الصفوف قبل موضع الصف المحدد. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | إضافة فلتر نطاق بيانات جديد إلى هذه الورقة |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | إضافة فلتر نطاق بيانات جديد إلى هذه الورقة |
isColumnHiddenByUser(columnPosition) | Boolean | يعرض ما إذا كان العمود الذي يظهر مخفيًا بواسطة المستخدم. |
isRightToLeft() | Boolean | عرض true إذا كان تنسيق الورقة هذا من اليمين إلى اليسار. |
isRowHiddenByFilter(rowPosition) | Boolean | لعرض ما إذا كان الصف المحدّد مخفيًا باستخدام فلتر (وليس عرض فلتر). |
isRowHiddenByUser(rowPosition) | Boolean | يعرض ما إذا كان الصف المحدّد مخفيًا بواسطة المستخدم. |
isSheetHidden() | Boolean | عرض true إذا كانت الورقة مخفية حاليًا. |
moveColumns(columnSpec, destinationIndex) | void | نقل الأعمدة التي تم اختيارها من خلال النطاق المحدّد إلى الموضع المشار إليه من خلال destinationIndex |
moveRows(rowSpec, destinationIndex) | void | نقل الصفوف التي تم اختيارها من خلال النطاق المحدّد إلى الموضع المُشار إليه من خلال destinationIndex |
newChart() | EmbeddedChartBuilder | لعرض أداة إنشاء لإنشاء رسم بياني جديد لهذه الورقة. |
protect() | Protection | تنشئ عنصرًا يمكنه حماية جدول البيانات من التعديل باستثناء المستخدمين الذين لديهم إذن. |
removeChart(chart) | void | يزيل رسمًا بيانيًا من الورقة الرئيسية. |
setActiveRange(range) | Range | لضبط النطاق المحدّد على أنه active range في ورقة البيانات النشطة، مع أعلى خلية إلى يمين النطاق في النطاق current cell . |
setActiveRangeList(rangeList) | RangeList | لضبط قائمة النطاقات المحدّدة على أنها active ranges في ورقة البيانات النشطة. |
setActiveSelection(range) | Range | لضبط منطقة الاختيار النشطة لهذه الورقة. |
setActiveSelection(a1Notation) | Range | لضبط الاختيار النشط، كما هو محدد في تدوين A1 أو تدوين R1C1. |
setColumnGroupControlPosition(position) | Sheet | لضبط موضع مفتاح تحكّم مجموعة الأعمدة على ورقة البيانات. |
setColumnWidth(columnPosition, width) | Sheet | لضبط عرض العمود المحدّد بالبكسل. |
setColumnWidths(startColumn, numColumns, width) | Sheet | لضبط عرض الأعمدة المحدّدة بالبكسل. |
setConditionalFormatRules(rules) | void | استبدال كل قواعد التنسيق الشرطي الحالية في جدول البيانات بقواعد الإدخال |
setCurrentCell(cell) | Range | لضبط الخلية المحدّدة على أنها current cell . |
setFrozenColumns(columns) | void | يعمل على تجميد العدد المحدّد من الأعمدة. |
setFrozenRows(rows) | void | يؤدي هذا الخيار إلى تجميد العدد المحدّد من الصفوف. |
setHiddenGridlines(hideGridlines) | Sheet | إخفاء خطوط الشبكة الورقة أو إظهارها |
setName(name) | Sheet | ضبط اسم الورقة |
setRightToLeft(rightToLeft) | Sheet | تعيين تنسيق ورقة البيانات أو إلغاء ضبطه على اليمين إلى اليسار. |
setRowGroupControlPosition(position) | Sheet | لضبط موضع زر تبديل مجموعة التحكّم في الصفوف على ورقة البيانات. |
setRowHeight(rowPosition, height) | Sheet | لضبط ارتفاع الصف للصف المحدّد بالبكسل. |
setRowHeights(startRow, numRows, height) | Sheet | لضبط ارتفاع الصفوف المحدّدة بالبكسل. |
setRowHeightsForced(startRow, numRows, height) | Sheet | لضبط ارتفاع الصفوف المحدّدة بالبكسل. |
setTabColor(color) | Sheet | لضبط لون علامة تبويب الورقة. |
setTabColorObject(color) | Sheet | لضبط لون علامة تبويب الورقة. |
showColumns(columnIndex) | void | إظهار العمود في الفهرس المعيّن |
showColumns(columnIndex, numColumns) | void | يظهر عمودًا واحدًا أو أكثر من الأعمدة المتتالية بدءًا من الفهرس المحدّد. |
showRows(rowIndex) | void | يظهر الصف في الفهرس. |
showRows(rowIndex, numRows) | void | يظهر صفًا واحدًا أو أكثر بدءًا من الفهرس المحدَّد. |
showSheet() | Sheet | لإظهار الورقة. |
sort(columnPosition) | Sheet | يتم ترتيب جدول بيانات تصاعدي حسب العمود. |
sort(columnPosition, ascending) | Sheet | لترتيب ورقة حسب العمود. |
unhideColumn(column) | void | يظهر العمود في النطاق المحدّد. |
unhideRow(row) | void | يظهر الصف في النطاق المحدّد. |
updateChart(chart) | void | يعدِّل الرسم البياني في ورقة البيانات هذه. |
المستندات التفصيلية
activate()
تفعيل ورقة البيانات هذه. لا يغيّر ورقة البيانات نفسها، بل يمثّل فقط فكرة العنصر الرئيسي لورقة البيانات النشطة.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
رحلة العودة
Sheet
— ورقة البيانات النشطة حديثًا.
addDeveloperMetadata(key)
تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد وحق الوصول إلى ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | إذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة المحدّدين إلى ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
تتم إضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة وإمكانية الوصول إلى ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the // visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | إذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
لإلحاق صف إلى أسفل منطقة البيانات الحالية في ورقة البيانات
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowContents | Object[] | مصفوفة من القيم المراد إدراجها بعد الصف الأخير في ورقة البيانات. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
تعرض ورقة البيانات باعتبارها DataSourceSheet
إذا كانت ورقة البيانات من النوع SheetType.DATASOURCE
، أو null
بخلاف ذلك.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the data source sheet value if the sheet is of type // SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value. const dataSourceSheet = sheet.asDataSourceSheet(); // Gets the data source sheet value and logs it to the console. console.log(dataSourceSheet); console.log(sheet.getType().toString());
رحلة العودة
DataSourceSheet
- ورقة مصدر بيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
لضبط عرض العمود المحدّد ليلائم محتواه.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود المحدد لتغيير حجمه. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
لضبط عرض جميع الأعمدة بدءًا من موضع العمود المحدد لتناسب محتواها.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startColumn | Integer | تم تغيير حجم عمود البدء تلقائيًا. |
numColumns | Integer | عدد الأعمدة المطلوب تغيير حجمها تلقائيًا. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
لضبط ارتفاع جميع الصفوف بدءًا من موضع الصف المحدد لتناسب محتواها.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startRow | Integer | صف البدء المطلوب تغيير حجمه تلقائيًا. |
numRows | Integer | عدد الصفوف المطلوب تغيير حجمها تلقائيًا. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
محو ورقة المحتوى وتنسيق التنسيق
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
رحلة العودة
Sheet
— الورقة التي تم محوها
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
لمحو ورقة المحتوى و/أو التنسيق، كما هو محدد بالخيارات المتقدمة المحددة
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
options | Object | خريطة JavaScript تحتوي على خيارات متقدّمة مُدرَجة أدناه. |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
contentsOnly | Boolean | محو المحتوى |
formatOnly | Boolean | تحديد ما إذا كنت تريد محو التنسيق. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
يزيل كل قواعد التنسيق الشرطي من ورقة البيانات. يعادل استدعاء setConditionalFormatRules(rules)
مع مصفوفة فارغة كإدخال.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
لمحو ورقة المحتوى مع الاحتفاظ بمعلومات التنسيق.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
لمحو ورقة التنسيق، مع الاحتفاظ بالمحتوى
يشير التنسيق إلى كيفية تنسيق البيانات كما هو مسموح به في الخيارات ضمن قائمة "تنسيق" (على سبيل المثال: غامق ومائل والتنسيق الشرطي) وليس عرض الخلايا أو ارتفاعها.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
محو ورقة جميع الملاحظات
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
تصغير كل مجموعات الأعمدة في ورقة البيانات
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
تصغير كل مجموعات الصفوف في ورقة البيانات
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
يؤدّي هذا الإجراء إلى نسخ جدول البيانات إلى جدول بيانات معيّن، ويمكن أن يكون جدول البيانات نفسه الذي يكون فيه المصدر. تسمى الورقة المنسوخة "نسخة من [الاسم الأصلي]".
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
spreadsheet | Spreadsheet | جدول البيانات المراد نسخ ورقة البيانات هذه إليه، والذي يمكن أن يكون جدول البيانات نفسه الذي يظهر فيه المصدر. |
رحلة العودة
Sheet
— الورقة الجديدة للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
تعرض DeveloperMetadataFinder
للبحث عن البيانات الوصفية لمطوّر البرامج ضمن نطاق ورقة البيانات هذه. تقع البيانات الوصفية في نطاق ورقة بيانات معيّنة إذا كانت مرتبطة بالورقة نفسها، أو مرتبطة بصف أو عمود أو نطاق على ورقة البيانات هذه.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Creates the developer metadata finder. const metadatafinder = sheet.createDeveloperMetadataFinder(); // Finds the metadata with value 'PARIS' and displays its key in the console. console.log(metadatafinder.withValue('PARIS').find()[0].getKey());
رحلة العودة
DeveloperMetadataFinder
: باحث بيانات وصفية لمطوّر البرامج للبحث عن البيانات الوصفية في نطاق ورقة البيانات هذه.
createTextFinder(findText)
يؤدّي هذا الإجراء إلى إنشاء أداة البحث عن نص في ورقة البيانات، والتي يمكنها البحث عن النص واستبداله في ورقة البيانات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه. |
رحلة العودة
TextFinder
— TextFinder
للورقة.
deleteColumn(columnPosition)
حذف العمود في موضع العمود المعني
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود، بدءًا من 1 للعمود الأول. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
حذف عدد الأعمدة التي تبدأ في موضع الأعمدة المحدّد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود الأول المطلوب حذفه. |
howMany | Integer | عدد الأعمدة المطلوب حذفها |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
حذف الصف في موضع الصف المحدد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف، بدءًا من الرقم 1 للصف الأول. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
حذف عدد من الصفوف بدءًا من موضع الصف المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف الأول الذي سيتم حذفه. |
howMany | Integer | عدد الصفوف المطلوب حذفها |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllColumnGroups()
توسيع كل مجموعات الأعمدة في ورقة البيانات. تتطلّب هذه الطريقة مجموعة أعمدة واحدة على الأقل.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
توسيع كل مجموعات الصفوف في ورقة البيانات. تتطلّب هذه الطريقة مجموعة صفوف واحدة على الأقل.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
توسيع جميع مجموعات الأعمدة إلى العمق المحدد، وتصغير جميع المجموعات الأخرى
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
groupDepth | Integer | نظرة معمّقة على المجموعة تصل إليها مجموعات الأعمدة. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
تعمل على توسيع كل مجموعات الصفوف حتى العمق المحدّد، وكذلك تصغير كل المجموعات الأخرى.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
groupDepth | Integer | عمق المجموعة لغاية توسيع مجموعات الصفوف. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
لعرض الخلية النشطة في ورقة البيانات هذه.
ملاحظة: ننصح باستخدام السمة getCurrentCell()
التي تعرض الخلية المميّزة الحالية.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
رحلة العودة
Range
: الخلية النشطة الحالية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
يعرض النطاق المحدد في الورقة النشطة أو null
إذا لم يكن هناك نطاق نشط. وإذا تم اختيار نطاقات متعددة، لن تؤدي هذه الطريقة إلا إلى عرض النطاق الأخير الذي تم اختياره فقط.
يشير مصطلح "النطاق النشط" إلى النطاق الذي اختاره المستخدم في ورقة البيانات النشطة، ولكن في الدالة المخصّصة يشير إلى الخلية التي تتم إعادة حسابها بفاعلية.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
رحلة العودة
Range
: النطاق النشط
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
يمكن أيضًا مراجعة
getActiveRangeList()
يعرض قائمة النطاقات النشطة في ورقة البيانات النشطة أو null
في حال عدم توفّر نطاقات نشطة.
إذا كان هناك نطاق واحد محدّد، سيعمل ذلك كمكالمة getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
رحلة العودة
RangeList
- قائمة النطاقات النشطة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
يمكن أيضًا مراجعة
getBandings()
تعرض جميع النطاقات في هذه الورقة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
رحلة العودة
Banding[]
: كل النطاقات في هذه الورقة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
تعرض صفيفًا من الرسومات البيانية في هذه الورقة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
رحلة العودة
EmbeddedChart[]
: مصفوفة من الرسومات البيانية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
لعرض مجموعة الأعمدة بالمؤشر المحدد وعمق المجموعة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. var columnGroup = sheet.getColumnGroup(2, 1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس عمود زر تبديل التحكُّم في المجموعة أو فهرس داخل المجموعة. |
groupDepth | Integer | عمق المجموعة |
رحلة العودة
Group
: مجموعة الأعمدة في فهرس عنصر التحكّم وعمقها، أو التي تتضمن استثناءً في حال عدم توفّر المجموعة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
تعرض GroupControlTogglePosition
لجميع مجموعات الأعمدة في ورقة البيانات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
رحلة العودة
GroupControlTogglePosition
: true
إذا تم عرض زر تبديل التحكّم في تجميع الأعمدة بعد المجموعة على ورقة البيانات هذه وfalse
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
لعرض عمق المجموعة في العمود على الفهرس المحدد.
يشير عمق المجموعة إلى عدد المجموعات التي تتداخل مع العمود. وقد يتراوح هذا العدد بين صفر و8 حسابات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس العمود. |
رحلة العودة
Integer
— عمق المجموعة في العمود في الفهرس المحدد.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
للحصول على العرض بالبكسل للعمود المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود المطلوب فحصه. |
رحلة العودة
Integer
— عرض العمود بالبكسل
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getConditionalFormatRules()
يمكنك الحصول على جميع قواعد التنسيق الشرطي في ورقة البيانات هذه.
// Logs the conditional format rules in a sheet. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var rule = rules[i]; Logger.log(rule); }
رحلة العودة
ConditionalFormatRule[]
: مصفوفة من جميع القواعد في ورقة البيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
لعرض الخلية الحالية في ورقة البيانات النشطة أو null
إذا لم تكن هناك خلية حالية. الخلية الحالية هي الخلية التي يتم التركيز عليها في واجهة مستخدم "جداول بيانات Google"، ويتم تمييزها بحدود داكنة. لا توجد أكثر من خلية حالية مطلقًا. عندما يختار المستخدم نطاقًا واحدًا أو أكثر من الخلايا، تكون إحدى الخلايا في التحديد هي الخلية الحالية.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
رحلة العودة
Range
: الخلية الحالية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
تعرِض Range
المقابلة للأبعاد التي تتوفّر بها البيانات.
يعادل ذلك عمليًا إنشاء نطاق مقيَّد بـ A1 و(Sheet.getLastColumn() وSheet.getLastالصفوف()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
رحلة العودة
Range
: نطاق يتضمن كل البيانات في جدول البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
تحصل على جميع صيغ مصدر البيانات.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
رحلة العودة
DataSourceFormula[]
- قائمة بصيغ مصادر البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
الحصول على جميع الجداول المحورية لمصدر البيانات
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
رحلة العودة
DataSourcePivotTable[]
- قائمة بالجداول المحورية لمصدر البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
الحصول على جميع جداول مصادر البيانات
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
رحلة العودة
DataSourceTable[]
- قائمة بجداول مصادر البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
الحصول على جميع البيانات الوصفية لمطوّري البرامج المرتبطة بهذه الورقة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
رحلة العودة
DeveloperMetadata[]
: البيانات الوصفية لمطوّر البرامج المرتبطة بهذه الورقة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
تعرض صفيفًا من الرسومات في ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
رحلة العودة
Drawing[]
- قائمة الرسومات في ورقة البيانات هذه.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
يتم عرض الفلتر في ورقة البيانات هذه أو null
في حال عدم توفّر فلتر.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
رحلة العودة
Filter
— الفلتر
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
تعرض عنوان URL للنموذج الذي يرسل ردوده على ورقة البيانات هذه، أو null
إذا لم تكن ورقة البيانات هذه تحتوي على نموذج مرتبط.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
رحلة العودة
String
: عنوان URL للنموذج الذي يضع ردوده في ورقة البيانات هذه، أو null
إذا لم تكن ورقة البيانات هذه تحتوي على نموذج مرتبط.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
لعرض عدد الأعمدة المجمّدة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
رحلة العودة
Integer
: عدد الأعمدة المجمّدة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
لعرض عدد الصفوف المجمّدة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
رحلة العودة
Integer
: عدد الصفوف المجمّدة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
لعرض جميع الصور المعروضة على الشبكة في ورقة البيانات.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
رحلة العودة
OverGridImage[]
: مصفوفة من الصور المعروضة على الشبكة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
للحصول على موضع جدول البيانات في جدول البيانات الرئيسي يبدأ العرض في 1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
رحلة العودة
Integer
- موضع جدول البيانات في جدول البيانات الرئيسي.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
لعرض موضع العمود الأخير الذي يتضمن محتوى.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
رحلة العودة
Integer
: العمود الأخير في جدول البيانات الذي يتضمن محتوى
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
لعرض موضع الصف الأخير الذي يتضمن محتوى.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
رحلة العودة
Integer
: الصف الأخير من جدول البيانات الذي يتضمن محتوى
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
لعرض العدد الحالي من الأعمدة في ورقة البيانات، بغض النظر عن المحتوى.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
رحلة العودة
Integer
: الحد الأقصى لعرض جدول البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
لعرض العدد الحالي من الصفوف في ورقة البيانات، بغض النظر عن المحتوى.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
رحلة العودة
Integer
: الحد الأقصى لارتفاع ورقة البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
تعرض اسم ورقة البيانات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
رحلة العودة
String
: اسم ورقة البيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
تحصل على جميع النطاقات المُعنوَنة في ورقة البيانات هذه.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
رحلة العودة
NamedRange[]
: مصفوفة من النطاقات المُعنوَنة في ورقة البيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
تعرض Spreadsheet
التي تحتوي على ورقة البيانات هذه.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
رحلة العودة
Spreadsheet
— جدول البيانات الرئيسي.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
تعرض جميع الجداول المحورية في ورقة البيانات هذه.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the pivot table info for the sheet. const pivotTables = sheet.getPivotTables(); // Logs the pivot tables to the console. for (const pivotTable of pivotTables) { console.log(pivotTable.getSourceDataRange().getValues()); }
رحلة العودة
PivotTable[]
: الجداول المحورية في ورقة البيانات هذه.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
تحصل على مصفوفة من العناصر التي تمثل جميع النطاقات المحمية في ورقة البيانات، أو مصفوفة من عنصر واحد تمثل الحماية على ورقة البيانات نفسها.
// Remove all range protections in the spreadsheet that the user has permission to edit. var sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && protection.canEdit()) { protection.remove(); }
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
type | ProtectionType | نوع المنطقة المحمية، إما SpreadsheetApp.ProtectionType.RANGE أو SpreadsheetApp.ProtectionType.SHEET . |
رحلة العودة
Protection[]
: مصفوفة من العناصر التي تمثل جميع النطاقات المحمية في ورقة البيانات، أو مصفوفة من عنصر واحد تمثل الحماية في ورقة البيانات نفسها.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
لعرض النطاق مع الخلية العلوية اليسرى بالإحداثيات المحددة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Integer | فهرس صف الخلية المطلوب عرضه، وتبدأ فهرسة الصف بالرقم 1. |
column | Integer | فهرس العمود للخلية التي سيتم عرضها، وتبدأ فهرسة الأعمدة بالرقم 1. |
رحلة العودة
Range
: نطاق يحتوي على هذه الخلية فقط.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
تعرض النطاق مع الخلية العلوية اليسرى في الإحداثيات المحددة، وبعدد محدد من الصفوف.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Integer | فهرس صف البداية للنطاق، وتبدأ فهرسة الصفوف بالرقم 1. |
column | Integer | فهرس عمود النطاق، وتبدأ فهرسة الأعمدة بالرقم 1. |
numRows | Integer | عدد الصفوف المطلوب عرضها. |
رحلة العودة
Range
: نطاق يحتوي على عمود واحد من البيانات مع عدد الصفوف المحددة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
تعرض النطاق مع الخلية العلوية اليمنى بالإحداثيات المحددة مع العدد المحدّد من الصفوف والأعمدة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Integer | فهرس صف البداية للنطاق، وتبدأ فهرسة الصفوف بالرقم 1. |
column | Integer | فهرس عمود البداية للنطاق، وتبدأ فهرسة الأعمدة بالرقم 1. |
numRows | Integer | عدد الصفوف المطلوب عرضها. |
numColumns | Integer | عدد الأعمدة المطلوب عرضها. |
رحلة العودة
Range
: نطاق مقابل المنطقة المحدَّدة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
تعرض النطاق المحدد في تدوين A1 أو تدوين R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
a1Notation | String | النطاق المراد عرضه، كما هو محدّد في تدوين A1 أو تدوين R1C1. |
رحلة العودة
Range
: النطاق في الموقع الجغرافي المحدّد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
تعرض المجموعة RangeList
التي تمثل النطاقات في ورقة البيانات نفسها المحدّدة من خلال قائمة غير فارغة من علامات A1 أو علامات R1C1.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
a1Notations | String[] | قائمة النطاقات المطلوب عرضها، كما هو محدّد في تدوين A1 أو تدوين R1C1. |
رحلة العودة
RangeList
: قائمة النطاقات في الموقع الجغرافي المحدّد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
لعرض مجموعة الصفوف وفقًا لعمق المجموعة والمجموعة المحدّدة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. var rowGroup = sheet.getRowGroup(2, 1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس صف عنصر التحكّم في المجموعة أو فهرس داخل المجموعة. |
groupDepth | Integer | عمق المجموعة |
رحلة العودة
Group
: مجموعة الصفوف في فهرس التحكّم وعمقها، أو تستثني استثناءً إذا لم تكن المجموعة متاحة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
تعرض GroupControlTogglePosition
لجميع مجموعات الصفوف في ورقة البيانات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
رحلة العودة
GroupControlTogglePosition
: true
إذا تم عرض زر إيقاف/تفعيل التحكُّم في تجميع الصفوف بعد المجموعة في ورقة البيانات هذه وfalse
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
لعرض عمق المجموعة للصف في الفهرس المحدد.
يشير عمق المجموعة إلى عدد المجموعات التي تتداخل مع الصف. يمكن أن يتراوح هذا العدد بين صفر و8.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس الصف. |
رحلة العودة
Integer
— عمق المجموعة للصف في الفهرس المحدد.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
للحصول على الارتفاع بالبكسل للصف المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف المراد فحصه. |
رحلة العودة
Integer
: ارتفاع الصف بالبكسل
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
لعرض Selection
الحالية في جدول البيانات.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
رحلة العودة
Selection
- الاختيار الحالي
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetId()
تعرض رقم تعريف الورقة التي يمثّلها هذا العنصر.
هذا هو رقم تعريف جدول البيانات الفريد في جدول البيانات. رقم التعريف هو عدد صحيح
أحادي الاتجاه يتم تعيينه في وقت إنشاء الورقة، ويكون مستقلاً عن موضع الورقة. ويُعدّ ذلك مفيدًا إلى جانب طرق مثل Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
التي تستخدِم معلَمة gridId
بدلاً من مثيل Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
رحلة العودة
Integer
: رقم تعريف جدول البيانات الفريد في جدول البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
يعرض اسم الورقة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
رحلة العودة
String
: اسم ورقة البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
تعرض شبكة القيم المستطيلة لهذا النطاق بدءًا من الإحداثيات المحددة. تساوي قيمة -1 المحددة كموضع الصف أو العمود آخر صف أو عمود يتضمّن بيانات في ورقة البيانات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startRow | Integer | موضع صف البدء. |
startColumn | Integer | موضع عمود البدء. |
numRows | Integer | عدد الصفوف لعرض القيم لها. |
numColumns | Integer | عدد الأعمدة التي يتم عرض قيم لها. |
رحلة العودة
Object[][]
— مصفوفة من الأبعاد ثنائية الأبعاد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
تعرض صفيفًا على قطاعات شرائح في الورقة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
رحلة العودة
Slicer[]
- قائمة فلاتر نطاق البيانات على ورقة البيانات هذه.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
الحصول على لون علامة تبويب ورقة البيانات، أو null
إذا لم تكن علامة تبويب الورقة تحتوي على لون.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
رحلة العودة
Color
: لون علامة تبويب ورقة البيانات، أو null
إذا لم تكن علامة تبويب ورقة البيانات لونًا.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
تعرض نوع الورقة.
إنّ النوع التلقائي من جداول البيانات هو SheetType.GRID
. ورقة البيانات التي تحتوي على عنصر مضمّن واحد، مثل EmbeddedChart
هي ورقة بيانات من SheetType.OBJECT
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
رحلة العودة
SheetType
: نوع الورقة
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
عرض true
إذا كانت خطوط الشبكة في الورقة مخفية، أو عرض false
.
تظهر خطوط الشبكة بشكل تلقائي.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if the spreadsheet has hidden gridelines and logs the result to the console. console.log(sheet.hasHiddenGridlines());
رحلة العودة
Boolean
— true
إذا كانت خطوط الشبكة مخفية، أو false
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
إخفاء العمود أو الأعمدة في النطاق المحدّد
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
column | Range | نطاق العمود المطلوب إخفاءه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
إخفاء عمود واحد في الفهرس المحدّد استخدِم فهرسًا واحدًا لهذه الطريقة.
لإخفاء أكثر من عمود باستخدام فهرس، استخدِم hideColumns(columnIndex, numColumns)
.
لإخفاء أكثر من عمود باستخدام نطاق، استخدِم hideColumn()
.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس العمود الذي سيتم إخفاءه |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
إخفاء عمود واحد أو أكثر من الأعمدة المتتابعة بدءًا من الفهرس المحدد. استخدِم فهرسًا واحدًا لهذه الطريقة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس بداية الأعمدة المطلوب إخفاؤها |
numColumns | Integer | عدد الأعمدة المطلوب إخفاؤها |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
إخفاء الصفوف في النطاق المحدّد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Range | نطاق الصف المطلوب إخفاءه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
إخفاء الصف في الفهرس المحدّد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس الصف المطلوب إخفاءه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
إخفاء صف واحد متتالي أو أكثر بدءًا من الفهرس المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس بداية الصفوف المطلوب إخفاؤها. |
numRows | Integer | عدد الصفوف المطلوب إخفاؤها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
إخفاء ورقة البيانات هذه. لا يكون لها أي تأثير إذا كانت الورقة مخفية. إذا تم طلب هذه الطريقة في ورقة البيانات المرئية فقط، ستعرض لها استثناءً.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
رحلة العودة
Sheet
— ورقة البيانات الحالية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
لإضافة رسم بياني جديد إلى هذه الورقة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B4")) .setPosition(5, 5, 0, 0) .setOption("title", "Dynamic Chart") .build(); sheet.insertChart(chart);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
chart | EmbeddedChart | الرسم البياني المطلوب إدخاله |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
إدراج عمود بعد موضع العمود المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
afterPosition | Integer | العمود الذي يجب إضافة العمود الجديد بعده. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
إدخال عمود قبل موضع العمود المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
beforePosition | Integer | العمود الذي يجب إضافة العمود الجديد إليه. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
إدراج عمود فارغ في ورقة بيانات في المكان المحدّد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | المؤشر يشير إلى مكان إدراج عمود. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
إدراج عمود فارغ واحد أو أكثر من الأعمدة الفارغة في جدول بيانات بدءًا من الموقع المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | المؤشر يشير إلى مكان إدراج عمود. |
numColumns | Integer | عدد الأعمدة المراد إدخالها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
إدراج عدد من الأعمدة بعد موضع العمود المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the second column position sheet.insertColumnsAfter(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
afterPosition | Integer | العمود الذي يجب إضافة العمود الجديد بعده. |
howMany | Integer | عدد الأعمدة المراد إدخالها. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
إدراج عدد من الأعمدة قبل موضع العمود المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
beforePosition | Integer | العمود الذي يجب إضافة العمود الجديد إليه. |
howMany | Integer | عدد الأعمدة المراد إدخالها. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
إدراج BlobSource
كصورة في المستند في صف وعمود معيّن. يتم استرداد حجم
الصورة من محتوى الكائن الثنائي الكبير (blob). الحد الأقصى المسموح به لحجم الكائن الثنائي الكبير (blob) هو 2 ميغابايت.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
blobSource | BlobSource | الكائن الثنائي الكبير (blob) الذي يحتوي على محتوى الصورة ونوع MIME واسمه (اختياري) |
column | Integer | موضع العمود. |
row | Integer | تمثّل هذه السمة موضع الصف. |
رحلة العودة
OverGridImage
: الصورة التي تم إدراجها
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
يتم إدراج BlobSource
كصورة في المستند في صف وعمود معيّن، مع إزاحة بكسل. يتم استرداد حجم الصورة من محتوى الكائن الثنائي الكبير (blob). الحد الأقصى المسموح به لحجم الكائن الثنائي الكبير (blob) هو 2 ميغابايت.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
blobSource | BlobSource | الكائن الثنائي الكبير (blob) الذي يحتوي على محتوى الصورة ونوع MIME واسمه (اختياري) |
column | Integer | موضع العمود. |
row | Integer | تمثّل هذه السمة موضع الصف. |
offsetX | Integer | الإزاحة الأفقية من زاوية الخلية بالبكسل. |
offsetY | Integer | إزاحة رأسية من زاوية الخلية بالبكسل. |
رحلة العودة
OverGridImage
: الصورة التي تم إدراجها
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
إدراج صورة في المستند في صف وعمود محدد.
يجب أن تتوفّر للجميع إمكانية الوصول إلى عنوان URL المقدَّم.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للصورة |
column | Integer | موضع عمود الشبكة. |
row | Integer | تمثّل هذه السمة موضع صف الشبكة. |
رحلة العودة
OverGridImage
: الصورة التي تم إدراجها
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
إدراج صورة في المستند في صف وعمود محدد، مع إزاحة بكسل.
يجب أن تتوفّر للجميع إمكانية الوصول إلى عنوان URL المقدَّم.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للصورة |
column | Integer | موضع العمود. |
row | Integer | تمثّل هذه السمة موضع الصف. |
offsetX | Integer | الإزاحة الأفقية من زاوية الخلية بالبكسل. |
offsetY | Integer | إزاحة رأسية من زاوية الخلية بالبكسل. |
رحلة العودة
OverGridImage
: الصورة التي تم إدراجها
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
إدراج صف بعد موضع الصف المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
afterPosition | Integer | الصف الذي يجب إضافة الصف الجديد بعده. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
إدخال صف قبل موضع الصف المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
beforePosition | Integer | الصف الذي يجب إضافة الصف الجديد قبله. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
إدراج صف فارغ في ورقة في الموقع المحدد
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | الفهرس الذي يشير إلى مكان إدراج صف |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
إدراج صف فارغ واحد أو أكثر متتاليين في جدول بيانات يبدأ من الموقع المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | الفهرس الذي يشير إلى مكان إدراج صف |
numRows | Integer | عدد الصفوف المراد إدخالها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
إدراج عدد من الصفوف بعد موضع الصف المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
afterPosition | Integer | الصف الذي يجب إضافة الصفوف الجديدة بعده. |
howMany | Integer | عدد الصفوف المراد إدخالها. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
إدراج عدد من الصفوف قبل موضع الصف المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
beforePosition | Integer | الصف الذي يجب إضافة الصفوف الجديدة قبله. |
howMany | Integer | عدد الصفوف المراد إدخالها. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
إضافة فلتر نطاق بيانات جديد إلى هذه الورقة
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
range | Range | النطاق الذي يتم إنشاء فلتر نطاق البيانات عليه. |
anchorRowPos | Integer | تم إرساء الجانب العلوي من فلتر نطاق البيانات في هذا الصف. |
anchorColPos | Integer | تم إبراز الجانب العلوي من فلتر نطاق البيانات في هذه المجموعة. |
رحلة العودة
Slicer
— فلتر نطاق البيانات الذي تم إدخاله حديثًا.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
إضافة فلتر نطاق بيانات جديد إلى هذه الورقة
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
range | Range | النطاق الذي يتم إنشاء فلتر نطاق البيانات عليه. |
anchorRowPos | Integer | تم إرساء الجانب العلوي من فلتر نطاق البيانات في هذا الصف. |
anchorColPos | Integer | تم إبراز الجانب العلوي من فلتر نطاق البيانات في هذه المجموعة. |
offsetX | Integer | الإزاحة الأفقية من زاوية الخلية بالبكسل. |
offsetY | Integer | إزاحة رأسية من زاوية الخلية بالبكسل. |
رحلة العودة
Slicer
— فلتر نطاق البيانات الذي تم إدخاله حديثًا.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
يعرض ما إذا كان العمود الذي يظهر مخفيًا بواسطة المستخدم.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود المطلوب فحصه. |
رحلة العودة
Boolean
- true
إذا كان العمود مخفيًا، false
وبخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRightToLeft()
عرض true
إذا كان تنسيق الورقة هذا من اليمين إلى اليسار. تعرض false
إذا كانت ورقة البيانات تستخدم التنسيق التلقائي من اليسار إلى اليمين.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if a spreadsheet is ordered from right to left and logs the result to the console. console.log(sheet.isRightToLeft());
رحلة العودة
Boolean
— true
إذا كان من اليمين إلى اليسار، وبخلاف ذلك false
.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
لعرض ما إذا كان الصف المحدّد مخفيًا باستخدام فلتر (وليس عرض فلتر).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف المراد فحصه. |
رحلة العودة
Boolean
— true
إذا كان الصف مخفيًا، أو false
في حال عدم ظهوره.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
يعرض ما إذا كان الصف المحدّد مخفيًا بواسطة المستخدم.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف المراد فحصه. |
رحلة العودة
Boolean
— true
إذا كان الصف مخفيًا، أو false
في حال عدم ظهوره.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
عرض true
إذا كانت الورقة مخفية حاليًا.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
رحلة العودة
Boolean
- true
إذا كانت ورقة البيانات مخفية، false
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
نقل الأعمدة التي تم اختيارها من خلال النطاق المحدّد إلى الموضع المشار إليه من خلال destinationIndex
ليس من الضروري أن يمثل columnSpec
نفسه عمودًا أو مجموعة أعمدة بأكملها لنقلها، بل يختار جميع الأعمدة التي يمتد إليها هذا النطاق.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnSpec | Range | نطاق يمتد بين الأعمدة التي يجب نقلها. |
destinationIndex | Integer | الفهرس الذي يجب نقل الأعمدة إليه. لاحظ أن هذا الفهرس يستند إلى الإحداثيات قبل نقل الأعمدة. ويتم نقل البيانات الحالية إلى اليمين لتوفير مساحة للأعمدة التي يتم نقلها أثناء إزالة أعمدة المصدر من الشبكة. لذلك، قد تنتهي البيانات بفهرس مختلف عن المحدد الأصلي. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
نقل الصفوف التي تم اختيارها من خلال النطاق المحدّد إلى الموضع المُشار إليه من خلال destinationIndex
وليس من الضروري أن تمثّل rowSpec
نفسها صفًا كاملاً أو مجموعة صفوف لنقلها، بل يمكنها اختيار جميع الصفوف التي يشملها النطاق.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var rowSpec = sheet.getRange("A1:A2"); sheet.moveRows(rowSpec, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowSpec | Range | نطاق يمتد عبر الصفوف التي يجب نقلها. |
destinationIndex | Integer | الفهرس الذي يجب نقل الصفوف إليه لاحظ أن هذا الفهرس يستند إلى الإحداثيات قبل نقل الصفوف. ويتم نقل البيانات الحالية لتوفير مساحة للصفوف التي يتم نقلها أثناء إزالة صفوف المصدر من الشبكة. لذلك، قد تنتهي البيانات بمؤشر مختلف عن الفهرس المحدّد في الأصل. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
لعرض أداة إنشاء لإنشاء رسم بياني جديد لهذه الورقة.
يوضّح هذا المثال كيفية إنشاء رسم بياني جديد:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
رحلة العودة
EmbeddedChartBuilder
: أداة إنشاء لإنشاء رسم بياني جديد
protect()
تنشئ عنصرًا يمكنه حماية جدول البيانات من التعديل باستثناء المستخدمين الذين لديهم إذن. إلى أن يغيّر النص البرمجي قائمة أدوات تحرير ورقة البيانات (من خلال استدعاء
Protection.removeEditor(emailAddress)
أو Protection.removeEditor(user)
أو Protection.removeEditors(emailAddresses)
أو Protection.addEditor(emailAddress)
أو Protection.addEditor(user)
أو Protection.addEditors(emailAddresses)
أو ضبط قيمة جديدة
لـ Protection.setDomainEdit(editable)
)، تتطابق الأذونات مع أذونات جدول البيانات نفسه، ما يعني أن الورقة لا تزال غير محمية. إذا كانت ورقة البيانات محمية
من قبل، ستعرض هذه الطريقة عنصرًا يمثّل إعدادات الحماية الحالية.
قد تتضمّن ورقة بيانات محمية مناطق غير محمية.
// Protect the active sheet, then remove all other users from the list of editors. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
رحلة العودة
Protection
: كائن يمثّل إعدادات الحماية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
يزيل رسمًا بيانيًا من الورقة الرئيسية.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
chart | EmbeddedChart | الرسم البياني المطلوب إزالته |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
لضبط النطاق المحدّد على أنه active range
في ورقة البيانات النشطة، مع أعلى خلية إلى يمين النطاق في النطاق current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
range | Range | النطاق المراد ضبطه كنطاق نشط. |
رحلة العودة
Range
: النطاق النشط حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
لضبط قائمة النطاقات المحدّدة على أنها active ranges
في ورقة البيانات النشطة. تم ضبط النطاق الأخير في القائمة على أنه active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rangeList | RangeList | قائمة النطاقات المطلوب اختيارها |
رحلة العودة
RangeList
: قائمة النطاقات التي تم اختيارها حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
لضبط منطقة الاختيار النشطة لهذه الورقة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
range | Range | النطاق المراد تحديده كاختيار نشط. |
رحلة العودة
Range
: النطاق النشط حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
لضبط الاختيار النشط، كما هو محدد في تدوين A1 أو تدوين R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
a1Notation | String | النطاق المراد ضبطه كنشط، كما هو محدد في تدوين A1 أو تدوين R1C1. |
رحلة العودة
Range
: النطاق النشط حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
لضبط موضع مفتاح تحكّم مجموعة الأعمدة على ورقة البيانات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
position | GroupControlTogglePosition | موضع زر تبديل مجموعة التحكّم في الأعمدة. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
لضبط عرض العمود المحدّد بالبكسل.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | موضع العمود المحدّد المراد ضبطه. |
width | Integer | العرض بالبكسل لضبطه على |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
لضبط عرض الأعمدة المحدّدة بالبكسل.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startColumn | Integer | موضع عمود البدء المراد تغييره. |
numColumns | Integer | عدد الأعمدة المطلوب تغييرها |
width | Integer | العرض بالبكسل لضبطه على |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
استبدال كل قواعد التنسيق الشرطي الحالية في جدول البيانات بقواعد الإدخال يتم تقييم القواعد وفقًا لترتيب الإدخال.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rules | ConditionalFormatRule[] | قواعد التنسيق الشرطي الجديدة. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
لضبط الخلية المحدّدة على أنها current cell
.
إذا كانت الخلية المحددة موجودة في نطاق محدّد من قبل، سيصبح هذا النطاق هو النطاق النشط مع الخلية في الخلية الحالية.
إذا لم تكن الخلية المحددة موجودة في أي نطاق محدد، ستتم إزالة أي اختيار حالي وتصبح الخلية الخلية الحالية والنطاق النشط.
ملاحظة: يجب أن تتألّف السمة Range
المحدّدة من خلية واحدة، وإلا سيتم عرض استثناء.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
cell | Range | الخلية التي سيتم ضبطها كخلية حالية. |
رحلة العودة
Range
- الخلية الحالية التي تم إعدادها حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
يعمل على تجميد العدد المحدّد من الأعمدة. وإذا كانت القيمة صفرًا، لا يتم تجميد أي أعمدة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columns | Integer | عدد الأعمدة المطلوب تجميدها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
يؤدي هذا الخيار إلى تجميد العدد المحدّد من الصفوف. في حال عدم تطابق أي صف، لن يتم تجميد أي صفوف.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rows | Integer | عدد الصفوف المطلوب تجميدها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
إخفاء خطوط الشبكة الورقة أو إظهارها
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
hideGridlines | Boolean | في حال ضبط true على إخفاء خطوط الشبكة في ورقة البيانات هذه، يمكنك عرض
خطوط الشبكة. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
ضبط اسم الورقة
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | الاسم الجديد لجدول البيانات. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
تعيين تنسيق ورقة البيانات أو إلغاء ضبطه على اليمين إلى اليسار.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the sheet layout, so that the sheet is ordered from right to left. sheet.setRightToLeft(true);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rightToLeft | Boolean | إذا تم ضبط true ، سيتم ضبط تنسيق ورقة البيانات من اليمين إلى اليسار، مع الخلية A1
في أعلى يسار الصفحة. إذا تم ضبط false على تنسيق الورقة، سيتم ضبطه على الإعداد التلقائي من اليسار إلى اليمين، مع الخلية A1 في أعلى يمين الصفحة. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
لضبط موضع زر تبديل مجموعة التحكّم في الصفوف على ورقة البيانات.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
position | GroupControlTogglePosition | موضع زر تبديل مجموعة التحكّم في الصفوف. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
لضبط ارتفاع الصف للصف المحدّد بالبكسل. يتم توسيع الصفوف تلقائيًا لتناسب محتوى الخلية. إذا كنت تريد فرض ارتفاع الصفوف على ارتفاع معيّن، يمكنك استخدام setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowPosition | Integer | موضع الصف المراد تغييره. |
height | Integer | الارتفاع بالبكسل لضبطه على |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
لضبط ارتفاع الصفوف المحدّدة بالبكسل. يتم توسيع الصفوف تلقائيًا لتناسب محتوى الخلية. وإذا كنت
تريد فرض ارتفاع الصفوف على ارتفاع معيّن، يمكنك استخدام setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startRow | Integer | موضع صف البدء المراد تغييره. |
numRows | Integer | عدد الصفوف المطلوب تغييرها. |
height | Integer | الارتفاع بالبكسل لضبطه على |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
لضبط ارتفاع الصفوف المحدّدة بالبكسل. يتم توسيع الصفوف تلقائيًا لتناسب محتوى الخلية. عند استخدام setRowHeightsForced
، يتم فرض الصفوف على الارتفاع المحدّد حتى إذا كان محتوى الخلية أطول من ارتفاع الصف.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 5 pixels. sheet.setRowHeightsForced(1, 3, 5);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
startRow | Integer | موضع صف البدء المراد تغييره. |
numRows | Integer | عدد الصفوف المطلوب تغييرها. |
height | Integer | الارتفاع بالبكسل لضبطه على |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
لضبط لون علامة تبويب الورقة.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String | رمز لون في تدوين CSS (مثل '#ffffff' أو 'white' )، أو
null لإعادة ضبط لون علامة التبويب. |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
لضبط لون علامة تبويب الورقة.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); first.setTabColorObject(color); // Set the color to theme accent 1. first.setTabColorObject(null); // Unset the color.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون علامة تبويب الورقة الذي تريد ضبطه |
رحلة العودة
Sheet
: ورقة البيانات هذه للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
إظهار العمود في الفهرس المعيّن
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس العمود الذي تريد إظهاره. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
يظهر عمودًا واحدًا أو أكثر من الأعمدة المتتالية بدءًا من الفهرس المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnIndex | Integer | فهرس بداية الأعمدة المطلوب إظهاره |
numColumns | Integer | عدد الأعمدة المطلوب إظهارها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
يظهر الصف في الفهرس.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس الصف الذي سيتم إظهاره. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
يظهر صفًا واحدًا أو أكثر بدءًا من الفهرس المحدَّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowIndex | Integer | فهرس بداية الصفوف المطلوب إظهارها. |
numRows | Integer | عدد الصفوف المطلوب إظهارها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
لإظهار الورقة. لن يكون له أي تأثير إذا كانت الورقة مرئية من قبل.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
رحلة العودة
Sheet
— ورقة البيانات الحالية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
يتم ترتيب جدول بيانات تصاعدي حسب العمود.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | العمود المطلوب الترتيب حسبه. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
لترتيب ورقة حسب العمود. تستخدم مَعلمة لتحديد ترتيب تصاعدي أو تنازلي.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnPosition | Integer | العمود المطلوب الترتيب حسبه. |
ascending | Boolean | true للأنواع الصاعدة، false للترتيب التنازلي. |
رحلة العودة
Sheet
: ورقة البيانات مفيدة لسلسلة الطرق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
يظهر العمود في النطاق المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
column | Range | النطاق المراد إظهاره في حال إخفاؤه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
يظهر الصف في النطاق المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Range | النطاق المراد إظهاره في حال إخفاؤه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
يعدِّل الرسم البياني في ورقة البيانات هذه.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
chart | EmbeddedChart | الرسم البياني الذي سيتم تعديله. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets