الوصول إلى رسم بياني لمصدر بيانات حالي وتعديله
لا تستخدم هذا الصف إلا مع البيانات المرتبطة بقاعدة بيانات.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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)
للانتظار حتى اكتمال عملية التنفيذ الحالية، تنتهي المهلة بعد عدد الثواني المحدد. توفّر استثناءً إذا لم تكتمل عملية التنفيذ عند انتهاء المهلة، ولكنها لا تُلغي تنفيذ البيانات.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
timeoutInSeconds | Integer | وقت انتظار تنفيذ البيانات بالثواني. الحدّ الأقصى هو 300 ثانية. |
استرجاع الكرة
DataExecutionStatus
— حالة تنفيذ البيانات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets