تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DataSource

الوصول إلى مصدر البيانات الحالي وتعديله لإنشاء جدول مصدر بيانات مع مصدر بيانات جديد، يُرجى الاطّلاع على DataSourceTable

لا تستخدِم هذه الفئة إلا مع البيانات المرتبطة بقاعدة بيانات.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`cancelAllLinkedDataSourceObjectRefreshes()`	`void`	تؤدي إلى إلغاء جميع عمليات إعادة التحميل الحالية لعناصر مصدر البيانات المرتبطة بمصدر البيانات هذا.
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	تنشئ عمودًا مَحسوبًا.
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	تنشئ جدولاً محوريًا لمصدر بيانات من مصدر البيانات هذا في الخلية الأولى من ورقة بيانات جديدة.
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	تنشئ جدول مصدر بيانات من مصدر البيانات هذا في الخلية الأولى من ورقة بيانات جديدة.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	تعرض العمود المحسوب في مصدر البيانات الذي يتطابق مع اسم العمود.
`getCalculatedColumns()`	`DataSourceColumn[]`	تعرض كل الأعمدة المحسوبة في مصدر البيانات.
`getColumns()`	`DataSourceColumn[]`	تعرض كل الأعمدة في مصدر البيانات.
`getDataSourceSheets()`	`DataSourceSheet[]`	تعرض أوراق مصدر البيانات المرتبطة بمصدر البيانات هذا.
`getSpec()`	`DataSourceSpec`	الحصول على مواصفات مصدر البيانات
`refreshAllLinkedDataSourceObjects()`	`void`	تتم إعادة تحميل جميع عناصر مصدر البيانات المرتبطة بمصدر البيانات.
`updateSpec(spec)`	`DataSource`	تعديل مواصفات مصدر البيانات وإعادة تحميل عناصر مصدر البيانات المرتبطة بهذا العنصر ومصدر البيانات بالمواصفات الجديدة.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	تعدّل مواصفات مصدر البيانات وتعيد تحميل `data source sheets` المرتبط بالمواصفات الجديدة.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	الانتظار إلى أن تكتمل جميع عمليات التنفيذ الحالية لعناصر مصدر البيانات المرتبطة، وتنتهي المهلة بعد عدد الثواني المحدد.

الوثائق التفصيلية

`cancelAllLinkedDataSourceObjectRefreshes()`

تؤدي إلى إلغاء جميع عمليات إعادة التحميل الحالية لعناصر مصدر البيانات المرتبطة بمصدر البيانات هذا.

يوضّح هذا المثال كيفية إلغاء جميع عمليات إعادة تحميل مصدر بيانات.

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

يعرض هذا العمود استثناءً إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدام طرق SpreadsheetApp#enable...Execution() لتفعيل تنفيذ البيانات للبيانات المحدّدة ونوع المصدر.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`createCalculatedColumn(name, formula)`

تنشئ عمودًا مَحسوبًا.

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم العمود المحسوب.
`formula`	`String`	صيغة العمود المحسوب.

الإرجاع

DataSourceColumn: العمود المحسوب الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`createDataSourcePivotTableOnNewSheet()`

تنشئ جدولاً محوريًا لمصدر بيانات من مصدر البيانات هذا في الخلية الأولى من ورقة بيانات جديدة. نتيجة لذلك، أُنشئت مكتبة مات بلوت ليب في تأثير جانبي، يجعل الورقة الجديدة الورقة النشطة.

الإرجاع

DataSourcePivotTable - الجدول المحوري لمصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`createDataSourceTableOnNewSheet()`

تنشئ جدول مصدر بيانات من مصدر البيانات هذا في الخلية الأولى من ورقة بيانات جديدة. كجانب تأثير، يجعل الورقة الجديدة الورقة النشطة.

الإرجاع

DataSourceTable : جدول مصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getCalculatedColumnByName(columnName)`

تعرض العمود المحسوب في مصدر البيانات الذي يتطابق مع اسم العمود.

المعلمات

الاسم	النوع	الوصف
`columnName`	`String`	اسم العمود المحسوب المطلوب الحصول عليه.

الإرجاع

DataSourceColumn: العمود المحسوب الذي يتطابق مع اسم العمود، أو null في حال عدم توفّر مثل عمود محسوب.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getCalculatedColumns()`

تعرض كل الأعمدة المحسوبة في مصدر البيانات.

الإرجاع

DataSourceColumn[] - مصفوفة من كل الأعمدة المحسوبة في مصدر البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getColumns()`

تعرض كل الأعمدة في مصدر البيانات.

الإرجاع

DataSourceColumn[] — مصفوفة من جميع DataSourceColumn في مصدر البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getDataSourceSheets()`

تعرض أوراق مصدر البيانات المرتبطة بمصدر البيانات هذا.

الإرجاع

DataSourceSheet[] — مصفوفة من أوراق مصدر البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getSpec()`

الحصول على مواصفات مصدر البيانات

الإرجاع

DataSourceSpec — مواصفات مصدر البيانات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`refreshAllLinkedDataSourceObjects()`

تتم إعادة تحميل جميع عناصر مصدر البيانات المرتبطة بمصدر البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`updateSpec(spec)`

تعمل هذه السياسة على تعديل مواصفات مصادر البيانات وإعادة تحميل عناصر مصدر البيانات المرتبطة بهذا العنصر. ومصدر البيانات بالمواصفات الجديدة.

المعلمات

الاسم	النوع	الوصف
`spec`	`DataSourceSpec`	مواصفات مصدر البيانات المطلوب تعديلها.

الإرجاع

DataSource — مصدر البيانات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`updateSpec(spec, refreshAllLinkedObjects)`

تعدّل مواصفات مصدر البيانات وتعيد تحميل data source sheets المرتبط بالمواصفات الجديدة.

المعلمات

الاسم	النوع	الوصف
`spec`	`DataSourceSpec`	مواصفات مصدر البيانات المطلوب تعديلها.
`refreshAllLinkedObjects`	`Boolean`	في حال `true`، ستتم أيضًا إعادة تحميل جميع عناصر مصدر البيانات. مرتبطة بمصدر البيانات هذا.

الإرجاع

DataSource — مصدر البيانات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

الانتظار إلى أن تكتمل جميع عمليات التنفيذ الحالية لعناصر مصدر البيانات المرتبطة، وتنتهي المهلة بعد عدد الثواني المحدد. لعرض استثناء في حال عدم اكتمال عمليات التنفيذ عند انتهاء المهلة، بدون إلغاء عمليات تنفيذ البيانات.

المعلمات

الاسم	النوع	الوصف
`timeoutInSeconds`	`Integer`	يشير ذلك المصطلح إلى وقت الانتظار لتنفيذ البيانات بالثواني. الحد الأقصى هو 300 ثوانٍ.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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