Mevcut veri kaynağı sayfasına erişme ve sayfada değişiklik yapma. Yeni bir veri kaynağı sayfası oluşturmak için Spreadsheet.insertDataSourceSheet(spec) işlevini kullanın.
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 |
|---|---|---|
addFilter(columnName, filterCriteria) | DataSourceSheet | Veri kaynağı sayfasına uygulanan bir filtre ekler. |
asSheet() | Sheet | Veri kaynağı sayfasını normal sayfa nesnesi olarak döndürür. |
autoResizeColumn(columnName) | DataSourceSheet | Belirtilen sütunun genişliğini otomatik olarak yeniden boyutlandırır. |
autoResizeColumns(columnNames) | DataSourceSheet | Belirtilen sütunların genişliğini otomatik olarak yeniden boyutlandırır. |
cancelDataRefresh() | DataSourceSheet | Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder. |
forceRefreshData() | DataSourceSheet | Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
getColumnWidth(columnName) | Integer | Belirtilen sütunun genişliğini döndürür. |
getDataSource() | DataSource | Nesnenin bağlı olduğu veri kaynağını alır. |
getFilters() | DataSourceSheetFilter[] | Veri kaynağı sayfasına uygulanan tüm filtreleri döndürür. |
getSheetValues(columnName) | Object[] | Sağlanan sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür. |
getSheetValues(columnName, startRow, numRows) | Object[] | Sağlanan sütun adı için, veri kaynağı sayfasındaki tüm değerleri
başlangıç satırı (1 temelli) ve sağlanan numRows değerine kadar. |
getSortSpecs() | SortSpec[] | Veri kaynağı sayfasındaki tüm sıralama özelliklerini alır. |
getStatus() | DataExecutionStatus | Nesnenin veri yürütme durumunu alır. |
refreshData() | DataSourceSheet | Nesnenin verilerini yeniler. |
removeFilters(columnName) | DataSourceSheet | Veri kaynağı sayfası sütununa uygulanan tüm filtreleri kaldırır. |
removeSortSpec(columnName) | DataSourceSheet | Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini kaldırır. |
setColumnWidth(columnName, width) | DataSourceSheet | Belirtilen sütunun genişliğini ayarlar. |
setColumnWidths(columnNames, width) | DataSourceSheet | Belirtilen sütunların genişliğini ayarlar. |
setSortSpec(columnName, ascending) | DataSourceSheet | Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar. |
setSortSpec(columnName, sortOrder) | DataSourceSheet | Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Geçerli yürütme işlemi tamamlanana kadar bekler. Belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar. |
Ayrıntılı belgeler
addFilter(columnName, filterCriteria)
Veri kaynağı sayfasına uygulanan bir filtreyi ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Bu filtrenin uygulanacağı sütunun adı. |
filterCriteria | FilterCriteria | Uygulanacak filtre ölçütleri. |
Return
DataSourceSheet — Yöntem zinciri için veri kaynağı sayfası.
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
asSheet()
Veri kaynağı sayfasını normal sayfa nesnesi olarak döndürür.
Return
Sheet: Normal e-tablo.
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
autoResizeColumn(columnName)
Belirtilen sütunun genişliğini otomatik olarak yeniden boyutlandırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sütun adı. |
Return
DataSourceSheet — Zincirleme için bu veri kaynağı sayfası.
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
autoResizeColumns(columnNames)
Belirtilen sütunların genişliğini otomatik olarak yeniden boyutlandırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnNames | String[] | Güncellenecek sütun adlarının listesi. |
Return
DataSourceSheet — Zincirleme için bu veri kaynağı sayfası.
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
cancelDataRefresh()
Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.
Bu örnekte, formül yenilemenin nasıl iptal edileceği gösterilmektedir.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma
türü.
Return
DataSourceSheet: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. Şunun için refreshData() sayfasına bakın:
inceleyebilirsiniz. Bu nesnenin şu anda çalışan yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() bölümüne bakın.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.
Return
DataSourceSheet: Veri nesnesi.
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
getColumnWidth(columnName)
Belirtilen sütunun genişliğini döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sütun adı. |
Return
Integer: Sütunun genişliği veya sütun varsayılan genişliği kullanıyorsa 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
getDataSource()
Nesnenin bağlı olduğu veri kaynağını alır.
Return
DataSource — Veri kaynağı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getFilters()
Veri kaynağı sayfasına uygulanan tüm filtreleri döndürür.
Return
DataSourceSheetFilter[]: Veri kaynağı sayfasına uygulanan tüm filtrelerin 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
getSheetValues(columnName)
Sağlanan sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Değerlerinin alınacağı veri kaynağı sütununun adı. |
Return
Object[]: Tek boyutlu bir değer 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
getSheetValues(columnName, startRow, numRows)
Sağlanan sütun adı için, veri kaynağı sayfasındaki tüm değerleri
başlangıç satırı (1 temelli) ve sağlanan numRows değerine kadar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Değerlerinin alınacağı veri kaynağı sütununun adı. |
startRow | Integer | Değer getirmeye başlanacak satır konumu. |
numRows | Integer | Getirilecek satır sayısı. |
Return
Object[]: Tek boyutlu bir değer 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
getSortSpecs()
Veri kaynağı sayfasındaki tüm sıralama özelliklerini alır.
Return
SortSpec[]: Sıralama özelliklerinin listesi.
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
getStatus()
Nesnenin veri yürütme durumunu alır.
Return
DataExecutionStatus — Veri yürütme durumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refreshData()
Nesnenin verilerini yeniler.
Şu anda error durumundaysa istisna atar. Spesifikasyonu güncellemek için DataSource#updateSpec() simgesini kullanın. Yöntem
veri kaynağında beklenmeyen düzenlemeleri önlemek için forceRefreshData() yerine tercih edilir.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma
türü.
Return
DataSourceSheet: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
removeFilters(columnName)
Veri kaynağı sayfası sütununa uygulanan tüm filtreleri kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Filtrelerin kaldırılacağı sütunun adı. |
Return
DataSourceSheet — Yöntem zinciri için veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
removeSortSpec(columnName)
Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sütunun adı. |
Return
DataSourceSheet — Zincirleme için veri kaynağı sayfası.
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
setColumnWidth(columnName, width)
Belirtilen sütunun genişliğini ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sütun adı. |
width | Integer | Sütunun yeni genişliği. |
Return
DataSourceSheet — Zincirleme için bu veri kaynağı sayfası.
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
setColumnWidths(columnNames, width)
Belirtilen sütunların genişliğini ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnNames | String[] | Güncellenecek sütun adlarının listesi. |
width | Integer | Sütunların yeni genişliği. |
Return
DataSourceSheet — Zincirleme için bu veri kaynağı sayfası.
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
setSortSpec(columnName, ascending)
Veri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sıralanacak sütunun adı. |
ascending | Boolean | true ise sütunu artan düzende, false ise azalan düzende sıralayın. |
Return
DataSourceSheet: Zincirleme için veri kaynağı sayfası.
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
setSortSpec(columnName, sortOrder)
Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Sıralanacak sütunun adı. |
sortOrder | SortOrder | Sıralama ölçütü. |
Return
DataSourceSheet — Zincirleme için veri kaynağı sayfası.
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
waitForCompletion(timeoutInSeconds)
Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa bir istisna atar ancak veri yürütme sürecidir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
timeoutInSeconds | Integer | Verilerin yürütülmesi için beklenecek saniye cinsinden süre. Maksimum değer 300'dür. saniye. |
Return
DataExecutionStatus: Veri yürütme durumu.
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