【GAS】Ｇメールの検索機能まとめ【サンプルソース付】

GAS開発者向けにＧメールの検索機能をすべてまとめました。

目的に合わせてよく使う検索を設定しておき、簡単に探せるようにしておきましょう。

検索に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]の検索
1. 検索１[search(クエリ)]
2. 検索２[search(クエリ, 開始, 最大)]
最後に

ＧメールAPPクラス[GmailApp]の検索

Ｇメールの検索メソッドです。

検索１[search(クエリ)]

search(query)
指定されたクエリでGmailを検索します。

すべてのスレッドのサイズが大きすぎてシステムが処理できない場合、この呼び出しは失敗します。スレッドサイズが不明で、潜在的に非常に大きい場合は、「paged」呼び出しを使用し、各呼び出しで取得するスレッドの範囲を指定してください。

function search1Sample() {
  // 件名が付いたスター付きメッセージを検索する重要
  var threads = GmailApp.search('is:starred subject:"IMPORTANT"');
}

Parameters
名前	タイプ	説明
query	String	Gmailに入力する検索クエリ

Return
GmailThread[] - このクエリに一致するGmailスレッドの配列

検索２[search(クエリ, 開始, 最大)]

search(query, start, max)
指定されたクエリでGmailを検索します。

function search2Sample() {
  // 件名が重要なスター付きメッセージを検索し、10の2番目のバッチを返します。
  // 少なくとも11個あると仮定します。そうでない場合、空の配列を返します。
  var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);
}

Parameters
名前	タイプ	説明
query	String	Gmailに入力する検索クエリ
start	Integer	開始スレッドのインデックス
max	Integer	返すスレッドの最大数

Return
GmailThread[] - このクエリに一致するGmailスレッドの配列

最後に

Ｇメールの検索機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。