【Gmail】Google Apps Scriptの実行エラー通知だけ別ラベルに分けるフィルタ設定

Google Apps Script(GAS)を業務で活用していると、スクリプトの実行エラー通知がGmailに届くことがあります。特に多くのトリガーやプロジェクトを運用している場合、エラー通知が増えて受信トレイが乱雑になり、重要なメールを見落とす原因にもなります。この記事では、GASの実行エラー通知だけを自動で別のラベルに振り分けるフィルタ設定方法を、具体例を交えて詳しく解説します。設定手順だけでなく、フィルタが機能しないときの原因や対処法、管理者に確認すべきポイントもカバーします。

1. GASエラー通知メールの特徴とフィルタリングの考え方

Google Apps Scriptの実行エラー通知は、通常「Google Apps Script」という表示名で送信されます。送信元アドレスはプロジェクトの設定やGoogle Workspaceの環境によって異なりますが、多くはapps-scripts-notifications@google.comまたはnoreply-scripts@google.comのようなアドレスです。件名は「Execution failed: [スクリプト名]」や「[プロジェクト名] – Error」といった英語表記が一般的ですが、アカウントの言語設定によっては日本語の件名になる場合もあります。

フィルタリングの基本は、これらのメールの共通パターンを見つけて条件に指定することです。最も確実なのは送信者アドレスで絞り込む方法ですが、送信者アドレスがすべてのプロジェクトで統一されていないケースもあるため、件名や本文のキーワードも併用すると精度が上がります。ただし、条件が広すぎると誤って関係のないメールまでラベル付けしてしまう可能性があるため、注意が必要です。

1-1. 送信者アドレスの確認方法

最初に、実際に届いたエラー通知メールのヘッダー情報を確認しましょう。Gmailで該当メールを開き、三点リーダーメニューから「元のメッセージを表示」を選ぶと、Fromフィールドに完全なメールアドレスが表示されます。組織によっては独自ドメインの送信者アドレス(例:notifications@yourcompany.com)を使用している可能性もあるため、必ず実例で確認してください。

2. フィルタ作成の事前準備

フィルタを作成する前に、使用するラベルを用意しておくとスムーズです。左サイドバーで「新しいラベルを作成」から、例えば「GASエラー」といった名前のラベルを作成します。さらにサブラベル(例:「GASエラー/緊急」「GASエラー/確認待ち」)を設けたい場合は、親ラベル作成時にネスト構造を指定できます。

また、フィルタの動作をテストするために、検証用のメールを先に送信しておくことも有効です。GASのエラー通知は実際にエラーが発生しないと届かないため、テスト環境で意図的にエラーを起こすか、既存のエラー通知を利用してください。

3. 具体的なフィルタ設定手順

以下の手順で、GASエラー通知を自動ラベル付けするフィルタを作成します。ここでは送信者アドレスと件名のキーワードを組み合わせた条件を例示します。

1. Gmailを開き、画面右上の設定アイコン(歯車)→「すべての設定を表示」をクリックします。
2. 「フィルタとブロック中のアドレス」タブを開き、一番下にある「新しいフィルタを作成」をクリックします。
3. 表示された「フィルタ条件」で以下の設定を行います。送信者アドレスが apps-scripts-notifications@google.com の場合、
   「From」欄に apps-scripts-notifications@google.com と入力します。
   さらに絞り込みたい場合は「件名」欄に Execution failed または Error を入力します。キーワードは大文字小文字を区別しません。
4. 「フィルタを作成」ボタンをクリックします。
5. フィルタのアクション画面で「ラベルを付ける」を選択し、事前に作成したラベル(例:「GASエラー」)をチェックします。必要に応じて「受信トレイをスキップ(アーカイブ)」も同時に設定すると、受信トレイに入らなくなります。
6. 「既存のメールにもこのフィルタを適用する」にチェックを入れると、過去のエラー通知にも同じラベルが付与されます。初回だけチェックすることをおすすめします。
7. 「フィルタを作成」をクリックして完了です。

以上の手順で、条件に合致する新着メールが自動的に指定ラベルに振り分けられます。フィルタ作成後、テストメールが届くか確認するか、既存のエラー通知が正しくラベル付けされているか確認しましょう。

4. フィルタが動作しない場合のトラブルシューティング

4-1. フィルタ条件の確認と調整

フィルタを作成してもエラー通知がラベル付けされない場合、条件が実メールと合致していない可能性があります。確認すべき点を以下にまとめます。

• 送信者アドレスが正しいか:メールヘッダーのFromアドレスと比較します。スペルやドメインが微妙に異なる場合があるため、コピー&ペーストで正確に入力してください。
• 件名の表記揺れ:件名が「Execution failed: MyScript」の場合、「Execution failed」は含まれますが、「Execution Failed」と大文字が異なる場合でもGmailは大文字小文字を区別しません。ただし、キーワード漏れがないか確認しましょう。
• 複数条件の論理:Gmailのフィルタは「From」と「件名」をAND条件で扱います。どちらか一方だけでも一致しないと適用されません。必要に応じて条件を緩めるか、複数のフィルタを作成してください。
• フィルタの適用順序:Gmailはすべてのフィルタを上から順に評価します。先に別のフィルタで受信トレイをスキップする設定があると、その後のフィルタが適用されない場合があります。フィルタの順序を「設定>フィルタとブロック中のアドレス」でドラッグして変更できます。

4-2. 組織ポリシーによる制限

会社のGoogle Workspaceアカウントを使用している場合、管理者が個人のフィルタ作成を禁止していることがあります。その場合は個人設定画面に「フィルタ」タブ自体が表示されないか、フィルタ作成後も適用されないことがあります。この場合、管理者に組織全体のルール(コンテンツコンプライアンスルールやルータールール)で同様の設定を依頼する必要があります。具体的には、Google管理コンソールの「Gmail」→「コンプライアンス」→「コンテンツコンプライアンス」で送信者と件名に基づくルールを設定してもらいます。

4-3. 失敗パターンと判断基準

よくある失敗パターンとその判断基準を表にまとめました。

状況	判断基準	対処法
フィルタを作成したのにエラー通知がラベルに届かない	メールが受信トレイに残っている、または他のラベルに振り分けられている	条件を見直し、テスト用のメールでフィルタのプレビューを実行する
ラベル付けされたが、通常のメールも誤って含まれてしまう	ラベルに該当しないメールが混在している	条件をより厳しくする。例えば本文に特定キーワードを追加する
フィルタが有効にならない(フィルタ一覧に表示されない)	設定画面でフィルタが作成できない、または保存後も表示されない	ブラウザのキャッシュクリア、別の端末で試す。それでも不可なら管理者に問い合わせ

5. 管理者設定が必要な場合の対処法

もし個人設定ではフィルタが使えない場合、管理者に以下の内容を伝えて対応を依頼しましょう。

• 目的:Google Apps Scriptの実行エラー通知を特定のラベルに振り分けたいこと。
• 具体的な条件:送信者アドレス(例:apps-scripts-notifications@google.com)と件名キーワード(例:Execution failed)を指定。
• 設定場所:Google管理コンソール > アプリ > Google Workspace > Gmail > コンプライアンス > コンテンツコンプライアンス。
• 注意点:組織全体に影響するため、テストグループで検証してから本番適用するように依頼してください。

6. よくある質問

Q1. 日本語の件名のエラー通知にも対応できますか?

送信者アドレスでフィルタすれば、件名にかかわらずキャッチできます。ただし、送信者アドレスが統一されていない場合は、件名に「エラー」「失敗」などの日本語キーワードを追加してください。Gmailのフィルタは日本語も認識しますが、表記揺れ(「エラー」「エラ―」など)に注意しましょう。

Q2. 過去のエラー通知メールにも一括でラベルを付けたいです。

フィルタ作成時に「既存のメールにもこのフィルタを適用する」をチェックすれば、過去のメールにもラベルが付きます。ただし、大量のメールがある場合は時間がかかることがあります。チェックを入れずに後から手動で適用することも可能です(フィルタ一覧の「適用」リンクから)。

Q3. フィルタを一時的に無効にするにはどうすればいいですか?

「設定>フィルタとブロック中のアドレス」で該当フィルタのチェックを外す(無効化)か、フィルタの編集画面で条件を変更せずに保存しないことで一時停止できます。完全に削除する場合は「削除」リンクをクリックします。

Q4. 同じ送信者アドレスから正常な通知も来るため、エラーだけを抽出したいです。

その場合は、件名に「Execution failed」や「Error」といったエラー特有のキーワードを必ず含めるように条件を追加してください。さらに本文に「Exception」や「Stack trace」などの単語が含まれることを条件にすることも有効です。ただし、Gmailのフィルタは本文中のキーワードも検索可能です(「次の文字列を含む」欄にキーワードを入力)。

7. まとめ

Google Apps Scriptの実行エラー通知を自動でラベル分けするフィルタ設定は、受信トレイの整理と重要メールの見落とし防止に役立ちます。設定の鍵は、送信者アドレスと件名キーワードの正確な特定と、フィルタの動作確認です。個人設定が制限されている場合は管理者に組織ルールを依頼しましょう。フィルタ条件は定期的に見直し、新しいプロジェクトや通知形式の変更に合わせて更新することをおすすめします。これらの対策を講じることで、GAS運用の効率が大幅に向上します。

✉️

Gmail・Googleアカウントトラブル完全解決データベース 送受信エラー/迷惑メール対策/容量整理/ラベル・自動振り分け/アカウント復旧/2段階認証/スマホ同期/転送・複数アカウントのトラブルを即解消。GmailとGoogleアカウントの実務リファレンスとしてご活用ください。