このページは Cloud Translation API によって翻訳されました。

Google スプレッドシートの拡張

Google Apps Script を使用すると、Google スプレッドシートを使って斬新かつ効果的な処理を行うことができます。Google Chat では Apps Script を使用してカスタムメニューを追加するダイアログ、サイドバーを Google スプレッドシートに追加できます。また、以下に対応するカスタム関数を記述し、他の Google サービスとスプレッドシートを Google サービス: カレンダー、ドライブ、 Gmail。

Google スプレッドシート用に設計されたスクリプトのほとんどは、配列を操作してスプレッドシート内のセル、行、列の操作。Google Workspace の Codecademy が提供する配列向けの優れたトレーニングモジュールをご覧ください。（このコースは Google によって開発されたものでも、Google との関連でもありません）。

Google スプレッドシートで Apps Script を使用する方法については、 5 分間のクイックスタートガイドマクロ、メニュー、カスタム関数。

始める

Apps Script には特別な API があり、これを使用してプログラムで編集する方法を学びましたApps Script では、大きく分けて 2 種類の方法で Google スプレッドシートを操作できます。方法: 任意のスクリプトでスプレッドシートの作成や修正を行うには、スクリプトのユーザーが必要な権限が与えられます。また、スクリプトにバインドされているスプレッドシートは、ユーザーインターフェースを変更したり、スプレッドシートが開きます。バインドされたスクリプトを作成するには、内から [拡張機能] > [Apps Script] を選択します。 Google スプレッドシート。

スプレッドシートサービスでは、Google 2 次元配列を操作する、グリッドとして表示するスプレッドシート。データを取得するにはそのデータが保存されているスプレッドシートにデータを含むスプレッドシートの範囲を取得し、セルの値。Apps Script は、読み取りや書き込みによる構造化データを処理し、構造化データに対応する JavaScript オブジェクトを作成します。

データの読み取り

商品の名前と商品番号のリストがあって、スプレッドシートで次のように処理されます。

以下の例は、商品名と商品を取得して記録する方法を示しています。あります。

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

ログを表示

ログに記録されたデータを表示するには、スクリプトエディタの上部にある 実行ログ。

データの書き込み

新しい製品名や番号などのデータをスクリプトの末尾に次のコードを追加します。

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

上記のコードは、スプレッドシートの下部に新しい行を追加し、値を指定します。この関数を実行すると、表示されます。

カスタムメニューとユーザーインターフェース

Google スプレッドシートにカスタムのメニュー、ダイアログボックス、追加できますメニュー作成の基本については、メニューガイドをご覧ください。Google Chat の設定のカスタマイズやダイアログボックスの内容については、 HTML サービスに関するガイドをご覧ください。

画像や図形描画にスクリプト関数をアタッチすることもできます。スプレッドシートユーザーが画像をクリックするとき、描画します。詳しくは、Google スプレッドシートの画像と図形描画をご覧ください。

API の一部としてカスタムインターフェースを公開することを計画している場合、アドオンを使用する場合は、スタイルガイドを参照してください。 Google スプレッドシートエディタです。

Google フォームへの接続

Apps Script を使用すると、Google フォームと Google スプレッドシートを接続できます。フォーム、スプレッドシートサービス。この機能スプレッドシートのデータに基づいて Google フォームを自動的に作成できます。 Apps Script では、次のようなトリガーを使用することもできます。 onFormSubmit: ユーザーがフォームに回答した後に特定のアクションを実行します。 Google スプレッドシートを Google フォームに接続する方法については、 Google フォームの回答に関する 5 分間のクイックスタートガイドです。

書式設定

Range クラスには、次のようなメソッドがあります。 setBackground(color) セルまたはセル範囲の形式にアクセスしたり、セルの範囲を変更したりできます。次の次の例は、範囲のフォントスタイルを設定する方法を示しています。

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

データの検証

Apps Script では、Google スプレッドシート内の既存のデータ検証ルールにアクセスできます新しいルールを作成できます。たとえば、次のサンプルは、セルに 1 ～ 100 の数値のみを許可するデータ検証ルール。

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

データ検証ルールの使用について詳しくは、このモジュールの SpreadsheetApp.newDataValidation() DataValidationBuilder, および Range.setDataValidation(rule)

グラフ

Apps Script を使用すると、スプレッドシート内のデータを表すグラフをスプレッドシートに埋め込むことができます。指定します。次の例では、埋め込み棒グラフが生成されます。セル A1:B15 にグラフ可能なデータがあります。

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

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

  sheet.insertChart(chart);
}

スプレッドシートにグラフを埋め込む方法について詳しくは、 EmbeddedChart とグラフを作成できます。たとえば、 EmbeddedPieChartBuilder。

Google スプレッドシートのカスタム関数

カスタム関数は、組み込みのスプレッドシート関数（=SUM(A1:A5) など）を動作を確認する方法を学びます。たとえば、カスタムスペースを作成して関数 in2mm() はインチからミリメートルの値を変換し、数式を変換するには、[=in2mm(A1)] または [=in2mm(10)] を選択します。

カスタム関数について詳しくは、メニューとカスタム関数 5 分間のクイックスタート、またはカスタム関数に関するガイドをご覧ください。

マクロ

マクロを使用すると、Google スプレッドシートの UI から Apps Script コードを実行できます。カスタム関数とは異なり、キーボードショートカットまたは Google スプレッドシートのメニューです詳細については、次をご覧ください: Google スプレッドシートのマクロ。

Google スプレッドシート向けアドオン

アドオンは特別にパッケージ化された Apps Script である Google スプレッドシート内で実行され、インストール可能な Google スプレッドシートアドオンストアから利用できますGoogle スプレッドシート用のスクリプトを開発した場合世界中と共有したい場合は、Apps Script で公開する他のユーザーがアドオンストアからインストールできるようにする必要があります。

トリガー

Google スプレッドシートファイルにバインドされているスクリプト関数のような単純なトリガーを onOpen() と onEdit() で、編集権限を持つユーザーがアクセス権を付与すると、スプレッドシートを開いたり編集したりできるようになります。

単純なトリガーと同様にインストール可能なトリガーを使用すると、Google スプレッドシートで特定のイベントが発生したときに関数を自動的に実行します。インストール可能ただし、単純なトリガーやサポートよりも柔軟性に優れ、オープン、編集、変更、フォーム送信、時間ドリブン（時計）のイベントが含まれます。