Class DataSourcePivotTable

DataSourcePivotTable

Mevcut veri kaynağı pivot tablosuna erişip değiştirin. Yeni bir veri kaynağı pivot tablosu oluşturmak için Range.createDataSourcePivotTable(dataSource) simgesini kullanın.

Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.

Yöntemler

YöntemDönüş türüKısa açıklama
addColumnGroup(columnName)PivotGroupBelirtilen veri kaynağı sütununa göre yeni bir pivot sütun grubu ekler.
addFilter(columnName, filterCriteria)PivotFilterBelirtilen veri kaynağı sütununa ve belirtilen filtre ölçütlerine göre yeni bir filtre ekler.
addPivotValue(columnName)PivotValueBelirtilen veri kaynağı sütununa göre, özetleme işlevi olmadan yeni bir pivot tablo değeri ekler.
addPivotValue(columnName, summarizeFunction)PivotValueBelirtilen özetleme işleviyle, belirtilen veri kaynağı sütununa dayalı yeni bir pivot değeri ekler.
addRowGroup(columnName)PivotGroupBelirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler.
asPivotTable()PivotTableVeri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür.
cancelDataRefresh()DataSourcePivotTableŞu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder.
forceRefreshData()DataSourcePivotTableGeçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
getDataSource()DataSourceNesnenin bağlı olduğu veri kaynağını alır.
getStatus()DataExecutionStatusNesnenin veri yürütme durumunu alır.
refreshData()DataSourcePivotTableNesnenin verilerini yeniler.
waitForCompletion(timeoutInSeconds)DataExecutionStatusMevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı sonunda 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

AdTürAçıklama
columnNameStringPivot grubun temel alındığı veri kaynağı sütununun adı.

Return

PivotGroup: Yeni pivot grubu.

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

addFilter(columnName, filterCriteria)

Belirtilen veri kaynağı sütununa ve belirtilen filtre ölçütlerine göre yeni bir filtre ekler.

Parametreler

AdTürAçıklama
columnNameStringFiltrenin temel alındığı veri kaynağı sütununun adı.
filterCriteriaFilterCriteriaFiltrenin kullandığı ölçütler.

Return

PivotFilter: Yeni filtre.

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

addPivotValue(columnName)

Belirtilen veri kaynağı sütununa göre, özetleme işlevi olmadan yeni bir pivot tablo değeri ekler. Yalnızca Looker ölçümleri için geçerlidir.

Aşağıdaki kodda, Looker ölçüsünü nasıl özet değeri olarak ekleyebileceğiniz gösterilmektedir. 

// TODO(developer): Replace with your spreadsheet ID which has a Looker data
// source.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

Bu yöntem yalnızca Looker veri kaynakları için kullanılabilir.

Parametreler

AdTürAçıklama
columnNameStringPivot değerinin temel alındığı veri kaynağı sütununun adı.

Return

PivotValue: Yeni pivot değeri.

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

addPivotValue(columnName, summarizeFunction)

Belirtilen özetleme işleviyle, belirtilen veri kaynağı sütununa dayalı yeni bir pivot değeri ekler.

Looker ölçümleri için pivot değerleri eklemek üzere addPivotValue(columnName) simgesini kullanın.

Parametreler

AdTürAçıklama
columnNameStringPivot değerinin temel alındığı veri kaynağı sütununun adı.
summarizeFunctionPivotTableSummarizeFunctionÖzetleme işlevi, pivot değerini kullanır.

Return

PivotValue: Yeni pivot değeri.

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

addRowGroup(columnName)

Belirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler.

Parametreler

AdTürAçıklama
columnNameStringPivot grubun temel alındığı veri kaynağı sütununun adı.

Return

PivotGroup: Yeni pivot grubu.

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

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 biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 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() bölümüne bakın. Bu nesnenin şu anda devam eden yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() başlıklı makaleyi inceleyin.

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 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

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

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 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 belirtilen saniye sayısı sonunda zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa istisna oluşturur ancak veri yürütmeyi iptal etmez.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVeri yürütme için beklenecek süre (saniye cinsinden). Maksimum süre 300 saniyedir.

Return

DataExecutionStatus: Veri yürütme durumu.

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