मौजूदा डेटा सोर्स टेबल को ऐक्सेस करना और उसमें बदलाव करना. नई शीट पर डेटा सोर्स की नई टेबल बनाने के लिए,
Spreadsheet.insertSheetWithDataSourceTable(spec)
का इस्तेमाल करें.
इस क्लास का इस्तेमाल सिर्फ़ BigQuery डेटा सोर्स के साथ करें.
इस उदाहरण में, नई डेटा सोर्स टेबल बनाने का तरीका बताया गया है.
SpreadsheetApp.enableBigQueryExecution(); const spreadsheet = SpreadsheetApp.getActive(); const spec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('big_query_project') .setRawQuery('select @FIELD from table limit @LIMIT') .setParameterFromCell('FIELD', 'Sheet1!A1') .setParameterFromCell('LIMIT', 'namedRangeCell') .build(); // Starts data execution asynchronously. const dataSheet = spreadsheet.insertSheetWithDataSourceTable(spec); const dataSourceTable = dataSheet.getDataSourceTables()[0]; // waitForCompletion() blocks script execution until data execution completes. dataSourceTable.waitForCompletion(60); // Check status after execution. Logger.log( 'Data execution state: %s.', dataSourceTable.getStatus().getExecutionState(), );
इस उदाहरण में, डेटा सोर्स में बदलाव करने का तरीका बताया गया है.
SpreadsheetApp.enableBigQueryExecution(); const dataSheet = SpreadsheetApp.getActive().getSheetByName('Data Sheet 1'); const dataSourceTable = dataSheet.getDataSourceTables()[0]; const dataSource = dataSourceTable.getDataSource(); const newSpec = dataSource.getSpec() .copy() .asBigQuery() .setRawQuery('select name from table limit 2') .removeAllParameters() .build(); // Updates data source specification and starts data execution asynchronously. dataSource.updateSpec(newSpec); // Check status during execution. Logger.log( 'Data execution state: %s.', dataSourceTable.getStatus().getExecutionState(), ); // waitForCompletion() blocks script execution until data execution completes. dataSourceTable.waitForCompletion(60); // Check status after execution. Logger.log( 'Data execution state: %s.', dataSourceTable.getStatus().getExecutionState(), );
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
add | Data | डेटा सोर्स टेबल में कॉलम जोड़ता है. |
add | Data | डेटा सोर्स टेबल पर लागू किया गया फ़िल्टर जोड़ता है. |
add | Data | डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है. |
add | Data | डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है. |
cancel | Data | अगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश फ़िलहाल चल रहा है, तो उसे रद्द कर देता है. |
force | Data | इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है. भले ही, उसकी मौजूदा स्थिति कुछ भी हो. |
get | Data | डेटा सोर्स टेबल में जोड़े गए सभी डेटा सोर्स कॉलम दिखाता है. |
get | Data | वह डेटा सोर्स दिखाता है जिससे ऑब्जेक्ट लिंक है. |
get | Data | डेटा सोर्स टेबल पर लागू किए गए सभी फ़िल्टर दिखाता है. |
get | Range | इस डेटा सोर्स टेबल के स्पैन की जानकारी देने वाला Range . |
get | Integer | डेटा सोर्स टेबल के लिए, पंक्ति की सीमा दिखाता है. |
get | Sort | डेटा सोर्स टेबल में, क्रम से लगाने की सभी खास बातें पाता है. |
get | Data | ऑब्जेक्ट के डेटा लागू होने की स्थिति दिखाता है. |
is | Boolean | यह दिखाता है कि डेटा सोर्स टेबल, उससे जुड़े डेटा सोर्स के सभी कॉलम को सिंक कर रही है या नहीं. |
refresh | Data | ऑब्जेक्ट का डेटा रीफ़्रेश करता है. |
remove | Data | डेटा सोर्स टेबल के सभी कॉलम हटा देता है. |
remove | Data | डेटा सोर्स टेबल में, क्रम से लगाने की सभी खास बातों को हटा देता है. |
set | Data | डेटा सोर्स टेबल की पंक्ति की सीमा अपडेट करता है. |
sync | Data | इससे, डेटा सोर्स से जुड़े सभी मौजूदा और आने वाले कॉलम, डेटा सोर्स टेबल में सिंक हो जाते हैं. |
wait | Data | मौजूदा एक्ज़ीक्यूशन पूरा होने तक इंतज़ार करता है. यह तय किए गए सेकंड के बाद टाइम आउट हो जाता है. |
ज़्यादा जानकारी वाला दस्तावेज़
add Columns(columnNames)
डेटा सोर्स टेबल में कॉलम जोड़ता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
column | String[] | जोड़ने के लिए कॉलम के नामों की सूची. |
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Filter(columnName, filterCriteria)
डेटा सोर्स टेबल पर लागू किया गया फ़िल्टर जोड़ता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
column | String | इस फ़िल्टर को लागू करने के लिए कॉलम का नाम. |
filter | Filter | फ़िल्टर करने की शर्तें. |
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Sort Spec(columnName, ascending)
डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
column | String | जिस कॉलम को क्रम से लगाना है उसका नाम. |
ascending | Boolean | अगर true है, तो कॉलम को बढ़ते क्रम में लगाएं. अगर false है, तो कॉलम को घटते क्रम में लगाएं. |
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Sort Spec(columnName, sortOrder)
डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
column | String | जिस कॉलम को क्रम से लगाना है उसका नाम. |
sort | Sort | क्रम से लगाने का तरीका. |
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancel Data Refresh()
अगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश फ़िलहाल चल रहा है, तो उसे रद्द कर देता है.
इस उदाहरण में, फ़ॉर्मूला रीफ़्रेश करने की प्रोसेस को रद्द करने का तरीका बताया गया है.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
अगर डेटा सोर्स टाइप चालू नहीं है, तो अपवाद दिखाता है. किसी खास डेटा सोर्स टाइप के लिए डेटा प्रोसेस करने की सुविधा चालू करने के लिए, Spreadsheet
तरीकों का इस्तेमाल करें.
वापसी का टिकट
Data
— डेटा ऑब्जेक्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
force Refresh Data()
इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है. भले ही, उसकी मौजूदा स्थिति कुछ भी हो. ज़्यादा जानकारी के लिए, refresh
देखें. अगर आपको इस ऑब्जेक्ट को रीफ़्रेश करने की प्रोसेस रद्द करनी है, तो cancel
देखें.
अगर डेटा सोर्स टाइप चालू नहीं है, तो अपवाद दिखाता है. किसी खास डेटा सोर्स टाइप के लिए डेटा प्रोसेस करने की सुविधा चालू करने के लिए, Spreadsheet
तरीकों का इस्तेमाल करें.
वापसी का टिकट
Data
— डेटा ऑब्जेक्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Columns()
डेटा सोर्स टेबल में जोड़े गए सभी डेटा सोर्स कॉलम दिखाता है.
वापसी का टिकट
Data
— डेटा सोर्स टेबल के कॉलम की सूची.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source()
वह डेटा सोर्स दिखाता है जिससे ऑब्जेक्ट लिंक है.
वापसी का टिकट
Data
— डेटा सोर्स.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Filters()
डेटा सोर्स टेबल पर लागू किए गए सभी फ़िल्टर दिखाता है.
वापसी का टिकट
Data
— डेटा सोर्स टेबल पर लागू किए गए सभी फ़िल्टर का कलेक्शन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range()
इस डेटा सोर्स टेबल के स्पैन की जानकारी देने वाला Range
.
वापसी का टिकट
Range
— रेंज.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Limit()
डेटा सोर्स टेबल के लिए, पंक्ति की सीमा दिखाता है.
वापसी का टिकट
Integer
— डेटा सोर्स टेबल के लिए लाइन की सीमा या null
, अगर कोई सीमा सेट नहीं की गई है और टेबल, Google Sheets के यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट ज़्यादा से ज़्यादा सीमा का इस्तेमाल करती है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sort Specs()
डेटा सोर्स टेबल में, क्रम से लगाने की सभी खास बातें पाता है.
वापसी का टिकट
Sort
— क्रम से लगाने के लिए खास जानकारी की सूची.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Status()
ऑब्जेक्ट के डेटा लागू होने की स्थिति दिखाता है.
वापसी का टिकट
Data
— डेटा प्रोसेस करने की स्थिति.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Syncing All Columns()
यह दिखाता है कि डेटा सोर्स टेबल, उससे जुड़े डेटा सोर्स के सभी कॉलम को सिंक कर रही है या नहीं.
वापसी का टिकट
Boolean
— True
अगर डेटा सोर्स टेबल, उससे जुड़े डेटा सोर्स के सभी कॉलम को सिंक कर रही है, तो True
और अगर नहीं, तो false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh Data()
ऑब्जेक्ट का डेटा रीफ़्रेश करता है.
अगर फ़िलहाल error
स्थिति में है, तो अपवाद दिखाता है. स्पेसिफ़िकेशन अपडेट करने के लिए, Data
का इस्तेमाल करें. डेटा सोर्स में अचानक होने वाले बदलावों को रोकने के लिए, इस तरीके को force
के मुकाबले प्राथमिकता दी जाती है.
अगर डेटा सोर्स टाइप चालू नहीं है, तो अपवाद दिखाता है. किसी खास डेटा सोर्स टाइप के लिए डेटा प्रोसेस करने की सुविधा चालू करने के लिए, Spreadsheet
तरीकों का इस्तेमाल करें.
वापसी का टिकट
Data
— डेटा ऑब्जेक्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove All Columns()
डेटा सोर्स टेबल के सभी कॉलम हटा देता है.
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove All Sort Specs()
डेटा सोर्स टेबल में, क्रम से लगाने की सभी खास बातों को हटा देता है.
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Row Limit(rowLimit)
डेटा सोर्स टेबल की पंक्ति की सीमा अपडेट करता है. अगर लाइन की दी गई सीमा null
है, तो डेटा सोर्स टेबल को अपडेट किया जाता है, ताकि Google Sheets के यूज़र इंटरफ़ेस (यूआई) में लाइन की डिफ़ॉल्ट ज़्यादा से ज़्यादा सीमा का इस्तेमाल किया जा सके.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
row | Integer | डेटा टेबल के लिए, नई लाइन की सीमा. अगर null है, तो टेबल को अपडेट करके, पंक्ति की डिफ़ॉल्ट सीमा का इस्तेमाल किया जाता है. |
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sync All Columns()
इससे, डेटा सोर्स से जुड़े सभी मौजूदा और आने वाले कॉलम, डेटा सोर्स टेबल में सिंक हो जाते हैं.
वापसी का टिकट
Data
— चेन करने के लिए डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For Completion(timeoutInSeconds)
मौजूदा एक्ज़ीक्यूशन पूरा होने तक इंतज़ार करता है. यह तय समय के बाद टाइम आउट हो जाता है. अगर समय खत्म होने पर भी प्रोसेस पूरी नहीं होती है, तो यह एक अपवाद दिखाता है. हालांकि, यह डेटा प्रोसेस को रद्द नहीं करता.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
timeout | Integer | डेटा प्रोसेस होने में लगने वाला समय, सेकंड में. यह अवधि ज़्यादा से ज़्यादा 300 सेकंड हो सकती है. |
वापसी का टिकट
Data
— डेटा प्रोसेस करने की स्थिति.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets