Google Apps Script GitHub アシスタントセットアップ

概要

ローカルPCで開発した GAS のスクリプトを Google Drive に反映する方法としては3パターンあります。

1. 手動でソースをコピペ
2. clasp コマンドで反映
3. GitHub から Google Apps Script GitHub アシスタントを使って反映

開発時と本番リリース時で方法を変えるなど、運用手法としての議論はここでは置いておきまして、
パターン3 の環境構築について説明します。

１，GitHub アクセストークン発行

https://github.com/settings/tokens にアクセスします。
Generate new token のプルダウンから Generate new token (classic) を選択します。

次のように入力します。

項目	設定値
Note	トークンの名称。日本語でOK。 自分しか見ることはありません。 （例）Google Apps Script GitHub アシスタント用
Expiration	トークンの有効期限。 90日くらいが無難。無期限もあります。 期限切れ前にメール通知してくれます。
Select scope	repo と gist にチェックを付ける

Generate token ボタンをクリックします。
表示されたアクセストークンは後から確認することができませんのでメモしておきます。

２，Chrome拡張機能のインストール

Chrome拡張機能 【Google Apps Script GitHub アシスタント】 を画面に従ってインストールします。

３，Google Apps Script GitHub アシスタントの認証設定

オプションのダイアログを開きます。（オプションの開き方は何通りかあります）
username に GitHubアカウント名を、github access token に先ほどメモしておいたアクセストークンを入力し、 GITHUB LOGIN ボタンをクリックします。
Google の認可ダイアログが表示されることがありますので、許可してください。

アカウント名 と LOGOUT ボタンが表示されていればOK。

４，Google Apps Script API をオンにする

デフォルトではオフですので、オンに変更してください。
https://script.google.com/home/usersettings

ここまででセットアップは完了です。
以下簡単に使い方を説明します。

Google Apps Script GitHub アシスタントの使い方

正しくセットアップが完了すると、
スクリプトエディターのツールバー右側に各種操作ボタンが表示されます。

設定

歯車マークをクリックすると設定ダイアログが開きます。

• Sync type
  • GitHub上で管理している拡張子に合わせて .gs もしくは .js を選択します。
• Ignore file patterns
  • 同期対象外のファイル名を正規表現で設定します。
  • スクリプトファイルとHTMLファイル以外は標準で除外されますのでここで指定する必要はありません。
• Manage manifest file
  • appsscript.json を同期対象にする場合はチェックを付けます。

この設定は GASプロジェクトごとに設定されるため、新たなプロジェクトで作業される際はその都度設定を確認しましょう。

リポジトリとブランチを選択

操作対象の GitHub リポジトリとブランチを選択します。

GitHub から pull

GitHub のスクリプトを反映したい場合は ↓ ボタンをクリックします。

ローカルとの差分がダイアログとして表示されますので、反映するファイルのみチェックを付けて Pull ボタンをクリックします。

GitHub へ push

ローカルのスクリプトを GitHub へ反映したい場合は ↑ ボタンをクリックします。

pull の場合と同じように差分ダイアログが表示されますので、反映するファイルのみチェックを付け、コミットコメントを入力して Push ボタンをクリックします。