الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير | 
|---|---|---|
| build() | Data | تُنشئ هذه الأداة مواصفات مصدر بيانات من الإعدادات الواردة في أداة الإنشاء هذه. | 
| copy() | Data | تُنشئ Dataاستنادًا إلى إعدادات مصدر البيانات هذا. | 
| get | String | تحصل على رقم تعريف مجموعة بيانات BigQuery. | 
| get | Data | تحصل على مَعلمات مصدر البيانات. | 
| get | String | للحصول على رقم تعريف مشروع الفوترة | 
| get | String | تحصل على سلسلة طلب البحث الأوّلية. | 
| get | String | تحصل على معرّف جدول BigQuery. | 
| get | String | تحصل على رقم تعريف مشروع BigQuery للجدول. | 
| get | Data | تحصل على نوع مصدر البيانات. | 
| remove | Big | تزيل جميع المَعلمات. | 
| remove | Big | تزيل المَعلمة المحدّدة. | 
| set | Big | تُستخدَم لضبط رقم تعريف مجموعة بيانات BigQuery. | 
| set | Big | تُضيف مَعلمة، أو إذا كانت المَعلمة التي تحمل الاسم متوفّرة، تعدّل خلية المصدر الخاصة بأدوات إنشاء مواصفات مصدر البيانات من النوع Data. | 
| set | Big | لضبط رقم تعريف مشروع الفوترة في BigQuery | 
| set | Big | تُستخدَم لضبط سلسلة طلب البحث الأوّلية. | 
| set | Big | تُستخدَم لضبط معرّف جدول BigQuery. | 
| set | Big | تُستخدَم لضبط رقم تعريف مشروع BigQuery للجدول. | 
مستندات تفصيلية
build()
تُنشئ هذه الأداة مواصفات مصدر بيانات من الإعدادات الواردة في أداة الإنشاء هذه. يجب استخدام as...()
لتحديد نوع مصدر بيانات قبل الإنشاء.
ينشئ نموذج التعليمات البرمجية التالي مواصفات مصدر بيانات BigQuery.
const bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery(); // TODO(developer): Replace with the required dataset, project and table IDs. bigQueryDataSourceSpec.setDatasetId('my data set id'); bigQueryDataSourceSpec.setProjectId('my project id'); bigQueryDataSourceSpec.setTableId('my table id'); bigQueryDataSourceSpec.build();
ينشئ نموذج التعليمات البرمجية التالي مواصفات Looker DataSource.
const lookerDataSourceSpecBuilder = SpreadsheetApp.newDataSourceSpec().asLooker(); const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name') .setInstanceUrl('my instance url') .setModelName('my model name') .build();
الإرجاع
Data: مواصفات مصدر البيانات
copy()
تُنشئ Data استنادًا إلى إعدادات مصدر البيانات هذا.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const newSpec = spec.copy();
الإرجاع
Data: صانع المحتوى
get
تحصل على رقم تعريف مجموعة بيانات BigQuery.
الإرجاع
String: معرّف مجموعة البيانات، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث أولي.
get
تحصل على مَعلمات مصدر البيانات.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const parameters = spec.getParameters();
لا تتوفّر هذه الطريقة إلا لمصادر بيانات BigQuery.
الإرجاع
Data - قائمة المَعلمات
get
للحصول على رقم تعريف مشروع الفوترة
الإرجاع
String - رقم تعريف المشروع
get
تحصل على سلسلة طلب البحث الأوّلية.
الإرجاع
String: سلسلة طلب البحث الأوّلية
get
تحصل على معرّف جدول BigQuery.
الإرجاع
String: رقم تعريف الجدول، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث أولي.
get
تحصل على رقم تعريف مشروع BigQuery للجدول.
الإرجاع
String: رقم تعريف مشروع الجدول، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث خام.
get
تحصل على نوع مصدر البيانات.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const type = spec.getType();
الإرجاع
Data: نوع مصدر البيانات
remove
تزيل جميع المَعلمات.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeAllParameters();
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر
remove
تزيل المَعلمة المحدّدة.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeParameter('x');
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| parameter | String | اسم المَعلمة المطلوب إزالتها | 
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر
set
تُستخدَم لضبط رقم تعريف مجموعة بيانات BigQuery.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| dataset | String | رقم تعريف مجموعة البيانات. | 
الإرجاع
Big: هذا المُنشئ، لتسلسل العناصر.
set
تُضيف مَعلمة، أو إذا كانت المَعلمة التي تحمل الاسم متوفّرة، تعدّل خلية المصدر الخاصة بأدوات إنشاء مواصفات مصدر البيانات من النوع Data.
لا تتوفّر هذه الطريقة إلا لمصادر بيانات BigQuery.
const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery(); specBuilder.setParameterFromCell('x', 'A1'); const bigQuerySpec = specBuilder.build();
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| parameter | String | اسم المَعلمة | 
| source | String | الخلية المصدر، كما هو محدّد في أسلوب A1 | 
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر
set
لضبط رقم تعريف مشروع الفوترة في BigQuery
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| project | String | معرّف مشروع الفوترة | 
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر
set
تُستخدَم لضبط سلسلة طلب البحث الأوّلية.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| raw | String | سلسلة طلب البحث الأوّلية. | 
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر
set
تُستخدَم لضبط معرّف جدول BigQuery.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| table | String | رقم تعريف الجدول. | 
الإرجاع
Big: هذا المُنشئ، لتسلسل العناصر.
set
تُستخدَم لضبط رقم تعريف مشروع BigQuery للجدول.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| project | String | رقم تعريف مشروع جدول BigQuery. | 
الإرجاع
Big — أداة الإنشاء لتسلسل العناصر