Mevcut veri kaynağına erişme ve bu kaynağı değiştirme. Yeni veri kaynağına sahip bir veri kaynağı tablosu oluşturmak için şu makaleyi inceleyin:
DataSourceTable
Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
cancelAllLinkedDataSourceObjectRefreshes() | void | Bu veri kaynağına bağlı veri kaynağı nesnelerinde şu anda devam eden tüm yenilemeleri iptal eder. |
createCalculatedColumn(name, formula) | DataSourceColumn | Hesaplanmış bir sütun oluşturur. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur. |
createDataSourceTableOnNewSheet() | DataSourceTable | Yeni bir sayfanın ilk hücresinde bu veri kaynağından veri kaynağı tablosu oluşturur. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Veri kaynağında, sütun adıyla eşleşen hesaplanmış sütunu döndürür. |
getCalculatedColumns() | DataSourceColumn[] | Veri kaynağındaki hesaplanmış tüm sütunları döndürür. |
getColumns() | DataSourceColumn[] | Veri kaynağındaki tüm sütunları döndürür. |
getDataSourceSheets() | DataSourceSheet[] | Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür. |
getSpec() | DataSourceSpec | Veri kaynağı spesifikasyonunu alır. |
refreshAllLinkedDataSourceObjects() | void | Veri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler. |
updateSpec(spec) | DataSource | Veri kaynağı spesifikasyonunu günceller ve buna bağlı veri kaynağı nesnelerini yeniler yeni spesifikasyona sahip veri kaynağı oluşturun. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Veri kaynağı spesifikasyonunu günceller ve bağlı data
source sheets özelliğini yeni spesifikasyonla yeniler. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Bağlı veri kaynağı nesnelerinin mevcut tüm yürütmeleri tamamlanana kadar bekler ve zaman aşımına uğrar belirtilen sayıda saniye geçtikten sonra. |
Ayrıntılı belgeler
cancelAllLinkedDataSourceObjectRefreshes()
Bu veri kaynağına bağlı veri kaynağı nesnelerinde şu anda devam eden tüm yenilemeleri iptal eder.
Bu örnekte, bir veri kaynağının tüm yenilemelerinin nasıl iptal edileceği gösterilmektedir.
SpreadsheetApp.enableBigQueryExecution(); const dataSource = spreadsheet.getDataSources()[0]; dataSource.cancelAllLinkedDataSourceObjectRefreshes();
Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın
kaynak türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
createCalculatedColumn(name, formula)
Hesaplanmış bir sütun oluşturur. Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Hesaplanmış sütunun adı. |
formula | String | Hesaplanmış sütun formülü. |
Return
DataSourceColumn: Yeni oluşturulan hesaplanmış sütun.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTableOnNewSheet()
Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur. Kullanıcı yeni sayfayı etkin sayfa haline getirir.
Return
DataSourcePivotTable — Yeni oluşturulan veri kaynağı pivot tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
createDataSourceTableOnNewSheet()
Yeni bir sayfanın ilk hücresinde bu veri kaynağından veri kaynağı tablosu oluşturur. Yan olarak yeni sayfayı etkin sayfa haline getirir.
Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.
Return
DataSourceTable: Yeni oluşturulan veri kaynağı tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumnByName(columnName)
Veri kaynağında, sütun adıyla eşleşen hesaplanmış sütunu döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Alınacak hesaplanmış sütunun adı. |
Return
DataSourceColumn: Sütun adıyla eşleşen hesaplanmış sütun veya böyle bir hesaplanmış sütun yoksa null.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumns()
Veri kaynağındaki hesaplanmış tüm sütunları döndürür.
DataSourceType.LOOKER türünün veri kaynağı özellikleri boş bir dizi döndürüyor.
Return
DataSourceColumn[]: Veri kaynağındaki tüm hesaplanmış sütunların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getColumns()
Veri kaynağındaki tüm sütunları döndürür.
Return
DataSourceColumn[] — Veri kaynağındaki tüm DataSourceColumn öğelerini içeren bir dizi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür.
Return
DataSourceSheet[]: Veri kaynağı e-tabloları dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSpec()
Veri kaynağı spesifikasyonunu alır.
Return
DataSourceSpec: Veri kaynağı spesifikasyonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refreshAllLinkedDataSourceObjects()
Veri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.
Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın
kaynak türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec)
Veri kaynağı spesifikasyonunu günceller ve buna bağlı veri kaynağı nesnelerini yeniler yeni spesifikasyona sahip veri kaynağı oluşturun.
Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın
kaynak türü.
Veri kaynağı spesifikasyon türü Mevcut veri kaynağı türünü seçin.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
spec | DataSourceSpec | Güncelleme yapılacak veri kaynağı spesifikasyonu. |
Return
DataSource — Veri kaynağı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
Veri kaynağı spesifikasyonunu günceller ve bağlı data
source sheets özelliğini yeni spesifikasyonla yeniler.
Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın
kaynak türü.
Veri kaynağı spesifikasyon türü Mevcut veri kaynağı türünü seçin.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
spec | DataSourceSpec | Güncellenecek veri kaynağı spesifikasyonu. |
refreshAllLinkedObjects | Boolean | true ise tüm veri kaynağı nesnelerini de yeniler
bu veri kaynağına bağlı. |
Return
DataSource — Veri kaynağı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Bağlı veri kaynağı nesnelerinin mevcut tüm yürütmeleri tamamlanana kadar bekler ve zaman aşımına uğrar belirtilen sayıda saniye geçtikten sonra. Yürütmeler tamamlanmazsa istisna atar zaman aşımına uğrattığını ancak veri yürütmelerini iptal etmez.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
timeoutInSeconds | Integer | Saniye cinsinden veri yürütme işlemi için beklenecek süre. Maksimum değer 300'dür. saniye. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets