アドオンで Google スプレッドシートを拡張する

Google スプレッドシートはクラウドベースの リアルタイムのコラボレーションと データの可視化、処理、伝達を行います。

Google スプレッドシートを拡張して、ワークフローをカスタマイズされた方法で改善できるアドオンを サードパーティ システムへの接続を確立し、スプレッドシートのデータを統合できます。 他の Google Workspace アプリケーション（ 。

他のユーザーが Google スプレッドシートのアドオンを使って Google Workspace Marketplace:

対応策

Google スプレッドシートを拡張するアドオンを使用すると、次のようなことができます。

スプレッドシートのアドオンは Apps Script を使用して作成されます。Google Chat の設定にアクセスする方法については、 管理する方法の詳細については、 Google スプレッドシートを拡張する。

シートの構造

Google スプレッドシートは 1 枚以上のシートで構成されています。各シートは 2D のセルのグリッドで、その中にテキスト、数値、リンク、 値を格納できます。1 つ以上の隣接するセルのグループを「セル」と呼びます。 範囲:

Apps Script スプレッドシート サービス スプレッドシートで組織構造を表す複数のクラスを提供 （Sheet、 Range）。これらを使用して、 Google スプレッドシートのデータと動作を読み取り、変更するためのクラス。

トリガー

Apps Script のトリガーを使用すると、 特定の条件が満たされたときに、指定された関数を実行します。たとえば、 スプレッドシートを開いたときや、アドオンをインストールしたときに表示されます。

詳しくは、アドオン トリガーをご覧ください。 スプレッドシートのアドオンで使用できるトリガーと適用される制限 あります。

カスタム関数

Google スプレッドシートの 組み込み関数 Google スプレッドシートのセル内から呼び出すことができる、SUM や AVERAGE のような関数です。 スプレッドシートのアドオンでは、 カスタム関数を使用して、これらの 組み込み関数を使用します。ユーザーが アドオン、アドオンに含まれる定義済みのカスタム関数がインストールされます すぐに利用できるようになりますアドオンの構成要素は カスタム関数の定義だけですカスタム関数の定義は主に 定義を含むアドオンを公開することで、他のユーザーと共有できます。

アドオンのカスタム関数を作成する

アドオン スクリプト プロジェクトで定義されている関数は、任意の関数をカスタム 使用します。関数が実装されてアドオンをインストールすると、 スプレッドシートの他の組み込み関数と同様に、カスタム関数を呼び出すことができます。 シートのセルで、= を入力し、その後に関数の名前と必要な文字列を入力します。 あります。エラーがなければ、この関数から をシートのセルに配置し、必要に応じて隣接するセルにオーバーフローします。

アドオンでカスタム関数を作成する際は、 一般的なカスタム関数のガイドラインは次のとおりです。

また、アドオンで定義されたカスタム関数には、 考慮事項:

  • 関数に名前を付けるときは、関数に関連しそうな一意の名前を アドオンの名前。複数のインストール済みアドオンがカスタム 関数を使用する場合、ユーザーはそのうちの 1 つしか使用できません。
  • アドオンが提供するカスタム関数を明確に伝える必要があります。 カスタム関数に正確な JSDoc コメントを記述して、 Apps Script は 予測入力情報 提供します。また、Google が承認したポリシーに関する追加のドキュメントを カスタム関数をアドオン自体またはアドオンのサポート ウェブページで指定できます。
  • 30 秒未満で完了しないカスタム関数は、 Internal error executing the custom function エラー。優れたユーザーを獲得する カスタム関数で実行できる処理量を抑えてエクスペリエンスを改善できます。 関数を最適化する できます。
  • カスタム関数では、承認を必要とする Apps Script サービスは使用できません。 You do not have permission to call X service エラーで失敗します。 試行されます。次のみを使用してください: 許可されたサービス 追加します。
  • シート内の各カスタム関数では、Apps Script が個別に呼び出されます。 説明します。ユーザーがカスタム関数を使用しようとしているセルが多すぎると、 関数の実行が遅くなる可能性があります。これを軽減するには、カスタム関数を できるだけシンプルにすることです複雑な関数や拡張された処理を実行する関数が必要な場合は、 カスタム関数を使用しません。その機能を提供するには、 メニュー項目、ダイアログ、サイドバー インタラクションを代わりに呼び出します。

スプレッドシートのマクロ

マクロを使用すると、操作を記録できます 後でキーボード ショートカットを使って繰り返します。特定の マクロを作成した場合、そのマクロを Apps UI のマクロ関数として追加します。 そのシートにバインドされているスクリプト プロジェクト。詳細情報 マクロの詳細については、 Google スプレッドシートのマクロ。

申し訳ございませんが、スプレッドシートのマクロをアドオンとともに配布することはできません。次を含める場合: マクロ定義をアドオンのマニフェスト内に定義した場合、そのマクロ定義のユーザーは できます。