現時点で実装されている、面グラフ、棒グラフ、縦棒グラフ、コンボチャート(2つの単位の異なるグラフ)、ヒストグラムチャート、折れ線グラフ、円グラフ、散布図、テーブルチャート。

各グラフ毎のリファレンスを全部マージしてます。だいぶボリュームが膨れ上がってしまいましたが。。。各グラフで使用しているメソッドは表のマトリックスで表現してます。

すべてのチャートに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

埋め込みチャートクラス[EmbeddedChart]

スプレッドシートに埋め込まれたグラフを表します。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedChart

次の例は、既存のチャートを変更する方法を示しています。

function chartModifySample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getRange("A2:B8")
  var chart = sheet.getCharts()[0]; 
  chart = chart.modify()
      .addRange(range)
      .setOption('title', 'Updated!')
      .setOption('animation.duration', 500)
      .setPosition(2,2,0,0)
      .build();
  sheet.updateChart(chart);
}

この例は、新しいグラフを作成する方法を示しています。

function newChartSample(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

チャートコンテンツタイプ変換取得[getAs(コンテンツタイプ)]

getAs(contentType)
このオブジェクト内のデータを、指定されたコンテンツタイプに変換されたblobとして返します。このメソッドは、適切な拡張子をファイル名に追加します（たとえば、「myfile.pdf」）。ただし、最後のピリオド（存在する場合）に続くファイル名の部分は、置き換える必要がある既存の拡張子であると想定しています。その結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

Return
Blob - ブロブとしてのデータ。

チャートデータブロブ取得[getBlob()]

getBlob()
このオブジェクト内のデータをblobとして返します。

Return
Blob - ブロブとしてのデータ。

チャート識別子取得[getChartId()]

getChartId()
チャートを含むスプレッドシート全体で一意なチャートの安定した識別子を返します。チャートがスプレッドシートにない場合はnullを返します。

Return
Integer - 安定したチャート識別子。

チャート位置情報取得[getContainerInfo()]

getContainerInfo()
シート内のチャートの位置に関する情報を返します。

function getContainerInfoSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  var containerInfo = chart.getContainerInfo();

  // setPosition()で使用した値を記録します
  Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
            containerInfo.getAnchorColumn(),
            containerInfo.getAnchorRow(),
            containerInfo.getOffsetX(),
            containerInfo.getOffsetY());
}

Return
ContainerInfo - チャートコンテナーの位置を含むオブジェクト

チャート行列非表示方法取得[getHiddenDimensionStrategy()]

getHiddenDimensionStrategy()
非表示の行と列の処理に使用する方法を返します。デフォルトはIGNORE_ROWSです。

function getHiddenDimensionStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
      .setPosition(5, 5, 0, 0)
      .build()

  // この場合はCharts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS
  // である非表示の行と列に使用する方法を記録します。
  Logger.log(chart.getHiddenDimensionStrategy());
}

Return
ChartHiddenDimensionStrategy - 非表示の行と列に使用する方法。

チャートオブジェクトID取得[getId()]

getId()
このオブジェクトに割り当てられたIDを返します。

これをapp.getElementById()と組み合わせて使用して、このオブジェクトへの参照を取得できます。

Return
String - このオブジェクトに割り当てられたID

チャートマージ方法取得[getMergeStrategy()]

getMergeStrategy()
複数の範囲が存在する場合に使用されるマージ方法を返します。 MERGE_ROWSの場合、行はマージされます。 MERGE_COLUMNSの場合、列はマージされます。デフォルトはMERGE_COLUMNSです。

function getMergeStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B10");
  var range2 = sheet.getRange("C1:C10");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .addRange(range2)
      .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
      .setPosition(5, 5, 0, 0)
      .build()

  // 複数の範囲の行（この場合はMERGE_ROWS）がマージされるかどうかを記録します。
  Logger.log(chart.getMergeStrategy());
}

Return
ChartMergeStrategy - 行が複数の範囲にわたってマージされる場合、MERGE_ROWS。列が複数の範囲にわたってマージされる場合、MERGE_COLUMNS。

チャートヘッダー行列数取得[getNumHeaders()]

getNumHeaders()
範囲としてヘッダーとして扱われる行または列の数を返します。

function getNumHeadersSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setNumHeaders(1)
      .setPosition(5, 5, 0, 0)
      .build()
  // ヘッダーとして使用する行または列の数を記録します。この場合は1です。
  //Logger.log(chart.getHeaders());
  Logger.log(chart.getNumHeaders());
}

Return
Integer - ヘッダーとして処理される行または列の数。負の値は、ヘッダーが自動検出されることを示します。

チャートオプション取得[getOptions()]

getOptions()
高さ、色、軸など、このチャートのオプションを返します。

返されるオプションは不変です。

Return
ChartOptions - 高さ、色、軸など、このグラフのオプション。

チャート範囲取得[getRanges()]

getRanges()
このチャートがデータソースとして使用する範囲を返します。

function getRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  var ranges = chart.getRanges();

  // このグラフのデータソースとして1つの範囲しかないため、
  // 「A1：B8」をログに記録します
  for (var i in ranges) {
    var range = ranges[i];
    Logger.log(range.getA1Notation());
  }
}

Return
Range[] - このチャートのデータソースとして機能する範囲の配列。

チャートデータ行列転置取得[getTransposeRowsAndColumns()]

getTransposeRowsAndColumns()
trueの場合、グラフの設定に使用される行と列が切り替えられます。デフォルトはfalseです。

function getTransposeRowsAndColumnsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .addRange(range)
      .setChartType(Charts.ChartType.BAR)
      .setTransposeRowsAndColumns(true)
      .setPosition(5, 5, 0, 0)
      .build()

  // 行と列を転置するかどうかを記録します。この場合はtrueです。
  Logger.log(chart.getTransposeRowsAndColumns());
}

Return
Boolean - チャートの構築に使用される行と列が転置される場合はtrue。

チャートオブジェクトタイプ取得[getType()]

getType()
このオブジェクトのタイプを取得します。

Return
String - オブジェクトタイプ

チャート変更[modify()]

modify()
このチャートの変更に使用できるEmbeddedChartBuilderを返します。 sheet.updateChart(chart)を呼び出して、変更を保存します。

function getTypeSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chart = sheet.getCharts()[0];
  chart = chart.modify()
      .setOption('width', 800)
      .setOption('height', 640)
      .setPosition(5, 5, 0, 0)
      .build();
  sheet.updateChart(chart);
}

Return
EmbeddedChartBuilder - 埋め込みグラフを作成するためのビルダー。

埋め込みチャートID設定[setId(チャートID)]

setId(id)
UiAppで使用されるこのEmbeddedChartのIDを設定します。

Return
Chart - 連鎖用の埋め込みチャート

埋め込みチャートビルダークラス[EmbeddedChartBuilder]

EmbeddedChartの編集に使用されるビルダー。チャートに加えられた変更は、再構築されたチャートでSheet.updateChart(chart)が呼び出されるまで保存されません。

function embeddedChartBuilderSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getRange("A1:B8");
  var chart = sheet.getCharts()[0];
  chart = chart.modify()
      .addRange(range)
      .setOption('title', 'Updated!')
      .setOption('animation.duration', 500)
      .setPosition(2,2,0,0)
      .build();
  sheet.updateChart(chart);
}

チャート範囲追加[addRange(範囲)]

addRange(range)
このビルダーが変更するグラフに範囲を追加します。既にチャートに追加されている範囲は追加しません。

function addRangeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

面グラフ設定[asAreaChart()]

asAreaChart()
チャートタイプをAreaChartに設定し、EmbeddedAreaChartBuilderを返します。

Return
EmbeddedAreaChartBuilder - 面グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedAreaChartBuilder

棒グラフ設定[asBarChart()]

asBarChart()
チャートタイプをBarChartに設定し、EmbeddedBarChartBuilderを返します。

Return
EmbeddedBarChartBuilder - 棒グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedBarChartBuilder

縦棒グラフ設定[asColumnChart()]

asColumnChart()
チャートタイプをColumnChartに設定し、EmbeddedColumnChartBuilderを返します。

Return
EmbeddedColumnChartBuilder - 縦棒グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedColumnChartBuilder

コンボチャート(2つの単位の異なるグラフ)設定[asComboChart()]

asComboChart()
チャートタイプをComboChartに設定し、EmbeddedComboChartBuilderを返します。

Return
EmbeddedComboChartBuilder - コンボチャートのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedComboChartBuilder

ヒストグラムチャート設定[asHistogramChart()]

asHistogramChart()
チャートタイプをHistogramChartに設定し、EmbeddedHistogramChartBuilderを返します。

Return
EmbeddedHistogramChartBuilder - ヒストグラムチャートのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedHistogramChartBuilder

折れ線グラフ設定[asLineChart()]

asLineChart()
チャートタイプをLineChartに設定し、EmbeddedLineChartBuilderを返します。

Return
EmbeddedLineChartBuilder - 折れ線グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedLineChartBuilder

円グラフ設定[asPieChart()]

asPieChart()
チャートタイプをPieChartに設定し、EmbeddedPieChartBuilderを返します。

Return
EmbeddedPieChartBuilder - 円グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedPieChartBuilder

散布図設定[asScatterChart()]

asScatterChart()
チャートタイプをScatterChartに設定し、EmbeddedScatterChartBuilderを返します。

Return
EmbeddedScatterChartBuilder - 散布図のビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedScatterChartBuilder

テーブルチャート設定[asTableChart()]

asTableChart()
チャートタイプをTableChartに設定し、EmbeddedTableChartBuilderを返します。

Return
EmbeddedTableChartBuilder - テーブルチャートのビルダー

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedTableChartBuilder

チャート構築[build()]

build()
チャートに加えられたすべての変更を反映するようにチャートを作成します。

このメソッドは、スプレッドシートの上にグラフを自動的に描画しません。新しいチャートは、sheet.insertChart(chart)で挿入する必要があり、既存のチャートはsheet.updateChart(chart)で更新する必要があります。

function buildSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChart - 作成されたグラフ。スプレッドシートに追加する必要があります。

チャート範囲削除[clearRanges()]

clearRanges()
このビルダーが変更するチャートからすべての範囲を削除します。

function clearRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // このコードは、チャートの既存のフォーマットを維持しながら、
  // 新しい範囲のみを使用するようにチャートを更新します。
  var chart = sheet.getCharts()[0];
  var newChart = chart
      .modify()
      .clearRanges()
      .addRange(sheet.getRange("A1:A5"))
      .addRange(sheet.getRange("B1:B5"))
      .build();
  sheet.updateChart(newChart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

データページング有効設定1[enablePaging(ページング有効化有無)]

enablePaging(enablePaging)
データのページングを有効にするかどうかを設定します。

デフォルトの動作はページングが無効です。ページングが有効な場合、デフォルトのページサイズは10です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

データページング有効設定2[enablePaging(ページサイズ)]

enablePaging(pageSize)
ページングを有効にし、各ページの行数を設定します。

デフォルトのページサイズは10です。

function enablePaging2Sample() {
  // テーブルチャートビルダーを作成し、ページサイズ5のページングを有効にします。
  var builder = Charts.newTableChart();
  builder.enablePaging(5);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

データページング有効設定3[enablePaging(ページサイズ, 最初のページ)]

enablePaging(pageSize, startPage)
ページングを有効にし、各ページの行数と表示する最初のテーブルページを設定します（ページ番号は0から始まります）。

デフォルトのページサイズは10、デフォルトの開始ページは0です。

function enablePaging3Sample() {
  // テーブルチャートビルダーを作成し、ページサイズ5で
  // ページングを有効にし、最初にページ2を表示します。
  var builder = Charts.newTableChart();
  builder.enablePaging(5, 2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブル列順序逆設定[enableRtlTable(列順序逆有無)]

enableRtlTable(rtlEnabled)
テーブルの列の順序を逆にすることにより、右から左に記述する言語（アラビア語やヘブライ語など）の基本的なサポートを追加します。列0は右端の列で、最後の列は左端の列です。

これは、基になるデータの列インデックスには影響せず、表示の順序にのみ影響します。このオプションを使用しても、テーブルの視覚化では完全な双方向(BiDi)言語表示はサポートされません。ページオプションを使用してページングを有効にした場合、または必要なテーブルサイズよりも小さい高さと幅のオプションを指定したためにテーブルにスクロールバーがある場合、このオプションは無視されます。デフォルトの動作は、RTLサポートが無効になっています。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

列ソート設定[enableSorting(列ソート有無)]

enableSorting(enableSorting)
ユーザーが列見出しをクリックしたときに列をソートするかどうかを設定します。

並べ替えが有効になっている場合、ユーザーが列ヘッダーをクリックすると、行が自動的に並べ替えられます。デフォルトの動作はソートが有効です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャートタイプ取得[getChartType()]

getChartType()
現在のチャートタイプを返します。

Return
ChartType - チャートタイプ

チャート位置取得[getContainer()]

getContainer()
チャートContainerInfoを返します。これは、チャートがシート上のどこに表示されるかをカプセル化します。

function getContainerSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0);

  // このメソッドは、Chart＃getContainerInfo()とまったく同じデータを返します
  var containerInfo = chartBuilder.getContainer();

  // setPosition()で使用した値を記録します
  Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
            containerInfo.getAnchorColumn(),
            containerInfo.getAnchorRow(),
            containerInfo.getOffsetX(),
            containerInfo.getOffsetY());
}

Return
ContainerInfo - チャートコンテナーの位置を含むオブジェクト。

チャート範囲リスト取得[getRanges()]

getRanges()
このチャートに現在データを提供している範囲のリストのコピーを返します。このリストを変更するには、addRange(range)およびremoveRange(range)を使用します。

function getRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0);

  var ranges = chartBuilder.getRanges();

  // このグラフのデータソースとして1つの範囲しかないため、
  // 「A1：B8」をログに記録します
  for (var i in ranges) {
    var range = ranges[i];
    Logger.log(range.getA1Notation());
  }
}

Return
Range[] - 作成されるデータソースのチャートとして機能する範囲の配列

チャート範囲削除[removeRange(範囲)]

removeRange(range)
このビルダーが変更するチャートから指定された範囲を削除します。範囲がこのチャートにない場合、エラーをスローしません。

削除される範囲は、addRange(range)で追加された範囲と一致する必要があります。それ以外の場合、チャートは変更されません。このメソッドを使用して、範囲から値を部分的に削除することはできません。

function removeRangeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var firstRange = sheet.getRange("A1:B5");
  var secondRange = sheet.getRange("A6:B8");

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(firstRange)
      // この範囲は異なる色でレンダリングされます
      .addRange(secondRange)
      .setPosition(5, 5, 0, 0);

  // これらの2つの形式のいずれかを使用できますが、
  // 範囲はaddRange()を介して追加された範囲と一致する必要があります。
  // 一致しない場合は削除されず、例外はスローされません。
  chartBuilder.removeRange(firstRange);
  chartBuilder.removeRange(sheet.getRange("A6:B8"));

  var chart = chartBuilder.build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

ドメイン軸描画反転[reverseCategories()]

reverseCategories()
ドメイン軸のシリーズの描画を反転します。垂直範囲グラフ（折れ線グラフ、面グラフ、縦棒グラフなど）の場合、これは水平軸が右から左に描画されることを意味します。水平範囲グラフ（棒グラフなど）の場合、これは垂直軸が上から下に描画されることを意味します。円グラフの場合、これはスライスが反時計回りに描かれることを意味します。

function reverseCategoriesSample() {
  // 円グラフビルダーを作成し、反時計回りにスライスの描画を設定します。
  var builder = Charts.newPieChart();
  builder.reverseCategories();
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie] - 連鎖用ビルダー。

水平軸反転[reverseDirection()]

reverseDirection()
バーが水平軸に沿って成長する方向を逆にします。デフォルトでは、値は左から右に増加します。このメソッドを呼び出すと、右から左に成長します。

Return
EmbeddedBarChartBuilder - 連鎖用ビルダー。

チャート3次元設定[set3D()]

set3D()
チャートを3次元に設定します。

Return
EmbeddedPieChartBuilder - This builder, useful for chaining.

チャート背景色設定[setBackgroundColor(スタイルシート値)]

setBackgroundColor(cssValue)
チャートの背景色を設定します。

function setBackgroundColorSample() {
  // 折れ線グラフビルダーを作成し、背景色をグレーに設定します
  var builder = Charts.newLineChart();
  builder.setBackgroundColor("gray");
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートタイプ設定[setChartType(チャートタイプ)]

setChartType(type)
チャートのタイプを変更します。現在、すべての埋め込みグラフタイプがサポートされているわけではありません。 ChartTypeを参照してください。

function setChartTypeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャート線色設定[setColors(スタイルシート値)]

setColors(cssValues)
チャートの線の色を設定します。

function setColorsSample() {
  // 折れ線グラフビルダーを作成し、最初の2本の線を
  // それぞれ緑と赤で描画するように設定します。
  var builder = Charts.newLineChart();
  builder.setColors(["green", "red"]);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャート曲線スタイル設定[setCurveStyle(曲線スタイル)]

setCurveStyle(style)
チャートの曲線に使用するスタイルを設定します。許可される曲線スタイルについては、CurveStyleを参照してください。

function setCurveStyleSample() {
  // 折れ線グラフビルダーを作成し、グラフ内の線を湾曲させます。
  var builder = Charts.newLineChart();
  builder.setCurveStyle(Charts.CurveStyle.SMOOTH)
}

Return
EmbeddedLineChartBuilder - 連鎖用ビルダー。

データテーブル最初の行番号設定[setFirstRowNumber(行番号)]

setFirstRowNumber(number)
データテーブルの最初の行の行番号を設定します。

最初の行のデフォルトの行番号は1です。

function setFirstRowNumberSample() {
  // テーブルチャートビルダーを作成し、最初の行を2に設定します。
  var builder = Charts.newTableChart();
  builder.setFirstRowNumber(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャート行列非表示方法設定[setHiddenDimensionStrategy(方法)]

setHiddenDimensionStrategy(strategy)
非表示の行と列に使用する方法を設定します。デフォルトはIGNORE_ROWSです。

function setHiddenDimensionStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

テーブル昇順ソート列設定[setInitialSortingAscending(ソート列)]

setInitialSortingAscending(column)
テーブルを最初にソート（昇順）する列のインデックスを設定します。

列は昇順でソートされ、それを示す小さな矢印でマークされます。

function setInitialSortingAscendingSample() {
  // テーブルチャートビルダーを作成し、2番目の列（昇順）で並べ替えます。
  var builder = Charts.newTableChart();
  builder.setInitialSortingAscending(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブル降順ソート列設定[setInitialSortingDescending(ソート列)]

setInitialSortingDescending(column)
テーブルを最初にソート（降順）する列のインデックスを設定します。

列は降順でソートされ、それを示す小さな矢印でマークされます。

function setInitialSortingDescendingSample() {
  // テーブルチャートビルダーを作成し、2番目の列（降順）で並べ替えます。
  var builder = Charts.newTableChart();
  builder.setInitialSortingDescending(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャート凡例位置設定[setLegendPosition(位置)]

setLegendPosition(position)
チャートに対する凡例の位置を設定します。デフォルトでは、凡例はありません。

function setLegendPositionSample() {
  // 折れ線グラフビルダーを作成し、凡例の位置を右に設定します。
  var builder = Charts.newLineChart();
  builder.setLegendPosition(Charts.Position.RIGHT);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャート凡例テキストスタイル設定[setLegendTextStyle(テキストスタイル)]

setLegendTextStyle(textStyle)
グラフの凡例のテキストスタイルを設定します。

function setLegendTextStyleSample() {
  // 折れ線グラフビルダーを作成し、青色の26ポイントの凡例用に設定します。
  var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
  var style = textStyleBuilder.build();
  var builder = Charts.newLineChart();
  builder.setLegendTextStyle(style);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートマージ方法設定[setMergeStrategy(マージ方法)]

setMergeStrategy(mergeStrategy)
複数の範囲が存在する場合に使用するマージ方法を設定します。 MERGE_ROWSの場合、行はマージされます。 MERGE_COLUMNSの場合、列はマージされます。デフォルトはMERGE_COLUMNSです。

function setMergeStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B10");
  var range2 = sheet.getRange("C:C10");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .addRange(range2)
      .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

チャートヘッダー行列数[setNumHeaders(ヘッダー)]

setNumHeaders(headers)
ヘッダーとして処理される範囲の行または列の数を設定します。

function setNumHeadersSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setNumHeaders(1)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャートオプション設定[setOption(オプション, 値)]

setOption(option, value)
このチャートの詳細オプションを設定します。使用可能なオプションのリストについては、Charts API Chart Galleryでチャートタイプを検索してください。たとえば、面グラフのオプションは次のとおりです。

このメソッドは、指定したオプションがこのチャートタイプに有効であるか、値が正しい形式/構造であるかどうかを検証しません。

この例は、アニメーションの継続時間を1秒に変更し、凡例を設定する方法を示しています。

function setOptionSample() {
  var builder = Charts.newLineChart();
  builder.setOption('title', 'Earnings projections');
  builder.setOption('animation.duration', 1000);
  builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

ライン内ポイントスタイル設定[setPointStyle(スタイル)]

setPointStyle(style)
ライン内のポイントのスタイルを設定します。デフォルトでは、ポイントには特定のスタイルはなく、線のみが表示されます。

function setPointStyleSample() {
  // 折れ線グラフビルダーを作成し、大きなポイントスタイルを設定します。
  var builder = Charts.newLineChart();
  builder.setPointStyle(Charts.PointStyle.LARGE);
}

Return
EmbeddedAreaChartBuilder[Line/Scatter] - 連鎖用ビルダー。

チャート表示位置設定[setPosition(行位置, 列位置, オフセットX, オフセットY)]

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
シート上のチャートの表示位置を変更して、位置を設定します。 anchorRowPosとanchorColPosには1のインデックスが付けられます。

function setPositionSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャート範囲設定[setRange(開始, 終了)]

setRange(start, end)
チャートの範囲を設定します。

データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line] - 連鎖用ビルダー。

積み上げ設定[setStacked()]

setStacked()
積み上げ行を使用します。つまり、行とバーの値は積み上げられます（累積されます）。デフォルトでは、スタッキングはありません。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram] - 連鎖用ビルダー。

チャートタイトル設定[setTitle(チャートタイトル)]

setTitle(chartTitle)
チャートのタイトルを設定します。タイトルはチャートの中央に表示されます。

function setTitleSample() {
  // 折れ線グラフビルダーを作成し、「My Line Chart」のタイトルを作成します。
  var builder = Charts.newLineChart();
  builder.setTitle('My Line Chart')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートタイトルテキストスタイル設定[setTitleTextStyle(テキストスタイル)]

setTitleTextStyle(textStyle)
チャートタイトルのテキストスタイルを設定します。

function setTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、青色の26ポイントのタイトルに設定します。
  var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
  var style = textStyleBuilder.build();
  var builder = Charts.newLineChart();
  builder.setTitleTextStyle(style);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートデータ行列転置設定[setTransposeRowsAndColumns(転置)]

setTransposeRowsAndColumns(transpose)
チャートの行と列を転置するかどうかを設定します。 trueに設定すると、行と列が切り替わります。デフォルトはfalseです。

function setTransposeRowsAndColumnsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setTransposeRowsAndColumns(true)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

水平軸対数目盛設定[setXAxisLogScale()]

setXAxisLogScale()
水平軸を対数目盛にします（すべての値が正である必要があります）。

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

水平軸範囲設定[setXAxisRange(開始, 終了)]

setXAxisRange(start, end)
チャートの水平軸の範囲を設定します。

データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

function setXAxisRangeSample() {
  // 散布図ビルダーを作成し、X軸の範囲を0～100に設定します。
  var builder = Charts.newTableChart();
  builder.setXAxisRange(0, 100);
}

Return
EmbeddedScatterChartBuilder - This builder, useful for chaining.

水平軸テキストスタイル設定[setXAxisTextStyle(テキストスタイル)]

setXAxisTextStyle(textStyle)
水平軸のテキストスタイルを設定します。

function setXAxisTextStyleSample() {
  // 折れ線グラフビルダーを作成し、X軸のテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setXAxisTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

水平軸タイトル設定[setXAxisTitle(タイトル)]

setXAxisTitle(title)
水平軸にタイトルを追加します。タイトルは中央に配置され、軸の値ラベルの下に表示されます。

function setXAxisTitleSample() {
  // 折れ線グラフビルダーを作成し、X軸のタイトルを設定します。
  var builder = Charts.newLineChart();
  //builder.setTitle('X-axis Title')
  builder.setXAxisTitle('X-axis Title')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

水平軸タイトルテキストスタイル設定[setXAxisTitleTextStyle(テキストスタイル)]

setXAxisTitleTextStyle(textStyle)
水平軸のタイトルテキストスタイルを設定します。

function setXAxisTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、X軸のタイトルテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setXAxisTitleTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸対数目盛設定[setYAxisLogScale()]

setYAxisLogScale()
縦軸を対数目盛にします（すべての値が正である必要があります）。

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

垂直軸範囲設定[setYAxisRange(開始, 終了)]

setYAxisRange(start, end)
チャートの垂直軸の範囲を設定します。データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

function setYAxisRangeSample() {
  // 散布図ビルダーを作成し、Y軸の範囲を0～100に設定します。
  var builder = Charts.newTableChart();
  builder.setYAxisRange(0, 100);
}

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

垂直軸テキストスタイル設定[setYAxisTextStyle(テキストスタイル)]

setYAxisTextStyle(textStyle)
垂直軸のテキストスタイルを設定します。

function setYAxisTextStyleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setYAxisTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸タイトル設定[setYAxisTitle(タイトル)]

setYAxisTitle(title)
垂直軸にタイトルを追加します。タイトルは中央に配置され、値ラベルの左側に表示されます。

function setYAxisTitleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のタイトルを設定します。
  var builder = Charts.newLineChart();
  builder.setYAxisTitle('Y-axis Title')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸タイトルテキストスタイル設定[setYAxisTitleTextStyle(テキストスタイル)]

setYAxisTitleTextStyle(textStyle)
垂直軸のタイトルのテキストスタイルを設定します。

function setYAxisTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のタイトルテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setYAxisTitleTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

テーブル最初の列の行番号表示設定[showRowNumberColumn(表示行番号)]

showRowNumberColumn(showRowNumber)
テーブルの最初の列として行番号を表示するかどうかを設定します。

デフォルトの動作では、行番号は表示されません。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブルチャート交互の色スタイル設定[useAlternatingRowStyle(交互の色有無)]

useAlternatingRowStyle(alternate)
交互の色スタイルをテーブルチャートの奇数行と偶数行に割り当てるかどうかを設定します。

デフォルトの動作は、交互の色スタイルを持つ行です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

範囲軸対数目盛設定[useLogScale()]

useLogScale()
範囲軸を対数目盛にします（すべての値が正である必要があります）。範囲軸は、垂直チャート（線、面、または列など）の垂直軸と、水平チャート（バーなど）の水平軸です。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line] - 連鎖用ビルダー。

最後に

GASすべてのチャート機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのすべてのチャート機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

便利なマクロを作成して、スプレッドシートのメニューに任意の名前で追加し、呼び出すことができます。

使いこなせれば手軽に自分用の機能を使えるので作業効率が上がるのは間違いありません。

メニュー追加・更新・削除に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

スプレッドシートクラス[Spreadsheet]のメニュー追加・更新・削除

スプレッドシートのメニュー追加・更新・削除メソッドです。

メニュー追加[addMenu(メニュー名, サブメニュー)]

addMenu(name, subMenus)
スプレッドシートUIに新しいメニューを作成します。

各メニュー項目は、ユーザー定義機能を実行します。通常は、スプレッドシートが読み込まれたときにメニューが自動的に作成されるように、onOpen()関数から呼び出します。

// スプレッドシートがロードされるたびにonOpen関数が自動的に実行されます
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // ユーザーが「addMenuExample」をクリックしてから
  // 「Menu Entry 1」をクリックすると、関数function1が実行されます。
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // 行区切り
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | addMenu(name, subMenus)

メニュー更新[updateMenu(メニュー名, サブメニュー)]

updateMenu(name, subMenus)
addMenu(name, subMenus)によって追加されたメニューを更新します。 addMenu(name, subMenus)とまったく同じように機能します。

function updateMenuSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
  ss.updateMenu("addMenuExample", menuEntries);
}

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | updateMenu(name, subMenus)

メニュー削除[removeMenu(メニュー名)]

removeMenu(name)
addMenu(name, subMenus)によって追加されたメニューを削除します。 name引数は、addMenu(name, subMenus)への対応する呼び出しと同じ値を持つべきです。

// スプレッドシートがロードされるたびにonOpen関数が自動的に実行されます
function removeMenuSample_onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
  {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // nameはメニューを追加したときに使用した名前と一致しなければなりません
}
function foo(){
  // 何もしない
}

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | removeMenu(name)

最後に

GASメニュー追加・更新・削除機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのメニュー追加・更新・削除機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

頻繁に新規ファイル作成、簡単に任意のファイルを起動、コピーして手軽にバックアップ、必要に応じてファイル名変更、など、GASを使えばスプレッドシートを扱いやすくなります。

たくさんスプレッドシートを作成してガチガチに管理しなければならない人にとっては作業が楽になるかもしれませんね。

ファイル作成・起動・コピー・名前変更に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

スプレッドシートAPPクラス[SpreadsheetApp]のファイル作成

スプレッドシートAPPのファイル新規作成メソッドです。

ファイル作成[create(ファイル名)]

create(name)
指定された名前で新しいスプレッドシートを作成します。

function create1Sample() {
  // 以下のコードは新しいスプレッドシート "Finances"を作成し、そのURLを記録します
  var ssNew = SpreadsheetApp.create("Finances");
  Logger.log(ssNew.getUrl());
}

Return
Spreadsheet - 新しいスプレッドシート。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class SpreadsheetApp | Methods | create(name)

ファイル行列指定作成[create(ファイル名, 行数, 列数)]

create(name, rows, columns)
指定された名前と指定された行数と列数で新しいスプレッドシートを作成します。

function create2Sample() {
  // 以下のコードは、50行5列の新しいスプレッドシート "Finances"を作成し、
  // そのURLを記録します。
  var ssNew = SpreadsheetApp.create("Finances", 50, 5);
  Logger.log(ssNew.getUrl());
}

Return
Spreadsheet - 新しいスプレッドシート。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class SpreadsheetApp | Methods | create(name, rows, columns)

スプレッドシートAPPクラス[SpreadsheetApp]のファイル起動

スプレッドシートAPPのファイル起動メソッドです。

ファイル起動[open(ファイル)]

open(file)
指定したFileオブジェクトに対応するスプレッドシートを開きます。

function openSample() {
  // Googleドライブからスター付きスプレッドシートを取得してから、
  // スプレッドシートを開き、各スプレッドシート内の最初のシートの名前を記録します。
  var files = DriveApp.searchFiles(
  starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"');
  while (files.hasNext()) {
    var spreadsheet = SpreadsheetApp.open(files.next());
    var sheet = spreadsheet.getSheets()[0];
    Logger.log(sheet.getName());
  }
}

Return
Spreadsheet - スプレッドシート。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class SpreadsheetApp | Methods | open(file)

ファイルＩＤ起動[openById(ID)]

openById(id)
与えられたIDでスプレッドシートを開きます。スプレッドシートIDはそのURLから抽出できます。たとえば、URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0のスプレッドシートIDは "abc1234567"です。

function openByIdSample() {
  // 以下のコードは、そのIDを使用してスプレッドシートを開き、その名前を記録します。
  // スプレッドシートはクライアント側で物理的に開かれていないことに注意してください。
  // サーバー上でのみ開かれます（スクリプトによる変更のため）。
  var ss = SpreadsheetApp.openById("abc1234567");
  Logger.log(ss.getName());
}

Return
Spreadsheet - 指定されたIDのSpreadsheetオブジェクト。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class SpreadsheetApp | Methods | openById(id)

ファイルＵＲＬ起動[openByUrl(URL)]

openByUrl(url)
与えられたURLでスプレッドシートを開きます。

function openByUrlSample() {
  // 以下のコードは、そのIDを使用してスプレッドシートを開き、その名前を記録します。
  // スプレッドシートはクライアント側で物理的に開かれていないことに注意してください。
  // サーバー上でのみ開かれます（スクリプトによる変更のため）。
  var ss = SpreadsheetApp.openByUrl(
             'https://docs.google.com/spreadsheets/d/abc1234567/edit');
  Logger.log(ss.getName());
}

Return
Spreadsheet - 指定されたIDのSpreadsheetオブジェクト。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class SpreadsheetApp | Methods | openByUrl(url)

スプレッドシートクラス[Spreadsheet]のファイルコピー

スプレッドシートのファイルコピーメソッドです。

ファイルコピー[copy(ファイル名)]

copy(name)
スプレッドシートをコピーして新しいものを返します。

function copySample() {
  // このコードは現在のスプレッドシートのコピーを作成し、それに適切な名前を付けます
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.copy("Copy of " + ss.getName());
}

Return
Spreadsheet - 連鎖用のスプレッドシート。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | copy(name)

スプレッドシートクラス[Spreadsheet]のファイル名取得変更

スプレッドシートのファイル名取得と変更メソッドです。

ファイル名取得[getName()]

getName()
スプレッドシートの名前を取得します。

function getNameSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  Logger.log(ss.getName());
}

Return
String - スプレッドシートの名前。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | getName()

ファイル名[rename(新ファイル名)]

rename(newName)
スプレッドシートの名前を変更します。

function renameSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.rename("This is the new name");
}

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Spreadsheet | Methods | rename(newName)

最後に

GASファイル作成・起動・コピー・名前変更機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのファイル作成・起動・コピー・名前変更機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

Excelもそうですが、セルにデフォルトで表示されている薄い灰色のグリッド線、シートの内容によってはない方がよい時もありますね。

メニューでワンクリックで簡単に変えられますが、どうしてもGASで処理に応じて動的にグリッド線の表示と非表示を切り替えたい場合はご活用ください。

グリッド線に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

シートクラス[Sheet]のグリッド線非表示設定

シートのグリッド線非表示設定メソッドです。

グリッド線非表示設定[setHiddenGridlines(hideGridlines)]

setHiddenGridlines(hideGridlines)
シートのグリッド線を非表示または表示にします。

function setHiddenGridlinesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  sheet.setHiddenGridlines(true);
}

Return
Sheet - this sheet, for chaining

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | setHiddenGridlines(hideGridlines)

シートクラス[Sheet]のグリッド線非表示確認

シートのグリッド線非表示確認メソッドです。

グリッド線非表示確認[hasHiddenGridlines()]

hasHiddenGridlines()
シートのグリッド線が非表示の場合はtrueを返します。それ以外の場合はfalseを返します。グリッド線はデフォルトで表示されています。

function hasHiddenGridlinesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  Logger.log(sheet.hasHiddenGridlines());
}

Return
Boolean - グリッド線が非表示の場合はtrueです。それ以外の場合はfalse

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | hasHiddenGridlines()

最後に

GASグリッド線機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのグリッド線機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

セルのデータを扱う際、うっとおしい空白データを削除して綺麗に整理したい時はきっとあると思います。

半角スペースのみ、全角スペースのみ、タブのみ、改行のみのセルデータを一発で綺麗にしてくれるのでGASで簡単にできるようにしておくといつか役立つはずです。

データ空白文字削除に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

セル範囲クラス[Range]の空白文字削除

セル範囲のデータ空白文字削除メソッドです。

データ空白文字削除[trimWhitespace()]

trimWhitespace()
この範囲内のすべてのセルの空白（スペース、タブ、改行など）を削除します。各セルのテキストの最初と最後からすべての空白を削除し、残りの空白文字のすべてのサブシーケンスを単一のスペースに減らします。

注：結果のトリミングされたテキストが「+」または「=」の文字で始まっている場合、テキストは文字列値として残り、式として解釈されません。

function trimWhitespaceSample() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  var range = sheet.getRange('A1:A4');
  range.activate();
  range.setValues(
  [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

  range.trimWhitespace();

  var values = range.getValues();
  // 値は['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']です。
}

Return
Range - 連鎖用のセル範囲。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | trimWhitespace()

セル範囲リストクラス[RangeList]の空白文字削除

セル範囲リストのデータ空白文字削除メソッドです。

データ空白文字削除[trimWhitespace()]

trimWhitespace()
この範囲リスト内のすべてのセルの空白（スペース、タブ、改行など）を削除します。各セルのテキストの最初と最後からすべての空白を削除し、残りの空白文字のすべてのサブシーケンスを単一のスペースに減らします。

注：結果のトリミングされたテキストが「+」または「=」の文字で始まっている場合、テキストは文字列値として残り、式として解釈されません。

function trimWhitespaceSample() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  var range = sheet.getRange('A1:A4');
  range.activate();
  range.setValues(
  [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

  var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
  rangeList.trimWhitespace();

  var values = range.getValues();
  //値は['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']です。
}

Return
RangeList - 連鎖用のセル範囲リスト。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class RangeList | Methods | trimWhitespace()

最後に

GASデータ空白文字削除機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのデータ空白文字削除機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

セルのデータを扱う際、うっとおしい重複データを削除して綺麗に整理したい時はきっとあると思います。

複数の列にまたがったデータを一発で綺麗にしてくれるので意外と便利です。

データ重複削除に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

セル範囲クラス[Range]の重複削除

セル範囲のデータ重複削除メソッドです。

データ重複削除1[removeDuplicates()]

removeDuplicates()
前の行の値と重複する値を含む、この範囲内の行を削除します。値は同じだが大文字小文字の区別、書式設定、または数式が異なる行は重複していると見なされます。このメソッドは、ビューから隠されている重複行も除去します（例えば、フィルターが原因で）。この範囲外のコンテンツは削除されません。

function removeDuplicates1Sample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B1:D7");

  // 範囲内の重複行を削除します。
  range.removeDuplicates();
}

Return
Range - 重複を削除した結果の範囲。範囲のサイズは、削除される行ごとに1行ずつ減少します。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | removeDuplicates()

データ重複削除2[removeDuplicates(重複値分析列)]

removeDuplicates(columnsToCompare)
指定された列の値のうち、前の行と重複する値を含む、この範囲内の行を削除します。値は同じだが大文字小文字の区別、書式設定、または数式が異なる行は重複していると見なされます。このメソッドは、ビューから隠されている重複行も除去します（例えば、フィルターが原因で）。この範囲外のコンテンツは削除されません。

function removeDuplicates2Sample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B1:D7");

  // 列Bに重複する値がある行を削除します
  range.removeDuplicates([2]);

  // 列BとDの両方に重複する値がある行を削除します
  range.removeDuplicates([2,4]);
}

Return
Range - 重複を削除した結果の範囲。範囲のサイズは、削除される行ごとに1行ずつ減少します。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | removeDuplicates(columnsToCompare)

最後に

GASデータ重複削除機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのデータ重複削除機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

スプレッドシート内の行や列の位置や選択したセルの行数、列数を取得して様々な処理に応用する場面はしょっちゅうあるはずです。

この行列位置と行列数は基本中の基本ではありますが、メソッド名が若干ややこしいのでまとめてみました。

行列位置と行列数取得に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

セル範囲クラス[Range]の行列位置取得

セル範囲の行の位置と列の位置取得メソッドです。

行位置取得[getRow()]

getRow()
この範囲の行位置を返します。 getRowIndex()と同じです。

function getRowSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2");
  Logger.log(range.getRow());
}

Return
Integer - 範囲の行位置です。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getRow()

行インデックス取得[getRowIndex()]

getRowIndex()
この範囲の行位置を返します。 getRow()と同じです。

function getRowIndexSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2");
  Logger.log(range.getRowIndex());
}

Return
Integer - 範囲の行位置です。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getRowIndex()

列位置取得[getColumn()]

getColumn()
この範囲の開始列位置を返します。

function getColumnSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2:D4");
  // "2.0"をログに記録
  Logger.log(range.getColumn());
}

Return
Integer - スプレッドシート内の範囲の開始列位置。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getColumn()

セル範囲クラス[Range]の行列数取得

セル範囲の行数と列数の取得メソッドです。

行数取得[getNumRows()]

getNumRows()
この範囲の行数を返します。

function getNumRowsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2:D5");
  Logger.log(range.getNumRows());
}

Return
Integer - 範囲内の行数。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getNumRows()

列数取得[getNumColumns()]

getNumColumns()
この範囲の列数を返します。

function getNumColumnsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2:D5");
  Logger.log(range.getNumColumns());
}

Return
Integer - 範囲内の列数。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getNumColumns()

セル範囲クラス[Range]のデータ最終行列位置取得

セル範囲のデータ最終行とデータ最終列の位置取得メソッドです。

データ最終行位置取得[getLastRow()]

getLastRow()
行末位置を返します。

function getLastRowSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2:D4");
  // ログ "4.0"
  Logger.log(range.getLastRow());
}

Return
Integer - スプレッドシート内の範囲の終了行位置。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getLastRow()

データ最終列位置取得[getLastColumn()]

getLastColumn()
終了列の位置を返します。

function getLastColumnSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("B2:D4");
  // ログ "4.0"
  Logger.log(range.getLastColumn());
}

Return
Integer - スプレッドシート内の範囲の終了列位置。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getLastColumn()

シートクラス[Sheet]のデータ最終行列位置取得

シートのデータ最終行とデータ最終列の位置取得メソッドです。

データ最終行位置取得[getLastRow()]

getLastRow()
コンテンツを含む最後の行の位置を返します。

function getLastRowSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // このシートの最後のセルに値を記録します
  var lastRow = sheet.getLastRow();
  var lastColumn = sheet.getLastColumn();
  var lastCell = sheet.getRange(lastRow, lastColumn);
  Logger.log(lastCell.getValue());
}

Return
Integer - コンテンツを含むシートの最後の行

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getLastRow()

データ最終列位置取得[getLastColumn()]

getLastColumn()
コンテンツがある最後の列の位置を返します。

function getLastColumnSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // このシートの最後のセルに値を記録します
  var lastRow = sheet.getLastRow();
  var lastColumn = sheet.getLastColumn();
  var lastCell = sheet.getRange(lastRow, lastColumn);
  Logger.log(lastCell.getValue());
}

Return
Integer - コンテンツを含むシートの最後の列

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getLastColumn()

シートクラス[Sheet]の最終行列取得

シートの最終行と最終列の取得メソッドです。

シート最終行取得[getMaxRows()]

getMaxRows()
内容に関係なく、シート内の現在の行数を返します。

function getMaxRowsSample() {
  // この例では "first"という名前のシートがあると仮定しています
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var first = ss.getSheetByName("first");
  Logger.log(first.getMaxRows());
}

Return
Integer - シートの最終行

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getMaxRows()

シート最終列取得[getMaxColumns()]

getMaxColumns()
内容に関係なく、シート内の現在の列数を返します。

function getMaxColumnsSample() {
  // この例では "first"という名前のシートがあると仮定しています
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var first = ss.getSheetByName("first");
  Logger.log(first.getMaxColumns());
}

Return
Integer - シートの最終列

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getMaxColumns()

最後に

GAS値設定取得機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートの行列位置と行列数取得機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

シートやセルに値を設定したり、値を取得する処理はGASの基本中の基本ですね。基本から学ぶにはもってこいのメソッドです。

単純なデータ設定や複雑な配列取得までデータを自由自在に操りまくりましょう。

値設定取得機能関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

セル範囲クラス[Range]の値設定

セル範囲の値設定メソッドです。

値設定[setValue(値)]

setValue(value)
範囲の値を設定します。値は数値、文字列、ブール値、または日付です。それが '='で始まっているなら、それは式として解釈されます。

function setValueSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setValue(100);
}

Return
Range - 連鎖用のセル範囲。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setValue(value)

配列値設定[setValues(値's)]

setValues(values)
値の2次元配列を設定します（この範囲のサイズと一致する必要があります）。

function setValuesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var values = [
    [ "2.000", "1,000,000", "$2.99" ]
  ];

  var range = sheet.getRange("B2:D2");
  range.setValues(values);
}

Return
Range - 連鎖用のセル範囲。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setValues(values)

セル範囲クラス[Range]の値取得

セル範囲の値取得メソッドです。

値取得[getValue()]

getValue()
範囲内の左上のセルの値を返します。値は、セルの値に応じてNumber、Boolean、Date、またはString型になります。空のセルは空の文字列を返します。

Return
Object - このセルの値

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getValue()

配列値取得[getValues()]

getValues()
この範囲の値の2次元配列を返します。

行、列の順にインデックス付けされた値の2次元配列を返します。値は、セルの値に応じて、数値型、ブール型、日付型、または文字列型になります。空のセルは、配列内の空の文字列で表されます。範囲インデックスは1、1から始まりますが、JavaScript配列は[0] [0]からインデックスが付けられていることを忘れないでください。

function getValuesSample() {
  // 以下のコードは、アクティブなスプレッドシートの範囲C2：G8の値を取得します。これはJavaScriptの配列です。
  // これはJavaScriptの配列です。
  var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
  Logger.log(values[0][0]);
}

Return
Object[][] - 値の2次元配列

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getValues()

表示値取得[getDisplayValue()]

getDisplayValue()
範囲内の左上のセルの表示値を返します。値は文字列です。表示される値は、スプレッドシートのロケール設定によって自動的に適用されるフォーマットを含む、日付、時刻、および通貨のフォーマットフォーマットを考慮しています。空のセルは空の文字列を返します。

Return
String - セルに表示される値。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getDisplayValue()

表示配列値取得[getDisplayValues()]

getDisplayValues()
この範囲の値の2次元配列を返します。

行、次に列でインデックス付けされた表示値の2次元配列を返します。値はStringオブジェクトです。表示される値には、スプレッドシートのロケール設定によって自動的に適用される形式を含む、日付、時刻、および通貨の形式が考慮されます。空のセルは、配列内の空の文字列で表されます。範囲インデックスは1、1から始まりますが、JavaScript配列は[0] [0]からインデックスが付けられていることを忘れないでください。

function getDisplayValuesSample() {
  // 以下のコードは、アクティブなスプレッドシートの範囲C2：G8の表示値を取得します。
  // これはJavaScriptの配列です。
  var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
  Logger.log(values[0][0]);
}

Return
String[][] - 値の2次元配列

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getDisplayValues()

セル範囲リストクラス[RangeList]の値設定

セル範囲リストの値設定メソッドです。

値設定[setValue(value)]

setValue(value)
範囲リストの各範囲に値を設定します。値は数値、文字列、ブール値、または日付です。それが '='で始まっているなら、それは式として解釈されます。

function setValueSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  // 範囲リストの各範囲に100の値を設定します。
  var rangeList = sheet.getRangeList(['A:A', 'C:C']);
  rangeList.setValue(100);
}

Return
RangeList - 連鎖用のセル範囲リスト。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class RangeList | Methods | setValue(value)

シートクラス[Sheet]のアクティブ取得

シートの配列値取得メソッドです。

シート配列値取得[getSheetValues(開始行, 開始列, 行数, 列数)]

getSheetValues(startRow, startColumn, numRows, numColumns)
指定された座標から開始して、この範囲の値の2次元配列を返します。行または列の位置として指定された-1の値は、シート内にデータがある最後の行または列を取得するのと同じです。

function getSheetValuesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 以下の2つのサンプルは同じ出力を生成します
  var values = sheet.getSheetValues(1, 1, 3, 3);
  Logger.log(values);

  var range = sheet.getRange(1, 1, 3, 3);
  values = range.getValues();
  Logger.log(values);
}

Return
Object[][] - 値の2次元配列

参照：Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getSheetValues(startRow, startColumn, numRows, numColumns)

最後に

GAS値設定取得のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートの値設定取得機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。

初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一覧となっております。まずはどんなメソッドが存在するのかを把握しましょう。

GASのメソッドはいろいろなパターンがあります。GASの公式リファレンスに載っているメソッドをスプレッドシートの機能ごとに別の切り口でまとめ、すべて載せているつもりです。

自分がよく使うGASメソッドの使い方が不明な場合は一覧を検索して詳細ページに翔んでみてください。少しでも参考になれば幸いです。

Google Apps Script スプレッドシートのメソッド[Methods]一覧

スプレッドシートの基本的なメソッドをまとめた一覧になります。

詳細は各機能ごとに纏めているサンプルソース付のページにリンクして参照ください。

一覧を上から眺めて気になるメソッドを見つけるか、気になるキーワードで一覧を検索してみてください。

例えば、

メソッドの分類は割と適当です。基本的にスプレッドシートのメニューをイメージして分類してます。

ショートカット一覧にも各GASメソッドページへのリンクを追加してますので、操作イメージから対象のメソッドを見つけたい場合は以下からどうぞ。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16