تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Range

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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`activate()`	`Range`	لضبط النطاق المحدّد على أنّه `active range`، أعلى قيمة الخلية اليسرى في نطاق مثل `current cell`.
`activateAsCurrentCell()`	`Range`	لضبط الخلية المحددة على أنّها `current cell`.
`addDeveloperMetadata(key)`	`Range`	تتم إضافة البيانات الوصفية للمطوِّر باستخدام المفتاح المحدّد إلى النطاق.
`addDeveloperMetadata(key, visibility)`	`Range`	تتم إضافة البيانات الوصفية للمطوِّر مع المفتاح المحدّد وإمكانية الوصول إلى النطاق.
`addDeveloperMetadata(key, value)`	`Range`	تتم إضافة البيانات الوصفية للمطوِّر باستخدام المفتاح والقيمة المحدّدَين إلى النطاق.
`addDeveloperMetadata(key, value, visibility)`	`Range`	تتم إضافة البيانات الوصفية للمطوِّر مع المفتاح والقيمة ومستوى الرؤية المحدّدَين إلى النطاق.
`applyColumnBanding()`	`Banding`	لتطبيق مظهر تلقائي لتتباين الأعمدة على النطاق.
`applyColumnBanding(bandingTheme)`	`Banding`	لتطبيق مظهر محدد لتتباين عمود على النطاق.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	يتيح هذا الإعداد تطبيق مظهر محدد لتداخل الأعمدة على نطاق يتضمن رأسًا وتذييلاً محدّدَين. الإعدادات.
`applyRowBanding()`	`Banding`	لتطبيق مظهر تلقائي لتطابُق الصفوف على النطاق.
`applyRowBanding(bandingTheme)`	`Banding`	لتطبيق مظهر محدد لتتباين الصفوف على النطاق.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	يتيح هذا الخيار تطبيق مظهر محدد لتطابُق الصفوف على النطاق باستخدام إعدادات محدّدة للرأس والتذييل.
`autoFill(destination, series)`	`void`	ملء السمة `destinationRange` بالبيانات استنادًا إلى البيانات في هذا النطاق
`autoFillToNeighbor(series)`	`void`	لحساب نطاق لملئه ببيانات جديدة بناءً على الخلايا المجاورة وملؤه تلقائيًا نطاق بقيم جديدة بناءً على البيانات الواردة فيه.
`breakApart()`	`Range`	يمكنك تقسيم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.
`canEdit()`	`Boolean`	تحدِّد هذه السياسة ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق.
`check()`	`Range`	تغيير حالة مربعات الاختيار في النطاق إلى "محدد".
`clear()`	`Range`	يؤدي هذا الإجراء إلى محو نطاق المحتوى والتنسيقات.
`clear(options)`	`Range`	محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقق من صحة البيانات و/أو التعليقات، كما هو محدّد في الخيارات المتقدمة المقدمة.
`clearContent()`	`Range`	يمحو محتوى النطاق، مع ترك التنسيق سليمًا.
`clearDataValidations()`	`Range`	يمحو قواعد التحقق من صحة البيانات للنطاق.
`clearFormat()`	`Range`	يؤدي هذا الإجراء إلى محو تنسيق هذا النطاق.
`clearNote()`	`Range`	يؤدي إلى محو الملاحظة في الخلية أو الخلايا المحدّدة.
`collapseGroups()`	`Range`	لتصغير كل المجموعات المضمنة بالكامل في النطاق.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	انسخ تنسيق النطاق إلى الموقع المحدد.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	انسخ تنسيق النطاق إلى الموقع المحدد.
`copyTo(destination)`	`void`	يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا.
`copyTo(destination, copyPasteType, transposed)`	`void`	يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا.
`copyTo(destination, options)`	`void`	يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	انسخ محتوى النطاق إلى الموقع المحدد.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	انسخ محتوى النطاق إلى الموقع المحدد.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	تنشئ جدولاً محوريًا فارغًا لمصدر بيانات من مصدر البيانات، مثبتًا في الخلية الأولى في هذا النطاق.
`createDataSourceTable(dataSource)`	`DataSourceTable`	تنشئ جدول مصدر بيانات فارغًا من مصدر البيانات، مثبتًا في الخلية الأولى في هذه النطاق.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	عرض DeveloperMetadataFinderApi للعثور على البيانات الوصفية لمطور البرامج ضمن نطاق هذا النطاق.
`createFilter()`	`Filter`	لإنشاء فلتر وتطبيقه على النطاق المحدد في ورقة البيانات.
`createPivotTable(sourceData)`	`PivotTable`	تنشئ جدولاً محوريًا فارغًا من `sourceData` المحدد المرتكز على الخلية الأولى. في هذا النطاق.
`createTextFinder(findText)`	`TextFinder`	تنشئ باحثًا عن نص للنطاق، والذي يمكنه العثور على نص في هذا النطاق واستبداله.
`deleteCells(shiftDimension)`	`void`	تحذف هذا النطاق من الخلايا.
`expandGroups()`	`Range`	لتوسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكّم الخاص بها مع هذا النطاق.
`getA1Notation()`	`String`	لعرض وصف سلسلة للنطاق بتنسيق A1.
`getBackground()`	`String`	تعرض لون الخلفية للخلية أعلى اليسار في النطاق (على سبيل المثال، `'#ffffff'`).
`getBackgroundObject()`	`Color`	لعرض لون خلفية الخلية أعلى اليسار في النطاق.
`getBackgroundObjects()`	`Color[][]`	لعرض ألوان خلفية الخلايا في النطاق.
`getBackgrounds()`	`String[][]`	تعرض ألوان خلفية الخلايا في النطاق (على سبيل المثال، `'#ffffff'`).
`getBandings()`	`Banding[]`	لعرض جميع النطاقات التي تم تطبيقها على أي خلايا في هذا النطاق.
`getCell(row, column)`	`Range`	لعرض خلية معينة داخل نطاق.
`getColumn()`	`Integer`	تعرض موضع عمود البداية لهذا النطاق.
`getDataRegion()`	`Range`	عرض نسخة من النطاق الذي تم توسيعه في `Direction` الأساسية الأربعة لتغطية كل الخلايا المجاورة التي تحتوي على بيانات.
`getDataRegion(dimension)`	`Range`	عرض نسخة من النطاق الذي تم توسيعه `Direction.UP` و`Direction.DOWN` إذا كانت المحددة هي `Dimension.ROWS`، أو `Direction.NEXT` و`Direction.PREVIOUS` إذا كانت السمة `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	لعرض `DataSourceFormula` للخلية الأولى في النطاق أو `null` إذا إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات.
`getDataSourceFormulas()`	`DataSourceFormula[]`	تعرض قيم `DataSourceFormula` للخلايا في النطاق.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	لإحضار جميع الجداول المحورية لمصدر البيانات المتقاطعة مع النطاق.
`getDataSourceTables()`	`DataSourceTable[]`	تعرض هذه الدالة جميع جداول مصدر البيانات المتقاطعة مع النطاق.
`getDataSourceUrl()`	`String`	تعرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء مخططات وطلبات بحث.
`getDataTable()`	`DataTable`	عرض البيانات داخل هذا الكائن على شكل DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	عرض البيانات داخل هذا النطاق كـ DataTable.
`getDataValidation()`	`DataValidation`	تعرض قاعدة التحقق من صحة البيانات للخلية العلوية اليسرى في النطاق.
`getDataValidations()`	`DataValidation[][]`	تعرض قواعد التحقق من صحة البيانات لجميع الخلايا في النطاق.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	الحصول على البيانات الوصفية للمطوِّر المرتبطة بهذا النطاق
`getDisplayValue()`	`String`	لعرض القيمة المعروضة للخلية في أعلى اليسار في النطاق.
`getDisplayValues()`	`String[][]`	تعرض شبكة مستطيلة من القيم لهذا النطاق.
`getFilter()`	`Filter`	عرض الفلتر على ورقة البيانات التي ينتمي إليها هذا النطاق، أو `null` إذا لم يكن هناك فلتر الورقة.
`getFontColorObject()`	`Color`	تعرض لون خط الخلية في الزاوية العلوية اليسرى من النطاق.
`getFontColorObjects()`	`Color[][]`	تعرض ألوان خط الخلايا في النطاق.
`getFontFamilies()`	`String[][]`	لعرض مجموعات الخطوط للخلايا في النطاق.
`getFontFamily()`	`String`	لعرض مجموعة الخطوط للخلية في الزاوية العلوية اليسرى من النطاق.
`getFontLine()`	`String`	تحصل على نمط خط الخلية في الزاوية العلوية اليسرى من النطاق (`'underline'`، `'line-through'` أو `'none'`).
`getFontLines()`	`String[][]`	الحصول على نمط سطر الخلايا في النطاق (`'underline'` أو `'line-through'` أو `'none'`).
`getFontSize()`	`Integer`	لعرض حجم الخط بحجم نقطة الخلية في الزاوية العلوية اليسرى من النطاق.
`getFontSizes()`	`Integer[][]`	لعرض أحجام خط الخلايا في النطاق.
`getFontStyle()`	`String`	عرض نمط الخط (`'italic'` أو `'normal'`) للخلية في أعلى اليمين اليمنى من النطاق.
`getFontStyles()`	`String[][]`	تعرض أنماط الخطوط للخلايا في النطاق.
`getFontWeight()`	`String`	لعرض سمك الخط (عادي/غامق) للخلية في الزاوية العلوية اليسرى من النطاق.
`getFontWeights()`	`String[][]`	لعرض أوزان الخط للخلايا في النطاق.
`getFormula()`	`String`	لعرض المعادلة (الترميز A1) للخلية العلوية اليسرى من النطاق، أو سلسلة فارغة إذا كان الخلية فارغة أو لا تحتوي على صيغة.
`getFormulaR1C1()`	`String`	لعرض الصيغة (تدوين R1C1) لخلية معينة أو عرض `null` في حالة عدم وجودها.
`getFormulas()`	`String[][]`	تعرض الصيغ (الترميز A1) للخلايا في النطاق.
`getFormulasR1C1()`	`String[][]`	لعرض الصيغ (تدوين R1C1) للخلايا في النطاق.
`getGridId()`	`Integer`	تعرض معرّف الشبكة للورقة الرئيسية للنطاق.
`getHeight()`	`Integer`	تعرض ارتفاع النطاق.
`getHorizontalAlignment()`	`String`	لعرض المحاذاة الأفقية للنص (اليسار/الوسط/اليمين) للخلية في أعلى اليسار اليمنى من النطاق.
`getHorizontalAlignments()`	`String[][]`	لعرض المحاذاة الأفقية للخلايا في النطاق.
`getLastColumn()`	`Integer`	تعرض موضع عمود النهاية.
`getLastRow()`	`Integer`	تعرض موضع صف النهاية.
`getMergedRanges()`	`Range[]`	عرض صفيف من كائنات `Range` تمثل الخلايا المدمجة التي تكون كاملة ضمن النطاق الحالي، أو تحتوي على خلية واحدة على الأقل في النطاق الحالي.
`getNextDataCell(direction)`	`Range`	بدءًا من الخلية في العمود الأول والصف الأول من النطاق، يتم إرجاع الخلية التالية في اتجاه معين هو حافة نطاق متجاورة من الخلايا يحتوي على بيانات أو داخل الخلية على حافة جدول البيانات في هذا الاتجاه.
`getNote()`	`String`	تعرض الملاحظة المرتبطة بالنطاق المحدّد.
`getNotes()`	`String[][]`	تعرض الملاحظات المرتبطة بالخلايا في النطاق.
`getNumColumns()`	`Integer`	تعرض عدد الأعمدة في هذا النطاق.
`getNumRows()`	`Integer`	تعرض عدد الصفوف في هذا النطاق.
`getNumberFormat()`	`String`	احصل على تنسيق الأرقام أو التاريخ للخلية العلوية اليسرى من النطاق المحدّد.
`getNumberFormats()`	`String[][]`	لعرض تنسيقات الأرقام أو التاريخ للخلايا في النطاق.
`getRichTextValue()`	`RichTextValue`	لعرض قيمة النص المنسق للخلية العلوية اليمنى من النطاق أو `null` إذا كانت الخلية أن تكون ليست نصًا.
`getRichTextValues()`	`RichTextValue[][]`	تعرض قيم النص المنسق للخلايا في النطاق.
`getRow()`	`Integer`	لعرض موضع الصف لهذا النطاق.
`getRowIndex()`	`Integer`	لعرض موضع الصف لهذا النطاق.
`getSheet()`	`Sheet`	تعرض الورقة التي ينتمي إليها هذا النطاق.
`getTextDirection()`	`TextDirection`	لعرض اتجاه النص للخلية العلوية اليسرى من النطاق.
`getTextDirections()`	`TextDirection[][]`	لعرض الاتجاهات النصية للخلايا في النطاق.
`getTextRotation()`	`TextRotation`	لعرض إعدادات تدوير النص للخلية العلوية اليسرى من النطاق.
`getTextRotations()`	`TextRotation[][]`	لعرض إعدادات تدوير النص للخلايا في النطاق.
`getTextStyle()`	`TextStyle`	لعرض نمط النص للخلية العلوية اليسرى من النطاق.
`getTextStyles()`	`TextStyle[][]`	لعرض أنماط النص للخلايا في النطاق.
`getValue()`	`Object`	لعرض قيمة الخلية العلوية على اليسار في النطاق.
`getValues()`	`Object[][]`	تعرض شبكة مستطيلة من القيم لهذا النطاق.
`getVerticalAlignment()`	`String`	لعرض المحاذاة الرأسية (الأعلى/الوسط/السفلي) للخلية في الزاوية العلوية اليسرى من النطاق.
`getVerticalAlignments()`	`String[][]`	لعرض المحاذاة العمودية للخلايا في النطاق.
`getWidth()`	`Integer`	تعرض عرض النطاق في الأعمدة.
`getWrap()`	`Boolean`	لعرض ما إذا كان النص في الخلية يلتف.
`getWrapStrategies()`	`WrapStrategy[][]`	لعرض استراتيجيات التفاف النص للخلايا في النطاق.
`getWrapStrategy()`	`WrapStrategy`	لعرض استراتيجية التفاف النص للخلية العلوية اليسرى من النطاق.
`getWraps()`	`Boolean[][]`	لعرض ما إذا كان النص في الخلايا يلتف.
`insertCells(shiftDimension)`	`Range`	إدراج خلايا فارغة في هذا النطاق
`insertCheckboxes()`	`Range`	إدراج مربعات اختيار في كل خلية في النطاق، مع ضبط الإعداد `true` على وضع التحديد تمت إزالة العلامة من المربّع `false` للحقل.
`insertCheckboxes(checkedValue)`	`Range`	تدرج مربعات الاختيار في كل خلية في النطاق، مع ضبطها بقيمة مخصصة لما تم تحديده السلسلة الفارغة لإلغاء الاختيار.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	تدرج مربعات الاختيار في كل خلية في النطاق، مع ضبطها بقيم مخصصة وغير المحددة بعلامة.
`isBlank()`	`Boolean`	تعرض `true` إذا كان النطاق فارغًا تمامًا.
`isChecked()`	`Boolean`	لعرض ما إذا كانت جميع الخلايا في النطاق لها حالة مربع الاختيار "محددة".
`isEndColumnBounded()`	`Boolean`	تُحدِّد ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن.
`isEndRowBounded()`	`Boolean`	تُحدِّد ما إذا كانت نهاية النطاق مرتبطة بصف معيّن.
`isPartOfMerge()`	`Boolean`	تعرض `true` إذا كانت الخلايا في النطاق الحالي تتداخل مع أي خلايا مدمَجة.
`isStartColumnBounded()`	`Boolean`	تحدِّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بعمود معيّن.
`isStartRowBounded()`	`Boolean`	تُحدِّد ما إذا كانت بداية النطاق مرتبطة بصف معيّن.
`merge()`	`Range`	يدمج الخلايا في النطاق معًا في كتلة واحدة.
`mergeAcross()`	`Range`	ادمج الخلايا في النطاق عبر أعمدة النطاق.
`mergeVertically()`	`Range`	يدمج الخلايا في النطاق معًا.
`moveTo(target)`	`void`	قص ولصق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق المستهدف.
`offset(rowOffset, columnOffset)`	`Range`	عرض نطاق جديد تتم إزاحته من هذا النطاق حسب عدد معين من الصفوف والأعمدة (والتي يمكن أن تكون سلبية).
`offset(rowOffset, columnOffset, numRows)`	`Range`	لعرض نطاق جديد مرتبط بالنطاق الحالي، والذي تتم إزاحة نقطته العلوية اليسرى من النطاق الحالي حسب الصفوف والأعمدة المحددة، وبارتفاع معين في الخلايا.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	لعرض نطاق جديد مرتبط بالنطاق الحالي، والذي تتم إزاحة نقطته العلوية اليسرى من النطاق الحالي حسب الصفوف والأعمدة المحددة، وبالارتفاع والعرض المحددين في الخلايا.
`protect()`	`Protection`	ينشئ كائنًا يمكنه حماية النطاق من التعديل باستثناء المستخدمين الذين إذن.
`randomize()`	`Range`	لترتيب الصفوف في نطاق معين عشوائيًا.
`removeCheckboxes()`	`Range`	إزالة جميع مربعات الاختيار من النطاق
`removeDuplicates()`	`Range`	يزيل الصفوف داخل هذا النطاق التي تحتوي على قيم مكررة لقيم في أي الصف السابق.
`removeDuplicates(columnsToCompare)`	`Range`	إزالة الصفوف المكررة في هذا النطاق والتي تحتوي على قيم في الأعمدة المحددة لأي صف سابق.
`setBackground(color)`	`Range`	لضبط لون الخلفية لجميع الخلايا في النطاق في تدوين CSS (مثل `'#ffffff'` أو `'white'`).
`setBackgroundObject(color)`	`Range`	لضبط لون الخلفية لجميع الخلايا في النطاق.
`setBackgroundObjects(color)`	`Range`	تضبط شبكة مستطيلة من ألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق).
`setBackgroundRGB(red, green, blue)`	`Range`	لضبط الخلفية على اللون المحدّد باستخدام قيم نموذج أحمر أخضر أزرق (الأعداد الصحيحة بين 0 و255).
`setBackgrounds(color)`	`Range`	تضبط شبكة مستطيلة من ألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	لضبط خاصية الحد.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	لضبط خاصية الحدود باللون و/أو النمط.
`setDataValidation(rule)`	`Range`	تحدِّد هذه السياسة قاعدة واحدة للتحقّق من صحة البيانات لجميع الخلايا في النطاق.
`setDataValidations(rules)`	`Range`	تحدد قواعد التحقق من صحة البيانات لجميع الخلايا في النطاق.
`setFontColor(color)`	`Range`	لضبط لون الخط في ترميز CSS (مثل `'#ffffff'` أو `'white'`).
`setFontColorObject(color)`	`Range`	لتعيين لون الخط للنطاق المحدد.
`setFontColorObjects(colors)`	`Range`	تضبط شبكة مستطيلة من ألوان الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontColors(colors)`	`Range`	تضبط شبكة مستطيلة من ألوان الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontFamilies(fontFamilies)`	`Range`	تضبط شبكة مستطيلة من مجموعات الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontFamily(fontFamily)`	`Range`	لضبط مجموعة الخطوط، مثل "SENDER" أو "Helvetica".
`setFontLine(fontLine)`	`Range`	تضبط نمط خط الخط للنطاق المحدَّد (`'underline'` أو `'line-through'` أو `'none'`).
`setFontLines(fontLines)`	`Range`	تضبط شبكة مستطيلة من أنماط الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontSize(size)`	`Range`	لضبط حجم الخط، على أن يكون الحجم هو حجم النقطة المراد استخدامها.
`setFontSizes(sizes)`	`Range`	تضبط شبكة مستطيلة لأحجام الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontStyle(fontStyle)`	`Range`	ضبط نمط الخط للنطاق المحدَّد (`'italic'` أو `'normal'`)
`setFontStyles(fontStyles)`	`Range`	تضبط شبكة مستطيلة من أنماط الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFontWeight(fontWeight)`	`Range`	ضبط عرض الخط للنطاق المحدد (عادي/غامق).
`setFontWeights(fontWeights)`	`Range`	تضبط شبكة مستطيلة لأوزان الخط (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFormula(formula)`	`Range`	تعمل هذه السياسة على تعديل صيغة هذا النطاق.
`setFormulaR1C1(formula)`	`Range`	تعمل هذه السياسة على تعديل صيغة هذا النطاق.
`setFormulas(formulas)`	`Range`	تحدِّد شبكة مستطيلة من الصيغ (يجب أن تتطابق مع أبعاد هذا النطاق).
`setFormulasR1C1(formulas)`	`Range`	تحدِّد شبكة مستطيلة من الصيغ (يجب أن تتطابق مع أبعاد هذا النطاق).
`setHorizontalAlignment(alignment)`	`Range`	تعيين المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المعين (اليسار/الوسط/اليمين).
`setHorizontalAlignments(alignments)`	`Range`	لضبط شبكة مستطيلة من المحاذاة الأفقية.
`setNote(note)`	`Range`	لضبط الملاحظة على القيمة المحدّدة.
`setNotes(notes)`	`Range`	تضبط شبكة مستطيلة من الملاحظات (يجب أن تتطابق مع أبعاد هذا النطاق).
`setNumberFormat(numberFormat)`	`Range`	لضبط تنسيق الرقم أو التاريخ على سلسلة التنسيق المحدّدة.
`setNumberFormats(numberFormats)`	`Range`	تضبط شبكة مستطيلة لتنسيقات الأرقام أو التاريخ (يجب أن تتطابق مع أبعاد هذا النطاق).
`setRichTextValue(value)`	`Range`	لتعيين قيمة النص المنسق للخلايا في النطاق.
`setRichTextValues(values)`	`Range`	تضبط شبكة مستطيلة من قيم النصوص المنسّقة.
`setShowHyperlink(showHyperlink)`	`Range`	لتعيين ما إذا كان يجب أن يعرض النطاق ارتباطات تشعبية أم لا.
`setTextDirection(direction)`	`Range`	لتعيين اتجاه النص للخلايا في النطاق.
`setTextDirections(directions)`	`Range`	تضبط شبكة مستطيلة لاتجاهات النص.
`setTextRotation(degrees)`	`Range`	لضبط إعدادات تدوير النص للخلايا في النطاق.
`setTextRotation(rotation)`	`Range`	لضبط إعدادات تدوير النص للخلايا في النطاق.
`setTextRotations(rotations)`	`Range`	لإعداد شبكة مستطيلة من عمليات تدوير النص
`setTextStyle(style)`	`Range`	لتعيين نمط النص للخلايا في النطاق.
`setTextStyles(styles)`	`Range`	تضبط شبكة مستطيلة من أنماط النص.
`setValue(value)`	`Range`	لتعيين قيمة النطاق.
`setValues(values)`	`Range`	تضبط شبكة مستطيلة من القيم (يجب أن تتطابق مع أبعاد هذا النطاق).
`setVerticalAlignment(alignment)`	`Range`	يمكنك ضبط المحاذاة الرأسية (من أعلى إلى أسفل) للنطاق المحدد (أعلى/متوسط/أسفل).
`setVerticalAlignments(alignments)`	`Range`	تضبط شبكة مستطيلة من المحاذاة العمودية (يجب أن تتطابق مع أبعاد هذا النطاق).
`setVerticalText(isVertical)`	`Range`	لتعيين ما إذا كان سيتم تكديس النص للخلايا في النطاق أم لا.
`setWrap(isWrapEnabled)`	`Range`	إعداد التفاف الخلية للنطاق المحدَّد.
`setWrapStrategies(strategies)`	`Range`	تحدد شبكة مستطيلة من استراتيجيات الالتفاف.
`setWrapStrategy(strategy)`	`Range`	تعيين استراتيجية التفاف النص للخلايا في النطاق.
`setWraps(isWrapEnabled)`	`Range`	تضبط شبكة مستطيلة من سياسات التفاف الكلمات (يجب أن تتطابق مع أبعاد هذا النطاق).
`shiftColumnGroupDepth(delta)`	`Range`	تغير عمق تجميع الأعمدة للنطاق حسب المقدار المحدد.
`shiftRowGroupDepth(delta)`	`Range`	لتغيير عمق تجميع الصفوف في النطاق حسب المقدار المحدد.
`sort(sortSpecObj)`	`Range`	لترتيب الخلايا في نطاق معين حسب العمود والترتيب المحدد.
`splitTextToColumns()`	`void`	يقسم عمودًا من النص إلى أعمدة متعددة بناءً على محدد يتم اكتشافه تلقائيًا.
`splitTextToColumns(delimiter)`	`void`	لتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحددة كمحدد مخصص.
`splitTextToColumns(delimiter)`	`void`	تقسِّم عمودًا من النص إلى أعمدة متعددة بناءً على المحدِّد المحدد.
`trimWhitespace()`	`Range`	يزيل المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في هذا النطاق.
`uncheck()`	`Range`	تغيير حالة مربعات الاختيار في النطاق إلى "غير محددة".

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

الطريقة	نوع الإرجاع	وصف قصير
`getFontColor()`	`String`	تعرض لون خط الخلية في الزاوية العلوية اليسرى من النطاق، بتدوين CSS (مثل باسم `'#ffffff'` أو `'white'`).
`getFontColors()`	`String[][]`	لعرض ألوان خط الخلايا في النطاق بتدوين CSS (مثل `'#ffffff'` أو `'white'`).

الوثائق التفصيلية

`activate()`

لضبط النطاق المحدّد على أنّه active range، أعلى قيمة الخلية اليسرى في نطاق مثل current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

الإرجاع

Range — هذا النطاق للسلاسل.

`activateAsCurrentCell()`

لضبط الخلية المحددة على أنّها current cell.

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

إذا كانت الخلية المحددة غير موجودة في أي نطاق موجود، فإن التحديد الحالي يكون الخلية وتصبح الخلية الحالية والنطاق النشط.

ملاحظة: يجب أن تتكون قيمة Range المحددة من خلية واحدة، وإلا فإنها تنشئ .

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

المعلمات

الاسم	النوع	الوصف
`key`	`String`	هو مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

المعلمات

الاسم	النوع	الوصف
`key`	`String`	هو مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
`visibility`	`DeveloperMetadataVisibility`	إمكانية رؤية البيانات الوصفية الجديدة لمطوّر البرامج

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

المعلمات

الاسم	النوع	الوصف
`key`	`String`	هو مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
`value`	`String`	قيمة البيانات الوصفية لمطوّر البرامج الجديد

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

المعلمات

الاسم	النوع	الوصف
`key`	`String`	هو مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
`value`	`String`	قيمة البيانات الوصفية لمطوّر البرامج الجديد
`visibility`	`DeveloperMetadataVisibility`	إمكانية رؤية البيانات الوصفية الجديدة لمطوّر البرامج

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`applyColumnBanding()`

لتطبيق مظهر تلقائي لتتباين الأعمدة على النطاق. بشكل افتراضي، يكون للتفرقة عنوان، ولا لون التذييل.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

الإرجاع

Banding — النطاق الجديد

التفويض

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

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

`applyColumnBanding(bandingTheme)`

لتطبيق مظهر محدد لتتباين عمود على النطاق. بشكل افتراضي، يكون للتفرقة عنوان بدون لون تذييل.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

المعلمات

الاسم	النوع	الوصف
`bandingTheme`	`BandingTheme`	مظهر لون لتطبيقه على الأعمدة في النطاق.

الإرجاع

Banding — النطاق الجديد

التفويض

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

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

يتيح هذا الإعداد تطبيق مظهر محدد لتداخل الأعمدة على نطاق يتضمن رأسًا وتذييلاً محدّدَين. الإعدادات.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

المعلمات

الاسم	النوع	الوصف
`bandingTheme`	`BandingTheme`	مظهر لون لتطبيقه على الأعمدة في النطاق.
`showHeader`	`Boolean`	إذا كانت `true`، سيتم تطبيق لون عنوان مظهر التباين على أول .
`showFooter`	`Boolean`	إذا كانت `true`، سيتم تطبيق لون تذييل مظهر التباين على آخر .

الإرجاع

Banding — النطاق الجديد

التفويض

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

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

`applyRowBanding()`

لتطبيق مظهر تلقائي لتطابُق الصفوف على النطاق. بشكل افتراضي، يكون للتفرقة عنوان، ولا لون التذييل.

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

الإرجاع

Banding — التباين.

التفويض

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

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

`applyRowBanding(bandingTheme)`

لتطبيق مظهر محدد لتتباين الصفوف على النطاق. بشكل افتراضي، يكون للتفرقة عنوان، ولا لون التذييل.

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

المعلمات

الاسم	النوع	الوصف
`bandingTheme`	`BandingTheme`	نسق لون لتطبيقه على الصفوف في النطاق.

الإرجاع

Banding — النطاق الجديد

التفويض

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

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

يتيح هذا الخيار تطبيق مظهر محدد لتطابُق الصفوف على النطاق باستخدام إعدادات محدّدة للرأس والتذييل.

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

المعلمات

الاسم	النوع	الوصف
`bandingTheme`	`BandingTheme`	نسق لون لتطبيقه على الصفوف في النطاق.
`showHeader`	`Boolean`	إذا كان `true`، سيتم تطبيق لون عنوان مظهر التباين على الصف الأول.
`showFooter`	`Boolean`	إذا كان `true`، سيتم تطبيق لون تذييل مظهر التباين على الصف الأخير.

الإرجاع

Banding — النطاق الجديد

التفويض

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

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

`autoFill(destination, series)`

ملء السمة destinationRange بالبيانات استنادًا إلى البيانات في هذا النطاق القيم الجديدة يتم تحديدها أيضًا حسب نوع series المحدّد. يجب أن يحتوي نطاق الوجهة على هذا النطاق ويوسعه في اتجاه واحد فقط. على سبيل المثال، يتم ملء A1:A20 في ما يلي. بسلسلة من الأرقام المتزايدة استنادًا إلى القيم الحالية في A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

المعلمات

الاسم	النوع	الوصف
`destination`	`Range`	النطاق الذي سيتم ملؤه تلقائيًا بالقيم. يجب أن يكون نطاق الوجهة يحتوي على هذا النطاق ويوسعه في اتجاه واحد فقط (لأعلى أو لأسفل أو لليسار أو اليمين).
`series`	`AutoFillSeries`	نوع سلسلة الملء التلقائي الذي يجب استخدامه لحساب القيم الجديدة. تشير رسالة الأشكال البيانية يختلف تأثير هذه السلسلة استنادًا إلى نوع بيانات المصدر ومقدارها.

التفويض

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

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

`autoFillToNeighbor(series)`

لحساب نطاق لملئه ببيانات جديدة بناءً على الخلايا المجاورة وملؤه تلقائيًا نطاق بقيم جديدة بناءً على البيانات الواردة فيه. تُعد هذه القيم الجديدة أيضًا يتم تحديده من خلال النوع series المحدّد.

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

على سبيل المثال، إذا تم ملء A1:A20 بسلسلة من الأعداد المتزايدة وهذه الطريقة في النطاق B1:B4 الذي يحتوي على سلسلة من التواريخ، والقيم الجديدة تم إدراجها في B5:B20. بهذه الطريقة، تظل هذه القيم الجديدة "ثابتة" إلى الخلايا التي تحتوي على القيم الموجودة في العمود A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

المعلمات

الاسم	النوع	الوصف
`series`	`AutoFillSeries`	نوع سلسلة الملء التلقائي الذي يجب استخدامه لحساب القيم الجديدة. تشير رسالة الأشكال البيانية يختلف تأثير هذه السلسلة استنادًا إلى نوع بيانات المصدر ومقدارها.

التفويض

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

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

`breakApart()`

يمكنك تقسيم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.

يتساوى استدعاء هذه الدالة على نطاق مع تحديد نطاق والنقر على التنسيق > دمج الخلايا > إلغاء دمج.

// Opens the spreadsheet 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 range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`canEdit()`

تحدِّد هذه السياسة ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق. جدول البيانات مالكه دائمًا من تحرير النطاقات والأوراق المحمية.

// Opens the spreadsheet 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 range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

الإرجاع

Boolean — true إذا كان المستخدم لديه إذن بتعديل كل خلية في النطاق false وإلا.

التفويض

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

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

`check()`

تغيير حالة مربعات الاختيار في النطاق إلى "محدد". تتجاهل الخلايا في النطاق التي لا تحتوي حاليًا على القيمة المحدَّدة أو غير المحدَّدة التي تم ضبطها

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clear()`

يؤدي هذا الإجراء إلى محو نطاق المحتوى والتنسيقات.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clear(options)`

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

// The code below clears range C2:G7 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

المعلمات

الاسم	النوع	الوصف
`options`	`Object`	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسم	النوع	الوصف
`commentsOnly`	`Boolean`	تحديد ما إذا كان سيتم محو التعليقات فقط
`contentsOnly`	`Boolean`	ما إذا كان سيتم محو المحتوى فقط أم لا.
`formatOnly`	`Boolean`	ما إذا كنت تريد محو التنسيق فقط أم لا لاحظ أن محو أيضًا على مسح قواعد التحقق من صحة البيانات.
`validationsOnly`	`Boolean`	ما إذا كان سيتم محو قواعد التحقق من صحة البيانات فقط.
`skipFilteredRows`	`Boolean`	ما إذا كان سيتم تجنُّب محو الصفوف التي تمت فلترتها.

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clearContent()`

يمحو محتوى النطاق، مع ترك التنسيق سليمًا.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clearDataValidations()`

يمحو قواعد التحقق من صحة البيانات للنطاق.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clearFormat()`

يؤدي هذا الإجراء إلى محو تنسيق هذا النطاق.

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`clearNote()`

يؤدي إلى محو الملاحظة في الخلية أو الخلايا المحدّدة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`collapseGroups()`

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

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

للحصول على وصف تفصيلي لمَعلمةGridId، يُرجى الاطّلاع على getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

المعلمات

الاسم	النوع	الوصف
`gridId`	`Integer`	المعرّف الفريد للورقة داخل جدول البيانات، بغض النظر عن موضعها.
`column`	`Integer`	العمود الأول من النطاق المستهدف.
`columnEnd`	`Integer`	عمود النهاية للنطاق المستهدف.
`row`	`Integer`	صف بداية النطاق المستهدف.
`rowEnd`	`Integer`	صف النهاية للنطاق المستهدف.

التفويض

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

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

انظر أيضًا

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

المعلمات

الاسم	النوع	الوصف
`sheet`	`Sheet`	الورقة المستهدفة.
`column`	`Integer`	العمود الأول من النطاق المستهدف.
`columnEnd`	`Integer`	عمود النهاية للنطاق المستهدف.
`row`	`Integer`	صف بداية النطاق المستهدف.
`rowEnd`	`Integer`	صف النهاية للنطاق المستهدف.

التفويض

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

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

`copyTo(destination)`

يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. كل من القيم والتنسيق البيانات.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

المعلمات

الاسم	النوع	الوصف
`destination`	`Range`	نطاق وجهة للنسخ إليه يكون موضع الخلية في أعلى اليسار هو فقط ذي الصلة.

التفويض

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

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

`copyTo(destination, copyPasteType, transposed)`

يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

المعلمات

الاسم	النوع	الوصف
`destination`	`Range`	نطاق وجهة للنسخ إليه يكون موضع الخلية في أعلى اليسار هو فقط ذي الصلة.
`copyPasteType`	`CopyPasteType`	نوع يحدد كيفية لصق محتويات النطاق في الوجهة.
`transposed`	`Boolean`	لتحديد ما إذا كان يجب لصق النطاق في اتجاهه الذي تم تبديل موضعه

التفويض

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

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

`copyTo(destination, options)`

يتم نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. بشكل افتراضي، يتم تضمين كل من القيم ولكن يمكن إلغاء ذلك باستخدام الوسيطات المتقدمة.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

المعلمات

الاسم	النوع	الوصف
`destination`	`Range`	نطاق وجهة للنسخ إليه يكون موضع الخلية في أعلى اليسار هو فقط ذي الصلة.
`options`	`Object`	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسم	النوع	الوصف
`formatOnly`	`Boolean`	يحدد أنه ينبغي نسخ التنسيق فقط
`contentsOnly`	`Boolean`	يحدد أنه يجب نسخ المحتوى فقط

التفويض

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

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

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

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

للحصول على وصف تفصيلي لمَعلمةGridId، يُرجى الاطّلاع على getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

المعلمات

الاسم	النوع	الوصف
`gridId`	`Integer`	المعرّف الفريد للورقة داخل جدول البيانات، بغض النظر عن موضعها.
`column`	`Integer`	العمود الأول من النطاق المستهدف.
`columnEnd`	`Integer`	عمود النهاية للنطاق المستهدف.
`row`	`Integer`	صف بداية النطاق المستهدف.
`rowEnd`	`Integer`	صف النهاية للنطاق المستهدف.

التفويض

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

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

انظر أيضًا

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

المعلمات

الاسم	النوع	الوصف
`sheet`	`Sheet`	الورقة المستهدفة.
`column`	`Integer`	العمود الأول من النطاق المستهدف.
`columnEnd`	`Integer`	عمود النهاية للنطاق المستهدف.
`row`	`Integer`	صف بداية النطاق المستهدف.
`rowEnd`	`Integer`	صف النهاية للنطاق المستهدف.

التفويض

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

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

`createDataSourcePivotTable(dataSource)`

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

يوضّح هذا المثال كيفية إنشاء جدول محوري لمصدر بيانات جديد وإعداده.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

المعلمات

الاسم	النوع	الوصف
`dataSource`	`DataSource`	مصدر البيانات لإنشاء الجدول المحوري منه.

الإرجاع

DataSourcePivotTable - الجدول المحوري لمصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

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

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

`createDataSourceTable(dataSource)`

تنشئ جدول مصدر بيانات فارغًا من مصدر البيانات، مثبتًا في الخلية الأولى في هذه النطاق.

يوضّح هذا المثال كيفية إنشاء جدول مصدر بيانات جديد وإعداده.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

المعلمات

الاسم	النوع	الوصف
`dataSource`	`DataSource`	مصدر البيانات لإنشاء الجدول المحوري منه.

الإرجاع

DataSourceTable : جدول مصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

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

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

`createDeveloperMetadataFinder()`

عرض DeveloperMetadataFinderApi للعثور على البيانات الوصفية لمطور البرامج ضمن نطاق هذا النطاق. تكون بيانات التعريف ضمن نطاق النطاق فقط إذا كانت مضمنة بالكامل في ذلك النطاق. على سبيل المثال، لا تقع البيانات الوصفية المرتبطة بالصف "3:3" في نطاق نطاق معيّن. "A1:D5" ولكن ضمن نطاق "1:5".

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

الإرجاع

DeveloperMetadataFinder — أداة بحث عن البيانات الوصفية لمطوّر البرامج بهدف البحث عن البيانات الوصفية في نطاق هذا النطاق

`createFilter()`

لإنشاء فلتر وتطبيقه على النطاق المحدد في ورقة البيانات. لا يمكنك إنشاء أكثر من عامل تصفية واحد على ورقة. للوصول إلى الفلتر وتعديله بعد إنشائه، استخدِم getFilter() أو Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

استخدِم هذه الطريقة لإنشاء فلاتر لأوراق بيانات Grid، وهو النوع التلقائي لأوراق البيانات. أوراق الشبكة هي أوراق غير مرتبطة بقاعدة بيانات. لإنشاء أنواع أخرى من الفلاتر، يُرجى الرجوع إلى ما يلي:

إنشاء فلتر جدول محوري باستخدام PivotTable.addFilter(sourceDataColumn, filterCriteria)
إنشاء فلتر لجدول بيانات مرتبط بقاعدة بيانات باستخدام DataSourceSheet.addFilter(columnName, filterCriteria)
إنشاء فلتر لجدول محوري مرتبط بقاعدة بيانات باستخدام DataSourcePivotTable.addFilter(columnName, filterCriteria)

الإرجاع

Filter: الفلتر الجديد

التفويض

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

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

`createPivotTable(sourceData)`

تنشئ جدولاً محوريًا فارغًا من sourceData المحدد المرتكز على الخلية الأولى. في هذا النطاق.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

المعلمات

الاسم	النوع	الوصف
`sourceData`	`Range`	البيانات المراد إنشاء الجدول المحوري منها.

الإرجاع

PivotTable — PivotTable الذي تم إنشاؤه حديثًا

التفويض

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

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

`createTextFinder(findText)`

تنشئ باحثًا عن نص للنطاق، والذي يمكنه العثور على نص في هذا النطاق واستبداله.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = textFinder.replaceWith('cat');

المعلمات

الاسم	النوع	الوصف
`findText`	`String`	النص المطلوب البحث عنه.

الإرجاع

TextFinder — TextFinder للنطاق

`deleteCells(shiftDimension)`

تحذف هذا النطاق من الخلايا. يتم تغيير البيانات الحالية في ورقة البيانات على طول السمة المقدّمة. تجاه النطاق المحذوف.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

المعلمات

الاسم	النوع	الوصف
`shiftDimension`	`Dimension`	البُعد المطلوب تحويل البيانات الحالية من خلاله.

التفويض

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

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

`expandGroups()`

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

الإرجاع

Range — هذا النطاق للسلاسل.

التفويض

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

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

`getA1Notation()`

لعرض وصف سلسلة للنطاق بتنسيق A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

الإرجاع

String — وصف السلسلة للنطاق في ترميز A1.

التفويض

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

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

`getBackground()`

تعرض لون الخلفية للخلية أعلى اليسار في النطاق (على سبيل المثال، '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

الإرجاع

String — رمز لون الخلفية

التفويض

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

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

`getBackgroundObject()`

لعرض لون خلفية الخلية أعلى اليسار في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

الإرجاع

Color - لون خلفية الخلية في أعلى اليسار في النطاق

التفويض

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

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

`getBackgroundObjects()`

لعرض ألوان خلفية الخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

الإرجاع

Color[][] — مصفوفة ثنائية الأبعاد من ألوان الخلفية.

التفويض

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

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

`getBackgrounds()`

تعرض ألوان خلفية الخلايا في النطاق (على سبيل المثال، '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

الإرجاع

String[][] — مصفوفة ثنائية الأبعاد لرموز ألوان الخلفيات.

التفويض

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

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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

الإرجاع

Banding[]: جميع النطاقات التي تم تطبيقها على أي خلايا في هذا النطاق.

التفويض

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

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

`getCell(row, column)`

لعرض خلية معينة داخل نطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

المعلمات

الاسم	النوع	الوصف
`row`	`Integer`	صف الخلية بالنسبة إلى النطاق.
`column`	`Integer`	عمود الخلية بالنسبة إلى النطاق.

الإرجاع

Range — نطاق يحتوي على خلية واحدة في الإحداثيات المحدّدة

التفويض

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

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

`getColumn()`

تعرض موضع عمود البداية لهذا النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

الإرجاع

Integer - موضع عمود بداية النطاق في جدول البيانات

التفويض

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

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

`getDataRegion()`

عرض نسخة من النطاق الذي تم توسيعه في Direction الأساسية الأربعة لتغطية كل الخلايا المجاورة التي تحتوي على بيانات. إذا كان النطاق محاطًا بخلايا فارغة لا تتضمن تلك الخلايا على طول القطر، يتم عرض النطاق نفسه. هذا مشابه لتحديد النطاق جارٍ كتابة Ctrl+A في المحرر.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

الإرجاع

Range — منطقة بيانات النطاق أو نطاق جدول البيانات بأكمله.

التفويض

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

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

`getDataRegion(dimension)`

عرض نسخة من النطاق الذي تم توسيعه Direction.UP وDirection.DOWN إذا كانت المحددة هي Dimension.ROWS، أو Direction.NEXT وDirection.PREVIOUS إذا كانت السمة Dimension.COLUMNS. توسيع النطاق يعتمد على اكتشاف البيانات الموجودة بجوار النطاق الذي تم تنظيمه كجدول. النطاق الموسَّع تغطي جميع الخلايا المجاورة وبياناتها على طول السمة المحددة، بما في ذلك الجدول الحدود. إذا كان النطاق الأصلي محاطًا بخلايا فارغة على طول البُعد المحدد، يتم عرض النطاق نفسه. تتشابه هذه الطريقة مع اختيار النطاق وكتابة Ctrl+Space للأعمدة أو Shift+Space للصفوف في المحرِّر.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

المعلمات

الاسم	النوع	الوصف
`dimension`	`Dimension`	البُعد المطلوب توسيع النطاق من خلاله.

الإرجاع

Range — منطقة بيانات النطاق أو نطاق يغطي كل عمود أو كل صف تمتد به علامة النطاق الأصلي.

التفويض

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

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

`getDataSourceFormula()`

لعرض DataSourceFormula للخلية الأولى في النطاق أو null إذا إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات.

// 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 the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

الإرجاع

DataSourceFormula: DataSourceFormula للخلية

التفويض

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

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

`getDataSourceFormulas()`

تعرض قيم DataSourceFormula للخلايا في النطاق.

// 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 the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

الإرجاع

DataSourceFormula[] — مصفوفة من 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 the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.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 the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

الإرجاع

DataSourceTable[] — قائمة بجداول مصادر البيانات

التفويض

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

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

`getDataSourceUrl()`

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

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

الإرجاع

String — عنوان URL لهذا النطاق كمصدر بيانات يمكن تمريره إلى واجهات برمجة تطبيقات أخرى، مثل الرسوم البيانية.

التفويض

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

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

`getDataTable()`

عرض البيانات داخل هذا الكائن على شكل DataTable.

// 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 the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

الإرجاع

DataTable — البيانات كجدول بيانات.

`getDataTable(firstRowIsHeader)`

عرض البيانات داخل هذا النطاق كـ DataTable.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

المعلمات

الاسم	النوع	الوصف
`firstRowIsHeader`	`Boolean`	ما إذا كان سيتم التعامل مع الصف الأول كعنوان.

الإرجاع

DataTable — البيانات كجدول بيانات.

التفويض

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

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

`getDataValidation()`

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

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

الإرجاع

DataValidation: قاعدة التحقّق من صحة البيانات للخلية أعلى اليمين في النطاق.

التفويض

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

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

`getDataValidations()`

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

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

الإرجاع

DataValidation[][] — مصفوفة ثنائية الأبعاد لقواعد التحقق من صحة البيانات مرتبطة بالخلايا في النطاق.

التفويض

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

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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

الإرجاع

DeveloperMetadata[] — البيانات الوصفية للمطوّرين المرتبطة بهذا النطاق

التفويض

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

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

`getDisplayValue()`

لعرض القيمة المعروضة للخلية في أعلى اليسار في النطاق. القيمة هي String. تراعي القيمة المعروضة تنسيق التاريخ والوقت والعملة، بما في ذلك التي يتم تطبيقها تلقائيًا بواسطة إعداد لغة جدول البيانات. تؤدي الخلايا الفارغة إلى إرجاع حقل فارغ السلسلة.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

الإرجاع

String - القيمة المعروضة في هذه الخلية

التفويض

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

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

`getDisplayValues()`

تعرض شبكة مستطيلة من القيم لهذا النطاق.

تعرض صفيفًا ثنائي الأبعاد من القيم المعروضة، مفهرسة حسب الصف، ثم حسب العمود. تشير رسالة الأشكال البيانية القيم هي عناصر String. تراعي القيمة المعروضة التاريخ والوقت أو تنسيق العملات، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا حسب لغة جدول البيانات الإعداد. يتم تمثيل الخلايا الفارغة بسلسلة فارغة في الصفيف. تذكر أنه في حين أن يبدأ فهرس النطاق في 1, 1، وتمت فهرسة مصفوفة JavaScript من [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

الإرجاع

String[][] — مصفوفة قيم ثنائية الأبعاد.