スクリプトが Google スプレッドシート、ドキュメント、スライド、フォームのファイルにバインドされている場合、そのファイル スタンドアロン スクリプトとしてではなく、そのドキュメントからスクリプトを作成します。 バインドされたスクリプトが添付されているファイルは「コンテナ」と呼ばれます。 バインドされたスクリプトは通常、スタンドアロン スクリプトと同様に動作しますが、 Google ドライブに表示されないため、ファイルから切り離すことはできません。 バインドされ、親ファイルに対していくつかの特別な権限が付与されます。
スクリプトを Google サイトにバインドすることもできますが、 ほとんどの場合、ウェブアプリとしてデプロイされます。スクリプト Google スプレッドシート、ドキュメント、スライド、フォームにバインドされたアプリケーションもウェブアプリになることができますが、 これは珍しいことです。
バインドされたスクリプトを作成する
Google ドキュメント、スプレッドシート、スライド
Google ドキュメント、スプレッドシート、スライドでバインドされたスクリプトを作成するには、 Google スプレッドシートのスプレッドシート、スライドのプレゼンテーションなど、Google スプレッドシートの 拡張機能 > [Apps Script]。スクリプトを 後で同じことをするか、スクリプトをプログラムから Apps Script ダッシュボード。
Google フォーム
Google フォームでバインドされたスクリプトを作成するには、フォームを開きます その他アイコン > スクリプト エディタで確認できます。スクリプトを スクリプトを Apps Script ダッシュボード。
をクリックします。特別なメソッド
バインドされたスクリプトは、スタンドアロン スクリプトではできない、いくつかのメソッドを呼び出すことができます。
getActiveSpreadsheet()
getActiveDocument()
、getActivePresentation()
、 およびgetActiveForm()
バインドされたスクリプトが、親ファイルを参照することなく、 表示されます。getUi
を使用すると、 バインドされたスクリプトは、親ファイルのユーザー インターフェースにアクセスして カスタム メニュー、ダイアログ、サイドバー。- Google スプレッドシート(
getActiveSheet()
)で、getActiveRange()
、 およびgetActiveCell()
ユーザーの現在のシート、選択されているセル範囲、 セル。setActiveSheet(sheet)
およびsetActiveRange(range)
その選択をスクリプトで変更できるようにします - Google ドキュメント(
getActiveTab()
)で、getCursor()
、getSelection()
スクリプトにより、ユーザーの現在のタブ、ユーザーの 選択したテキストにカーソルを合わせます。setActiveTab(tabId)
setCursor(position)
およびsetSelection(range)
その選択をスクリプトで変更できるようにします
詳しくは、 Google スプレッドシートの拡張ガイド Google ドキュメントの拡張ガイドをご覧ください。
カスタム メニュー、ダイアログ、サイドバー
バインドされたスクリプトは、スプレッドシート、ドキュメント、フォームを カスタム メニューと ダイアログ ボックスやサイドバーの留意点: ただし、スクリプトがやり取りできるのはそのサービスのユーザー インターフェース 現在のインスタンスが表示されます。つまり、1 つのドキュメントに 1 つのスクリプトが 別のドキュメントのユーザー インターフェースには影響を与えません。
アドオン
アドオンは、Gmail、Google スプレッドシート、Google ドキュメント、 スライド、フォーム。境界の定義や スタンドアロン 世界中と共有したい場合は、Apps Script で 公開するスクリプトを 他のユーザーがアドオンストアからインストールできるようにする必要があります。
トリガー
バインドされたスクリプトは単純なトリガーを使用できる
たとえば、特別な onOpen()
関数があります。この関数は、関数が呼び出されたときに
編集権限を持つユーザーが開いています。あらゆるタイプのスクリプトと同様に、
インストール可能なトリガーも使用します。
カスタム関数
カスタム関数は、
Google スプレッドシートにバインドされています。
構文 =myFunctionName()
。そのため、カスタム関数は数百もの関数に
スプレッドシートの組み込み関数
AVERAGE
や
SUM
。ただし、
カスタム関数の動作を変更できます。
バインドされたスクリプトへのアクセス
コンテナの編集権限を持つユーザーのみが、バインドされたスクリプトを実行できます。 閲覧権限しかない共同編集者は、スクリプトを開けません コンテナ ファイルのコピーを作成すると、そのコピーは スクリプトのコピーを表示、実行できます。
スクリプトのコンテナ ファイルを共有する方法については、ファイルの共有元: Google ドライブ。