既存のデータソースにアクセスして変更する。新しいデータソースを使用してデータソース テーブルを作成するには、DataSourceTable
をご覧ください。
このクラスは、データベースに接続されているデータでのみ使用します。
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
createCalculatedColumn(name, formula) | DataSourceColumn | 計算列を作成します。 |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | このデータソースからデータソースのピボット テーブルを新しいシートの最初のセルに作成します。 |
createDataSourceTableOnNewSheet() | DataSourceTable | このデータソースから新しいテーブルの最初のセルにデータソース テーブルを作成します。 |
getCalculatedColumnByName(columnName) | DataSourceColumn | 列名と一致する、データソース内の計算列を返します。 |
getCalculatedColumns() | DataSourceColumn[] | データソース内のすべての計算列を返します。 |
getColumns() | DataSourceColumn[] | データソース内のすべての列を返します。 |
getDataSourceSheets() | DataSourceSheet[] | このデータソースに関連付けられたデータソース シートを返します。 |
getSpec() | DataSourceSpec | データソース仕様を取得します。 |
refreshAllLinkedDataSourceObjects() | void | データソースにリンクされているすべてのデータソース オブジェクトを更新します。 |
updateSpec(spec) | DataSource | データソース仕様を更新し、このデータソースにリンクされているデータソース オブジェクトを新しい仕様で更新します。 |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | データソース仕様を更新し、リンクされた data
source sheets を新しい仕様で更新します。 |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | リンクされたデータソース オブジェクトの現在の実行がすべて完了するまで待機し、指定された秒数後にタイムアウトします。 |
詳細なドキュメント
createCalculatedColumn(name, formula)
計算列を作成します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
name | String | 計算された列の名前。 |
formula | String | 計算された列の数式。 |
戻る
DataSourceColumn
- 新しく作成された計算列。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTableOnNewSheet()
このデータソースからデータソースのピボット テーブルを新しいシートの最初のセルに作成します。副作用として、新しいシートをアクティブなシートにします。
戻る
DataSourcePivotTable
- 新しく作成されたデータソースのピボット テーブル。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTableOnNewSheet()
このデータソースから新しいテーブルの最初のセルにデータソース テーブルを作成します。副作用として、新しいシートをアクティブなシートにします。
戻る
DataSourceTable
- 新しく作成されたデータソース テーブル。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumnByName(columnName)
列名と一致する、データソース内の計算列を返します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
columnName | String | 取得する計算列の名前。 |
戻る
DataSourceColumn
- 列名と一致する計算列。そのような計算列がない場合は null
です。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumns()
データソース内のすべての計算列を返します。
戻る
DataSourceColumn[]
- データソース内のすべての計算列の配列。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumns()
データソース内のすべての列を返します。
戻る
DataSourceColumn[]
- データソース内のすべての DataSourceColumn
の配列。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
このデータソースに関連付けられたデータソース シートを返します。
戻る
DataSourceSheet[]
- データソース シートの配列。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpec()
データソース仕様を取得します。
戻る
DataSourceSpec
- データソース仕様。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshAllLinkedDataSourceObjects()
データソースにリンクされているすべてのデータソース オブジェクトを更新します。
データソースの種類が有効になっていない場合は、例外がスローされます。SpreadsheetApp#enable...Execution()
メソッドを使用して、特定のデータソース タイプに対してデータ実行を有効にします。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec)
データソース仕様を更新し、このデータソースにリンクされているデータソース オブジェクトを新しい仕様で更新します。
データソースの種類が有効になっていない場合は、例外がスローされます。SpreadsheetApp#enable...Execution()
メソッドを使用して、特定のデータソース タイプに対してデータ実行を有効にします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
spec | DataSourceSpec | 更新するデータソースの仕様。 |
戻る
DataSource
- データソースです。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
データソース仕様を更新し、リンクされた data
source sheets
を新しい仕様で更新します。
データソースの種類が有効になっていない場合は、例外がスローされます。SpreadsheetApp#enable...Execution()
メソッドを使用して、特定のデータソース タイプに対してデータ実行を有効にします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
spec | DataSourceSpec | 更新するデータソースの仕様。 |
refreshAllLinkedObjects | Boolean | true の場合、このデータソースにリンクされているすべてのデータソース オブジェクトも更新されます。 |
戻る
DataSource
- データソースです。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
リンクされたデータソース オブジェクトの現在の実行がすべて完了するまで待機し、指定された秒数後にタイムアウトします。タイムアウト時に実行が完了しなかった場合、例外をスローしますが、データ実行をキャンセルしません。
パラメータ
名前 | 型 | 説明 |
---|---|---|
timeoutInSeconds | Integer | データ実行の待機時間(秒単位)。最大値は 300 秒です。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets