גישה לתדירות של לוח זמנים לרענון, שמציינת באיזו תדירות ומתי יתבצע הרענון.
יש להשתמש במחלקה הזו רק עם נתונים שמקושרים למסד נתונים.
כדי לראות מתי לוח הזמנים לרענון מתוזמן לפעול, יש להשתמש בפונקציה DataSourceRefreshSchedule.getTimeIntervalOfNextRun().
כדי לעדכן, צריך להשתמש בDataSourceRefreshSchedule.setFrequency(newFrequency).
שיטות
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
getDaysOfTheMonth() | Integer[] | הפונקציה מקבלת את הימים בחודש כמספרים (1-28) שבהם יתבצע רענון של מקור הנתונים. |
getDaysOfTheWeek() | Weekday[] | הפונקציה מקבלת את הימים בשבוע שבהם יש לרענן את מקור הנתונים. |
getFrequencyType() | FrequencyType | הפונקציה מקבלת את סוג התדירות. |
getStartHour() | Integer | הפונקציה מקבלת את שעת ההתחלה (כמספר בין 0 ל-23) של מרווח הזמן שבמהלכו פועל לוח הזמנים לרענון. |
תיעוד מפורט
getDaysOfTheMonth()
הפונקציה מקבלת את הימים בחודש כמספרים (1-28) שבהם יתבצע רענון של מקור הנתונים. רלוונטי רק אם סוג התדירות הוא חודשי.
החזרות
Integer[] – הימים בחודש שבהם יש לרענן.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDaysOfTheWeek()
הפונקציה מקבלת את הימים בשבוע שבהם יש לרענן את מקור הנתונים. רלוונטי רק אם סוג התדירות הוא שבועי.
החזרות
Weekday[] – הימים בשבוע שבהם צריך לרענן.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getFrequencyType()
הפונקציה מקבלת את סוג התדירות.
החזרות
FrequencyType – סוג התדירות.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getStartHour()
הפונקציה מקבלת את שעת ההתחלה (כמספר בין 0 ל-23) של מרווח הזמן שבמהלכו פועל לוח הזמנים לרענון. לדוגמה, אם שעת ההתחלה היא 13 ופרק הזמן של מרווח הזמן הוא 4 שעות, מקור הנתונים יתרענן בין 13:00 ל-17:00. השעה היא באזור הזמן של הגיליון האלקטרוני.
החזרות
Integer – שעת ההתחלה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets