الوصول إلى رسم بياني لمصدر بيانات حالي وتعديله
لا تستخدم هذا الصف إلا مع البيانات المرتبطة بقاعدة بيانات.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
cancelDataRefresh() | DataSourceChart | يؤدي هذا الإجراء إلى إلغاء عملية إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كان قيد التشغيل حاليًا. |
forceRefreshData() | DataSourceChart | إعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية |
getDataSource() | DataSource | الحصول على مصدر البيانات المرتبط بالكائن. |
getStatus() | DataExecutionStatus | للحصول على حالة تنفيذ البيانات للكائن. |
refreshData() | DataSourceChart | لإعادة تحميل بيانات العنصر. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | انتظر إلى أن تكتمل عملية التنفيذ الحالية، وانتظِر بعد عدد الثواني المحدّد. |
الوثائق التفصيلية
cancelDataRefresh()
يؤدي هذا الإجراء إلى إلغاء عملية إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كان قيد التشغيل حاليًا.
يعرِض هذا المثال كيفية إلغاء إعادة تحميل الصيغة.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
يتم عرض استثناء إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدِم طرق
SpreadsheetApp#enable...Execution()
لتفعيل تنفيذ البيانات لنوع محدّد من مصدر البيانات.
استرجاع الكرة
DataSourceChart
: كائن البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلّب الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
إعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية يمكنك الاطّلاع على refreshData()
للحصول على المزيد من التفاصيل. إذا أردت إلغاء عملية إعادة تحميل جارية حاليًا لهذا الكائن، يُرجى الاطّلاع على "cancelDataRefresh()
".
يتم عرض استثناء إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدِم طرق 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