「GAS」の記事 - Crieit

【GAS】処理時間の制限を回避する

2023-12-17T10:50:09+09:00

こんにちは、しきゆらです。
急な出社が続いてあまり記事を書けていない今日この頃です。
今回は、以前投稿したGASでファイル一覧を取得するコードを載せましたが、実際の環境で処理回したら処理時間の制限に引っかかったので、回避するように直したのでその旨をメモしておきます。
前回の記事はこちら。

【GAS】Googleドライブにあるフォルダ・ファイルの一覧を取得する | しきゆらの備忘録 https://shikiyura.com/2023/11/how_to_get_file_list_in_google_drive/

改めて、GASの制限については以下を参照いただければと思います。

Google サービスの割り当て | Apps Script | Google for Developers https://developers.google.com/apps-script/guides/services/quotas?hl=ja#current_limitations

上記を見ると、スクリプトの制限としては１回の処理で6分までとなっています。今回は、ここを回避していきます。

回避の方針

処理時間の制限としては、処理時間が一定時間を超えたらそこでいったん処理を止める、というだけ。
ただし、それだけだと処理しきれなかった部分が出てくるので、そこもケアしてあげましょう。

ざっくり手順としては以下の通り。

定期的に処理時間の確認し、一定時間を超えていたら処理を止める
処理途中のデータを保存する
処理を続きから実行するためのトリガーを定義する
一時停止した場合に前回の処理から再開する

それぞれ見ていきましょう。

なお、スクリプトのよって内容が変わると思いますが、ここでの例として前回のファイル・フォルダの一覧を取得する、というものに対してコードを書いていきます。

【GAS】Googleドライブにあるフォルダ・ファイルの一覧を取得する | しきゆらの備忘録 https://shikiyura.com/2023/11/how_to_get_file_list_in_google_drive/

ファイル・フォルダ一覧を取得するコードはこんな感じ。

function allFiles(){
  const folderId= "xxxxxxxxxx";
  const targetDir = DriveApp.getFolderById(folderId);
  const files = []; // ファイルオブジェクトを保持する配列
  const subFolders = [targetDir.getFolders()];

for(let i = 0; i < subFolders.length; i++) {
    const subFolder = subFolders[i];
    while(subFolder.hasNext()) {
      const folder = subFolder.next();
      subFolders.push(folder.getFolders());
      folders.push(...allFilesBy(folder));
    }
  }
  return files;
}

function allFilesBy(folder) {
  const files = []; // 対象となるフォルダにあるファイルオブジェクトを保持する配列
  const fileIterator = folder.getFiles();
  while(fileIterator.hasNext()) {
    files.push(fileIterator.next());
  }
  return files;
}

処理時間を回避するコード

処理途中のデータを保存する

処理を止めるだけでは、次に実行したときに再開することはできません。処理を止めたときに、次回実行時に処理途中から再開できるように

前述の通り、前回のファイル・フォルダ一覧を取得するコードを例として書いていきます。前回の記事はこちら。

【GAS】Googleドライブにあるフォルダ・ファイルの一覧を取得する | しきゆらの備忘録 https://shikiyura.com/2023/11/how_to_get_file_list_in_google_drive/

データを保持する先は、以前に紹介したPropertiesServiceを使います。 PropertiesServiceに関しては、過去記事を書いているのでこちらもご覧ください。

【GAS】パスワードやトークンをコードに直書きしない方法 | しきゆらの備忘録 https://shikiyura.com/2021/07/how_to_use_properties_service_at_gas/

ファイル・フォルダの一覧を取得する場合、保持しなければいけないのは主に以下の3点ですね。

取得したファイル・フォルダのリスト
処理途中のファイル・フォルダイテレータ
参照予定のフォルダリスト

この3点の中で、最初の「取得したファイル・フォルダのリスト」については、おそらく取得した後で最終的にはスプレッドシートにまとめたりするはずなので、あえてPropertiesServiceに置いておかなくてもよいかもしれません。

一方で、「処理途中のファイル・フォルダイテレータ」や「参照予定のフォルダリスト」は処理途中で終了しなければいけない場合は保持しておかなければ続きから再開ができません。
ということで、この２点を保持する形を作っていきます。

イメージ図を置いておきます。
赤フォルダ配下にあるフォルダを取得するとき、getFolders()で青フォルダたちFolderIteratorとして取得できます。

青フォルダたちをFolderIteratorで取得している間に下図の線の位置で時間切れとなった場合、残り2つのフォルダは次回に回さないといけません。
合わせて、青フォルダ1の配下にある紫フォルダたちを取得するFolderIteratorも取得済みなので、こいつらも次回処理するときに見る必要がありますよね。

ということで上記3点のうち、青フォルダのFolderIteratorが「処理途中のファイル・フォルダイテレータ」、紫フォルダのFolderIteratorが「参照予定のフォルダリスト」となります。
では、それぞれの保持の仕方を見ていきます。

FolderIterator、FileIteratorのどちらもgetContinuationToken()メソッドが定義されており、イテレータ処理で時間がかかる場合に途中から再開することができるようになっています。
再開するには、DriveAppクラスに定義されているcontinueFolderIterator、continueFileIteratorにトークンを渡せばよい。

// トークンの取得
const iteratorToken = fileIterator.getContinuationToken();

// イテレータの再開
const resumeIterator = DriveApp.continueFileIterator(iteratorToken);

Class FolderIterator | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/folder-iterator?hl=ja#getContinuationToken()

Class FileIterator | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/file-iterator?hl=ja#getContinuationToken()

このトークンをPropertiesServiceなどで保持しておけば再開できますね。

参照予定のフォルダリストの保持

前述の通り、フォルダやファイル一覧についてはPropertiesServiceを使って保持します。なお、参照予定のフォルダ一覧はFolderIteratorが複数ある形なので、これらも上記の通りトークンに変換して保持します。

const subFolders = []; // 参照予定のFolderIteratorリストを保持する配列
...

// スクリプトプロパティを取得
const scriptProperty = PropertiesService.getScriptProperties();
// 参照予定のFolderIteratorをトークンに変換する
const subFolderTokens = subFolders.map(subFolder => subFolder.getContinuationToken());
// 参照予定のリストをJSONに変換して保持
scriptProperty.setProperty("folders", JSON.stringify(subFolderTokens));

処理途中のイテレータも同じくgetContinuationTokenメソッドでトークンを取得できるので取得しつつsubFoldersの先頭に置いておけば再開できそうですね。

ここまでで、一時停止のためのデータ保持が完了です。

処理の続きを実行するトリガーを定義する

GASにはトリガーという機能があり、特定の時間やタイミングなどになったら処理を始める、ということを指定できます。
トリガークラスについてはこの辺を参照ください。

トリガーの作成はScriptAppのnewTrigger()で作成できます。

Class ScriptApp | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/script/script-app?hl=ja#getProjectTriggers()

トリガー作成時に、トリガー起動時に呼び出す関数名を文字列で指定します。ここでは、トリガーとして1分後に起動するトリガーを作成します。

ScriptApp.newTrigger(functionName).timeBased().after(1000 * 60).create();

newTrigger()が返してくるのはTriggerBuilderクラスになっています。詳しくはこちら。

Class TriggerBuilder | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/script/trigger-builder?hl=ja

timeBased()はトリガーの種類として時間を基準として動くタイプとして指定しています。 after()でトリガーが起動する時間をミリ秒で指定しています。 create()で指定したトリガーを作っているだけ。見ればわかる感じですね。

一時停止した場合に前回の処理から再開する

前回の処理がある場合は、前回の処理から再開してあげる必要があります。

先ほどPropertiesServiceに保持したデータですが、ここから取得してできるかどうかで判別したり、関数の引数の有無で判別したり、方法はいくつかありそうですがここではPropertiesServiceにデータがあるかどうかで判別してみます。

// スクリプトプロパティを取得
const scriptProperty = PropertiesService.getScriptProperties();
// 前回の処理からの続きとなるデータを取得
const resumeData = scriptProperty.getProperty("folders");

if(resumeData === null) {
  // 前回のデータがないので、ターゲットとなるフォルダを取得
} else {
  // 前回のデータがあるので、再開する
}

再開する場合は、トークンを使ってイテレータの続きを取得します。上記サンプルのelse部分は以下のような感じになります。

const tokenJson = JSON.parse(resumeData);
const subFolders = tokenJson.map(token => DriveApp.continueFolderIterator(token));

あとは、このトークンから復元したイテレータをひとつづつ取り出して処理を進めればよいですね。

まとめてコードを載せると以下のような感じ。

// 処理時間の制限を超えたかどうかのフラグ
let limitFlag = false;

function allFiles(){
  const functionName = "allFiles";
  const startDate = new Date();
  let subFolders = []; // 配下にあるサブフォルダを保持する配列
  let files = [];

// 中断データを取得する
  const resume = getResume(functionName);
  if (resume === null) {
    // 中断データがない場合は、初期フォルダから処理を開始する
    const folderId= "xxxxxxxxxx";
    const targetDir = DriveApp.getFolderById(folderId);
    subFolders.push(targetDir.getFolders());
    files.push(...Array.from(allFilesBy(targetDir, startDate)));
  } else {
    // 中断データがある場合は、トークンからFolderIteratorに変換する
    const tokensJson = JSON.parse(resume);
    subFolders = tokensJson.map(token => DriveApp.continueFolderIterator(token));
  }

for(let i = 0; i < subFolders.length; i++) {
    const subFolder = subFolders[i];
    while(subFolder.hasNext()) {
      const folder = subFolder.next();
      subFolders.push(folder.getFolders());
      files.push(...allFilesBy(folder));
      if(limitFlag || checkLimit(startDate)) break;
    }

    // 一定の処理時間を超えた場合、処理途中のFolderIteratorをトークンに変換して保存する
    if(limitFlag || checkLimit(startDate)){
      const tokens = [subFolder.getContinuationToken()];
      const subFolderTokens = subFolders.map(subFolder => subFolder.getContinuationToken());
      setResume(functionName, JSON.stringify(tokens.concat(subFolderTokens)));
            break;
    }
  }
    // 今回処理した結果を返す
  return files;
}

function allFilesBy(folder) {
  const files = []; // 対象となるフォルダにあるファイルオブジェクトを保持する配列
  const fileIterator = folder.getFiles();
  while(fileIterator.hasNext()) {
    files.push(fileIterator.next());
  }
  return files;
}

function checkLimit(startDate) {
  const processingSec = (new Date().getTime() - startDate.getTime()) / 1000;
  limitFlag = processingSec >= 300
  return limitFlag;
}

// 中断データを取得する
function getResume(functionName) {
  const scriptProperty = PropertiesService.getScriptProperties();
  const properties = scriptProperty.getProperty(functionName);
  scriptProperty.deleteProperty(functionName);

  return properties;
}

// 中断データを保持し、トリガーを設定する
function setResume(functionName, data) {
  const scriptProperty = PropertiesService.getScriptProperties();
  scriptProperty.setProperty(functionName, data);

  setTrigger(functionName);
}

// トリガーを設定する
function setTrigger(functionName) {
  let triggers = ScriptApp.getProjectTriggers();
  for(let trigger of triggers) {
    if(trigger.getHandlerFunction() === functionName){
      ScriptApp.deleteTrigger(trigger);
    }
  }
  ScriptApp.newTrigger(functionName).timeBased().after(1000 * 60).create();
}

これで、処理時間の制限に引っかかるような長時間の処理が必要な場合、これを回避して処理させることができるようになりました。
処理時間の制限があるのでGASを使うのはきびしいな、というような場合に参考にしていただければ幸いです。

まとめ

今回は、GASの処理時間の制限を回避するため、以下の項目を組み合わせて回避してみました。

処理時間の計測
処理途中のデータをPropertiesServiceへ保存
処理再開のためのトリガー設定
前回の処理途中からの再開

私の場合は、とあるフォルダ配下にあるファイルたちのオーナー一覧を取得してほしい、というお題が来たので上記のようなコードを書いていました。 RubyなどからAPI経由でデータ取得するよりも、GAS上で書く方がシンプルでしたが、ざっと書いたところ処理時間の制限に阻まれたのでリファレンス等を読みつつ変更した結果が今回の時期の内容になります。

GASでコードを書いた方がシンプルだが、処理にどの程度時間がかかるかわからないというような場合でもGASを使って処理させることができるようになるので、参考になればうれしいです。

今回は、ここまで。

おわり

【GAS】Googleドライブにあるフォルダ・ファイルの一覧を取得する

2023-11-04T21:30:36+09:00

こんにちは、しきゆらです。
今回は、GASでGoogleドライブにあるファイル・フォルダの一覧を取得する方法をメモしておきます。

ファイル・フォルダの一覧を取得するコード

すべてのフォルダを取得する

すべてのフォルダを取得する場合、以下だけです。

const folders = DriveApp.getFolders();

DriverApp.getFolders()でGoogleドライブにあるフォルダのイテレータを取得できます。
ドライブ内にあるすべてのファイルが欲しければ、このイテレータ内でファイル一覧を取得していけば可能ですね。

Class DriveApp | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/drive-app?hl=ja#getfolders

なお、Folderクラスにも直下にあるフォルダ一覧を取得できるgetFolders()メソッドが生えているので、同じように使えます。

Class Folder | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/folder?hl=ja#getfolders

フォルダ直下にあるファイル一覧を取得する

上記のようなFolderIteratorからFolderクラスのインスタンスを取得します。
Folderクラスには、直下にあるファイルのイテレータを取得するメソッドがあるのでこれを使います。

const folder = folders.next(); // FolderIteratorからFolderオブジェクトを取得
const fileIterator = folder.getFiles();

const files = []; // ファイルオブジェクトを格納する配列
while(fileIterator.hasNext()) {
  files.push(fileIterator.next());
}

Class Folder | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/folder?hl=ja#getfiles

これらを組み合わせれば、特定のフォルダ配下のすべてのファイル一覧を取得することができますね。やってみましょう。

特定のフォルダ配下にあるすべてのファイルを取得する

ターゲットとなるフォルダを取得する

まずは、GASからターゲットとなるフォルダを取得します。

// https://drive.google.com/drive/u/0/folders/xxxxxxのxxxxxxx部分
const folderId= "xxxxxxxxxx"; 
const targetDir = DriveApp.getFolderById(folderId);

targetDirはGASのFolderクラスのインスタンスが入っています。

Folderクラスについては以下を参照。

Class Folder | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/folder?hl=ja

フォルダ一覧を取得する

前述の通り、Folderクラスには配下にあるフォルダ一覧を取得するメソッドが定義されているのでそれを使います。

const folderIterator = targetDir.getFolders(); // Folderのイテレータオブジェクトが返ってくる
while (folderIterator.hasNext()) { // 参照していないFolderがあればループする
  folders.push(folderIterator.next()); // .next()でFolderを取得
}

FolderIteratorクラスは以下を参照。
よくあるイテレータで、hasNext()で次の要素があるかどうかを確認しつつ、次の要素があればnext()で取得する形です。

Class FolderIterator | Apps Script | Google for Developers https://developers.google.com/apps-script/reference/drive/folder-iterator?hl=ja

ただし、ここで取得できるのはtargetDir直下にあるフォルダのみです。
targetDir配下すべてを取得するにはちょっと工夫してあげる必要がります。

const subFolders = [targetDir.getFolders()];
for(let i = 0; i < subFolders.length; i++) {
  const subFolder = subFolders[i];
  while(subFolder.hasNext()) {
    const folder = subFolder.next();
    subFolder.push(folder.getFolders()); // フォルダ一覧を取得し、次に参照する
  }
}

配列に破壊的に追加しつつforでループ処理するので、だいぶお行儀がよくない印象ですがいい方法が思いつきませんでした。
forEachを使うと、追加された要素を参照してくれなかったのでforで回しています。

ファイルの一覧を取得するコードの全体像はこんな感じ。
最終的にはfilesの配列にファイルオブジェクトが集まるので、ここに対してあれこれすればよい。
3重ループになっているので、ファイル取得部分を関数に分けるなどすればもう少し見やすくなるかなと思います。

const folderId= "xxxxxxxxxx";
const targetDir = DriveApp.getFolderById(folderId);
const files = []; // ファイルオブジェクトを保持する配列
const subFolders = [targetDir.getFolders()];

for(let i = 0; i < subFolders.length; i++) {
  const subFolder = subFolders[i];
  while(subFolder.hasNext()) {
    const folder = subFolder.next();
    subFolders.push(folder.getFolders());

    const fileIterator = folder.getFiles();
    while(fileIterator.hasNext()) {
      files.push(fileIterator.next());
    }
  }
}

フォルダの一覧の場合は、fileIteratorのループが不要で、subFolder.next()を配列に詰めればOK。
もっとこう書けばええやん、というご指摘等あればコメントいただければ嬉しいです。

まとめ

今回は、GASでGoogleドライブにあるとあるフォルダ配下にあるすべてのファイルを取得する方法をメモしました。
GASは結構機能が用意されているので、Googleサービスに対してやろうと思ったことは気軽に実装できそうな印象です。

ただし、GASには実行時間の制限などもあるので、この辺に気をつけて使いましょう。

Google サービスの割り当て | Apps Script | Google for Developers https://developers.google.com/apps-script/guides/services/quotas?hl=ja

今回は、ここまで。

おわり

【分かる方教えてください】GASで、スプレッドシートに入力した値と、現在の日（年・日時ではなく、「日」のみの値が合致しているかどうか）が同じであれば、チャットワークにその値を表示するというプログラムを作成しています。

2021-08-14T18:58:28+09:00

プログラム自体にエラーは出ていないのですが、スプレッドシートに「14」と入力しているけれど（本日の日と合致しているけれど）、
チャットワークにelseの値（15）がに表示されてしまうため、正しく日を拾えていないかと思います。
理由が分かれば教えていただきたいです。よろしくお願いします。

以下コード

===

function myFunction() {

//スプレッドシートの、特定の範囲を読み込む
var sheet = SpreadsheetApp.getActiveSheet();
var x = sheet.getRange(2,1).getValue();

//日付の定義（日を取得する）
var date = new Date
var day = date.getDate();
var yesterday = date.getDate(day-1);
var tomorrow = date.getDate(day+1);

//入力した日と条件が合致していれば、（CWに値を表示する）
if( x > yesterday && x < tomorrow)
{

x=x;

}

else{

x=x+1;

}

var client = ChatWorkClient.factory({token: '8314e1a8f4c4e0c5891d1d90f731e85b'});
client.sendMessage({room_id:100266334, body:x});

}

[GAS]SpreadSheetにカスタムメニューを追加して簡単なUIを作る

2021-02-10T11:54:19+09:00

はじめに

GASでカスタムメニューを追加するスクリプトについてです。

画像のようにスプレッドシートのメニューバー（ツールバー）の一番右に「カスタムメニュー」という項目が新しく追加され、クリックしたときの処理をカスタマイズすることができます。

今回カスタムメニューを作って実装する内容は「最終行へアクティブセルを移動する」というシンプルなものです。
例えば僕は特定のPC作業をしたときのログをスプレッドシートを作っているのですが、行数が増えてくると一番下までスクロールして入力するのが面倒になります。クリックするだけで一番下に飛べると便利だなーと思って作ってみました。

全体のスクリプト

まずは今回作成するスクリプトの全体像です。

スプレッドシートのコンテナバインドスクリプトを作り、以下のスクリプトを記述します。
その後、スプレッドシートのページをリロードすると、カスタムメニューが反映されるはずです。

// 現在のスプレッドシート
const SS = SpreadsheetApp.getActiveSpreadsheet();

// ファイルが開いたときに動作する処理
function onOpen() {
  SS.addMenu('カスタムメニュー', [
    {name: '最新行へ', functionName: 'moveToLastRow_'}
  ]);
}

// 最終行にアクティブセルを移動する関数
function moveToLastRow_(){
  const sheet = SS.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastRange = sheet.getRange(lastRow + 1, 1);
  SpreadsheetApp.setActiveRange(lastRange);
}

それでは作り方とカスタマイズの仕方を見ていきます。

1. onOpen()関数を作る

まずはonOpen()という名前で、ファイルが開かれたときに動作する関数を作っておきます。

// 現在のスプレッドシート
const SS = SpreadsheetApp.getActiveSpreadsheet();

// ファイルが開いたときに動作する処理
function onOpen() {
    // [TODO] カスタムメニューを追加する処理
}

SpreadSheetオブジェクトの定義も最初にしておきましょう。のちの関数でもこのオブジェクトを使うため、グローバルスコープに記述しています。

このようにonOpen()という名前で関数を作ると、ファイルが開いたときに動作する処理を作ることができます。トリガーを設定する必要などありません。
こういった特定のイベントが起こったときに処理を実行する関数を「イベントハンドラ」と呼ぶそうです。

2. メニューの選択肢を追加する

続いてカスタムメニューをクリックした時の選択肢を追加していきます。
スプレッドシートオブジェクトのaddMenu()メソッドを使い、先ほどのコードに以下のように記述します。

// ファイルが開いたときに動作する処理
function onOpen() {
    // カスタムメニューを追加する処理
  SS.addMenu('カスタムメニュー', [
    {name: '最新行へ', functionName: 'moveToLastRow_'}
  ]);
}

このaddMenu()の第一引数には、メニューバーに表示させる文字列を書きます。
ここでは「カスタムメニュー」としておきましょう。

第二引数には、追加したいメニューをオブジェクトの配列で書いてあげます。
このオブジェクトにnameとfunctionNameというプロパティを持たせることで、メニューに表記する文字列と、選択されたときに実行する関数名を指定することができます。

{name: '<メニューに表記する文字列>', functionName: '<関数名>'}

ここで指定する関数は後ほど作るので、現段階では実装予定の名前で大丈夫です。
ここではmoveToLastRow_という関数名を指定しておきました。

注意点としては、関数名には丸かっこをつけずに書くことです。
もし丸カッコをつけてしまうと、その関数が実行されて戻り値がfunctionNameの値に設定されてしまうことになります。今回は関数名を文字列として指定したいので、丸かっこをつけないで文字列リテラルで書くのが正解になります。

このaddMenu()の第二引数に指定するオブジェクトを増やしていくことで、どんどんメニューを追加することもできます（後ほど備考として記載します）。

3. メニューを選択したときに動作する関数を作る

最後に、先ほど関数名に指定したmoveToLastRow_()関数を新たに定義すればOKです。
ここでは現在のシートの「最終行の次の行の１列目」にアクティブセルを移動させています。

// 最終行にアクティブセルを移動する関数
function moveToLastRow_(){
  const sheet = SS.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastRange = sheet.getRange(lastRow + 1, 1);
  SpreadsheetApp.setActiveRange(lastRange);
}

アクティブセルの移動先を指定したい場合
もし移動させるセルを変更したい場合は、上のコードの5行目のgetRange()に渡す引数を変えてあげましょう。

const lastRange = sheet.getRange(lastRow + 1, 1);

例えば、現在のシートの「最終行の３列目」などとしたい場合は、次のようにカスタマイズすればOKです。

const lastRange = sheet.getRange(lastRow, 3);

以上で実装は完了です。
スクリプトを保存して、スプレッドシートを開いているページをリロードして少し待つと、カスタムメニューが追加されているかと思います。

備考

カスタムメニューの選択肢を増やしたい場合
onOpen()に書いたSS.addMenu()の中身のオブジェクトを増やしてみましょう。

function onOpen() {
    // カスタムメニューを追加する処理
  SS.addMenu('カスタムメニュー', [
    {name: '最新行へ', functionName: 'moveToLastRow_'},
    {name: 'マスタ転記', functionName: 'copyFromMaster_'},
    {name: 'ほげほげ', functionName: 'hogehoge'}
  ]);
}

配列の要素としてオブジェクトを追加していく形になるので、注意してくださいね。
構文エラー（SyntaxError）が出てしまう場合は、オブジェクトの書き方やカンマの有無など要チェックです。

スプレッドシートを開いたときに最終行に移動させたい場合
今回はカスタムメニューを使って最終行へ移動するスクリプトを書きましたが、ファイルを開いたときにアクティブセルを移動させるやり方でも良いかもしれません。
そうしたい場合は、onOpen()に直接今回のmoveToLastRow_()の中身の処理を書いてあげればOKです。
ただし、セル数にもよりますが起動が重くなってしまうかもしれないので、ご注意ください。

おわりに

カスタムメニューは、スプレッドシートを使っていて「ボタンをクリックしたら一括で処理するようにしたい」というような場合にシンプルなUIを作ることができて、とても便利です。
他にもスプレッドシートの関数で転記できるような作業でも、GASのカスタムメニューを使った実装をすることでシートを軽くしたりもできるので、よく活用しています。

その他の実装アイデア
- カスタムメニューを実行すると、マスターデータから必要な情報を探して一括で転記する（）
- シートでメール送信先リストを作り、カスタムメニューをクリックするとメールが一括送信されるようにする

農家だけど色々作ったので振り返る2020

2020-12-16T15:24:50+09:00

こちらの記事は Crieit のアドベントカレンダーなんでもの15日目の記事として、書かせていただきます。
（日付を間違えていて一日ずれての投稿になってしまったのは秘密です...）

はじめに

今年2020年は、本業の農業のかたわら色々なツール制作に取り組んできました。
仕事に活きるもの、生活に活きるもの、プログラミング学習に活きるもの、また作ったけど活かせなかったものなどなど。言語は主にGASとPython。
この機会に、ノンプログラマーがプログラミングを学んで作ったものを振り返って整理しておきたいと思います。

昨年からプログラミングをやっていて、今年の2月ごろにGASでちょっとしたプログラムで身近なことが便利になる、というのを知ってから、だいぶプログラミングが楽しくなったのを覚えています。

制作したもの

GASでのツール制作

（１）LINEbot：ゴミ出しリマインダ

練習のために作ってみた、家族で共有するためのbotです。燃えるゴミ・燃えないゴミなどの収集日の前日の夜にリマインダを飛ばしてくれる、というだけのもの。Messaging APIを使って実装し、放置していて今も動いています。

【GAS】家族で使えるゴミ出しリマインダ LINEチャットボットを作った - Crieit

（２）LINEbot：農作業記録アシスタント

こちらは２月ごろにかなり力を入れて制作した、LINE上で対話形式で作業日報を入力していくツールです。入力した内容はGoogleCalendarに登録されます。
Messaging APIを使いラインのトーク画面に表示できるリッチメニューの実装を学習。
LINEはITリテラシーが高くない一般の方々にも有用なツールだと実感します。

ただ、このbotを興味持ってくれた人数名にテストユーザーになってもらうためセッティングしたのですが、使用のハードルはやはり高そうだなーという印象でした。そもそも「日誌はアナログで取っており基本的に満足している」というところに刺さっていくのは、素人の思いつきでは厳しいものがあるんだろうな、と思います。ツール制作にこだわらず、別のアプローチが必要です。

個人的にもこちらは現在運用はしておらず、農作業の記録はアグリノートという既存のサービスを活用しています。

GASで「農作業記録アシスタント」LINE bot作った（紹介編） - Crieit
GASで「農作業記録アシスタント」LINE bot作った（技術・設計編） - Crieit

（３）Gmail添付ファイル保存ツール

業務資料を整理するため制作。農協からの情報の多くはFAXで送られてきますが、その内容がpdfファイルでメール添付でGmailに添付されて送られます。その添付ファイルをDriveに保存する作業を自動化しようと思って着手。
４月に主にネット情報をもとにコピペで制作し、バグが出て放置していたものを、現在は言語を学び直しながら改善中です。Driveにファイル名によりフォルダ分けして格納し、個人で使ってるSlackへ通知とリンクが送られるようにもしてみました。

Pythonでのツール制作

（１）LINEbot：共同作業グループ用の作業時間記録・集計ツール

７月に制作。初めて他者に使ってもらって良い評価をもらった、満足度の高いツールです。
自分の所属している地域の共同作業グループで使うための入力支援ツールをMessaging APIを使って作りました（LINE大好きすぎる）。

サーバーとしてHerokuを利用（正しい表現かちょっとわからない）。入力データはDB代わりにSpreadsheetと連携しています。シート操作のライブラリはgspreadを使いました。クラウドサーバにデプロイ時のライブラリ依存周りの設定、Spreadsheet設定でOAuth認証情報をクラウドサーバの環境変数に入れるというような部分がなかなか難しかった記憶です(そもそも環境変数とは、の段階からではありました)

現場では作業した人が、LINEで作業開始・終了の時間をタップだけで入力できて、後から時給計算する際もLINEで集計結果が返ってくるようになっています。これまで紙で管理して電卓で集計していたのが、相当楽になりました。
グループでの作業は年に１回、収穫時期が来れば必ず必要になる作業なので、LINE botも毎年改善しながら運用を続けていきます。

業務で活用するLINEbot制作にあたって意識した事｜Massa｜note

（２）卸売市場価格を取得するためのスクレイピングツール

ノンプロ研で受講したPython講座きっかけで、Seleniumを使ったWebサイトのスクレイピングに取り組みました。作っている農産物の価格動向を毎日見られるようにしたいなと思いました。

７月、まずは初めはpdfのダウンロードをしてDropboxへ入れるだけのツールを制作しましたが、ダウンロードしっぱなしで全然活用できず。
次に１１月には収集する対象を市況データのまとまった別のWebサイトに変更し、その日の欲しい市況データをSpreadsheetに入れる & 自分のSlackへ送信、というもの。

定期実行には、Windowsのバッチファイルとタスクスケジューラを使用してローカルで実行する方法、クラウドのHerokuに上げてHeroku Scheduler を使用する方法を試しました。ローカルの方がセッティングは楽ですが、PC起動時にしかスクリプトが動かせないというデメリットがあります（やりようはあるのかな？）。クラウドはデプロイができれば任せっきりで楽ですが、HerokuでSeleniumを動かす設定に一手間かかりました。一長一短で、習得コストも考慮して運用方法は考えなければなあと学習。

こちらは今後、Slackに送られてくるデータをもっと見やすいように工夫したいです。

（３）楽天市場の価格調査

卸売価格からのアプローチだけでなく、直販価格からのアプローチもしてみたくて取り組み。
９月は統計に興味が向いていて、Pandasの扱い方を覚え、データの収集と加工、価格分析の基礎的なところをやってみました。

楽天商品検索APIで特定のキーワードに合致する商品情報を取得する
取得したデータを使える形に加工して分析する

統計学的な難しいことはわからないのですが、最終的に平均値・中央値などの簡単な統計量を算出し、価格が重量に線型近似していることを確かめ、平均的なキロ単価を算出することができました（正確では無いかと思いますが、参考程度には十分な数値だと思います）。

現場の人間がデータを扱うには、ExcelやSpreadsheetなどの表計算ソフトの扱いに慣れているかどうかが大事だなと思いました。「データ分析＝Python, Pandas」みたいなイメージを持っていましたが、それよりも「何を目的としてやるか」があり、そのために「どのツール（手段）でやるか」という考え方で、習得コストのかからないやり方を選ぶのも大事なんだろうなと思います。

こちらは農産物のネットショップ開設のための価格調査に直結したので、ひとまず成果につながった分析だったかなあと思っています。

Python農家のITマーケティング試行錯誤日記1.楽天商品検索APIを使って商品情報をcsv出力する - Crieit
Python農家のITマーケティング試行錯誤日記2.商品情報の収集とデータ加工を行う - Crieit
Python農家のITマーケティング試行錯誤日記3.商品価格の集計と分析を行う - Crieit

⬇️商品「メークイン」の箱の重量(kg)と価格の中央値(円)の関係

⬇️近似曲線から商品「メークイン」のキロ単価を計算

（４） GUI付きテキストファイル作成ツール

自分用に開発作業のログを残すのを便利にするために作りました。Python標準ライブラリのtkinterを使ってGUIを作って、プルダウンを選びボタンを押すと選んだ内容に応じたテンプレートが入ったテキストファイルが作成される、という仕組みです。またちょっとマニアックなこともトライしていて、同じく標準ライブラリのsubprocessを使って、ボタンを押すとGithubへプッシュするコマンドを実行するようなコマンド操作も学習しました。
作成したPythonスクリプトはpyファイルにしてデスクトップに置き、ダブルクリックで実行できるようにしています。

こちらは現在も運用中です。

（５）PDF文字抽出ツール／自炊用PDF結合・加工ツール

PythonでPDFを扱うPyPDF2、文字抽出にはpdfminerというライブラリを使用。講座のPDFテキストを特定の文字があるページだけ画像化する…ということをしています。いくつかPDFファイルを触ってみたのですが、PDFファイルの文字を扱うのは一般的には難しくて、自分で作ったファイルなら良いけど、既存のPDFを扱うのはあまり考えない方が良いかな…と思いました。
また最近書籍の自炊をしているとPDF結合や分割をしたくなったので、短いコードを作ってJupyter Notebook上で実行できるような、ちょっとした便利コード集みたいなものも、スキャン中の時間を生かして作りました。笑

慣れるとこういうちょっとしたツールがすぐにできる、というのがPythonの良いところだなあ…。
PDF操作に便利なコード集も整理して記事にしておきたいです。

PythonPDFから特定の文字列を抽出＆ページを画像として保存するツール - Crieit

おわりに

アウトプットとしてはこんな感じでしょうか。かなり作ったんだなあ…。
こうやって振り返ってみると、設計時点の反省点が明確に見えてきたり、「もう少しこう改善したいというのも整理されて良いなと思いました。

制作の動機が自分自身のために向いているものが多く、勉強ために作ったようなものもあります。
別に悪いことでないのですが、どうしても「作る」のが好きでそこに拘ってしまうことがあり、おかげで機能がコテコテになってしまったり、メンテナンス性の悪いスクリプトになっている気がします。

一方で振り返って良い点としては、LINEやSlackで情報を受け取るような明確な「アウトプット」が見られるツールの作り方を習得できたことです。外作業が多いと「スマホで見られる」というのも重要に感じます。

今後作っていきたいもの

必ずしもツール制作だけじゃなくて既存のデータの「整理」というのがキーワードなのですが、ざっくり

農場データの整理（クラウドの利用）
既存のサービスの活用（農作業日誌、温度etc....csvファイルの活用や部分的な自動化・可視化）
現場で使えるツール（どこを改善したいか？誰のため？）

技術的にも興味のあるものにもっと取り組んでいきたいのですが、来年はまたもうちょっと広い視点で農業経営に役に立つ・農村地域や人の役に立つツールを作れたらな、と思います。
IoTを活用してデータを蓄積できるような環境も作ってみたいです。

勉強の幅がプログラミング以外にも広くて、どこに集中して勉強していけば良いか…。楽しく頑張ります。

[GAS][Javascript]指定の年月の「第n d曜日」を配列で取得する

2020-12-11T23:10:59+09:00

はじめに

GASでのゴミ出しリマインダ用に「第n d曜日」を計算するアルゴリズムを作りました。
面白かったので、まとめておきます。

考え方としては、

（１）指定した年月の「d曜日」をすべて配列で取得する
（２）その配列から「第n d曜日」だけを抜き出して配列で取得する

という順番で実装していきます。

特にDate型の扱いと、配列メソッドの使い方が勉強になりました。
配列メソッドは、配列に要素として含まれているかどうかをブール値で返すincludes()メソッドと、配列の要素のうち引数に指定した関数をみたすものだけを配列として取り出すfilter()メソッドあたりの理解がミソになるかと思います。

このあたりの練習問題としても、やってみたい方は是非おすすめです！

（１）指定した年月の「d曜日」をすべて配列で取得する

まずは、指定した年月の指定した曜日の一覧を配列で取得してみたいと思います。
例えば「今月の水曜日」と指定してやると、2020年12月の水曜日に該当する

第1水曜 2020/12/2
第2水曜 2020/12/9
第3水曜 2020/12/16
第4水曜 2020/12/23
第5水曜 2020/12/30

これらをDate型の配列という形で作ってみよう、という訳です

「変数date = 今日の日付（Date型）」と「変数day = 取得したい曜日（数値）」を指定して、目的の配列を作ってみたいと思います。

GAS（Javascript）のDate型では、0が日曜日、1が月曜日…、6が土曜日に対応しています。

const WEEKDAYS = ['日', '月', '火', '水', '木', '金', '土'];
今回は必要ありませんが、こんな定数を用意しておくと、今後なんか活用できる機会があるかも？
「あれ、0は日曜だっけ？月曜だっけ？」という備忘のためにスクリプト内に記述しておいても良いかもしれません。

今回は「水曜日」が欲しいので、day = 3としてみます。

スクリプトは以下の通りです。

function mainFunction() {
  const date = new Date(); //今日の日付
  const day = 3; //水曜日

  const year = date.getFullYear();
  const month = date.getMonth();

  const days = [];

  for (let i = 1; i <= 31; i++){
    const tmpDate = new Date(year, month, i);

    if (month !== tmpDate.getMonth()) break; //月代わりで処理終了
    if (tmpDate.getDay() !== day) continue; //引数に指定した曜日以外の時は何もしない
    days.push(tmpDate);
  }

  console.log(days);
}

上のgetDays()関数を実行してログを確認してみると、「2020年12月の水曜日」を配列で得ることができます。

[ Wed Dec 02 2020 00:00:00 GMT+0900 (日本標準時),
  Wed Dec 09 2020 00:00:00 GMT+0900 (日本標準時),
  Wed Dec 16 2020 00:00:00 GMT+0900 (日本標準時),
  Wed Dec 23 2020 00:00:00 GMT+0900 (日本標準時),
  Wed Dec 30 2020 00:00:00 GMT+0900 (日本標準時) ]

こちらの記事を全力でパクらせていただきましたw
etau the non programmer coder — GAS特定の月の特定の曜日を取得する

関数に切り分ける

こんな感じでgetDays()関数に切り分けて、再利用しやすいようにしてみました。
mainFunction()内で日付と曜日を指定して実行すると、同様の結果が得られます。

function mainFunction(){

  const date = new Date();
  const day = 3; //水曜日

  const days = getDays(date, day);
  console.log(days);
}


/*
*その年月のd曜日を取得する関数
* 
* @param {Date} date - 調べたい年月の日付（Date型）
* @param {number} day - 取得したい曜日を表す数値(0:日曜日〜6:土曜日)
* @return {days} ある年月のday曜日の日付の入った配列
*/
function getDays(date, day) {
  const year = date.getFullYear();
  const month = date.getMonth();

  const days = [];

  for (let i = 1; i <= 31; i++){
    const tmpDate = new Date(year, month, i);

    if (month !== tmpDate.getMonth()) break; //月代わりで処理終了
    if (tmpDate.getDay() !== day) continue; //引数に指定した曜日以外の時は何もしない
    days.push(tmpDate);
  }

  return days;
}

（２）その配列から「第n d曜日」だけを抜き出して配列で取得する

いくつかアプローチが考えられます。

・先ほど作った「d曜日」を返すgetDays()関数を加工して「第n d曜日」の配列を返す関数を作る
・メイン関数mainFunction()の中で配列daysを加工して「第n d曜日」の配列を作る

後者のやり方でシンプルにできます。
新たに変数weeksを定義して、配列で欲しい週を指定してあげます。
（隔週に限らず、欲しい番号を指定してみましょう）

function mainFunction2(){

  const date = new Date();
  const day = 3; //水曜日
  const weeks = [2, 4]; //第2週目、第4週目 を指定


  const days = getDays(date, day);
  const specifiedDays = days.filter((v, i) => weeks.includes(i+1));
  console.log(specifiedDays);

}

スクリプトの中身については、後ほど文法の説明とともに（ちゃんと説明できてるかどうかわからない）解説を載せておきます。
この関数を実行してログを表示すると、指定した第２・第４水曜日だけの配列ができています。やったね！

[ Wed Dec 09 2020 00:00:00 GMT+0900 (日本標準時),
  Wed Dec 23 2020 00:00:00 GMT+0900 (日本標準時) ]

備考

weeksに0, 10などのあり得ない数値を入れてやっても、特に不具合が出ることなく、該当する数値のみをとった配列が出来上がるようです。
これを利用すると、例えばweeks = [1, 3, 5]などと指定しておけば、5週目のあるなしに関わらず欲しい配列が手に入りますね。

また、この「第n d曜日」を配列にする処理も他の関数に切り分けて作ってはみましたが、あまりその関数を頻繁に使う機会が思い浮かびませんでした。。。
なので、今回作ってみたスクリプトとしてはここまで。

解説：配列のincludes()とfilter()メソッドの活用

GAS（Javascript）の文法について。知っていたら飛ばしてください。

ポイントはこの１行。

const specifiedDays = days.filter((v, i) => weeks.includes(i+1));

ちょっとよくわかりませんね。

先に、今回使う配列のメソッドの最低限の使い方だけ整理しておきます。

メソッド	説明
arr.filter()	配列arrの要素のうち、引数に指定したをみたすものだけを抽出した配列として返す
arr.includes()	引数に指定したが配列arrに含まれているかどうかをブール値で返す

さて...先ほどの１行は、全体の構文としては
const specifiedDays = days.filter(なんかの関数);

という構造になっています。
この構造だけみると実はシンプルで、specifiedDaysという配列に、先ほど作った指定した曜日が全部入った配列daysからfilter()メソッドで「なんらかの処理」をして要素を抽出した配列を返していることになります。

この「なんらかの処理」というのが、filter()メソッドの引数に指定した関数です。

(v, i) => weeks.includes(i+1)

こいつは「アロー関数」という関数リテラルの書き方ですね。
矢印の左側が仮引数、右側が具体的な処理です。
（仮引数v, iはvalue, indexに相当します）

ざっくり「weeksで指定した数値がインデックス担っているものだけ、daysから要素を抽出している」というような処理になっています。

今回の場合はこれにより第2、第4曜日だけをdaysから抽出して、specifiedDaysを作っています。

おわりに

飲み会から派生したネタでした。
実用的かつ気になっていた配列のメソッドを扱う、とても良い練習になりました。
メソッドの解説のあたりはだいぶ飛ばしてしまっているので、もう少しうまく説明できないかな…。思いついたら修正してみます。

MEMO

参考記事
etau the non programmer coder — GAS特定の月の特定の曜日を取得する

参考書籍（pp202-213　配列を取り扱う - Arrayオブジェクト）
Amazon.co.jp：詳解! Google Apps Script完全入門第2版 ~GoogleアプリケーションとGoogle Workspaceの最新プログラミングガイド: 高橋宣成: 本

浜辺美波が日報を投稿してくれるSlackコマンドをつくりました

2020-04-15T12:01:05+09:00

私は日報を忘れてしまう人間です。
もう少し正しく言うとめんどくさく思ってしまう人間です。

今日閉じたIssueと取り組んでいるIssueを全部コピペしてきたりとか。

今働いているチームのSlackには #nippo チャンネルがあり、メンバーはみんなここにその日やったこととかを投稿しています。

今回つくったのはそんな毎日の日報をもう少し楽ちんにして、本質である"振り返る"という行為だけに留めたいと言うものです。
言い換えると何をやったかは自動で出力できるようにしたい。

その名も「浜辺美波」です。

/nippo 今日は足が冷えて冷えて大変でした。

とうつと#nippoにこのように投稿してくれます。

仕組みとしてはSpreadSheetにそれぞれのメンバーのSlackのユーザーIDとGitHubIDを保存してあり、GASでSlack commandから送られてくるユーザー情報と照会してGitHubから関連のIssueを取得してきています。
GitHub GraphQL API初めて使いましたが便利すぎてびっくりしました。Explorerが本当に便利。

function doPost(e) {
  var spreadsheet = SpreadsheetApp.openById('SpreadSheetのID');
  var sheet = spreadsheet.getActiveSheet();

  var username = e.parameter.user_name;
  var comment = comment = e.parameter.text;
  var row = findRowForSlackUsername(sheet,username);
  var githubId = sheet.getRange(row, 2).getValue();
  var freeeId = sheet.getRange(row, 3).getValue();

  if(comment.length === 0) {
    return ContentService.createTextOutput("⚠️`/nippo 振り返りコメント`の形式でコメントも書いて！");
  }

  if(githubId.length === 0 || freeeId.length === 0) {
    return ContentService.createTextOutput("⚠️あなたのアカウント情報がまだちゃんと用意されてないみたい。超絶イケメンなimjnに聞いてみて！");
  }

  var resForClosed = fetchIssues(githubId, "closed");
  var resForWIP = fetchIssues(githubId, "open");
  var closedIssues = JSON.parse(resForClosed.getContentText()).data.search.edges;
  var wipIssues = JSON.parse(resForWIP.getContentText()).data.search.edges;
  var issuesClosedToday = getIssuesClosedToday(closedIssues);
  var outputString = `今日もおつかれさまでした。 ${githubId}の日報です💙\n\n`;

  outputString += `💪 *今${githubId}が取り組んでいるIssue* ↓\n`

  if(wipIssues.length > 0) {
    var wipIssueString = "";
    for(var i=0;i ${githubId}がアサインされているタスクはありません。タスク待ち！`;
  }

  outputString += `\n\n🤗 *今日${githubId}がCloseしたIssue* ↓\n`

  if(issuesClosedToday.length > 0) {
    var issueString = "";
    for(var i=0;i ${githubId}が今日CloseしたIssueはありません`;
  }

  outputString += `\n\n✍️ *振り返りコメント* ↓\n`

  outputString += '```' + comment + '```';

  const webhookUrl = "Slackのwebhook URL";
  const data = { 
    'attachments': [{
      'color': '#0086CC',
      'text' : outputString,
    }]
  };

  const payload = JSON.stringify(data);
  const options = {
    'method' : 'POST',
    'contentType' : 'application/json',
    'payload' : payload
  };

  UrlFetchApp.fetch(webhookUrl, options);
  return ContentService.createTextOutput("#nippoに投稿したよ！❤️");
}

function findRowForSlackUsername(sheet,val){
  var lastRow=sheet.getDataRange().getLastRow();

  for(var i=1;i<=lastRow;i++){
    if(sheet.getRange(i,1).getValue() === val){
      return i;
    }
  }
  return 0;
}

function fetchIssues(githubId, status) {
  const query = 
'query {\
   search(last: 10, query: "org:オーガニゼーションID is:issue is:' + status + ' assignee:' + githubId + ' sort:updated-desc", type: ISSUE) {\
     edges {\
       node {\
         ... on Issue {\
           title\
           url\
           closedAt\
         }\
      }\
    }\
  }\
}';

  const option = buildGraphqlRequest(query);
  return UrlFetchApp.fetch("https://api.github.com/graphql", option);
}

function buildGraphqlRequest(graphql) {
  return {
    method: "post",
    contentType: "application/json",
    headers: {
      Authorization: "bearer GitHubのアクセストークン",
    },
    payload: JSON.stringify({ query: graphql }),
  };
}

function getIssuesClosedToday(issues) {
  var now = new Date();
  var closedIssues = [];
  for(var i=0;i



せっかくfreeeも使ってるのでまた時間がある時に勤務時間とかも含められるようにしたいと思います。

今月中に旅行領域で新規プロダクトを出します。こんなご時世ですが、がんばる。



GAS & LINE messaging APIの学習便利帳
2020-02-27T23:28:56+09:00
はじめに

ノンプログラマの僕がGAS（Google Apps Script）とLINE messaging APIを活用したツールを制作するにあたり、全くよくわからない状態から何となくそれらしいものが作れるようになるまでに学習した、主な教材とブログをまとめておきます。

これからGASを習得したい！ LINE botを制作したい！ という方の情報収集の参考にしてもらえたら嬉しいです。

（１）GASの習得のために

Udemy教材

●ビジネスパーソンに贈る業務効率化大全 〜Google Apps Scriptによる業務の自動化〜 | Udemy

もはやGAS入門の決定版と言いたい。実際に業務効率化にすぐに活用できるスクリプトを書きながら、GASの基本から段階を追って体系的に習得できます。

とても解説がわかりやすいし、一通りの必要な操作（Googleカレンダー、Googleフォーム、Googleメール、LINEやSlackへの通知、スプレッドシート・ドキュメントの扱いなど）を実戦形式で学べます。

最後は駆け足ながらGASでのWebスクレイピングの講座もあるので、これを足がかりにもっと深く学びたくなりました。

ブログ

●いつも隣にITのお仕事 | 毎日の業務が楽チンに！

書籍「詳解！GoogleAppsScript完全入門」の著者さま。こちらも基本から解説してくれていて文章がとてもわかりやすく、コードだけでなくプログラミング共通の基本の考え方に通じる学びがあります。

作業をしていると「GAS + やりたいこと」「Javascript + やりたいこと」で検索して解決することが多いのですが、その際によくヒットしてきます。

GASのPropaty Serciceで秘匿情報を隠すという考え方と実際のやり方はこちらで学びました。この初心者向けGASのシリーズで体系的にGASを学ぶことができるのも面白そうです。

ちなみに僕は次にこちらに連載されている「Gmailの添付ファイルをGoogleドライブに自動保存する」というツールの作成に挑戦してみようと思っています。

→ 【初心者向けGAS】プロパティストアの概要とスクリプトプロパティの編集方法

→ Google Apps ScriptでGmailの添付ファイルをGoogleドライブに保存する

（２）GASでLINE messaging APIを操作するために

Udemy教材

●はじめてのLINEBOTの作り方　秘書ボットを作ろう | Udemy

こちらはGASでLINE botを制作するプロセスを学べる講座。

コードの解説ももちろんありますが、それよりも初めてLINE botを作る際にサンプルコードを活用して「動くものを作って流れを体感する」という部分でとても勉強になりました。

基本の「おうむ返しボット」（ユーザーがLINEで投稿したメッセージをそのまま返答する）からスタートして、Googleカレンダーと連携して予定を追加したり毎日決まった時間に予定をLINEに通知してくれる「秘書ボット」を作成するという講座。作成したボットはそのまま自分でも活用しています。

僕はLINE bot制作にあたってこの講座を一番最初に学んだのですが、それによりLINE messaging APIの動きを体感することができました。

細かいコード部分はこの講座だけだと理解が難しいのですが、作りたいものを作っていく過程で改めてこのサンプルコード読み解いていくという作業を行いました。

GASのCache Serviceというものを利用してLINE botの処理を分岐する方法はこの講座で知ることができました。

ブログ

●30歳からの「くら」のブログ

LINE messaging APIをGASのコードに落とし込むための書き方をだいぶ参考にしました。

特に「日時選択アクション」「クイックリプライ」「テンプレートメッセージ」などを使うためのシンプルなコードが紹介されているので、公式ドキュメントだけだとどうGASで書いたら良いかわからなかったものも実際にコードに落とし込むことができます。

●HASEKATSU｜note

GAS + LINE botに特化して数年にわたり独学を続けてきた血と涙と汗の結晶を感じます！

これまでに学んできた大量のコードを公開＆販売しつつ、noteの記事では惜しみなく実際のコードと積み上げてきた情報を出して解説しています。フレームワーク的なものも自作していてやばい。これからも楽しみです。

今回何よりも僕が助かったのが、リッチメニューをLINE公式アカウントからではなくLINE messaging APIを使ってGASのスクリプトで実装するやり方です。これは他にほとんど情報がなく、大いに頼ることになりました。

またCoconaraでのサービス提供の実績もあり、実践的に色々試行錯誤している姿勢を僕も学んでトライしていきたいと思います。

→ Postmanでリッチメニューを設定する方法【LINE Messaging API×GAS】｜HASEKATSU｜note

→ GASでLINE Messaging APIのリッチメニューオブジェクトをGoogleスライドから作成する【実戦GoogleAppsScriptプログラミング講座～天空闘技場～】｜HASEKATSU｜note

→ GASでLINE Messaging APIのリッチメニュー画像を反映させる【実戦GoogleAppsScriptプログラミング講座～天空闘技場～】｜HASEKATSU｜note

おわりに

以上です。

入門（何も知らない段階）〜初級（基礎を理解する段階）〜中級（実際に制作する段階）に到るまで、これらの教材とブログ記事で学べばかなりいいところまで行けると思います。

自分がこれまで学ばせていただいた感謝の意も込めて。ありがとううう（そしてこれからもよろしくお願いします）


【GAS】コードにAPIトークンやIDのベタ書きを避ける！（プロパティサービスの活用）
2020-02-11T00:26:28+09:00
はじめに

GASでの開発でGithubリポジトリと連携する方法について書きましたが、リポジトリにプッシュする前に、一般に公開しないほうが良い情報が入っていないか気をつける必要があります。例えば、


APIトークン
メールアドレス
なんかのパスワード
特定のIDやURL


これまでコードにLINE messanger APIのチャンネルアクセストークンや自身のメールアドレス、LINEのIDなどをベタ書きしており、Githubのリポジトリにアップする際にどうするのが正しいのか悩みました。リポジトリをprivateに設定すれば大丈夫かな？とかやってみたんですが、なんか落ち着かないしスマートじゃない気が。

調べてみると、どうやらGASでは「プロパティ」として公開したくない情報を管理できるやり方があるようです。

またメンターさんに教えていただいたところによると、一般的には秘匿情報を


プロパティファイルに記述する
環境変数に入れる


とするのが対策になってくるようです。どの言語でも関係なくこの考え方は理解しておく必要がありそうですね（個人の趣味レベルでもセキュリティ意識は大事だと思う）。

というわけで今回はGASのプロパティサービスを活用することで対応してみたので、それについてまとめてみました。

GASのプロパティサービスとは

イメージ


APIトークンやメールアドレスなど一般に公開したくない情報をコードに書く必要がある！
そんな時にコードにこれらの情報をベタ書きせず別の場所（プロパティストア）に入れておいて、コードではそこから情報を取り出す命令だけ書いておく（プロパティサービス）。
これによって隠したい情報を見れないようにして安全に管理できるよ！

用語

ざっくり解説

プロパティストア

IDなどの公開したくない情報を格納しておく場所のこと。情報に名前をつけて格納しておくことができる。権限がないと中身を見ることはできない。

プロパティサービス

プロパティストアに格納した情報をGASスクリプトから取り出したり編集したりすることができる仕組み。PropatiesServiceやPropertiesなどをコードに書くことで色々できる。


誤解を恐れずわかりやすさ重視でまとめるとこんなイメージです。

（詳細は参照リンク１がとてもわかりやすく大いに参考にさせていただきました）

ちなみにプロパティストアにも「スクリプトプロパティ」「ユーザープロパティ」「ドキュメントプロパティ」と３種類ありますが、詳しくはここでは割愛。初めのうちは「スクリプトプロパティ」だけを考えて大丈夫でしょう。

実装手順

具体的に実装してみます。とってもかんたん。

１．問題のコード

例えばこういうコード。

var ACCESS_TOKEN = "hogehoge1234......";
var calendar = CalendarApp.getCalendarById("hogehoge");


このAPIトークンの中身（hogehoge1234......の部分）はGithubに公開したりブログに書いちゃったりすると誰かに使われてしまう可能性がありそうです。

またカレンダーID（hogehoge）も個人情報なので出来れば隠したいですね。

２．プロパティを登録する

詳細は参照リンク１を参考に。

（１）GASのスクリプトエディタのメニューで、「ファイル」＞「プロジェクトのプロパティ」を開く

（２）「スクリプトのプロパティ」タブを選択

（３）「＋行を追加」をクリック

（４）左の欄に値を取り出す時に使う名前（キー）、右の欄にAPIトークンなどの値を入れて「保存」をクリック



この名前の付け方は何でも良いのですが、一目で何を意味しているのかわかる名前にするのが良いですね。

ここでは「アクセストークン」と「カレンダーID」をそれぞれ登録しておきましょう（参考画像はちょっと違うプロパティを登録してますがすんません）。

※（余談）変数に使用する記号やキャメルケースorスネークケースなどあるので、一貫した命名規則を簡単に学んでおくと名付けで迷うことが無くなるかと思います。

僕はJavascriptの命名規則の一つとしてざっくり「変数名はキャメルケース」「定数名はスネークケース」と学んだので、今回のプロパティは定数と考えてスネークケースで名付けてあります（詳しくは調べてみてね）。

３．登録したプロパティをコードに記述する方法

詳細は参照リンク２を参考に。

プロパティストアの登録が終わったら、問題のコードを書き換えてみます。

var ACCESS_TOKEN = PropertiesService.getScriptProperties().getProperty("ACCESS_TOKEN");
var calendar = PropertiesService.getScriptProperties().getProperty("CALENDAR_ID");


最初のコードと全く同じ内容になるのですが、うまく情報を隠して記述することができました！

ただこれだと少し冗長なので次のようにスッキリと書くこともできます。

（プロパティが２つだけだと余計長くなってる感じですが…。プロパティを複数使う場合はだいぶスッキリするはずです）

var prop = PropertiesService.getScriptProperties().getProperties();

var ACCESS_TOKEN = prop.ACCESS_TOKEN;
var calendar = CalendarApp.getCalendarById(prop.CALENDAR_ID);


解説・補足

最終的に書き換えたコードの解説をざっくりとしてみます。

var prop = PropertiesService.getScriptProperties().getProperties();


まずプロパティサービスを使うためには、PropertiesServiceというクラスを使用します。

次にgetScriptPropertiesというメソッドを使用して、プロパティストアに登録したスクリプトプロパティ達を取得します。そこからgetPropaties()というメソッドを使うことで、変数propにオブジェクトとしてプロパティ達をセットしています。

（このpropには登録したプロパティ（キーと値のセット）が全部入っている、というイメージですかね）

var ACCESS_TOKEN = prop.ACCESS_TOKEN;
var calendar = CalendarApp.getCalendarById(prop.CALENDAR_ID);


登録したAPIトークンやIDなどの値を実際に取り出すには、先ほど用意したprop変数を使ってprop.キー名という形で自由に取り出すことができます。やったね！

クラスやメソッドは色々あるので、詳しくは公式ドキュメントを参考に。

なかなか初学者の方にとっては慣れるまではドキュメントの見方が分からず難しいかと思うので、少し慣れた段階や詰まった時に見るようにするといいかもしれません。僕もまだ苦手です。

Properties Service  |  Apps Script  |  Google Developers

あとがきMEMO

どうしても独学ベースだと、セキュリティ面まで意識するのってなかなか難しいんじゃないでしょうか（自分だけ？）

今回のような「秘匿情報を別の場所に格納しておく」という視点は当たり前のことなのかもしれませんが、調べていて目からウロコでした。

今回具体的なGASのプロパティサービスの使い方を書きましたが、それだけに限らない大事な視点だなーと思ってまとめてみました。抽象的な概念と具体的な使い方をセットで覚えておくと理解が深まりますね。

参考にしたサイト


参照リンク１

【初心者向けGAS】プロパティストアの概要とスクリプトプロパティの編集方法
参照リンク２

【初心者向けGAS】スクリプトプロパティを操作してそのデータを取り出す方法
GAS公式ドキュメントのProperties Servise

Properties Service  |  Apps Script  |  Google Developers



テキストエディタとGitHubでコード管理できるGAS開発環境を作る
2020-02-04T12:25:53+09:00
はじめに

GASでの開発に取り組む中で、コードをテキストエディタで書き、Githubで進捗を管理したいなと思いました。

普通にGASで開発する場合は、ブラウザからGoogleDriveのスクリプトエディタを起動してその中でコードを記述します。

このブラウザ上で簡単に書けてすぐに実行できるという開発環境いらずなのがGASの良いところなのですが、

このコードをローカルのテキストファイルとして作り、Githubを使って管理できたら良いなあと思ったわけです。

僕の場合は

- 以前に書いたコードと見比べたい時に、テキストファイルだと参照しやすい

- Githubにコードを残してポートフォリオやメンターの方と共有したい

- 以前Githubのプルリクを使って開発する流れを教わったので活用したい（行き当たりばったりの開発にならないように）

そんなところから自分のやりやすいように開発環境を作ってしまえと考えてやってみた結果、

1. VSCodeでコードを作成・修正してGithubにpush

2. GASのscriptエディタでそれをpullして実行

3. 1に戻ってデバッグ

という流れで作業をすることができるようになり、

例えば学習教材から学んだサンプルコードと見比べて吟味したりコピペしたり学びながらコードを書くのがとても便利になりました。

正直この開発環境がベストプラクティスかどうかは怪しいですが、ノンプログラマの僕が最低限の使い方ができれば良し！という感じでやっています。

同じく最低限で使えれば良いよーという方は参考にしてみたらいただけたら嬉しいです。

また、もっと良いやり方があるよーというのがあれば教えていただけると嬉しいです。

この記事の対象者


GASを既に使っている方
gitやGithubの基本的な使い方もある程度理解している方


使用ツール等


Google Chrome（ブラウザ）
VSCode（テキストエディタ）
Github

　

GASでのgithubとの連携にはChrome拡張機能を使用します。

前提として、以下のアカウント登録やインストールなどは先に済ませておきます。それぞれのやり方はここでは割愛。
Githubのアカウントは登録済み
GitをPCにインストール済み（$ git --versionでバージョンが出ればOK）


開発環境づくり

１．プロジェクトフォルダとファイルの作成

これから制作するプロジェクトのフォルダと、コードを記述するファイルを作っておきます。

プロジェクトフォルダはどこに作っても大丈夫です（試しに作るならデスクトップで良いでしょう）。

そしてその中にmain.jsという空のテキストファイルをjs拡張子で作成しておきます。

（実際には拡張子は.gsなんですが、ここは.jsに。理由は後ほど）

※（余談）プロジェクトフォルダの名前や保存先は自由に決めて問題ないですが、あまり階層を深くしないのと、プロジェクトは一箇所（僕の場合はDocuments/Projects）にまとめておき、その中にプロジェクトごとにフォルダを作るのが便利かなって思います。

２．ターミナルでgitの初期設定とGithubとの連携

ここから、参照リンク１を大いに参考にさせて頂いてます。

ターミナル（Mac）を起動してコマンドを打ち込んでいっても良いのですが、せっかくなのでVSCodeのターミナル機能を使ってみます。

VSCodeを開いたら、「表示」タブから「外観＞パネルを表示＞ターミナル」もしくは「ターミナル」タブから「新しいターミナル」で開けます。これでターミナルも別窓にならないのでとても便利。



さて、このターミナルにコマンドを打ち込んでいって、先ほど作成したプロジェクトフォルダに入ります。

フォルダを作った場所によって違いますが、僕の場合はDocuments/Projects/（プロジェクト名）がプロジェクトフォルダなので、

$ cd Documents
$ cd Projects
$ cd （プロジェクト名）


次にgitの初期化を行い

$ git init


GitHubとの連携のための初期設定を行っていきます。

$ git config --global user.name "ユーザー名を入力"
$ git config --global user.email "メールアドレスを入力"


ダブルクォーテーション（""）の中には、自分のGithubにアカウント登録しているユーザー名とメールアドレスを入力するようにします。エラーが出ないようなら成功。

３．Githubでリポジトリ作成

GitHubにログインしてNewボタンからリポジトリを作っておきます（ここでReadMeを作っておくと良いようですが僕はすっ飛ばしてしまいました）。

リポジトリが完成したら、とりあえずHTTPSを選択（下の画像の赤丸）

…or push an existing repository from the command line

の下の２行のコマンドをコピーしておきます。一番右のマークをクリックしたら一発でコピーできます。

（下の画像の赤四角の部分）



※（余談）ほんとはSSHを選択して鍵の作成や設定をしておくと安全だったりするっぽいのですが今回はHTTPSで。もうちょっと勉強しておきます。

４．リモートリポジトリの登録・コミットとプッシュ

ターミナルに戻り、一旦今の状態でコミット。

コミットメッセージは最初はとりあえず"First Commit"とでもしておきます。

$ git add .
$ git commit -m "First Commit"


次に、ローカルディレクトリにリポートリポジトリを登録します。

先ほど作成したGithubリモートリポジトリからコピーした２行のコマンドを入れます。

$ git remote add origin https://github.com/アカウント名/リポジトリ名.git
$ git push -u origin master


するとユーザーネームとパスワードを聞かれるので、Githubのアカウントに使用しているものを入力します。

（上のコマンドを入力後の応答）
Username for 'https://github.com': （Githubのユーザーネームを入力）
Password for 'https://ユーザーネーム@github.com':　（Githubのパスワードを入力）


もしパスワード入力に失敗したりしても、慌てずに$ git push -u origin masterと入れれば再度入力できます。

ユーザーネームとパスワード入力に成功すれば、見事リモートリポジトリの登録完了！

５．Chrome拡張機能の導入・GASでGithubと連携

次にGASのスクリプトエディタ側でGithubと連携し、push/pullをできるようにします。

これにはChromeの拡張機能である「Google Apps Script GitHub アシスタント」を利用します。

この導入には参照２を参考にさせていただきました。

導入は簡単で、まずChrome ウェブストアから「Google Apps Script GitHub アシスタント」を検索してインストール（Chromeに追加）します。

次にGASのスクリプトエディタを開いて、Login SCMをクリックして、usernameとpasswordを入力すればGithubと連携が完了です（Repositoryが選択可能な状態になっていればOKです）。



６．GASでいったんpullしてみる

Repositoryタブから今回作成したGithubリポジトリを選択して、

その右のほうにある⬇︎ボタンをクリックしてpullしておきます。

（⬇︎がpull、⬆︎がpush）

ただ、そのままpullしようとしても上手くいきません。上部に「There is nothing to pull」とアラートが出てしまいます。

Repositoryの右の方にある歯車マークをクリックして、File type to syncの項目を.jsに変更します。

これはテキストファイルを作った時にjs拡張子で作っていたためです。こうすることでgsファイルとして読み込むことができます。

これにより⬇︎をクリックするとちゃんとpullできるようになっています。

以上で設定は完了です！わーい！

開発の流れ

以降、


VSCodeでコードを作成・修正してGithubにpush
GASのscriptエディタでそれをpullして実行
1に戻ってデバッグ


を繰り返して開発を進めていきます。

VSCodeでテキストファイルを読み込んで、実際にコーディングしていきましょう。

ある程度コードを書いていき、ここらでGASで実行してみたいなーと思ったら、ターミナルでプロジェクトフォルダに入ってることを確認してから、

$ git add .
$ git commit -m "（コミットメッセージを入力）"
$ git push


続いてGASのスクリプトエディタ側で、⬇︎クリックでpullして、関数の実行なりアプリ公開なりしてみてください。

しっかり「テキストエディタ＆Github＆GASのスクリプトエディタ」が連携しているはずです！！

※（余談）コミットの管理とかプッシュはVSCodeの「ソース管理画面」なるものからクリックで直感的にできるようです。僕はターミナルを叩きたくて使ってませんが、そのやり方も参照リンク１を参考にできそうです。

解説・補足

ただこのやり方、開発の際に注意しなければいけないのが、コンフリクトが起きないように気をつけることです。

例えばデバッグする際にGASのスクリプトエディタ側のコードを修正してしまうと、テキストエディタで記述しているものと差異が生まれてしまいます。

その都度push＆pullするなら良いのですが、うっかり忘れがちなので結構面倒です。

僕はひとまず

「コードの修正は必ずテキストエディタの方で行う」

と決めて、GASスクリプトエディタでは基本的にコードを直接いじらないようにして回避しています（いじるとしたらあくまで関数の動作チェックのため）。

そこがちょっと煩わしいのですが、一応今の所は不自由なく目的を果たしています。

この辺上手く使いこなしている方がいれば、ぜひやり方を教えてください。

また、テキストエディタはVSCodeに限る必要はなさそうなので、自身の慣れたテキストエディタでアレンジしてみても面白そうです。

あとがきMEMO

今回のやり方はさほど手間もかからずに１時間程度でできるし、自分の使い慣れているツール・やり方に落とし込む作業というのは、ハマればとても楽しいものですね。

gitでのバージョン管理やGithubはこれまでも使っていたものの、調べて書いてある通りにやっていただけで実際によくわかっていなかったので、これを機に理解が深まった気がします。

参考にしたサイト


参照リンク１

【初心者向け】Visual Studio Codeで書いたコードをGitHubに公開する方法 - 鍋綿ブログ
参照リンク２

GASをGitHubで簡単管理可能なChrome拡張機能　～導入時に躓いたこと～ - Qiita



【GAS】家族で使えるゴミ出しリマインダ LINEチャットボットを作った
2020-01-24T17:37:21+09:00
はじめに

日常のゴミ出しって難題ですよね。

「今日燃えるゴミの日なのに、ゴミ出し忘れた！！」

「プラごみ出し忘れて今日で１ヶ月…また２週間後まで出せない…」

いや、できるのが普通当たり前のことなのかもしれないのですが、自分のような日常生活に支障をきたす程度の面倒くさがり＋曜日感覚のない人間にとっては、ゴミを定期的に出すというのはかなりのハードルです。

一人暮らしの時にはアパートの入り口は基本ゴミの山。

結婚してからも自分の力でゴミ出しができた試しがなく妻には頭が上がらない。

男女問わずこんなダメ人間多忙なビジネスパーソンが多いと僕は信じています…。

ともあれ、そんなやっかいなゴミ出し問題を解決するために、家族や夫婦で活用できるアプリを制作しました。

「ゴミ出し日の前日にリマインドしてくれるLINEチャットボット」

一人暮らしで活用してもよし、旦那さんが奥さんのために率先してゴミ出ししてもよし、夫婦で共有してもよし、子供にゴミ出しを意識づけさせるために使ってもよし。

使用した技術


GAS（Google Apps Script）
LINE Messanger API


１．チャットボット詳細

改めて、このチャットボットで出来ることはとてもシンプルで、このLINE botアカウントと友達になっておくことで

「ゴミ出し日の前日夜9時にリマインダが送られてくる」

というものです。ただそれだけ。

曜日によって送る情報を変えることができるので、自分の地域のゴミ収集曜日を入れておくことでそれに応じてリマインドしてくれます。

↓いろいろ通知してくれるLINE bot 「にゃんこ通信」



↓こんな感じに勝手にチャットが飛んできてお知らせしてくれます。うんこうんこ



３．色々な情報をグローバルで定義しておく

Line Developersのチャンネル作成やプッシュメッセージの登録などが必要ですが、

今回はコードのみ紹介。

//チャンネル情報・ラインユーザー情報の取得
var CHANNEL_ACCESS_TOKEN = 'ここにアクセストークンを入力';
var USER_ID_M = 'ここにラインユーザーIDを入力';
var USER_ID_L = 'ここにラインユーザーIDを入力';


まず、チャンネルアクセストークンと、リマインダメッセージを送りたいラインのユーザーIDを変数に入れます。

これらはプログラム中で変更することがないので定数constに入れたいなあと思うのですが、どうやらconstはグローバルでは定義できないようです（参考リンク１）

（定数は関数内でプライベートでのみ定義）

頭に書いておきたいので変数varで定義しておきます。

チャンネルアクセストークンと自身のLINEユーザーIDについては、LINE Developersのチャンネル情報で見れるので、それを利用します。

ちょっと手間がかかるのが複数人でこのbotを共有する場合。

僕の場合は妻とbotを共有したいので、メッセージの送り先として妻のLINEユーザーID（ラインで友達検索に使うラインIDとは別物です）を設定しなければなりません。

ところが、調べているとこれが簡単に取得できないことが発覚。

一旦置いておいて次項で。

//ユーザー入力項目
var weekday = ["日", "月", "火", "水", "木", "金", "土"];
var garbageCalendar = {
  "日":"",
  "月":"燃やすゴミ",
  "火":"",
  "水":"資源ゴミ",
  "木":"燃やすゴミ",
  "金":"",
  "土":""
};


次にユーザー入力項目ですが、

このgarbageCalendar変数に、オフジェクトでゴミ収集の曜日とゴミの種類を入れておきます。

地域のゴミ収集カレンダーから持って来ましょう。

３．他人のラインユーザーIDの取得

これには参考サイト１をそのまま活用させてもらいました。

取得したユーザーIDをグローバル変数に入れておきます。

４．リマインダのメイン処理

次に、リマインダのメッセージなどを記述して送信するためのgarbageReminder()関数というものを作ります。

//リマインダのメイン処理
function garbageReminder() {
//翌日の日時を取得
  var date = new Date();
  date.setDate(date.getDate() + 1);
//翌日の曜日を取得して、ゴミの種類を取得
  var dayNum = date.getDay();
  var day = weekday[dayNum];
  var garbageType = garbageCalendar[day];

//明日がゴミ収集日にリマインドメッセージを送信
  var message = "【ゴミ出し通信】\n";

  if(garbageType != ""){ 
    message += " 明日は${day}曜日、「${garbageType}」の日です。\n出すゴミをチェックしよう！".replace('${day}',day).replace('${garbageType}',garbageType);
    sendToLine(message);
  }else{

  };
}


前半では、今日の日付から曜日を取得してわちゃわちゃして翌日のゴミの種類を判別してます。

new Date()でまず今日の日付情報を取得できるので、その変数にdate.setDate(date.getDate() + 1);とすることで、翌日の日付情報を取得しています。

その取得した日付情報dateにgetDay()メソッドを使うことで曜日を取り出すことができます。曜日は数字になっているので注意。

曜日からゴミの種別を取ってくるときは、グローバルで定義しておいた配列とオブジェクトを使用します。

後半は、メッセージを送信する処理になります。

翌日がゴミ出し曜日の場合にのみ、変数messageに曜日やゴミの種別が入った文字列が入ります。

変数を文字列として送るときはreplaseメソッドを活用。

また改行を入れたいときは\n(記号はバックスラッシュ)を使います。

最後にsendToLine(message)という関数（次項に記述）を利用して、先ほどの変数

messageの値をラインに送信しています。

５．ラインに送信する処理

前項の最後の、実際にラインに送信するための色々な情報を記述する

sendToLine()関数を作ります。

//ラインに送信する処理
function sendToLine(message){
//色々なパラメータを設定
  var url = 'https://api.line.me/v2/bot/message/multicast';
  var headers = {
    'Content-Type':'application/json; charset=UTF-8',
    'Authorization':'Bearer ' + CHANNEL_ACCESS_TOKEN
  };

  var data={
    "to":[USER_ID1,　USER_ID2],
    "messages":[{
      "type":"text",
      "text":message
    }]
  };

  var options = {
    'method':'post',
    'headers':headers,
    'payload':JSON.stringify(data)
  };
//LINE messanger APIを叩く
  UrlFetchApp.fetch(url, options);
}



最後のUrlFetchApp.fetch(url, options);がGASでAPIを叩く命令となります。

かっこの中は「どこへ、どの情報を送る」というイメージです。

そのために必要なものをその前に変数に入れて記述しています。

詳しくはLINE Developersの公式ドキュメント(Messaging APIリファレンス)を参照。

var urlにはHTTPリクエストを送るURLを記述します。

このurlの末尾をmulticastとしていることで、送り先を複数に設定しています。

この実際に送るのがvar dataのtoに配列で複数設定しているユーザーIDになっています。

例えばこのbotを自分だけが使用できれば良いという場合は、

HTTPリクエストを送るurlの末尾をpushにして、var dataのtoには自分のユーザーIDだけを指定しておけば良いですね。

詳しい説明は省いてしまいますが、このようにLINEのmessaging APIを叩くための諸々のパラメータをurl,headers,data, optionsに入れているわけです。

ここまでできたら、トリガーを登録することでリマインド機能が完成です！

課題


LINEのユーザーIDを調べる方法をコピペで実施しているので、コードを自分の頭で書いて理解してみようと思います。
というか、そもそもLINEユーザーIDをいちいち入れなくてもいい可能性はないか…？


おわりに

普段使っているラインを入り口にして色々できないかなーと考えるようになって

日常生活で欲しかったちょっとしたものを実際に作ってみた次第です。

これに夫婦で使いたい機能をちょっとずつ付け足していきたいと思っていて、

家計の金銭管理とか、買い物リストとか、直接ラインでやりとりするのは少し手間だったり精神的負担があったり…というようなほんと些細なことをツールで出来るようにしたいなーと思っています。

いずれリッチメニューなんかも作れるようになりたいですね。

夫婦中がちょっとだけアップするアプリを目指します。笑

参考にしたサイト


参考１

Google Apps Script - Google Apps Scriptでグローバルな定数を定義できない｜teratail
参考２

Google Apps Script試行錯誤Blog: LINE BOTでuserId, groupId, roomIdを取得したい
LINE Developers公式ドキュメント（プッシュメッセージ）

Messaging APIリファレンス


MEMO

Githubに全体のコードをあげています。

書き方はあまりスマートでない部分もあるかと思うので、その点はお手柔らかに。

LINEbot-for-life/push.gs at master · Massasquash/LINEbot-for-life · GitHub

また、LINE botのアイコンの画像はこちらのものを使用させていただいてます。感謝。

勉強猫 | 無料イラスト素材｜素材ラボ


GASでいいねしたツイートをいいねの数とリツイートの数と一緒に記録するやつ
2019-10-07T09:13:01+09:00
特定のユーザーのいいねしたツイート一覧を、ツイートに付いたいいねの数とリツイートの数も一緒に記録したくなって作りました。トリガー機能を使うと、定期的にいいねが記録されるようになります。

GASで自分のツイートを取得してスプレッドシートに記録するやつ



この記事も合わせて読むとわかりやすいかもしれません。



このように記録されます。



function getFav(){
  var service  = twitter.getService();
  var json = service.fetch("https://api.twitter.com/1.1/favorites/list.json?screen_name=いいねを取得したいアカウントのscreen name&count=100");
  var array = JSON.parse(json);

  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName('いいねを記録したいシートの名前');
  var lastRow = sheet.getLastRow() +1;
  var lastId = sheet.getRange("F2").getValue();

  for(var i = 0; i <= array.length -1; i++) {

    var int = parseInt(i);

    if(i === 0){
      var recId = array[int]["id"];
      sheet.getRange("G2").setValue(recId);
    }

     var id = array[int]["id"];

     if(id > lastId){
       var time = array[int]["created_at"];
       var userId = array[int]["user"]["id_str"];
       var json = service.fetch("https://api.twitter.com/1.1/users/show.json?user_id="+userId+"&include_entities=false");
       var array2 = JSON.parse(json);
       var screenName = array2["screen_name"];
       var text = array[int]["text"];
       var favorite_count = array[int]["favorite_count"];
       var retweet_count = array[int]["retweet_count"];


       sheet.getRange(lastRow,1).setValue(time);
       sheet.getRange(lastRow,2).setValue(screenName);
       sheet.getRange(lastRow,3).setValue(text);
       sheet.getRange(lastRow,4).setValue(favorite_count);
       sheet.getRange(lastRow,5).setValue(retweet_count);
       sheet.getRange(lastRow,6).setValue(id);
     }
    lastRow = lastRow + 1;
    }



いいねを１００件取得して、idが以前記録したツイートより大きければ記録する…といった感じです。

何かあったら気軽にコメントください。


GASで自分のツイートを取得してスプレッドシートに記録するやつ
2019-10-07T09:10:43+09:00
急にツイ消ししたくなった場合に備えて、自分のツイートをグーグルスプレッドシートに記録しておくことにしました。

GASでTwitterの投稿とタイムライン取得

こちらの記事を参考にして書いてみました。



画像のように記録されます。


 var twitter = TwitterWebService.getInstance(
 '**********',       // 作成したアプリケーションのConsumer Key
 '**********'  // 作成したアプリケーションのConsumer Secret
);

// 認証を行う（必須）
function authorize() {
  twitter.authorize();
}

// 認証をリセット
function reset() {
  twitter.reset();
}

// 認証後のコールバック（必須）
function authCallback(request) {
  return twitter.authCallback(request);
}

function getMyTweets() {
  var service  = twitter.getService();
  var json = service.fetch("https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name=ツイートを取得したいユーザーのid&count=30");
  var array = JSON.parse(json);

  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName('ツイートを保存したいシートの名前');
  var lastRow = sheet.getLastRow() +1;
  var lastId = sheet.getRange("D2").getValue();

  for(var i = 0; i <= array.length -1; i++) {

    var int = parseInt(i);

    if(i === 0){
      var recId = array[int]["id"];
      sheet.getRange("D2").setValue(recId);
    }

     var id = array[int]["id"];

     if(id > lastId){
       var time = array[int]["created_at"];
       var text = array[int]["text"];

       sheet.getRange(lastRow,1).setValue(time);
       sheet.getRange(lastRow,2).setValue(text);
       sheet.getRange(lastRow,3).setValue(id); 
     }
    lastRow = lastRow + 1;
    }
  }


自分のツイートを最新のやつから30件まで取得して、idが以前取得したツイートより大きければスプレッドシートに書き込む……という感じです。

ここ違うよ〜とかもっと良い書き方あるよ〜って場合は気軽にコメントください。


SlackのファイルをGASで自動削除する
2019-03-06T00:48:44+09:00
Unityゲーム開発者ギルドというコミュニティを運営しているんだけど、

無料版で使っているSlackのファイルストレージがギリギリになってた。




  Unityギルドについてはこちら -> https://twitter.com/naichilab/status/1061929632037892096


このままじゃファイルアップロードできなくなっちゃうので、古いファイルは自動削除されるようにした。

とりあえず30日以上経過したファイルは問答無用で消していこう。

（Slackのメッセージも今のペースだと２週間たらずで消えちゃうから30日経過したら削除で十分だろうと判断）

GASで下記スクリプトを作成。プロジェクトのプロパティでレガシートークンをセットして１時間トリガーを仕掛けた。


  １時間ごとに起動して、３０日以上経過したファイルを１０件検索＆削除。


削除後の反映は最大48時間かかるらしいので様子見〜。

function deleteOldFiles() {
  var res = filesList(30, 10);
  if(res.files.length == 0){
    Logger.log("削除対象ファイルは見つかりませんでした。");
    return;
  }

  res.files.forEach(function(file){
    Logger.log("削除します。 ID=" + file.id + ", Size=" + file.size);
    filesDelete(file.id)
    Utilities.sleep(50);//sleep 50msec
  });
}


//ref. https://api.slack.com/methods/files.list
function filesList(days, count){
  var params = {
    token: PropertiesService.getScriptProperties().getProperty("SLACK_ACCESS_TOKEN"),
    ts_to: elapsedDaysToUnixTime(days),
    count: count
  }
  return execute('files.list', params);
}

//ref. https://api.slack.com/methods/files.delete
function filesDelete(id){
  var params = {
    token: PropertiesService.getScriptProperties().getProperty("SLACK_ACCESS_TOKEN"),
    file: id
  }
  return execute('files.delete', params);
}

function execute(apiName, params){
  var options = {
    'method': 'POST',
    'payload': params
  }
  var res = UrlFetchApp.fetch('https://slack.com/api/' + apiName,options);
  return JSON.parse(res.getContentText());
}

function elapsedDaysToUnixTime(days){  
  var date = new Date();
  var now = Math.floor(date.getTime()/ 1000); // unixtime[sec]
  return now - 8.64e4 * days + '' // 8.64e4[sec] = 1[day] 文字列じゃないと動かないので型変換している
}