גישה לתרשים קיים של מקור נתונים ושינוי שלו.
יש להשתמש במחלקה הזו רק עם נתונים שמקושרים למסד נתונים.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
forceRefreshData() | DataSourceChart | רענון הנתונים של האובייקט הזה ללא קשר למצב הנוכחי. |
getDataSource() | DataSource | הפונקציה מקבלת את מקור הנתונים שאליו האובייקט מקושר. |
getStatus() | DataExecutionStatus | קבלת סטטוס הביצוע של הנתונים של האובייקט. |
refreshData() | DataSourceChart | רענון של נתוני האובייקט. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | ממתין לסיום ההפעלה הנוכחית, ומסתיים לאחר מספר השניות שצוין. |
תיעוד מפורט
forceRefreshData()
רענון הנתונים של האובייקט הזה ללא קשר למצב הנוכחי. לפרטים נוספים,
אפשר לקרוא את refreshData()
.
מציג חריגה אם סוג מקור הנתונים לא מופעל. שימוש בשיטות SpreadsheetApp#enable...Execution()
כדי לאפשר הפעלת נתונים לסוג ספציפי של מקור נתונים.
החזרות
DataSourceChart
- אובייקט הנתונים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
getStatus()
קבלת סטטוס הביצוע של הנתונים של האובייקט.
החזרות
DataExecutionStatus
– סטטוס הביצוע של הנתונים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
רענון של נתוני האובייקט.
הפונקציה מחריגה חריגות אם היא נמצאת כרגע במצב error
. יש להשתמש באפשרות DataSource#updateSpec()
כדי לעדכן את המפרט. השיטה הזו מועדפת על פני forceRefreshData()
כדי למנוע עריכות לא צפויות במקור הנתונים.
מציג חריגה אם סוג מקור הנתונים לא מופעל. שימוש בשיטות SpreadsheetApp#enable...Execution()
כדי לאפשר הפעלת נתונים לסוג ספציפי של מקור נתונים.
החזרות
DataSourceChart
- אובייקט הנתונים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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