דף זה תורגם על ידי 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`	מגדיר את הרקע לצבע הנתון באמצעות ערכי RGB (מספרים שלמים בין 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`	המדיניות הזו מגדירה את משפחת הגופנים, למשל "optout". או 'H בינלאומי'.
`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 של הטווח הזה כמקור נתונים שאפשר להעביר לממשקי API אחרים, כמו תרשימים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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. הערך המוצג מביא בחשבון את פורמט התאריך, השעה והמטבע, כולל פורמטים שהוחלו באופן אוטומטי על ידי הגדרת הלוקאל של הגיליון האלקטרוני. תאים ריקים מחזירים ערך ריק 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[][] - מערך דו-ממדי של ערכים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFilter()`

הפונקציה מחזירה את המסנן בגיליון שהטווח הזה שייך אליו, או null אם אין מסנן שבו בגיליון.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

חזרה

Filter – המסנן.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontColorObject()`

מחזירה את צבע הגופן של התא בפינה הימנית העליונה של הטווח.

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

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

חזרה

Color – צבע הגופן של התא הימני העליון בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontColorObjects()`

מחזירה את צבעי הגופן של התאים בטווח.

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

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

חזרה

Color[][] - מערך דו-ממדי של צבעי גופנים שמשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontFamilies()`

מחזירה את משפחות הגופנים של התאים בטווח.

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

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של משפחות גופנים שמשויכות לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontFamily()`

מחזירה את משפחת הגופנים של התא בפינה הימנית העליונה של הטווח.

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

Logger.log(range.getFontFamily());

חזרה

String – משפחת הגופנים של התא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontLine()`

מקבלת את סגנון הקו של התא בפינה הימנית העליונה של הטווח ('underline', 'line-through' או 'none').

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

Logger.log(range.getFontLine());

חזרה

String – שורת הגופן.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontLines()`

הפונקציה מקבלת את סגנון הקו של התאים בטווח ('underline', 'line-through', או 'none').

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

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של שורות גופנים שמשויכות לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontSize()`

מחזירה את גודל הגופן בגודל הנקודה של התא בפינה הימנית העליונה של הטווח.

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

Logger.log(range.getFontSize());

חזרה

Integer – גודל הגופן בגודל הנקודה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontSizes()`

מחזירה את גודל הגופן של התאים בטווח.

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

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

Integer[][] - מערך דו-ממדי של גודלי גופנים של טקסט שמשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontStyle()`

פונקציה זו מחזירה את סגנון הגופן ('italic' או 'normal') של התא בפינה הימנית העליונה הפינה של הטווח.

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

Logger.log(range.getFontStyle());

חזרה

String – סגנון הגופן של הטקסט בתא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontStyles()`

מחזירה את סגנונות הגופן של התאים בטווח.

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

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של סגנונות גופנים של טקסט המשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontWeight()`

מחזירה את עובי הגופן (רגיל/מודגש) של התא בפינה הימנית העליונה של הטווח.

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

Logger.log(range.getFontWeight());

חזרה

String – עובי הגופן של הטקסט בתא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontWeights()`

מחזירה את משקל הגופנים של התאים בטווח.

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

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של משקלי גופנים של טקסט המשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFormula()`

מחזירה את הנוסחה (סימון A1) לתא הימני העליון של הטווח, או מחרוזת ריקה אם התא ריק או שאינו מכיל נוסחה.

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

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

חזרה

String – הנוסחה של התא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFormulaR1C1()`

מחזירה את הנוסחה (סימון R1C1) לתא נתון, או null אם אין.

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

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

חזרה

String – הנוסחה בסימון R1C1.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFormulas()`

מחזירה את הנוסחאות (סימון A1) של התאים בטווח. הערכים במערך הדו-ממדי הם מחרוזות ריקות לתאים ללא נוסחה.

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

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

חזרה

String[][] - מערך דו-ממדי של נוסחאות בפורמט מחרוזת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFormulasR1C1()`

מחזירה את הנוסחאות (סימון R1C1) של התאים בטווח. הערכים במערך הדו-ממדי הם null לתאים ללא נוסחה.

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

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

חזרה

String[][] - מערך דו-ממדי של נוסחאות בסימון R1C1.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getGridId()`

הפונקציה מחזירה את מזהה הרשת של הגיליון הראשי של הטווח. מזהים הם ערכי Int אקראיים לא שליליים.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

חזרה

Integer – מזהה הרשת של גיליון ההורה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getHeight()`

מחזירה את גובה הטווח.

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

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

חזרה

Integer – גובה הטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getHorizontalAlignment()`

פונקציה זו מחזירה את היישור האופקי של הטקסט (שמאלה/מרכז/ימין) של התא, בצד שמאל למעלה הפינה של הטווח.

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

Logger.log(range.getHorizontalAlignment());

חזרה

String – היישור האופקי של הטקסט בתא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getHorizontalAlignments()`

מחזירה את כיוון היישור האופקי של התאים בטווח.

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

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של מערך דו-ממדי של טקסט המשויך לתאים טווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getLastColumn()`

מחזירה את המיקום של עמודת הסיום.

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

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

חזרה

Integer – מיקום העמודה האחרונה של הטווח בגיליון האלקטרוני.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getLastRow()`

הפונקציה מחזירה את המיקום של שורת הסיום.

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

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

חזרה

Integer – המיקום של שורת הסיום של הטווח בגיליון האלקטרוני.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getMergedRanges()`

פונקציה זו מחזירה מערך של Range אובייקטים שמייצגים תאים ממוזגים שממוקמים בשלמותם בטווח הנוכחי, או להכיל לפחות תא אחד בטווח הנוכחי.

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

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

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

חזרה

Range[] – מערך של Range אובייקטים, שמייצגים תאים ממוזגים שחופפים לטווח.

`getNextDataCell(direction)`

החל מהתא בעמודה הראשונה ובשורה הראשונה של הטווח, החזרת התא הבא בעמודה כיוון נתון שהוא הקצה של טווח רציף של תאים שיש בהם נתונים או שיש בהם נתונים בקצה הגיליון האלקטרוני, באותו כיוון. היא מקבילה להקלדה Ctrl+[arrow key] בעורך.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

פרמטרים

שם	סוג	תיאור
`direction`	`Direction`	הכיוון שבו יש למצוא את תא הקצה הבא של אזור הנתונים.

חזרה

Range – תא הקצה של האזור הגיאוגרפי לאחסון נתונים או התא בקצה הגיליון האלקטרוני.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNote()`

מחזירה את ההערה שמשויכת לטווח הנתון.

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

Logger.log(range.getNote());

חזרה

String – ההערה שמשויכת לתא הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNotes()`

מחזירה את ההערות שמשויכות לתאים בטווח.

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

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] – מערך דו-ממדי של הערות שמשויכות לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNumColumns()`

מחזירה את מספר העמודות בטווח הזה.

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

חזרה

Integer – מספר העמודות בטווח הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNumRows()`

מחזירה את מספר השורות בטווח הזה.

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

חזרה

Integer – מספר השורות בטווח הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNumberFormat()`

מקבלים את עיצוב המספר או התאריך בתא הימני העליון בטווח הנתון. הפורמט שמוחזר הדפוסים מתוארים ב-Sheets API תיעוד.

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

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

חזרה

String – פורמט המספרים של התא הימני העליון של הטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getNumberFormats()`

מחזירה את הפורמטים של המספר או התאריך בתאים שבטווח. דפוסי הפורמט שהוחזרו שמתוארים במסמכי התיעוד של Sheets API.

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

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

חזרה

String[][] - מערך דו-ממדי של פורמטים של מספרים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getRichTextValue()`

מחזירה את הערך של 'טקסט עשיר' של התא הימני העליון של הטווח, או null אם התא הוא לא טקסט.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

חזרה

RichTextValue – הערך 'טקסט עשיר' של התא הימני העליון בטווח, או null אם התא הוא לא טקסט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getRichTextValues()`

מחזירה את ערכי הטקסט העשיר של התאים בטווח.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

חזרה

RichTextValue[][] - מערך דו-ממדי של ערכים של טקסט עשיר.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getRow()`

מחזירה את מיקום השורה של הטווח הזה. הוא זהה ל-getRowIndex().

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

var range = sheet.getRange("B2");
Logger.log(range.getRow());

חזרה

Integer – מיקום השורה של הטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getRowIndex()`

מחזירה את מיקום השורה של הטווח הזה. הוא זהה ל-getRow().

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

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

חזרה

Integer – מיקום השורה של הטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

ראה גם

getRow()

`getSheet()`

מחזירה את הגיליון שאליו שייך הטווח הזה.

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

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

חזרה

Sheet – הגיליון שאליו שייך הטווח הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextDirection()`

מחזירה את כיוון הטקסט של התא השמאלי העליון בטווח. הפונקציה מחזירה את הערך null אם התא כיוון הטקסט נקבע באמצעות זיהוי אוטומטי.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

חזרה

TextDirection – כיוון הטקסט של התא הימני העליון בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextDirections()`

מחזירה את הנחיות הטקסט בתאים שבטווח. הערכים במערך הדו-ממדי הם null לתאים שמשתמשים בזיהוי אוטומטי.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

חזרה

TextDirection[][] – מערך דו-ממדי של הנחיות טקסט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextRotation()`

מחזירה את ההגדרות של סיבוב הטקסט בתא השמאלי העליון בטווח.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

חזרה

TextRotation – ההגדרות של סיבוב הטקסט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextRotations()`

מחזירה את ההגדרות של סיבוב הטקסט בתאים שבטווח.

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

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

חזרה

TextRotation[][] – מערך דו-ממדי של סיבובי טקסט שמשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextStyle()`

מחזירה את סגנון הטקסט של התא הימני העליון של הטווח.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

חזרה

TextStyle – סגנון הטקסט של התא הימני העליון בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTextStyles()`

מחזירה את סגנונות הטקסט של התאים בטווח.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

חזרה

TextStyle[][] - מערך דו-ממדי של סגנונות טקסט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getValue()`

מחזירה את הערך של התא הימני העליון בטווח. הערך יכול להיות מסוג Number, Boolean, Date או 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

חזרה

Object – הערך בתא הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getValues()`

מחזירה את רשת הערכים המלבנית של הערכים בטווח הזה.

מחזירה מערך דו-ממדי של ערכים, שנוספו לאינדקס לפי שורה, ולאחר מכן לפי עמודה. הערכים יכולים להיות מסוג Number, Boolean, Date או String, בהתאם של התא. תאים ריקים מיוצגים על ידי מחרוזת ריקה במערך. חשוב לזכור בזמן שאינדקס הטווח מתחיל ב-1, 1, מערך ה-JavaScript נוסף לאינדקס מ-[0][0].

// The code below gets the 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).getValues();
Logger.log(values[0][0]);

באפליקציות אינטרנט, ערך Date הוא לא פרמטר משפטי. לא ניתן להחזיר את getValues() לאפליקציות אינטרנט, אם הטווח מכיל תא עם ערך Date. במקום זאת, כל הערכים שאוחזרו מהגיליון לרכיב JavaScript נתמך כמו Number, Boolean או String.

חזרה

Object[][] - מערך דו-ממדי של ערכים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getVerticalAlignment()`

מחזירה את היישור האנכי (למעלה/אמצעי/למטה) של התא, בפינה השמאלית העליונה של טווח.

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

Logger.log(range.getVerticalAlignment());

חזרה

String – היישור האנכי של הטקסט בתא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getVerticalAlignments()`

מחזירה את היישור האנכי של התאים בטווח.

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

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] — מערך דו-ממדי של מערך דו-ממדי של טקסט המשויך לתאים טווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getWidth()`

מחזירה את רוחב הטווח בעמודות.

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

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

חזרה

Integer – מספר העמודות בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getWrap()`

הפונקציה מחזירה אם הטקסט בתא גולש. כדי לקבל אסטרטגיית גלישה מפורטת יותר, צריך להשתמש ב-getWrapStrategy().

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

Logger.log(range.getWrap());

חזרה

Boolean – האם הטקסט בתא הזה גולש או לא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getWrapStrategies()`

מחזירה את אסטרטגיות גלישת הטקסט של התאים בטווח.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

חזרה

WrapStrategy[][] - מערך דו-ממדי של אסטרטגיות גלישת טקסט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getWrapStrategy()`

מחזירה את האסטרטגיה של גלישת הטקסט של התא הימני העליון של הטווח.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

חזרה

WrapStrategy – האסטרטגיה של גלישת הטקסט של התא הימני העליון בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getWraps()`

הפונקציה מחזירה אם הטקסט בתאים גולש. כדי לקבל אסטרטגיית גלישה מפורטת יותר, צריך להשתמש ב-getWrapStrategies().

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

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

חזרה

Boolean[][] — מערך דו-ממדי של מערך דו-ממדי של טקסט המשויך לתאים טווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`insertCells(shiftDimension)`

הוספת תאים ריקים לטווח הזה בתאים החדשים נשמרים כל עיצובים שקיימים בתאים שהיה בטווח הזה בעבר. הנתונים הקיימים בגיליון לאורך המאפיין שצוין הם השתנה מהטווח שהוכנס.

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

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

פרמטרים

שם	סוג	תיאור
`shiftDimension`	`Dimension`	המאפיין שלפיהם יועברו הנתונים הקיימים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`insertCheckboxes()`

הוספת תיבות סימון לכל תא בטווח, שהוגדר באמצעות true לסימון ולסימון התיבה false לא מסומנת. ל-false מוגדר הערך של כל התאים בטווח.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`insertCheckboxes(checkedValue)`

מכניסה תיבות סימון לכל תא בטווח, שמוגדר עם ערך מותאם אישית של תיבות סימון ומסומנות המחרוזת הריקה לא מסומנת. מגדיר את הערך של כל תא בטווח למחרוזת הריקה.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

פרמטרים

שם	סוג	תיאור
`checkedValue`	`Object`	הערך שסומן לאימות הנתונים של תיבת הסימון.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

הוספת תיבות סימון לכל תא בטווח, שהוגדרו עם ערכים מותאמים אישית עבור הפריטים המסומנים ומצבים לא מסומנים. מגדיר את הערך של כל תא בטווח לערך המותאם אישית שלא מסומן.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

פרמטרים

שם	סוג	תיאור
`checkedValue`	`Object`	הערך שסומן לאימות הנתונים של תיבת הסימון.
`uncheckedValue`	`Object`	הערך שלא מסומן עבור אימות הנתונים של תיבת הסימון.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isBlank()`

הפונקציה מחזירה את הערך true אם הטווח ריק.

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

Logger.log(range.isBlank());

חזרה

Boolean – true אם הטווח ריק; false אם לא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isChecked()`

מחזירה אם מצב תיבת הסימון של כל התאים בטווח הוא 'מסומן'. הפונקציה מחזירה את הערך null אם חלק מהתאים מסומנים והשאר לא מסומן, או אם אין תיבת סימון בחלק מהתאים. אימות נתונים.

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

חזרה

Boolean — true, אם כל התאים בטווח מסומנים, false אם כל התאים בטווח הטווחים לא מסומנים, או null אם יש תאים שלא מסומנים או שאין בהם אימות נתונים של תיבת סימון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isEndColumnBounded()`

קובעת אם קצה הטווח קשור לעמודה מסוימת. לדוגמה, עבור הטווחים A1:B10 או B:B, שמקושרים לעמודות שבקצה הטווח, מחזירה true; לטווחים 3:7 או A1:5, שתחומים בלבד לשורות מסוימות בסוף הטווח, השיטה הזו מחזירה 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

חזרה

Boolean – true אם קצה הטווח קשור לעמודה מסוימת. false אחרת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isEndRowBounded()`

קובעת אם קצה הטווח קשור לשורה מסוימת. לדוגמה, עבור הטווחים A1:B10 או 3:7, שמקושרים לשורות בסוף הטווח, כלומר מחזירה true; לטווחים B:B או A1:C, שתחומים בלבד לעמודות מסוימות בסוף הטווח, השיטה הזו מחזירה 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

חזרה

Boolean – true אם קצה הטווח מקושר לשורה מסוימת; false אחרת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isPartOfMerge()`

הפונקציה מחזירה את הערך true אם התאים בטווח הנוכחי חופפים לתאים ממוזגים כלשהם.

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

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

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

חזרה

Boolean – true אם הטווח חופף לתאים ממוזגים כלשהם, אחרת מחזיר false.

`isStartColumnBounded()`

קובעת אם תחילת הטווח קשור לעמודה מסוימת. לדוגמה, עבור טווחים A1:B10 או B:B, שמקושרים לעמודות שבתחילת הטווח השיטה הזו מחזירה את הערך true; את הטווח 3:7 שמוגבל רק לשורה ב- בתחילת הטווח, השיטה הזו מחזירה 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

חזרה

Boolean – true אם תחילת הטווח קשור לעמודה מסוימת; false אחרת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`isStartRowBounded()`

קובעת אם תחילת הטווח קשור לשורה מסוימת. לדוגמה, עבור הטווחים A1:B10 או 3:7, שמקושרים לשורות בתחילת הטווח, מחזירה true; לטווח B:B, המקושר רק לטווח מסוים בתחילת הטווח, השיטה הזו מחזירה 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

חזרה

Boolean – true אם תחילת הטווח קשור לשורה מסוימת; false אחרת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`merge()`

מיזוג התאים בטווח לבלוק אחד.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`mergeAcross()`

מיזוג התאים מהטווח בין העמודות של הטווח.

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

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`mergeVertically()`

מיזוג התאים בטווח.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`moveTo(target)`

גוזרים ומדביקים (גם את הפורמט וגם את הערכים) מהטווח הזה לטווח היעד.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

פרמטרים

שם	סוג	תיאור
`target`	`Range`	טווח יעד להעתקה של הטווח הזה; רק המיקום של התא הימני העליון הוא רלוונטיות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`offset(rowOffset, columnOffset)`

פונקציה זו מחזירה טווח חדש המחושב מהטווח הזה במספר השורות והעמודות הנתון (שיכול להיות שלילי). הגודל של הטווח החדש זהה לגודל הטווח המקורי.

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

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

פרמטרים

שם	סוג	תיאור
`rowOffset`	`Integer`	מספר השורות למטה מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים שורות למעלה מהתא הימני העליון של הטווח.
`columnOffset`	`Integer`	מספר העמודות ישירות מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים עמודות משמאל מהתא הימני העליון של הטווח.

חזרה

Range – הטווח הזה, לשרשור.

`offset(rowOffset, columnOffset, numRows)`

פונקציה זו מחזירה טווח חדש שהוא יחסי לטווח הנוכחי, שהנקודה השמאלית העליונה שלו מתקזזת מהטווח הנוכחי לפי השורות והעמודות הנתונות, ועם הגובה הנתון בתאים.

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

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

פרמטרים

שם	סוג	תיאור
`rowOffset`	`Integer`	מספר השורות למטה מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים שורות למעלה מהתא הימני העליון של הטווח.
`columnOffset`	`Integer`	מספר העמודות ישירות מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים עמודות משמאל מהתא הימני העליון של הטווח.
`numRows`	`Integer`	הגובה בשורות של הטווח החדש.

חזרה

Range – הטווח הזה, לשרשור.

`offset(rowOffset, columnOffset, numRows, numColumns)`

פונקציה זו מחזירה טווח חדש שהוא יחסי לטווח הנוכחי, שהנקודה השמאלית העליונה שלו מתקזזת מהטווח הנוכחי לפי השורות והעמודות הנתונות, ועם הגובה והרוחב הנתונים תאים.

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

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

פרמטרים

שם	סוג	תיאור
`rowOffset`	`Integer`	מספר השורות למטה מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים שורות למעלה מהתא הימני העליון של הטווח.
`columnOffset`	`Integer`	מספר העמודות ישירות מהתא הימני העליון של הטווח; ערכים שליליים שמייצגים עמודות משמאל מהתא הימני העליון של הטווח.
`numRows`	`Integer`	הגובה בשורות של הטווח החדש.
`numColumns`	`Integer`	הרוחב בעמודות של הטווח החדש.

חזרה

Range – הטווח הזה, לשרשור.

`protect()`

יוצר אובייקט שיכול להגן על הטווח מפני עריכה, למעט על ידי משתמשים הרשאה. עד שהסקריפט משנה בפועל את רשימת העורכים של הטווח (על ידי קריאה Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses), או הגדרה של עבור Protection.setDomainEdit(editable)), ההרשאות משקפות את הגיליון האלקטרוני עצמו, והמשמעות היא שהטווח נשאר לא מוגן. אם הטווח הוא שכבר מוגן, השיטה הזו יוצרת טווח מוגן חדש שחופף לטווח הקיים. אם המיקום תא שמוגן במספר טווחים מוגנים, וכל אחד מהם מונע ממשתמש מסוים ואז המשתמש הזה לא יוכל לערוך את התא.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// 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

`randomize()`

יוצרת באופן אקראי את הסדר של השורות בטווח הנתון.

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

// Randomizes the range
range.randomize();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`removeCheckboxes()`

מתבצעת הסרה של כל תיבות הסימון מהטווח. מנקה את אימות הנתונים של כל תא. מנקה גם את הערך שלו אם התא מכיל את הערך המסומן או לא מסומן.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`removeDuplicates()`

מסירה שורות בטווח הזה שמכילות ערכים שהם כפילויות של ערכים. לשורה הקודמת. שורות עם ערכים זהים אבל עם הבדלים באותיות, בעיצוב או בנוסחאות נחשבים לכפילויות. שיטה זו גם מסירה שורות כפולות המוסתרות מהתצוגה (עבור לדוגמה, בגלל מסנן). לא תתבצע הסרה של תוכן מחוץ לטווח הזה.

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

// Remove duplicate rows in the range.
range.removeDuplicates();

חזרה

Range – הטווח שיתקבל אחרי הסרת הכפילויות. גודל הטווח מוקטן ב- עבור כל שורה שהוסרה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`removeDuplicates(columnsToCompare)`

מסירה שורות בטווח הזה שמכילות ערכים משוכפלים בעמודות שצוינו בשורה קודמת כלשהי. שורות עם ערכים זהים אבל גודל אותיות שונה, עיצוב, או נוסחאות נחשבות לכפילויות. השיטה הזו גם מסירה שורות כפולות מוסתרות מהתצוגה (לדוגמה: בגלל מסנן). לא תתבצע הסרה של תוכן מחוץ לטווח הזה.

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

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

פרמטרים

שם	סוג	תיאור
`columnsToCompare`	`Integer[]`	העמודות שצריך לנתח כדי לאתר ערכים כפולים. אם לא סופקו עמודות יתבצע ניתוח של כל העמודות כדי לאתר כפילויות.

חזרה

Range – הטווח שמתקבל אחרי הסרת הכפילויות. גודל הטווח מוקטן ב- עבור כל שורה שהוסרה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBackground(color)`

הגדרת צבע הרקע של כל התאים בטווח בסימון CSS (למשל '#ffffff' או 'white').

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

פרמטרים

שם	סוג	תיאור
`color`	`String`	קוד צבע בסימון CSS (כגון `'#ffffff'` או `'white'`). A הערך `null` מאפס את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBackgroundObject(color)`

הגדרת צבע הרקע של כל התאים בטווח.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

פרמטרים

שם	סוג	תיאור
`color`	`Color`	צבע הרקע שיוגדר; הערך של `null` מאפס את צבע הרקע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBackgroundObjects(color)`

מגדיר רשת מלבנית של צבעי רקע (חייבת להתאים למידות של הטווח הזה).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

פרמטרים

שם	סוג	תיאור
`color`	`Color[][]`	מערך דו-ממדי של צבעים; הערכים של `null` איפסו את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBackgroundRGB(red, green, blue)`

הגדרת הרקע לצבע הנתון באמצעות ערכי RGB (מספרים שלמים בין 0 ל-255 כולל).

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

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

פרמטרים

שם	סוג	תיאור
`red`	`Integer`	הערך האדום בסימון RGB.
`green`	`Integer`	הערך הירוק בסימון RGB.
`blue`	`Integer`	הערך הכחול בסימון RGB.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBackgrounds(color)`

מגדיר רשת מלבנית של צבעי רקע (חייבת להתאים למידות של הטווח הזה). הצבעים נמצאים בסימון CSS (כמו '#ffffff' או 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

פרמטרים

שם	סוג	תיאור
`color`	`String[][]`	מערך דו-ממדי של צבעים בסימון CSS (כגון `'#ffffff'` או `'white'`); ערכי `null` מאפסים את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

מגדיר את מאפיין הגבול. הערכים החוקיים הם true (מופעלת), false (מושבתת) ו-null (ללא שינוי).

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

פרמטרים

שם	סוג	תיאור
`top`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`left`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`bottom`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`right`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`vertical`	`Boolean`	`true` לגבולות אנכיים פנימיים, `false` ללא שינוי, `null` ללא שינוי.
`horizontal`	`Boolean`	`true` לגבולות אופקיים פנימיים, `false` ללא שינוי, `null` ללא שינוי.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

מגדיר את מאפיין הגבול עם צבע ו/או סגנון. הערכים החוקיים הם true (מופעלת), false (מושבתת) ו-null (ללא שינוי). להגדרת צבע, משתמשים באפשרות 'צבע' בסימון CSS (למשל '#ffffff' או 'white').

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

פרמטרים

שם	סוג	תיאור
`top`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`left`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`bottom`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`right`	`Boolean`	`true` לגבול, `false` ללא שינוי, `null` ללא שינוי.
`vertical`	`Boolean`	`true` לגבולות אנכיים פנימיים, `false` ללא שינוי, `null` ללא שינוי.
`horizontal`	`Boolean`	`true` לגבולות אופקיים פנימיים, `false` ללא שינוי, `null` ללא שינוי.
`color`	`String`	צבע בסימון CSS (כגון `'#ffffff'` או `'white'`), `null` לצבע ברירת המחדל (שחור).
`style`	`BorderStyle`	סגנון לגבולות, `null` לסגנון ברירת המחדל (קבוע).

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setDataValidation(rule)`

מגדיר כלל אחד לאימות נתונים לכל התאים בטווח.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

פרמטרים

שם	סוג	תיאור
`rule`	`DataValidation`	כלל אימות הנתונים שצריך להגדיר, או `null` כדי להסיר את אימות הנתונים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setDataValidations(rules)`

מגדיר את הכללים לאימות נתונים לכל התאים בטווח. בשיטה הזו נעשה שימוש במודל דו-ממדי מערך של אימותי נתונים, נוספו לאינדקס לפי שורה ואז לפי עמודה. מאפייני המערך חייבים להתאים למאפייני הטווח.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

פרמטרים

שם	סוג	תיאור
`rules`	`DataValidation[][]`	מערך דו-ממדי של כללי אימות נתונים שיש להגדיר; `null` ערכים הסרת אימות הנתונים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontColor(color)`

הגדרת צבע הגופן בסימון CSS (כגון '#ffffff' או 'white').

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

פרמטרים

שם	סוג	תיאור
`color`	`String`	צבע הגופן בסימון CSS (כגון `'#ffffff'` או `'white'`); A הערך `null` מאפס את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontColorObject(color)`

מגדיר את צבע הגופן של הטווח הנתון.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

פרמטרים

שם	סוג	תיאור
`color`	`Color`	צבע הגופן להגדיר; ערך של `null` מאפס את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontColorObjects(colors)`

מגדיר רשת מלבנית של צבעי גופנים (חייבת להתאים למידות של הטווח הזה).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

פרמטרים

שם	סוג	תיאור
`colors`	`Color[][]`	מערך דו-ממדי של צבעים; הערכים של `null` איפסו את צבע הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontColors(colors)`

מגדיר רשת מלבנית של צבעי גופנים (חייבת להתאים למידות של הטווח הזה). הצבעים נבחרו סימון CSS (כמו '#ffffff' או 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

פרמטרים

שם	סוג	תיאור
`colors`	`Object[][]`	מערך דו-ממדי של צבעים בסימון CSS (כגון `'#ffffff'` או `'white'`); ערכי `null` מאפסים את הצבע.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontFamilies(fontFamilies)`

מגדיר רשת מלבנית של משפחות גופנים (חייבת להתאים למידות של הטווח הזה). דוגמאות של משפחות הגופנים הן "optout" או HHL.

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

פרמטרים

שם	סוג	תיאור
`fontFamilies`	`Object[][]`	מערך דו-ממדי של משפחות גופנים; ערכי `null` איפסו את של משפחת הגופנים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontFamily(fontFamily)`

מגדיר את משפחת הגופנים, למשל 'optout'. או 'H בינלאומי'.

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

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

פרמטרים

שם	סוג	תיאור
`fontFamily`	`String`	משפחת הגופנים להגדרה; ערך `null` מאפס את משפחת הגופנים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontLine(fontLine)`

מגדיר את סגנון שורת הגופן של הטווח הנתון ('underline', 'line-through', או 'none').

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

פרמטרים

שם	סוג	תיאור
`fontLine`	`String`	סגנון שורת הגופן, `'underline'`, `'line-through'` או `'none'`; ערך `null` מאפס את סגנון שורת הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontLines(fontLines)`

מגדירה רשת מלבנית של סגנונות קו (חייבת להתאים למידות של הטווח הזה).

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

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

פרמטרים

שם	סוג	תיאור
`fontLines`	`Object[][]`	מערך דו-ממדי של סגנונות שורת גופנים (`'underline'`, `'line-through'` או `'none'`); ערכי `null` איפסו את סגנון שורת הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontSize(size)`

מגדיר את גודל הגופן. הגודל הוא גודל הנקודה לשימוש.

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

פרמטרים

שם	סוג	תיאור
`size`	`Integer`	גודל גופן בגודל הנקודה.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontSizes(sizes)`

מגדירה רשת מלבנית של גודלי גופנים (חייבת להתאים למידות של הטווח הזה). המידות הן נקודות.

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

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

פרמטרים

שם	סוג	תיאור
`sizes`	`Object[][]`	מערך דו-ממדי של גדלים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontStyle(fontStyle)`

מגדירים את סגנון הגופן בטווח הנתון ('italic' או 'normal').

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

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

פרמטרים

שם	סוג	תיאור
`fontStyle`	`String`	סגנון הגופן, `'italic'` או `'normal'`; `null` מאפס את סגנון הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontStyles(fontStyles)`

מגדיר רשת מלבנית של סגנונות גופנים (חייבת להתאים למידות של הטווח הזה).

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

פרמטרים

שם	סוג	תיאור
`fontStyles`	`Object[][]`	מערך דו-ממדי של סגנונות גופנים, `'italic'` או `'normal'`; ערכי `null` איפסו את סגנון הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontWeight(fontWeight)`

יש להגדיר את עובי הגופן לטווח הנתון (רגיל/מודגש).

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

פרמטרים

שם	סוג	תיאור
`fontWeight`	`String`	עובי הגופן, `'bold'` או `'normal'`; `null` מאפס את עובי הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFontWeights(fontWeights)`

מגדיר רשת מלבנית של משקלי הגופנים (חייבת להתאים למידות של הטווח הזה). דוגמה עובי הגופן הוא "מודגש".

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

פרמטרים

שם	סוג	תיאור
`fontWeights`	`Object[][]`	מערך דו-ממדי של משקלי גופנים, `'bold'` או `'normal'`; ערכים של `null` איפסו את עובי הגופן.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFormula(formula)`

עדכון הנוסחה לטווח הזה. הנוסחה הנתונה חייבת להיות בסימון A1.

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

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

פרמטרים

שם	סוג	תיאור
`formula`	`String`	מחרוזת שמייצגת את הנוסחה שצריך להגדיר בתא.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFormulaR1C1(formula)`

עדכון הנוסחה לטווח הזה. הנוסחה הנתונה חייבת להיות בסימון R1C1.

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

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

פרמטרים

שם	סוג	תיאור
`formula`	`String`	נוסחת מחרוזת.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFormulas(formulas)`

מגדירה רשת מלבנית של נוסחאות (חייבת להתאים למידות של הטווח הזה). הנוסחאות הנתונות חייב להיות בסימון A1. השיטה הזו לוקחת מערך דו-ממדי של נוסחאות, שנוספו לאינדקס לפי שורה, ולאחר מכן לפי עמודה. מאפייני המערך חייבים להתאים למאפייני הטווח.

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

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

פרמטרים

שם	סוג	תיאור
`formulas`	`String[][]`	מערך דו-ממדי של נוסחאות.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setFormulasR1C1(formulas)`

מגדירה רשת מלבנית של נוסחאות (חייבת להתאים למידות של הטווח הזה). הנוסחאות הנתונות חייב להיות בסימון R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

פרמטרים

שם	סוג	תיאור
`formulas`	`String[][]`	מערך דו-ממדי של נוסחאות בפורמט R1C1.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setHorizontalAlignment(alignment)`

מגדירים את היישור האופקי (משמאל לימין) בטווח הנתון (שמאל/מרכז/ימין).

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

פרמטרים

שם	סוג	תיאור
`alignment`	`String`	ההתאמה, `'left'`, `'center'` או `'normal'`; A הערך `null` מאפס את היישור.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setHorizontalAlignments(alignments)`

מגדירה רשת מלבנית של יישור אופקי. הצגת setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

פרמטרים

שם	סוג	תיאור
`alignments`	`Object[][]`	מערך דו-ממדי של התאמות, `'left'`, `'center'` או `'normal'`; ערך `null` מאפס את היישור.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

ראה גם

setHorizontalAlignment(alignment)

`setNote(note)`

מגדיר את ההערה לערך הנתון.

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

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

פרמטרים

שם	סוג	תיאור
`note`	`String`	ערך ההערה שיש להגדיר לטווח; ערך של `null` מסיר את ההערה.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setNotes(notes)`

מגדיר רשת מלבנית של הערות (חייבת להתאים למידות של הטווח הזה).

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

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

פרמטרים

שם	סוג	תיאור
`notes`	`Object[][]`	מערך דו-ממדי של הערות; `null` ערכים מסירים את ההערה.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

ראה גם

setNote(note)

`setNumberFormat(numberFormat)`

מגדיר את הפורמט של המספר או התאריך למחרוזת העיצוב הנתונה. תבניות הפורמטים הקבילות הן שמתוארים במסמכי התיעוד של Sheets API.

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

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

פרמטרים

שם	סוג	תיאור
`numberFormat`	`String`	מחרוזת של תבנית מספר.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setNumberFormats(numberFormats)`

מגדירה רשת מלבנית של פורמטים של מספרים או תאריכים (חייבת להתאים למידות של הטווח הזה). הם מחרוזות של תבנית עיצוב כפי שמתואר בתהליך מאמרי העזרה של Sheets API

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

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

פרמטרים

שם	סוג	תיאור
`numberFormats`	`Object[][]`	מערך דו-ממדי של פורמטים של מספרים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setRichTextValue(value)`

מגדיר את הערך של טקסט עשיר בתאים שבטווח.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

פרמטרים

שם	סוג	תיאור
`value`	`RichTextValue`	הערך הרצוי של טקסט עשיר.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setRichTextValues(values)`

מגדירה רשת מלבנית של ערכי טקסט עשיר.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

פרמטרים

שם	סוג	תיאור
`values`	`RichTextValue[][]`	הערכים הרצויים של טקסט עשיר.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setShowHyperlink(showHyperlink)`

הגדרה זו קובעת אם הטווח יציג היפר-קישורים.

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

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

פרמטרים

שם	סוג	תיאור
`showHyperlink`	`Boolean`	הגדרה שקובעת אם להציג את ההיפר-קישור או לא.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextDirection(direction)`

מגדיר את כיוון הטקסט בתאים שבטווח. אם הכיוון שצוין הוא null, מסיקה את הכיוון ואז מוגדרת.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

פרמטרים

שם	סוג	תיאור
`direction`	`TextDirection`	את הכיוון הרצוי של הטקסט; אם `null` יוסק לפני הכיוון הגדרה אישית.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextDirections(directions)`

מגדיר רשת מלבנית של הנחיות טקסט. אם הכיוון שצוין הוא null, הערך של סותר את הכיוון ואז מוגדר.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

פרמטרים

שם	סוג	תיאור
`directions`	`TextDirection[][]`	את כיווני הטקסט הרצויים; אם הכיוון שצוין הוא `null`, אז שהוסקו לפני ההגדרה.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextRotation(degrees)`

קובע את ההגדרות של סיבוב הטקסט בתאים שבטווח. הקלט תואם לזווית בין כיוון הטקסט הסטנדרטי לבין הכיוון הרצוי. קלט של אפס מציין שהטקסט מוגדר לכיוון הרגיל.

עבור כיוון טקסט משמאל לימין, זוויות חיוביות הן בכיוון השעון נגד כיוון השעון, ואילו מימין לשמאל הן בכיוון השעון.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

פרמטרים

שם	סוג	תיאור
`degrees`	`Integer`	הזווית הרצויה בין הכיוון הסטנדרטי לבין הכיוון הרצוי. בטקסט משמאל לימין, הזוויות החיוביות מופיעות נגד כיוון השעון.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextRotation(rotation)`

קובע את ההגדרות של סיבוב הטקסט בתאים שבטווח.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

פרמטרים

שם	סוג	תיאור
`rotation`	`TextRotation`	ההגדרות הרצויות לסיבוב הטקסט.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextRotations(rotations)`

מגדירה רשת מלבנית של סיבובי טקסט.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

פרמטרים

שם	סוג	תיאור
`rotations`	`TextRotation[][]`	ההגדרות הרצויות לסיבוב הטקסט.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextStyle(style)`

מגדיר את סגנון הטקסט של התאים בטווח.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

פרמטרים

שם	סוג	תיאור
`style`	`TextStyle`	סגנון הטקסט הרצוי.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setTextStyles(styles)`

מגדירה רשת מלבנית של סגנונות טקסט.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

פרמטרים

שם	סוג	תיאור
`styles`	`TextStyle[][]`	סגנונות הטקסט הרצויים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setValue(value)`

מגדיר את הערך של הטווח. הערך יכול להיות מספר, מחרוזת, ערך בוליאני או תאריך. אם היא מתחילה עם '=' הוא מפורש כנוסחה.

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

var cell = sheet.getRange("B2");
cell.setValue(100);

פרמטרים

שם	סוג	תיאור
`value`	`Object`	הערך של הטווח.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setValues(values)`

מגדירה רשת מלבנית של ערכים (חייבת להתאים למידות של הטווח הזה). אם ערך מתחיל ב- =, יפורש כנוסחה.

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

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

פרמטרים

שם	סוג	תיאור
`values`	`Object[][]`	מערך דו-ממדי של ערכים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setVerticalAlignment(alignment)`

מגדירים את היישור האנכי (מלמעלה למטה) של הטווח הנתון (למעלה/אמצעי/למטה).

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

פרמטרים

שם	סוג	תיאור
`alignment`	`String`	ההתאמה, `'top'`, `'middle'` או `'bottom'`; A הערך `null` מאפס את היישור.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setVerticalAlignments(alignments)`

מגדירה רשת מלבנית של יישור אנכי (חייבת להתאים למידות של הטווח הזה).

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

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

פרמטרים

שם	סוג	תיאור
`alignments`	`Object[][]`	מערך דו-ממדי של התאמות, `'top'`, `'middle'` או `'bottom'`; ערך `null` מאפס את היישור.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

ראה גם

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

קובעת אם לערום את הטקסט בתאים שבטווח או לא. אם הטקסט מופיע בערימה אנכית, המערכת מתעלמת מההגדרה של סיבוב טקסט במעלה.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

פרמטרים

שם	סוג	תיאור
`isVertical`	`Boolean`	האם לערום את הטקסט במקבצים.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setWrap(isWrapEnabled)`

מגדירים את גלישת התא של הטווח הנתון.

תאים שמופעל בהם גלישת טקסט (ברירת המחדל) משנים את גודלם כדי להציג את התוכן המלא שלהם. תאים עם גלישה התצוגה מושבתת ככל האפשר בתא, מבלי לשנות את גודלו או להריץ מספר שורות.

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

var cell = sheet.getRange("B2");
cell.setWrap(true);

פרמטרים

שם	סוג	תיאור
`isWrapEnabled`	`Boolean`	האם לגלול טקסט או לא.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setWrapStrategies(strategies)`

מגדירה רשת מלבנית של אסטרטגיות גלישה.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

פרמטרים

שם	סוג	תיאור
`strategies`	`WrapStrategy[][]`	אסטרטגיות האריזה הרצויות.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setWrapStrategy(strategy)`

מגדירה את האסטרטגיה של גלישת הטקסט לתאים שבטווח.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

פרמטרים

שם	סוג	תיאור
`strategy`	`WrapStrategy`	אסטרטגיית האריזה הרצויה.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`setWraps(isWrapEnabled)`

מגדיר רשת מלבנית של כללי מדיניות גלישת מילים (חייבת להתאים למידות של הטווח הזה). תאים עם שינוי גודל האריזה מופעל (ברירת המחדל) כדי להציג את התוכן המלא. תאים שבהם גלישת הטקסט מושבתת להציג כמה שיותר טקסט בתא בלי לשנות את הגודל שלו או להציג אותו בכמה שורות.

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

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

פרמטרים

שם	סוג	תיאור
`isWrapEnabled`	`Object[][]`	מערך דו-ממדי של משתני wrap – שקובעים אם לגלוש של הטקסט בתא, או לא.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

ראה גם

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

הפונקציה משנה את העומק של קיבוץ העמודות של הטווח לפי הסכום שצוין.

הדבר כולל יצירה, שינוי או מחיקה של קבוצות שמצטלבות עם טווח. במקרה של דלתות חיוביות, קבוצות נוצרות ו/או משתנות. בשביל דלתות שליליות, הקבוצות הושמד ו/או שונה.

אין לכך השפעה כאשר מקטינים את עומק הקבוצה מתחת לאפס או מעל שמונה.

אם column group control position הוא BEFORE, הפעולה הזו גורמת לשגיאה כשמנסים לשנות את היעד לעומק של השורה הראשונה.

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

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

פרמטרים

שם	סוג	תיאור
`delta`	`Integer`	הסכום לשינוי העומק של קבוצת העמודות בטווח הזה.

חזרה

Range – הטווח הזה, לשרשור.

קליעות

Error — כשמנסים להזיז את העומק של העמודה הראשונה כאשר המיקום של הבקרה הוא GroupControlTogglePosition.BEFORE

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`shiftRowGroupDepth(delta)`

הפונקציה משנה את עומק קיבוץ השורות של הטווח לפי הסכום שצוין.

אין לכך השפעה כאשר מקטינים את עומק הקבוצה מתחת לאפס או מעל שמונה.

אם הערך של row group control position הוא BEFORE, תופיע הודעת שגיאה כשמנסים להזיז את לעומק של השורה הראשונה.

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

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

פרמטרים

שם	סוג	תיאור
`delta`	`Integer`	הסכום שלפיו יש לשנות את עומק קבוצת השורות בטווח זה.

חזרה

Range – הטווח הזה, לשרשור.

קליעות

Error — כשמנסים להזיז את העומק של השורה הראשונה כשהפקדים המיקום הוא GroupControlTogglePosition.BEFORE

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`sort(sortSpecObj)`

ממיינת את התאים בטווח הנתון, לפי העמודה והסדר שצוינו.

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

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

פרמטרים

שם	סוג	תיאור
`sortSpecObj`	`Object`	העמודות שלפיהן רוצים למיין.

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`splitTextToColumns()`

מפצלת עמודת טקסט לכמה עמודות על סמך תו מפריד שמזוהה באופן אוטומטי.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`splitTextToColumns(delimiter)`

פיצול עמודת טקסט למספר עמודות תוך שימוש במחרוזת שצוינה כמפריד בהתאמה אישית.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

פרמטרים

שם	סוג	תיאור
`delimiter`	`String`	התו המפריד בהתאמה אישית שלפיו רוצים לפצל.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`splitTextToColumns(delimiter)`

פיצול עמודת טקסט למספר עמודות על סמך התו המפריד שצוין.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

פרמטרים

שם	סוג	תיאור
`delimiter`	`TextToColumnsDelimiter`	התו המפריד הקבוע מראש שצריך לפצל אותו.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`trimWhitespace()`

חיתוך של רווחים לבנים (כמו רווחים, כרטיסיות או שורות חדשות) בכל תא בטווח הזה. הסרות את כל הרווחים הלבנים מההתחלה והסוף של הטקסט בכל תא, ולהפחית את כל הרצף את תווי הרווח הלבן שנותרו ברווח אחד.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`uncheck()`

משנה את המצב של תיבות הסימון בטווח ל'לא מסומנות'. מתעלם מהתאים שבטווח והם לא מכילים כרגע את הערך המסומן או לא מסומן.

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

חזרה

Range – הטווח הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

שיטות שהוצאו משימוש

`getFontColor()`

הוצא משימוש. הוחלף על ידי getFontColorObject()

מחזירה את צבע הגופן של התא בפינה השמאלית העליונה של הטווח, בסימון CSS (כגון '#ffffff' או 'white').

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

Logger.log(range.getFontColor());

חזרה

String – צבע הגופן בסימון CSS (למשל '#ffffff' או 'white').

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFontColors()`

הוצא משימוש. הוחלף על ידי getFontColorObjects()

מחזירה את צבעי הגופן של התאים בטווח בסימון CSS (למשל '#ffffff' או 'white').

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

var results = range.getFontColors();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

חזרה

String[][] - מערך דו-ממדי של צבעי גופנים שמשויכים לתאים בטווח.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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