Class DataSourcePivotTable

DataSourcePivotTable

既存のデータソースのピボット テーブルにアクセスして変更する。新しいデータソースのピボット テーブルを作成するには、Range.createDataSourcePivotTable(dataSource) を使用します。

このクラスは、データベースに接続されているデータでのみ使用します。

Methods

メソッド戻り値の型概要
addColumnGroup(columnName)PivotGroup指定されたデータソース列に基づいて新しいピボット列グループを追加します。
addFilter(columnName, filterCriteria)PivotFilter指定したフィルタ条件を使用して、指定したデータソース列に基づいて新しいフィルタを追加します。
addPivotValue(columnName, summarizeFunction)PivotValue指定された集計関数を使用して、指定されたデータソース列に基づいて新しいピボット値を追加します。
addRowGroup(columnName)PivotGroup指定されたデータソース列に基づいて新しいピボット行グループを追加します。
asPivotTable()PivotTableデータソースのピボット テーブルを通常のピボット テーブル オブジェクトとして返します。
forceRefreshData()DataSourcePivotTable現在の状態に関係なく、このオブジェクトのデータを更新します。
getDataSource()DataSourceオブジェクトがリンクされているデータソースを取得します。
getStatus()DataExecutionStatusオブジェクトのデータ実行ステータスを取得します。
refreshData()DataSourcePivotTableオブジェクトのデータを更新します。
waitForCompletion(timeoutInSeconds)DataExecutionStatus現在の実行が完了するまで待機し、指定された秒数後にタイムアウトします。

詳細なドキュメント

addColumnGroup(columnName)

指定されたデータソース列に基づいて新しいピボット列グループを追加します。

パラメータ

名前説明
columnNameStringピボット グループのベースとなるデータソースの列名。

リターン

PivotGroup - 新しいピボット グループ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addFilter(columnName, filterCriteria)

指定したフィルタ条件を使用して、指定したデータソース列に基づいて新しいフィルタを追加します。

パラメータ

名前説明
columnNameStringフィルタの基になっているデータソースの列名。
filterCriteriaFilterCriteriaフィルタが使用する条件。

リターン

PivotFilter - 新しいフィルタ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(columnName, summarizeFunction)

指定された集計関数を使用して、指定されたデータソース列に基づいて新しいピボット値を追加します。

パラメータ

名前説明
columnNameStringピボット値の基になっているデータソースの列名。
summarizeFunctionPivotTableSummarizeFunctionピボット値で使用される集計関数。

リターン

PivotValue - 新しいピボット値。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addRowGroup(columnName)

指定されたデータソース列に基づいて新しいピボット行グループを追加します。

パラメータ

名前説明
columnNameStringピボット グループのベースとなるデータソースの列名。

リターン

PivotGroup - 新しいピボット グループ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

asPivotTable()

データソースのピボット テーブルを通常のピボット テーブル オブジェクトとして返します。

リターン

PivotTable - ピボット テーブル。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forceRefreshData()

現在の状態に関係なく、このオブジェクトのデータを更新します。詳しくは、refreshData() をご覧ください。

データソース タイプが有効になっていない場合、例外をスローします。特定のデータソース タイプに対してデータ実行を有効にするには、SpreadsheetApp#enable...Execution() メソッドを使用します。

リターン

DataSourcePivotTable - データ オブジェクト。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSource()

オブジェクトがリンクされているデータソースを取得します。

リターン

DataSource - データソース。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getStatus()

オブジェクトのデータ実行ステータスを取得します。

リターン

DataExecutionStatus - データ実行ステータス。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshData()

オブジェクトのデータを更新します。

現在 error 状態の場合、例外をスローします。DataSource#updateSpec() を使用して仕様を更新します。データソースの予期しない編集を防ぐため、forceRefreshData() よりもこのメソッドをおすすめします。

データソース タイプが有効になっていない場合、例外をスローします。特定のデータソース タイプに対してデータ実行を有効にするには、SpreadsheetApp#enable...Execution() メソッドを使用します。

リターン

DataSourcePivotTable - データ オブジェクト。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

現在の実行が完了するまで待機し、指定された秒数後にタイムアウトします。 タイムアウト時に実行が完了していない場合に例外をスローしますが、データ実行はキャンセルしません。

パラメータ

名前説明
timeoutInSecondsIntegerデータ実行の待機時間(秒単位)。最大値は 300 秒です。

リターン

DataExecutionStatus - データ実行ステータス。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets