Google Docs、Google Sheets、Google Analytics、GmailなどのGoogleサービスを使用している場合は、 GoogleAppsScriptを使用してこれらのサービスに接続して自動化できます。
Google Apps Scriptは、GoogleバージョンのMicrosoftのVBAスクリプトの(Microsoft’s VBA script)ように考えてください。VBAを使用して(Excel with VBA)MicrosoftWordおよびExcelでアクションとタスクを自動化したり、マクロをカスタマイズしたりできるのと同じように、 Googleサービス全体でタスクとアクションを自動化できます。SheetsやDocsなどのサービスでは、独自のカスタムメニューを作成することもできます。
この記事では、さまざまなGoogleサービスで(various Google services)Apps Scriptにアクセスして有効にする方法、 (Apps Script)Apps Script Editorをナビゲートする方法、およびサービスを接続する方法について学習します。特定のスクリプト機能については学習(learn specific script functions)しませんが、Googleには、 (Google)AppsScriptの記述方法を学習するための優れたドキュメントとAppsScriptチュートリアルが用意されています。
Google AppsScriptEditor(Access Google Apps Script Editor)にアクセスする方法
多くのGoogleサービス内から(Google)GoogleAppsScriptコードエディタを開くことができます。たとえば、AppsScriptはGoogleスプレッドシート内の[拡張機能]メニューにあります。(Extensions)
他のサービスでは、次の方法でGoogle AppsScriptEditor(Google Apps Script)を開くことができます。
- Googleドキュメント(Google Docs)：[ツール(Tools)]メニューで[スクリプトエディタ(Script editor)]を選択します。
- Googleスライド(Google Slides)：[ツール(Tools)]メニューで[スクリプトエディター(Script editor)]を選択します。
- Googleフォーム(Google Forms)：3ドットメニューで[スクリプトエディター]を選択します。(Script editor)
- Googleドライブ(Google Drive)：空白スペースを右クリックし、[その他]を選択して、[ (More)GoogleAppsScript ]を選択します。
これらの方法のいずれかを使用すると、AppsScriptコードエディタが新しいタブで開きます。これは、スクリプト全体を構成する各関数を作成するウィンドウです。デフォルトでは、myFunction（）という名前の空の関数が表示され、コードの入力を開始する準備ができています。
注(Note)：エラーを回避するには、コードのフォーマットが非常に重要です。次のコードに示すようにコメントを使用して、コードのセクション内で何をしようとしていたかを思い出してください。これは、Webプログラミングを使用したHTML(HTML)コードでのコメントの動作と非常によく似ています。
コードエディタをナビゲートしているときに、エディタ(Editor)ウィンドウの左側のナビゲーションペインでCode.gsを選択すると、このセクションに戻ることができます。他の利用可能なウィンドウを表示するには、左端のペインのアイコンにカーソルを合わせると、メインのナビゲーションペインが開きます。
[概要](Overview)セクションでは、発生したエラーの数、実行された回数など、スクリプトに関する統計を確認できます。
以下の各セクションでは、 GoogleAppsScript(Google Apps Script)エディタの他の各セクションについて説明します。
Google AppsScriptEditorの操作
エディターでコードを編集するときは、作業内容を失わないように、ディスク（保存）アイコンを頻繁に選択することをお勧めします。(Save)
保存すると、他のメニューオプションが点灯します。
これらには以下が含まれます：
- 実行(Run)：スクリプト全体を最初から最後まで実行してみます。
- デバッグ(Debug)：スクリプトを一度に1行ずつ実行します。
- 関数ドロップダウン(Function dropdown)：作成した各関数を参照して移動します。
- 実行ログ(Execution log)：スクリプトの実行を試行するたびに、ステータスまたはエラーメッセージが表示されます。
左側のナビゲーションメニューの[ライブラリ(Libraries)]オプションでは、他の人が作成した（または他の場所で作成して保存した）ライブラリにアクセスできます。これは、 Googleスプレッドシート(Google Sheets)やGoogleドキュメント(Google Docs)で使用したい機能をすでに作成している友人がいて、その上に機能を追加したい場合に便利です。
これらのライブラリをプロジェクトに追加するために必要なのは、スクリプトID(Script ID)だけです。これは、この記事の最後にあるプロジェクト設定セクションで見つけることができます。
Google AppsScriptServicesアドオン
サービス(Services)セクションが最も便利です。ここで、現在のスクリプトを、使用する可能性のある他のGoogleサービスと統合できます。
これを選択すると、[サービスの追加](Add a service)ウィンドウが開きます。既存のプロジェクトへのアドオンとして使用するサービスまで下に スクロールします。(Scroll)
たとえば、Google Analyticsアカウントからこのスクリプトにデータをプルする場合は、Google Analytics APIを選択し、[追加(Add)]を選択できます。
その新しいアドオンサービスで使用できる関数とその使用方法の詳細を知りたい場合は、APIの右側にある3つのドットを選択し、[(API)ドキュメントを参照(See documentation)]を選択します。
これにより、Google Apps Scriptのドキュメントが新しいタブで開き、そのGoogleサービスのセクションが自動的に開きます。
独自のスクリプトで使用できる関数の構文、チュートリアル、およびコード例については、ドキュメントを参照してください。
また、ドキュメントの他のセクションに移動して、 AppsScript(Apps Script)コードエディターを最初に開いたときに使用していたサービスに基づいて、スクリプトで使用できる一般的な関数を確認できることにも注意してください。
たとえば、Googleスプレッドシート(Google Sheets)でエディタを開いた場合は、ドキュメントメニューの[スプレッドシート]セクションで、スクリプト(Sheets)で使用できるGoogleスプレッドシートの機能を確認してください。(Google Sheets)
AppsScriptトリガー(Using Apps Script Triggers)の設定と使用
Google Apps Scriptのもう1つの便利な機能は、多数のイベントまたはスケジュールに基づいてトリガーを設定する機能です。
スクリプトの新しいトリガーを構成するには、左端のナビゲーションメニューから[トリガー]を選択します。(Triggers)開いた新しいトリガー(Triggers)ウィンドウで、[トリガーの追加(Add Trigger)]ボタンを選択します。
[トリガー(Add Trigger)の追加]ウィンドウには、スクリプトを実行する方法とタイミングを正確にカスタマイズするのに役立つオプションの長いリストがあります。
注(Note)：これらのオプションの多くは、スクリプトを作成しているサービスまたは追加したAPI(the APIs that you’ve added)によって異なります。
トリガーを設定するには、次を選択する必要があります。
- 最初に起動する関数
- 特定の時刻、日付、またはGoogle(Google)スプレッドシートのセルが変更されたときやドキュメントが最初に開かれたときなど、サービス内のイベントなどのイベントソース
- Googleスプレッドシートまたはドキュメント内の何かが開かれたり編集されたりしたとき、または日付や時刻の特定の設定などのイベントタイプ
- スクリプトが失敗したときの更新を取得する頻度の通知頻度
[保存(Save)]を選択すると、新しいトリガーを初めて保存した場合に、「スクリプト認証に失敗しました」というメッセージが表示される場合があります。(Script)
これは通常、ブラウザでポップアップブロッカーが有効になっている場合にトリガーされます。Google Chromeを使用している場合は、赤い「X」が付いた小さなウィンドウアイコンを選択するだけです。設定を[常にポップアップを許可する]に変更し、[(Always allow pop-ups)完了](Done)を選択します。
もう一度[保存](Save)を選択する場合は、プロセスをステップ実行して、作成したスクリプトをGoogleアカウントまたはGoogleWorkspaceで実行することを承認する必要があります。
まず、スクリプトの実行を許可するGoogleアカウントを選択します。(Google)
作成したカスタム関数またはスクリプトがGoogle(Google)によって「検証」されていないという警告が表示されます。スクリプトを作成した人であれば、これは問題ではなく、自分のGoogleアカウント(Google Account)またはGoogleWorkspaceで実行しても安全です。
この警告を回避するには、[詳細設定]を選択してから、下部にあるGo to <project> (unsafe)に移動]リンクを選択します。(Advanced)
最後に、権限ウィンドウで[許可](Allow)を選択して、カスタム関数とスクリプトをGoogleアカウントまたはGoogleWorkspaceで実行できるようにします。
このプロセスを再度繰り返す必要はありません。カスタムのGoogleApps(Google Apps)スクリプトプロジェクト を初めて保存または実行する場合に限ります。
GoogleScriptIDへのアクセス
最後に、友人や同僚がスクリプトを使用するか、ライブラリとして自分のスクリプトに追加できるように、スクリプトを提供することをお勧めします。
スクリプトID(Script ID)は、左端のナビゲーションペインの[設定](Settings)アイコンにあります。
スクリプトID(Script ID)は、スクリプトID(Script ID)の右側の[ ID](IDs)セクションにあります。
ご覧のとおり、使用する各機能に移動する方法を知っていれば、GoogleAppsScriptエディタはかなり簡単です。(Google Apps Script)スクリプト(Apps Script)と使用可能なすべての関数の記述方法を学び始めることができるように、GoogleのAppsScriptドキュメントをよく調べてください。(Just)
Google Apps Script Editor: Everything You Need to Know to Get Started
If you υse Google services like Google Docs, Google Shеets, Google Analytics, Gmail, and others, you could connеct and automate those services using Google Αрps Scrіpt.
Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.
In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.
How to Access Google Apps Script Editor
You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.
In other services, you can open the Google Apps Script editor in the following ways:
- Google Docs: Select Script editor in the Tools menu.
- Google Slides: Select Script editor in the Tools menu.
- Google Forms: Select Script editor in the three-dot menu.
- Google Drive: Right-click any blank space, select More, and select Google Apps Script.
Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.
Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.
As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.
The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.
We’ll cover each of the other sections of the Google Apps Script editor in each section below.
Navigating the Google Apps Script Editor
As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.
Once saved, you’ll see the other menu options light up.
These include:
- Run: Attempt to run your entire script from beginning to end.
- Debug: Step through your script one line at a time.
- Function dropdown: Browse through and navigate to each of the functions you’ve created.
- Execution log: See any status or error messages from each attempt you’ve made to run your script.
The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.
All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.
Google Apps Script Services Add-Ons
The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use.
When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project.
For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.
If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.
This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.
Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.
Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.
For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.
Setting Up and Using Apps Script Triggers
Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.
To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.
The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run.
Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.
To set up your trigger, you’ll need to choose:
- Which function to initially launch
- The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
- The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
- Notification frequency for how often you want to get updates about when your scripts have failed
Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.
This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.
When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.
First, select the Google account that you want to allow your script to run under.
You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.
To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.
Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.
You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects.
Accessing Your Google Script ID
One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script.
You can find your Script ID under the Settings icon in the far left navigation pane.
The Script ID can be found under the IDs section, to the right of Script ID.
As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.
