Mevcut veri kaynağı pivot tablosuna erişme ve değişiklik yapma. Yeni bir veri kaynağı pivot tablosu oluşturmak için Range.createDataSourcePivotTable(dataSource)
işaretini 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 |
---|---|---|
addColumnGroup(columnName) | PivotGroup | Belirtilen veri kaynağı sütununu temel alarak yeni bir pivot sütun grubu ekler. |
addFilter(columnName, filterCriteria) | PivotFilter | Belirtilen filtre ölçütleriyle belirtilen veri kaynağı sütununu temel alan yeni bir filtre ekler. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Belirtilen özetleme işleviyle, belirtilen veri kaynağı sütununu temel alarak yeni bir pivot değeri ekler. |
addRowGroup(columnName) | PivotGroup | Belirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler. |
asPivotTable() | PivotTable | Veri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür. |
forceRefreshData() | DataSourcePivotTable | Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
getDataSource() | DataSource | Nesnenin bağlı olduğu veri kaynağını alır. |
getStatus() | DataExecutionStatus | Nesnenin veri yürütme durumunu alır. |
refreshData() | DataSourcePivotTable | Nesnenin verilerini yeniler. |
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
addColumnGroup(columnName)
Belirtilen veri kaynağı sütununu temel alarak yeni bir pivot sütun grubu ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot grubunun temel aldığı veri kaynağı sütunu adı. |
Return
PivotGroup
: Yeni pivot grubu.
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
addFilter(columnName, filterCriteria)
Belirtilen filtre ölçütleriyle belirtilen veri kaynağı sütununu temel alan yeni bir filtre ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Filtrenin temel aldığı veri kaynağı sütunu adı. |
filterCriteria | FilterCriteria | Filtrenin kullandığı ölçütler. |
Return
PivotFilter
: Yeni filtre.
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
addPivotValue(columnName, summarizeFunction)
Belirtilen özetleme işleviyle, belirtilen veri kaynağı sütununu temel alarak yeni bir pivot değeri ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot tablo değerinin temel aldığı veri kaynağı sütunu adı. |
summarizeFunction | PivotTableSummarizeFunction | Pivot değerinin kullandığı özetleme işlevi. |
Return
PivotValue
: Yeni pivot değeri.
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
addRowGroup(columnName)
Belirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot grubunun temel aldığı veri kaynağı sütunu adı. |
Return
PivotGroup
: Yeni pivot grubu.
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
asPivotTable()
Veri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür.
Return
PivotTable
: Pivot tablo.
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
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
DataSourcePivotTable
: 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
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
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
DataSourcePivotTable
: 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
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