Class Sheet

جدول بيانات

الوصول إلى أوراق البيانات وتعديلها تتم عادةً إعادة تسمية ورقة البيانات والوصول إلى كائنات النطاق من ورقة البيانات.

الطُرق

الطريقةنوع الإرجاعوصف قصير
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());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

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());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
visibilityDeveloperMetadataVisibilityإذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

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());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
valueStringقيمة البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

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());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
valueStringقيمة البيانات الوصفية الجديدة لمطوّر البرامج.
visibilityDeveloperMetadataVisibilityإذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

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"]);

المَعلمات

الاسمالنوعالوصف
rowContentsObject[]مصفوفة من القيم المراد إدراجها بعد الصف الأخير في ورقة البيانات.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود المحدد لتغيير حجمه.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startColumnIntegerتم تغيير حجم عمود البدء تلقائيًا.
numColumnsIntegerعدد الأعمدة المطلوب تغيير حجمها تلقائيًا.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startRowIntegerصف البدء المطلوب تغيير حجمه تلقائيًا.
numRowsIntegerعدد الصفوف المطلوب تغيير حجمها تلقائيًا.

رحلة العودة

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 });

المَعلمات

الاسمالنوعالوصف
optionsObjectخريطة JavaScript تحتوي على خيارات متقدّمة مُدرَجة أدناه.

المعلمات المتقدمة

الاسمالنوعالوصف
contentsOnlyBooleanمحو المحتوى
formatOnlyBooleanتحديد ما إذا كنت تريد محو التنسيق.

رحلة العودة

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);

المَعلمات

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

رحلة العودة

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');

المَعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.

رحلة العودة

TextFinderTextFinder للورقة.


deleteColumn(columnPosition)

حذف العمود في موضع العمود المعني

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود، بدءًا من 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);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود الأول المطلوب حذفه.
howManyIntegerعدد الأعمدة المطلوب حذفها

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف، بدءًا من الرقم 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);

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف الأول الذي سيتم حذفه.
howManyIntegerعدد الصفوف المطلوب حذفها

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
groupDepthIntegerنظرة معمّقة على المجموعة تصل إليها مجموعات الأعمدة.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
groupDepthIntegerعمق المجموعة لغاية توسيع مجموعات الصفوف.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس عمود زر تبديل التحكُّم في المجموعة أو فهرس داخل المجموعة.
groupDepthIntegerعمق المجموعة

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس العمود.

رحلة العودة

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));

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود المطلوب فحصه.

رحلة العودة

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();
}

المَعلمات

الاسمالنوعالوصف
typeProtectionTypeنوع المنطقة المحمية، إما 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]);

المَعلمات

الاسمالنوعالوصف
rowIntegerفهرس صف الخلية المطلوب عرضه، وتبدأ فهرسة الصف بالرقم 1.
columnIntegerفهرس العمود للخلية التي سيتم عرضها، وتبدأ فهرسة الأعمدة بالرقم 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]);
  }
}

المَعلمات

الاسمالنوعالوصف
rowIntegerفهرس صف البداية للنطاق، وتبدأ فهرسة الصفوف بالرقم 1.
columnIntegerفهرس عمود النطاق، وتبدأ فهرسة الأعمدة بالرقم 1.
numRowsIntegerعدد الصفوف المطلوب عرضها.

رحلة العودة

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]);
  }
}

المَعلمات

الاسمالنوعالوصف
rowIntegerفهرس صف البداية للنطاق، وتبدأ فهرسة الصفوف بالرقم 1.
columnIntegerفهرس عمود البداية للنطاق، وتبدأ فهرسة الأعمدة بالرقم 1.
numRowsIntegerعدد الصفوف المطلوب عرضها.
numColumnsIntegerعدد الأعمدة المطلوب عرضها.

رحلة العودة

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");

المَعلمات

الاسمالنوعالوصف
a1NotationStringالنطاق المراد عرضه، كما هو محدّد في تدوين 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']);

المَعلمات

الاسمالنوعالوصف
a1NotationsString[]قائمة النطاقات المطلوب عرضها، كما هو محدّد في تدوين 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس صف عنصر التحكّم في المجموعة أو فهرس داخل المجموعة.
groupDepthIntegerعمق المجموعة

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس الصف.

رحلة العودة

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));

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف المراد فحصه.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startRowIntegerموضع صف البدء.
startColumnIntegerموضع عمود البدء.
numRowsIntegerعدد الصفوف لعرض القيم لها.
numColumnsIntegerعدد الأعمدة التي يتم عرض قيم لها.

رحلة العودة

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());

رحلة العودة

Booleantrue إذا كانت خطوط الشبكة مخفية، أو 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);

المَعلمات

الاسمالنوعالوصف
columnRangeنطاق العمود المطلوب إخفاءه.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس العمود الذي سيتم إخفاءه

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس بداية الأعمدة المطلوب إخفاؤها
numColumnsIntegerعدد الأعمدة المطلوب إخفاؤها

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowRangeنطاق الصف المطلوب إخفاءه.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس الصف المطلوب إخفاءه.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس بداية الصفوف المطلوب إخفاؤها.
numRowsIntegerعدد الصفوف المطلوب إخفاؤها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
chartEmbeddedChartالرسم البياني المطلوب إدخاله

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
afterPositionIntegerالعمود الذي يجب إضافة العمود الجديد بعده.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
beforePositionIntegerالعمود الذي يجب إضافة العمود الجديد إليه.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerالمؤشر يشير إلى مكان إدراج عمود.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerالمؤشر يشير إلى مكان إدراج عمود.
numColumnsIntegerعدد الأعمدة المراد إدخالها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
afterPositionIntegerالعمود الذي يجب إضافة العمود الجديد بعده.
howManyIntegerعدد الأعمدة المراد إدخالها.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
beforePositionIntegerالعمود الذي يجب إضافة العمود الجديد إليه.
howManyIntegerعدد الأعمدة المراد إدخالها.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
blobSourceBlobSourceالكائن الثنائي الكبير (blob) الذي يحتوي على محتوى الصورة ونوع MIME واسمه (اختياري)
columnIntegerموضع العمود.
rowIntegerتمثّل هذه السمة موضع الصف.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
blobSourceBlobSourceالكائن الثنائي الكبير (blob) الذي يحتوي على محتوى الصورة ونوع MIME واسمه (اختياري)
columnIntegerموضع العمود.
rowIntegerتمثّل هذه السمة موضع الصف.
offsetXIntegerالإزاحة الأفقية من زاوية الخلية بالبكسل.
offsetYIntegerإزاحة رأسية من زاوية الخلية بالبكسل.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
urlStringعنوان URL للصورة
columnIntegerموضع عمود الشبكة.
rowIntegerتمثّل هذه السمة موضع صف الشبكة.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
urlStringعنوان URL للصورة
columnIntegerموضع العمود.
rowIntegerتمثّل هذه السمة موضع الصف.
offsetXIntegerالإزاحة الأفقية من زاوية الخلية بالبكسل.
offsetYIntegerإزاحة رأسية من زاوية الخلية بالبكسل.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
afterPositionIntegerالصف الذي يجب إضافة الصف الجديد بعده.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
beforePositionIntegerالصف الذي يجب إضافة الصف الجديد قبله.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerالفهرس الذي يشير إلى مكان إدراج صف

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerالفهرس الذي يشير إلى مكان إدراج صف
numRowsIntegerعدد الصفوف المراد إدخالها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
afterPositionIntegerالصف الذي يجب إضافة الصفوف الجديدة بعده.
howManyIntegerعدد الصفوف المراد إدخالها.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
beforePositionIntegerالصف الذي يجب إضافة الصفوف الجديدة قبله.
howManyIntegerعدد الصفوف المراد إدخالها.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rangeRangeالنطاق الذي يتم إنشاء فلتر نطاق البيانات عليه.
anchorRowPosIntegerتم إرساء الجانب العلوي من فلتر نطاق البيانات في هذا الصف.
anchorColPosIntegerتم إبراز الجانب العلوي من فلتر نطاق البيانات في هذه المجموعة.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rangeRangeالنطاق الذي يتم إنشاء فلتر نطاق البيانات عليه.
anchorRowPosIntegerتم إرساء الجانب العلوي من فلتر نطاق البيانات في هذا الصف.
anchorColPosIntegerتم إبراز الجانب العلوي من فلتر نطاق البيانات في هذه المجموعة.
offsetXIntegerالإزاحة الأفقية من زاوية الخلية بالبكسل.
offsetYIntegerإزاحة رأسية من زاوية الخلية بالبكسل.

رحلة العودة

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));

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود المطلوب فحصه.

رحلة العودة

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());

رحلة العودة

Booleantrue إذا كان من اليمين إلى اليسار، وبخلاف ذلك 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));

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف المراد فحصه.

رحلة العودة

Booleantrue إذا كان الصف مخفيًا، أو 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));

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف المراد فحصه.

رحلة العودة

Booleantrue إذا كان الصف مخفيًا، أو 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);

المَعلمات

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

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

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

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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]);
}

المَعلمات

الاسمالنوعالوصف
chartEmbeddedChartالرسم البياني المطلوب إزالته

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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();

المَعلمات

الاسمالنوعالوصف
rangeRangeالنطاق المراد ضبطه كنطاق نشط.

رحلة العودة

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();

المَعلمات

الاسمالنوعالوصف
rangeListRangeListقائمة النطاقات المطلوب اختيارها

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rangeRangeالنطاق المراد تحديده كاختيار نشط.

رحلة العودة

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");

المَعلمات

الاسمالنوعالوصف
a1NotationStringالنطاق المراد ضبطه كنشط، كما هو محدد في تدوين 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);

المَعلمات

الاسمالنوعالوصف
positionGroupControlTogglePositionموضع زر تبديل مجموعة التحكّم في الأعمدة.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerموضع العمود المحدّد المراد ضبطه.
widthIntegerالعرض بالبكسل لضبطه على

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startColumnIntegerموضع عمود البدء المراد تغييره.
numColumnsIntegerعدد الأعمدة المطلوب تغييرها
widthIntegerالعرض بالبكسل لضبطه على

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rulesConditionalFormatRule[]قواعد التنسيق الشرطي الجديدة.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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();

المَعلمات

الاسمالنوعالوصف
cellRangeالخلية التي سيتم ضبطها كخلية حالية.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnsIntegerعدد الأعمدة المطلوب تجميدها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowsIntegerعدد الصفوف المطلوب تجميدها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
hideGridlinesBooleanفي حال ضبط 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");

المَعلمات

الاسمالنوعالوصف
nameStringالاسم الجديد لجدول البيانات.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rightToLeftBooleanإذا تم ضبط 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);

المَعلمات

الاسمالنوعالوصف
positionGroupControlTogglePositionموضع زر تبديل مجموعة التحكّم في الصفوف.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
rowPositionIntegerموضع الصف المراد تغييره.
heightIntegerالارتفاع بالبكسل لضبطه على

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startRowIntegerموضع صف البدء المراد تغييره.
numRowsIntegerعدد الصفوف المطلوب تغييرها.
heightIntegerالارتفاع بالبكسل لضبطه على

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
startRowIntegerموضع صف البدء المراد تغييره.
numRowsIntegerعدد الصفوف المطلوب تغييرها.
heightIntegerالارتفاع بالبكسل لضبطه على

رحلة العودة

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.

المَعلمات

الاسمالنوعالوصف
colorStringرمز لون في تدوين 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.

المَعلمات

الاسمالنوعالوصف
colorColorلون علامة تبويب الورقة الذي تريد ضبطه

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس العمود الذي تريد إظهاره.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
columnIndexIntegerفهرس بداية الأعمدة المطلوب إظهاره
numColumnsIntegerعدد الأعمدة المطلوب إظهارها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس الصف الذي سيتم إظهاره.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowIndexIntegerفهرس بداية الصفوف المطلوب إظهارها.
numRowsIntegerعدد الصفوف المطلوب إظهارها.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerالعمود المطلوب الترتيب حسبه.

رحلة العودة

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);

المَعلمات

الاسمالنوعالوصف
columnPositionIntegerالعمود المطلوب الترتيب حسبه.
ascendingBooleantrue للأنواع الصاعدة، 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);

المَعلمات

الاسمالنوعالوصف
columnRangeالنطاق المراد إظهاره في حال إخفاؤه.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);

المَعلمات

الاسمالنوعالوصف
rowRangeالنطاق المراد إظهاره في حال إخفاؤه.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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);
}

المَعلمات

الاسمالنوعالوصف
chartEmbeddedChartالرسم البياني الذي سيتم تعديله.

التفويض

إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

طرق متوقّفة نهائيًا