Mevcut veri kaynağı formüllerine erişme ve bunları değiştirme. Yeni bir veri kaynağı formülü oluşturmak için Range.setFormula(formula)
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 |
---|---|---|
forceRefreshData() | DataSourceFormula | Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
getAnchorCell() | Range | Bu veri kaynağı formülünün bağlı olduğu hücreyi temsil eden Range değerini döndürür. |
getDataSource() | DataSource | Nesnenin bağlı olduğu veri kaynağını alır. |
getDisplayValue() | String | Veri kaynağı formülünün görüntüleme değerini döndürür. |
getFormula() | String | Bu veri kaynağı formülüne ilişkin formülü döndürür. |
getStatus() | DataExecutionStatus | Nesnenin veri yürütme durumunu alır. |
refreshData() | DataSourceFormula | Nesnenin verilerini yeniler. |
setFormula(formula) | DataSourceFormula | Formülü günceller. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Mevcut yürütme işlemi tamamlanana kadar bekler ve sağlanan saniye sayısından sonra zaman aşımına uğrar. |
Ayrıntılı belgeler
forceRefreshData()
Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refreshData()
sayfasını ziyaret edin.
Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourceFormula
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
Bu veri kaynağı formülünün bağlı olduğu hücreyi temsil eden Range
değerini döndürür.
Return
Range
: Sabit hücre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Veri kaynağı formülünün görüntüleme değerini döndürür.
Return
String
: Gösterilen değer.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
Bu veri kaynağı formülüne ilişkin formülü döndürür.
Return
String
: Formül.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 durumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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. Belirtimi güncellemek için DataSource#updateSpec()
öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için bu yöntem forceRefreshData()
yerine tercih edilir.
Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourceFormula
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Formülü günceller.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Yeni formül. |
Return
DataSourceFormula
: Zincirleme için veri kaynağı formülü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 sağlanan saniye sayısından sonra zaman aşımına uğrar. Yürütme işlemi, zaman aşımına uğradığında tamamlanmazsa ancak veri yürütmeyi iptal etmezse istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Veri yürütülmesi için beklenecek saniye (saniye cinsinden). Maksimum süre 300 saniyedir. |
Return
DataExecutionStatus
: Veri yürütme durumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets