Memo/Google/Apps_Script

GAS(Google Apps Script) †

• Google Apps Script | Google Developers
  • JavaScriptベース。サーバサイドで実行される。
  • Document, windowといったクライアントサイドのオブジェクトは使えない。

• 記事
  • GASを使ったスクレイピングの作成手順を紹介！ | 株式会社LIG
  • Google Apps Script× BigQuery × Googleスプレッドシート × データポータルで簡易CRMを作ってみた - BASEプロダクトチームブログ
  • GASでローカルCSVを取り込み、スプレッドシートで請求書を作成する | Developers.IO
  • 土日は通知されたくない！ 平日・営業日だけ動く GAS (Google Apps Script) を作る ｜ Developers.IO
  • Google Apps Scriptを使ってスプレッドシートをD3.jsで可視化する ｜ DevelopersIO
  • 逆引きGoogle Apps Scriptリファレンス «
  • GASでSpreadsheetを操作する自分的ベストプラクティス - Qiita
  • Google Apps ScriptでスプレッドシートからGoogleドキュメント以外のサービスにアクセスする （1/7）CodeZine
  • Google Apps ScriptでGoogleドキュメントのスプレッドシートを操作する （1/6）：CodeZine

---

高速化 †

記事:

• GAS高速化のススメ - Nealle Developer's Blog

  シートへの読み書きを可能な限り一括で行うようにする

  外部APIリクエストを並列する

  キャッシュの活用

  擬似的な非同期処理を実装する

---

スクリプトのロック処理/排他制御 †

• Class Lock  |  Apps Script  |  Google for Developers

---

日付と時刻 †

• Date()

    const today = new Date();
    const year = today.getFullYear(); // 2023
    const month = today.getMonth()+1; // 2
    const date = today.getDate(); // 1
    const day = today.getDay(); // 3 (水曜日)

• Utilities.formatDate()
  • "yyyy-MM-dd HH:mm:ss"のような書式文字列で日時を取得できる

---

スプレッドシートのクリア †

• clear()
  • 値と書式両方削除

• clearContents()
  • 値だけ削除

• clearFormats()
  • 書式だけ削除

---

テキストファイルで改行コードを指定して保存 †

• shell scriptとして保存したい場合、改行コードをLFにしたい。
• エクスポートでTSVとして保存すると、改行コードがCRLF、カラムがタブになってうまく動かない

function main(){
  sheet = SpreadsheetApp.getActive();
  let file_name = getFileName(sheet, '.sh')
  createTextFile(out_sheet, file_name)  
}

function createTextFile(sheet, file_name, newline_code = '\n') {
  const text = getText(sheet);
  var blob = Utilities.newBlob(text, 'text/plain', file_name);
  var folder = getParentFolder();
  folder.createFile(blob);

}

function getText(sheet, newline_code = '\n') {
  const values = sheet.getDataRange().getValues();
  var data = [];
  for(let i = 0; i < values.length; i++) {
    let line = values[i].join(' ').trim()
    data.push(line);
  }

  return data.join(newline_code);
}

function getFileName(sheet, ext = '.txt', timeformat= 'yyyyMMdd_HHmm', timezone = 'Asia/Tokyo') {
  var sheetName = sheet.getName()
  var datetime = Utilities.formatDate(new Date(), timezone, timeformat);

  return sheetName + '_' + datetime + ext;
}

function getParentFolder() {
  let thisFileId = SpreadsheetApp.getActive().getId();
  let thisFile = DriveApp.getFileById(thisFileId);
  let parentFolder = thisFile.getParents().next();
  return parentFolder;
}

---

メール送信 †

記事:

• [GASで無料でやる]送付先ごとに別ファイルを添付して一斉メール送信するレシピ | DevelopersIO

---

AWSとの連携 †

記事:

• Google スプレッドシートの表をS3へJSONファイルとして保存する | DevelopersIO

---

ライブラリ: 一つのGASを複数のスプレッドシート等で使う †

共通化したいGASファイル:

• 新規 > その他 > Google Apps Script。専用フォルダ(例:gas)作ってまとめたほうが良い。
• ファイル名がクラス名？になる。「-」等は省略されるので、CamelCaseで良いかも。(利用側で任意の名前(Identifer)を設定はできる)
• 他から利用するために、バージョンを保存する必要がある。リリースの度に必要
  • ファイル > 版を管理 > 説明を記入 > Save new version
• 他から利用するために、スクリプトIDをコピー
  • ファイル > オブジェクトのプロパティ > スクリプト IDをコピー

GASを利用したいスプレッドシート側:

• ツール > スクリプトエディタ を開く
• リソース > ライブラリ > Add a library でスクリプトIDを入れて、追加
• バージョンは最新、Identiferはクラス名？なので重複しない名前にする
• スクリプトエディタ側では、「Identifer.funcion()」で呼び出せるようになる。

GASを更新する場合:

• GAS側で新しいバージョンを保存
• 利用側で新しいバージョンを指定

• 記事
  • 1つのGASを複数のスプレッドシートで利用する方法（Google Apps Script） | 非IT企業に勤める中年サラリーマンのIT日記

---

ベストプラクティス †

• Best Practices  |  Apps Script  |  Google Developers

---

コーディング規約/ガイドライン †

• Overview of Google Apps Script  |  Google Developers

• 記事
  • Google Apps Scriptコーディングガイドライン【随時更新】

---

GitHub連携 †

• 記事
  • Googleスプレッドシートからgithub issueを簡単に作成して作業効率化 ｜ Developers.IO

---

clasp: cliでソースコードを扱う †

デフォルトではweb上エディタ上を使うが、gitや任意のエディタを使えるようにする。

• https://github.com/google/clasp
  • node.js製

• 記事
  • GAS用のCLIツール clasp を使ってGASをローカルで開発して実行するの巻。 - Qiita
  • clasp + GitHub + CodeBuild で Google Apps Script の継続的デプロイをやってみた | Developers.IO

• claspを使ったGoogle Apps Scriptのソース管理を試してみた | Developers.IO
• Google Apps ScriptをTypeScriptで実装する(clasp/TSLint/Prettier) #gas #typescript - My External Storage
• Google Apps ScriptとclaspでBacklogの情報をGoogleスプレッドシートに取得しよう | ヌーラボ
• Google Apps Script をローカル環境で快適に開発するためのテンプレートを作りました - Qiita
• 5分で作るclaspを使ったGoogle Apps Scriptの開発環境 - Qiita
• Google Apps ScriptsでTypescriptが超簡単に使えるようになった！ - アクトインディ開発者ブログ

1. GoogleアカウントのGoogle Apps Script APIをオンにする
2. node.js製ツールなので、Memo/Linux/anyenv#ide22883 を参考に入れる
3. claspのインストール

   npm install -g @google/clasp
   
   # shellの再起動。claspが見つからない場合があった
   exec $SHELL -l

4. 表示されたURLを使いたいGoogleアカウントにサインインした状態で開く

   clasp login

---

サンプル: GET/POSTを表示する †

function doGet(e) {
  return HtmlService.createHtmlOutput(JSON.stringify(e));
}

function doPost(e) {
  return ContentService.createTextOutput(e.postData.getDataAsString());
}

• /dev/path1/path2/?key1=val1 でアクセスした場合の結果

  {
     "parameter":{
        "key1":"val1"
     },
     "contextPath":"",
     "contentLength":-1,
     "queryString":"key1=val1",
     "parameters":{
        "key1":[
           "val1"
        ]
     },
     "pathInfo":"path1/path2/"
  }

---

デプロイ †

devとprod用の異なるURLがある。
1度発行されたURLはコードを変えても変わらない

dev用:

1. コードを変更する
2. 公開 > ウェブアプリケーションとして導入 > 最新のコードのリンクをクリック
3. https://script.google.com/macros/s/{dev用token}/dev

prod用:

1. コードを変更する
2. ファイル > 版の管理 > 新しいバージョンを保存
3. 公開 > ウェブアプリケーションとして導入 > プロジェクトのバージョンで新しいバージョンを指定
4. 現在のウェブ アプリケーションのURL
5. https://script.google.com/macros/s/{prod用token}/exec

---

Logging †

• Logger.log()
  • 表示 > ログに出る。
  • doPost(), doGet(), 各トリガーで起動する場合は、Logger.log()に出ない。

• Logging  |  Apps Script  |  Google Developers
  • 表示 > Stackdriver Logging , Stackdriver Error Reporting で確認できる
  • console.log() が使える

• スプレッドシートにログを出力する

• 記事
  • GAS と Stackdriver(Logging, Error Reporting) を連携させる - Qiita
  • GoogleAppsScriptでdoPost()等でログが使えないときの代替案 - Qiita

---

GoogleフォームとSlack連携 †

• 記事
  • Googleカレンダの予定開始3分前になったら、予定開始まで1分毎に、Slackにメンション付き通知するGASスクリプト – サーバーワークスエンジニアブログ
  • Googleフォームで作った申請フォームからSlackに通知をする方法 - once upon a time,
  • Googleフォームの回答をGoogle Apps ScriptでSlackに通知するための作業手順

Software

• 自作ソフト
• wiki自作プラグイン
• 利用規定
• ランキング
• 雑誌等掲載履歴

Programming

Game

雑記

連絡先

---

• MenuBar
• RightBar
• :admin
  

人気の10件

最新の10件

---