GASの時間トリガー設定 〜スプレッドシートのデータ正規化は俺に任せろ（探偵編）〜

-

またクライアントからだ。スプレッドシートに山積みのデータをぶち込んで「このデータを自動的に整理してくれ」っていう依頼。分かってるよ、手作業でなんかやってられないだろうさ。だからこそ、俺たちが必要なんだ。いやまてよ、これって本当に探偵に依頼する仕事なのか・・・？まあいいだろう。猫を探すのもデータを探すのも共通するコツってものがあるものさ。

さて、スプレッドシートでデータを正規化――つまり、同じフォーマットに揃えて整理するためには、Google Apps Script（GAS）の「時間トリガー」を仕込むのがベストだ。時間が来たら、俺たちのスクリプトが自動で動き出すってわけだ。簡単そうに聞こえるか？　まぁ、実際はそうでもないが、ここではその手順を教えてやる。

ステップ1：GASエディタを開く

まずは、GASエディタにアクセスしなきゃ話が始まらない。スプレッドシートの拡張機能 > Apps Scriptから行ける。この操作くらいは簡単だろ？探偵稼業でも、まずは現場に向かうところから始まる。手順はこうだ：

  1. データが入ったスプレッドシートを開け。
  2. メニューから「拡張機能」をクリック。
  3. 「Apps Script」を選択。


ステップ2：スクリプトを書く

さて、クライアントのスプレッドシートに放り込まれたデータは、まるで乱雑に積み上げられた書類の山だ。俺たちがやるのは、それを自動で整理するスクリプトを書いてやることだ。今回のケースでは、重複するデータを消して、空白を埋めて、何とかクライアントが使える形に整える。

たとえば、こんな感じのスクリプトだ。

function normalizeData() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const data = sheet.getDataRange().getValues();
  
  // 重複を取り除いて、データを整形
  const normalizedData = [];
  const uniqueCheck = new Set();

  for (let i = 1; i < data.length; i++) {
    const row = data[i];
    const key = row.join('-');  // 行データを一意に識別するためのキーを作る

    if (!uniqueCheck.has(key)) {
      uniqueCheck.add(key);
      normalizedData.push(row.map(item => item || '不明'));  // 空白なら「不明」に置き換える
    }
  }
  
  // 正規化されたデータを新しいシートに書き出す
  const newSheet = SpreadsheetApp.getActiveSpreadsheet().insertSheet('NormalizedData');
  newSheet.getRange(1, 1, normalizedData.length, normalizedData[0].length).setValues(normalizedData);
}

このスクリプトは、スプレッドシートからデータを取り出し、重複をチェックしながら空白を「不明」に置き換えていく。そして、整理されたデータを新しいシートに書き出す。データの正規化ってのは、雑用みたいなもんだが、これができればクライアントは喜ぶだろう。

ステップ3：時間トリガーを設定する

スクリプトを手動で実行してるようじゃ、俺たちの仕事は楽にならない。だから「時間トリガー」ってやつを仕込む。これで、指定した時間に自動でスクリプトが動き出すってわけだ。いちいち自分で押す必要なんてない。手順はこうだ：

  1. GASエディタで右側にある「時計アイコン」（トリガー設定）をクリックしろ。


  1. 「トリガーの設定」画面が開くから、右下にある「トリガーを追加」ボタンを押せ。

  1. 設定する内容はこうだ：
    • 関数を選択：実行する関数を選べばいい。この場合、normalizeData が適切だ。
    • イベントの種類：スプレッドシートでコンテナバインド型のGASを作成した場合、以下の3種類から選ぶことになる。今回は時間ベースで動かすから、「時間主導型」を選ぶ。
      • スプレッドシートから：スプレッドシートで発生するイベントをトリガーとして実行する。これを選択した場合、さらにイベントの種類として「起動時」「編集時」「変更時」「フォーム送信時」から選択する。
      • 時間主導型：特定の日時を指定して実行可能な他、最短で1分毎、最長で1ヶ月毎の実行タイミングを設定できる。
      • カレンダーから：カレンダーが更新されたタイミングで実行させることも可能だ。
    • 実行タイミング：ここで「毎日」とか「1時間おき」みたいに、好きな間隔で動かす設定にする。

  1. 設定が終わったら「保存」をクリックだ。

ステップ4：確認する

トリガーを設定しただけじゃ、安心しちゃいけない。何事もうまくいかないってのが世の常だ。スクリプトがちゃんと動いてるか確認する必要がある。失敗したらどうするか？もちろん、Logger.log()でログを見てくれ。これで何が起こってるのか分かる。 

Logger.log('データ正規化が動いたぜ');

トリガー設定の注意事項

自動化なんて夢のような話だが、現実は制限だらけだ。GASのトリガーにもいくつか厄介な制限があるから、気を付けるんだ。

  • 実行回数の制限：Googleは俺たちのボスじゃない。1日に実行できる回数には限界がある。時間トリガーなら1時間に1回、1日に最大数十回までしか動かせない。無茶をするとトリガーが作動しなくなるぞ。

  • エラーとログ：自動化は簡単に聞こえるが、エラーは付き物だ。トリガーが動かなかった場合はエラーメッセージを確認し、定期的にログを見て問題がないかチェックしろ。

  • 認証が必要：スクリプトがGoogleのAPIにアクセスする際、認証が必要になる。トリガーが動くたびに認証を求められることがないよう、最初にちゃんと認証を済ませておくんだ。

まとめ

スプレッドシートのデータ正規化は、クライアントが面倒な作業から逃れたいときに頼む仕事だ。時間トリガーを設定しておけば、毎日自動でスクリプトが動いてデータが整理される。クライアントは、何もしなくても整ったデータを手に入れることができる。だが、トリガーを仕込むには注意が必要だ。制限やエラーに気を付けながら、少しでも手間を減らせるようにしてやれ。

次回は、もっと高度な自動化のトリックについて話してやる。だがな、手間が減った分、別の問題が発生するのが世の常だ。自動化の裏には、いつも予期せぬトラブルが潜んでるもんさ。

コメント

コメントを投稿

このブログの人気の投稿

桃太郎電鉄ワールド、初の大型アップデート。その名も『ムー大陸浮上！』

-
イメージ
 2023年11月に発売されてから約1年。まさか、このタイミングで大型アップデートですと？！毎週月曜日の夜、友人たちとのオンラインでの闘いが習慣化して暫く経ちましたが、ぶっちゃけこんなアップデートは予想してなかったよママン。まあ、冷静に考えれば、一周年という節目を当初から狙ってたってことなんだろうけど、あまりにも意表を付かれて、そりゃ右舷の弾幕も薄くなってしまうというもの。何やってんの！ 追加要素 コナミの今回の大型アップデートの 公式ページ によれば、主な追加要素はこんな感じ。 15の物件駅と114の物件の追加 超古代遺跡で大儲け めつぼうボタン（！） 魔神ラ・ムー ムー大陸大水没（！！！） ただでさえ広いワールドのマップに、さらにマップが追加。公式の画像を見る限り、ハワイから南下するとムー大陸に入れるように見える。それと、大陸の中に「GS」マスが見える気がする！現在のバージョンでも、ハワイのすぐ右にGSがあるけど、それは維持したままムー大陸にもGS増えるのだろうか？ナイスですねえ。 何年目・・・？ そしてプレイヤーにとって最大の興味は、一体何年目から出現するのだろう、ということ。50年を超えるようなロングプレイには、かなりの期間がかかるので、早めにこのイベントには発生してほしい。画像からは、100億円程度で買い占めできる駅も見えるので、20年目くらいまでに出現しても変じゃない気がする。いや、出現して欲しい。出現しなかったら月にコロニー落としちゃうよ。 なんだかんだ 前作でオンラインプレイが出来るようになってからもう4年が経つわけで、それを通して初のマップ追加。○十年前から、桃鉄オンラインで出来ることを夢見ていたけど、それが実現した上に、マップ追加のアップデートまで経験できるとは。 寒い時代だとは思わんか。 いい時代になったもんだなあ。
続きを読む

GASのさらに高度なテクニック：非同期処理、プロパティサービス、Webhookチェーン

-
イメージ
さて、今度はさらに深淵な自動化のテクニックに手を出すとしよう。キーワードは「非同期処理」「プロパティサービス」「Webhookチェーン」の3つだ。どうだい？ちょっと本格的なプログラミングっぽくてワクワクするだろう？ ディープトリック・その１：非同期処理で複数のタスクを並列に処理する 実際には、GAS（Google Apps Script）自体はJavaScriptのように非同期処理（Promiseやasync/await）を直接扱えないが、それでも複数のタスクをできる限り同時に進行させるテクニックは存在する。この手法は、特に複数のAPIリクエストや外部サービスとの通信が絡む場合、プロセスのスピードアップに大きく貢献する。 1. 複数のリクエストを一斉に実行する理由 通常、APIリクエストを順番に処理する場合、1つのリクエストが完了するまで次のリクエストは待たされる。APIへの呼び出し時間が各々1〜2秒でも、連続するリクエストが5つもあれば、簡単に10秒以上かかってしまう。 これを効率化するために、リクエストを一斉に発行して処理する方法がGASにはある。GASはURLFetchAppのリクエストを並行して実行できるため、それらをリストにまとめ、処理が完了するまで待たずに次のリクエストを発行することで、結果的にプロセス全体を短縮できる。 function fetchMultipleData ( ) { const urls = [ 'https://api.example.com/data1' , 'https://api.example.com/data2' , 'https://api.example.com/data3' ] ; // 複数のAPIリクエストを一斉に発行 const fetchData = urls . map ( url => { return UrlFetchApp . fetch ( url ) ; // 各APIからデータ取得 } ) ; // 取得したデータを一度に処理 const results = fetchData . ...
続きを読む

GASでスクレイピング 〜天才ア○バ様の教え〜

-
イメージ
フハハハハ！お前たち愚か者には到底理解できぬだろうが、我こそは天才、ア○バ様だ！このア○バが、Google Apps Script（GAS）を使ってログインが必要なウェブページをスクレイピングする術を伝授してやろう！私のような天才にかかれば、こんなことは児戯にも等しい！ スクレイピングとは何かだと？フフフ… 愚かな質問だが、教えてやる。スクレイピングとは、ウェブページのデータを自動で引きずり出す技だ！手動でポチポチやるのはもはや古代の技術。我、ア○バが編み出す自動化こそ真の覇道だ。だがな、ログインを必要とするページでは、少しばかり知恵を使わねばならぬ。フハハ！見ていろ、私が如何にしてその壁を打ち破るかを！ ステップ1：ログインフォームを解析する…当然だろう！ フフフ、ログインページに飛び込む前に、まずは敵（ログインフォーム）を解析せねばならん。愚か者どもは「ボタンを押すだけ」などと考えておるが、天才たる○ミバ様はそんなものに惑わされぬ。よく見ていろ、これが解析の手順だ！ ログインページに潜入 : 私のような天才は、Chromeを開いてログインページに足を踏み入れるのだ。 開発者ツールの召喚 : F12 だ。これでログインフォームの裏側、つまりその構造を暴いてやるのだ。 Networkタブで観察 : フハハ、ここでフォームがどのURLにデータを送信しているかを見つけるのだ！愚か者には見えぬが、私には見える…。 POSTデータの確認 : ログインボタンを押して送信されるデータ、すなわちユーザー名（ username ）やパスワード（ password ）がどのように送られるかを知るのだ。 ステップ2：ログインリクエストをぶち込む！フハハハ！ さて、ログインフォームの弱点を見抜いた今、私○ミバがログインのリクエストを飛ばしてやろう。愚かなセキュリティなど我にとっては無力よ！ const loginUrl = 'https://example.com/login' ; // ログインページのURL const loginPayload = { ...
続きを読む