דף זה תורגם על ידי Cloud Translation API.

Class DataSourceSheet

לגשת לגיליון קיים של מקור נתונים ולשנות אותו. כדי ליצור גיליון חדש של מקור נתונים, יש להשתמש ב-Spreadsheet.insertDataSourceSheet(spec).

יש להשתמש בכיתה הזו רק עם נתונים שמקושרים למסד נתונים.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`addFilter(columnName, filterCriteria)`	`DataSourceSheet`	הוספת מסנן שהוחל על הגיליון של מקור הנתונים.
`asSheet()`	`Sheet`	מחזירה את הגיליון של מקור הנתונים כאובייקט גיליון רגיל.
`autoResizeColumn(columnName)`	`DataSourceSheet`	שינוי אוטומטי של רוחב העמודה שצוינה.
`autoResizeColumns(columnNames)`	`DataSourceSheet`	שינוי אוטומטי של רוחב העמודות שצוינו.
`cancelDataRefresh()`	`DataSourceSheet`	ביטול של רענון הנתונים המשויך לאובייקט הזה, אם הוא פועל כרגע.
`forceRefreshData()`	`DataSourceSheet`	רענון הנתונים של האובייקט הזה, ללא קשר למצב הנוכחי.
`getColumnWidth(columnName)`	`Integer`	מחזירה את הרוחב של העמודה שצוינה.
`getDataSource()`	`DataSource`	הפונקציה מקבלת את מקור הנתונים שאליו האובייקט מקושר.
`getFilters()`	`DataSourceSheetFilter[]`	הפונקציה מחזירה את כל המסננים שהוחלו בגיליון של מקור הנתונים.
`getSheetValues(columnName)`	`Object[]`	מחזירה את כל הערכים בגיליון של מקור הנתונים עבור שם העמודה שצוינה.
`getSheetValues(columnName, startRow, numRows)`	`Object[]`	פונקציה זו מחזירה את כל הערכים בגיליון של מקור הנתונים עבור שם העמודה שצוינה משורת ההתחלה (מבוססת-1) ועד ל-`numRows` שצוין.
`getSortSpecs()`	`SortSpec[]`	קבלת כל המפרטים למיון בגיליון של מקור הנתונים.
`getStatus()`	`DataExecutionStatus`	הפונקציה מקבלת את סטטוס ביצוע הנתונים של האובייקט.
`refreshData()`	`DataSourceSheet`	רענון של נתוני האובייקט.
`removeFilters(columnName)`	`DataSourceSheet`	הסרה של כל המסננים שהוחלו על העמודה בגיליון של מקור הנתונים.
`removeSortSpec(columnName)`	`DataSourceSheet`	הסרה של מפרט המיון בעמודה בגיליון של מקור הנתונים.
`setColumnWidth(columnName, width)`	`DataSourceSheet`	מגדיר את הרוחב של העמודה שצוינה.
`setColumnWidths(columnNames, width)`	`DataSourceSheet`	מגדיר את הרוחב של העמודות שצוינו.
`setSortSpec(columnName, ascending)`	`DataSourceSheet`	מגדיר את מפרט המיון בעמודה בגיליון של מקור הנתונים.
`setSortSpec(columnName, sortOrder)`	`DataSourceSheet`	מגדיר את מפרט המיון בעמודה בגיליון של מקור הנתונים.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	בהמתנה לסיום הביצוע הנוכחי, הזמן הקצוב יסתיים אחרי מספר השניות שצוין.

מסמכי תיעוד מפורטים

`addFilter(columnName, filterCriteria)`

הוספת מסנן שהוחל על הגיליון של מקור הנתונים.

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה שעליה רוצים להחיל את המסנן הזה.
`filterCriteria`	`FilterCriteria`	קריטריוני הסינון שצריך להחיל.

חזרה

DataSourceSheet – הגיליון של מקור הנתונים, לשרשור של שיטות.

אישור

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

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

`asSheet()`

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

חזרה

Sheet – הגיליון הרגיל.

אישור

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

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

`autoResizeColumn(columnName)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה.

חזרה

DataSourceSheet – הגיליון האלקטרוני של מקור הנתונים, לשרשור.

אישור

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

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

`autoResizeColumns(columnNames)`

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

פרמטרים

שם	סוג	תיאור
`columnNames`	`String[]`	רשימת שמות העמודות שצריך לעדכן.

חזרה

DataSourceSheet – הגיליון האלקטרוני של מקור הנתונים, לשרשור.

אישור

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

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

`cancelDataRefresh()`

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

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

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

מחריגה חריג אם הסוג של מקור הנתונים לא מופעל. כדי להפעיל נתונים במקור נתונים ספציפי, צריך להשתמש בשיטות SpreadsheetApp#enable...Execution() מהסוג הזה.

חזרה

DataSourceSheet – אובייקט הנתונים.

אישור

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

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

`forceRefreshData()`

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

חזרה

DataSourceSheet – אובייקט הנתונים.

אישור

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

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

`getColumnWidth(columnName)`

מחזירה את הרוחב של העמודה שצוינה.

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה.

חזרה

Integer – רוחב העמודה, או null אם העמודה משתמשת ברוחב ברירת המחדל.

אישור

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

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

`getDataSource()`

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

חזרה

DataSource – מקור הנתונים.

אישור

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

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

`getFilters()`

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

חזרה

DataSourceSheetFilter[] – מערך של כל המסננים שהוחלו על הגיליון של מקור הנתונים.

אישור

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

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

`getSheetValues(columnName)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה של מקור הנתונים שאת הערכים שלה רוצים לאחזר.

חזרה

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

אישור

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

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

`getSheetValues(columnName, startRow, numRows)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה של מקור הנתונים שאת הערכים שלה רוצים לאחזר.
`startRow`	`Integer`	מיקום השורה שממנו רוצים להתחיל לאחזר ערכים.
`numRows`	`Integer`	מספר השורות לאחזור.

חזרה

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

אישור

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

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

`getSortSpecs()`

קבלת כל המפרטים למיון בגיליון של מקור הנתונים.

חזרה

SortSpec[] – רשימה של מפרטים למיון.

אישור

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

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

`getStatus()`

הפונקציה מקבלת את סטטוס ביצוע הנתונים של האובייקט.

חזרה

DataExecutionStatus – סטטוס הפעלת הנתונים.

אישור

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

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

`refreshData()`

רענון של נתוני האובייקט.

הפעולה הזאת גורמת לחריגה אם כרגע נמצאים במצב error. כדי לעדכן את המפרט, צריך להשתמש ב-DataSource#updateSpec(). השיטה היא העדפה על forceRefreshData() כדי למנוע עריכות לא צפויות במקור הנתונים.

חזרה

DataSourceSheet – אובייקט הנתונים.

אישור

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

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

`removeFilters(columnName)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה שממנה רוצים להסיר מסננים.

חזרה

DataSourceSheet – הגיליון של מקור הנתונים, לשרשור של שיטות.

אישור

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

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

`removeSortSpec(columnName)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה.

חזרה

DataSourceSheet – הגיליון של מקור הנתונים, לשרשור.

אישור

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

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

`setColumnWidth(columnName, width)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה.
`width`	`Integer`	הרוחב החדש של העמודה.

חזרה

DataSourceSheet – הגיליון האלקטרוני של מקור הנתונים, לשרשור.

אישור

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

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

`setColumnWidths(columnNames, width)`

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

פרמטרים

שם	סוג	תיאור
`columnNames`	`String[]`	רשימת שמות העמודות שצריך לעדכן.
`width`	`Integer`	הרוחב החדש של העמודות.

חזרה

DataSourceSheet – הגיליון האלקטרוני של מקור הנתונים, לשרשור.

אישור

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

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

`setSortSpec(columnName, ascending)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה למיון.
`ascending`	`Boolean`	אם הערך שלו הוא `true`, צריך למיין את העמודה בסדר עולה. אם `false`, מיון העמודה בסדר יורד.

חזרה

DataSourceSheet – הגיליון של מקור הנתונים, לשרשור.

אישור

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

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

`setSortSpec(columnName, sortOrder)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה למיון.
`sortOrder`	`SortOrder`	סדר המיון.

חזרה

DataSourceSheet – הגיליון של מקור הנתונים, לשרשור.

אישור

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

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

`waitForCompletion(timeoutInSeconds)`

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

פרמטרים

שם	סוג	תיאור
`timeoutInSeconds`	`Integer`	זמן ההמתנה להפעלת נתונים, בשניות. המקסימום הוא 300 שניות.

חזרה

DataExecutionStatus – סטטוס הפעלת הנתונים.

אישור

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

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