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)
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ütununa göre yeni bir pivot sütun grubu ekler. |
addFilter(columnName, filterCriteria) | PivotFilter | Belirtilen veri kaynağı sütununa göre, belirtilen filtre ölçütleriyle yeni bir filtre ekler. |
addPivotValue(columnName) | PivotValue | Özetleme olmadan, belirtilen veri kaynağı sütununa göre yeni bir pivot değeri ekler işlevini kullanın. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Belirtilen özetleme işleviyle belirtilen veri kaynağı sütununa göre yeni bir pivot değer 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. |
cancelDataRefresh() | DataSourcePivotTable | Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder. |
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 | 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
addColumnGroup(columnName)
Belirtilen veri kaynağı sütununa göre yeni bir pivot sütun grubu ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Pivot grubunun temel aldığı veri kaynağı sütun adı. |
Return
PivotGroup — Yeni pivot grubu.
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
addFilter(columnName, filterCriteria)
Belirtilen veri kaynağı sütununa göre, belirtilen filtre ölçütleriyle yeni bir filtre ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Filtrenin dayandığı 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName)
Özetleme olmadan, belirtilen veri kaynağı sütununa göre yeni bir pivot değeri ekler işlevini kullanın. Yalnızca Looker ölçümleri için.
Aşağıdaki kodda, pivot değer olarak bir Looker ölçümünü nasıl ekleyebileceğinizi görebilirsiniz.
// TODO(developer): Replace with your spreadsheet ID which has a Looker data source. var spreadsheet = SpreadsheetApp.openById("abcd1234") var datasource = spreadsheet.getDataSources()[0]; var pivotTable = datasource.createDataSourcePivotTableOnNewSheet(); pivotTable.addPivotValue("columnName");
Bu yöntem yalnızca Looker veri kaynakları için kullanılabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Pivot değerinin temel aldığı veri kaynağı sütunu adı. |
Return
PivotValue — Yeni pivot değeri.
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
addPivotValue(columnName, summarizeFunction)
Belirtilen özetle, belirtilen veri kaynağı sütununa göre yeni bir pivot değeri ekler işlevini kullanın.
Looker ölçümleri için pivot değerleri eklemek üzere addPivotValue(columnName) simgesini kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columnName | String | Pivot 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 kapsamlardan bir 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ütun adı. |
Return
PivotGroup — Yeni pivot grubu.
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
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 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 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 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
DataSourcePivotTable: 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
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 devam eden yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() bölümüne bakın.
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
DataSourcePivotTable: 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
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
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 kapsamlardan bir 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 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ü 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
DataSourcePivotTable: 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
waitForCompletion(timeoutInSeconds)
Geçerli yürütme işlemi tamamlanana kadar bekler. Belirtilen sayıda saniye geçtikten 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