Class DataSourceSheet

VeriKaynağıSayfası

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) simgesini 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 bir 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	Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi 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ğı e-tablosunun tüm değerlerini döndürür.
getSheetValues(columnName, startRow, numRows)	Object[]	Belirtilen sütun adı için veri kaynağı sayfasının, belirtilen başlangıç satırından (1'e dayalı) itibaren ve belirtilen numRows değerine kadar tüm değerlerini 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ğı e-tablo sütununa uygulanan tüm filtreleri kaldırır.
removeSortSpec(columnName)	DataSourceSheet	Veri kaynağı sayfasındaki bir sütundaki 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 spesifikasyonunu ayarlar.
setSortSpec(columnName, sortOrder)	DataSourceSheet	Veri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.
waitForCompletion(timeoutInSeconds)	DataExecutionStatus	Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar.

Ayrıntılı dokümanlar

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ç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

---

asSheet()

Veri kaynağı sayfasını normal bir sayfa nesnesi olarak döndürür.

Return

Sheet: Normal sayfa.

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

---

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ı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

---

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ı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

---

cancelDataRefresh()

Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi 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ü 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ı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()

Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refreshData() bölümüne bakın. 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ı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

---

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ı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

---

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ı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

---

getSheetValues(columnName)

Sağlanan sütun adı için veri kaynağı e-tablosunun tüm değerlerini döndürür.

Parametreler

Ad	Tür	Açıklama
columnName	String	Değerlerinin getirileceği veri kaynağı sütunu adı.

Return

Object[]: Tek boyutlu bir değer dizisi.

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

---

getSheetValues(columnName, startRow, numRows)

Belirtilen sütun adı için veri kaynağı sayfasının, belirtilen başlangıç satırından (1'e dayalı) itibaren ve belirtilen numRows değerine kadar tüm değerlerini döndürür.

Parametreler

Ad	Tür	Açıklama
columnName	String	Değerlerinin getirileceği veri kaynağı sütunu 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ı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

---

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ı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

---

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 oluşturur. Spesifikasyonu güncellemek için DataSource#updateSpec() simgesini kullanın. Veri kaynağında beklenmedik düzenlemeleri önlemek için bu yöntem, forceRefreshData() yerine tercih edilir.

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ı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ğı e-tablo 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ç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ütundaki 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ı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

---

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ı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

---

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ı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

---

setSortSpec(columnName, ascending)

Veri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.

Parametreler

Ad	Tür	Açıklama
columnName	String	Sıralamanın yapılacağı 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ı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

---

setSortSpec(columnName, sortOrder)

Veri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.

Parametreler

Ad	Tür	Açıklama
columnName	String	Sıralamanın yapılacağı sütunun adı.
sortOrder	SortOrder	Sıralama ölçütü.

Return

DataSourceSheet: Zincirleme 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

---

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ı olduğunda yürütme tamamlanmazsa bir istisna oluşturur ancak veri yürütme işlemini iptal etmez.

Parametreler

Ad	Tür	Açıklama
timeoutInSeconds	Integer	Veri yürütme işlemi için bekleme süresi (saniye cinsinden). Maksimum süre 300 saniyedir.

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