Mevcut veri kaynağı sayfasına erişme ve bu sayfayı değiştirme Yeni bir veri kaynağı sayfası oluşturmak için Spreadsheet.insertDataSourceSheet(spec)
politikasını 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 çalışıyorsa bu nesneyle ilişkili veri yenilemesini iptal eder. |
forceRefreshData() | DataSourceSheet | Geçerli 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 sağlanan başlangıç satırından (1 tabanlı) ve sağlanan numRows değerine kadar olan tüm veri kaynağı sayfasındaki tüm değerleri döndürür. |
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ütuna ilişkin sıralama spesifikasyonunu 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ütun için sıralama spesifikasyonunu ayarlar. |
setSortSpec(columnName, sortOrder) | DataSourceSheet | Veri kaynağı sayfasındaki bir sütun için sıralama spesifikasyonunu ayarlar. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Geçerli yürütme tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar. |
Ayrıntılı belgeler
addFilter(columnName, filterCriteria)
Veri kaynağı sayfasına uygulanan bir filtre 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 zincirleme işlemi için veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 biri 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 biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancelDataRefresh()
Bu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini iptal eder.
Bu örnekte, formül yenilemesinin 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 bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için
SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourceSheet
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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. Daha fazla bilgi için refreshData()
sayfasına bakın. Bu nesnenin şu anda devam eden yenilemesini iptal etmek istiyorsanız cancelDataRefresh()
adresine bakın.
Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourceSheet
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 biri 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 biri 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ütunu adı. |
Return
Object[]
— Tek boyutlu bir değerler dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 sağlanan başlangıç satırından (1 tabanlı) ve sağlanan numRows
değerine kadar olan tüm 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ütunu adı. |
startRow | Integer | Değerlerin alınmaya başlanacağı satır konumu. |
numRows | Integer | Getirilecek satır sayısı. |
Return
Object[]
— Tek boyutlu bir değerler dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 biri 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 durumudur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Nesnenin verilerini yeniler.
Şu anda error
durumundaysa istisna oluşturur. Teknik özellikleri güncellemek için DataSource#updateSpec()
öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için yöntem forceRefreshData()
yerine tercih edilir.
Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourceSheet
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 zincirleme işlemi için veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeSortSpec(columnName)
Veri kaynağı sayfasındaki bir sütuna ilişkin sıralama spesifikasyonunu 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 biri 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 biri 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 biri 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ütun için sıralama spesifikasyonunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Sıralanacak sütunun adı. |
ascending | Boolean | Sütun true ise 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 biri 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ütun için sıralama spesifikasyonunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Sıralanacak sütunun adı. |
sortOrder | SortOrder | Sıralama düzeni. |
Return
DataSourceSheet
: Zincirleme için veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Geçerli yürütme tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa ancak veri yürütme işlemini iptal etmezse bir istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Saniye cinsinden veri yürütülmesi için beklenecek süre. Maksimum süre 300 saniyedir. |
Return
DataExecutionStatus
: Veri yürütme durumudur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets