Gmail Add-on 入門 (デベロッパーアドオンの作成とインストール)

こんにちは、kenzauros です。

**Gmail がアドオン (Add-on) に対応**しました。

Asana や Trello など有名サービスのアドオンがリリースされていますが、実は誰でもアドオンを開発することができます。

ということで Quickstart を参考に、クイックスタートしてみたいと思います。

• Quickstart: Gmail Add-on | Google Developers
• G Suite Developers Blog: Gmail add-ons framework now available to all developers

アドオンの作成

スクリプトの作成

Gmail の Add-on は Google サービス共通の Web App や自動化のスクリプト環境である Google Apps Script で作成します。

まず、 Google Apps Script を開き、 Start Scripting をクリックします。 (2回目以降は自動で新規プロジェクトに飛ぶかもしれません)

こんな感じのスクリプトエディターが開きます。 Google Apps Script は言語的には JavaScript とほぼ同じです。日本語環境だと標準で コード.gs が開いていると思います。

スクリプト部分に Quickstart Step 1 のソースコードを貼り付けます。

[ファイル] から [保存] して変更を保存します。「無題のプロジェクト」となっているプロジェクト名をクリックして “Gmail Add-on Quickstart” とでも名前を変えておきましょう。

マニフェストファイルの編集

[表示] から [マニフェストファイルを表示] を選択します。

appsscript.json が開いたら Quickstart Step 2 のマニフェストファイル用 JSON をコピペし、保存します。

公開

今回はあくまでお試しのため、ウェブストア等で公開しません。 Gmail にインストールするために [公開] から [Deploy from manifest…] を選択します。

Deployments というダイアログが開くので、 [Get ID] というリンクをクリックします。

Deployment ID が表示されるのでこれをコピーし、ダイアログを 2 つとも閉じます。

これで Gmail Add-on の準備は完了です。

Gmail にインストール

Add-on をインストールしたいアカウントで Gmail を開きます。歯車アイコンから [設定] を開き、 [アドオン] タブを開きます。

今回のクイックスタート アドオンはウェブストア等に公開されたものではなく Google が安全を確認したものではないため（安全とわかっているのは作った本人だけ）、特別にインストールを許可してやる必要があります。

「ご利用のアカウントで、デベロッパーアドオンを有効にします」というチェックボックスを ON にします。

下記の通り、警告が表示されますが、今は自分で作ったアドオンをインストールするので、「有効にする」をクリックします。

「デベロッパーアドオンをインストール」という欄が表示されるので、このテキストボックスに先ほど作成時にコピーしておいた デプロイ ID (Deployment ID) を貼り付け、 [インストール] をクリックします。

さらに確認が表示されるので、 ID を確認してインストールします。

これで Gmail に戻り、リロードします。すると右側に Quickstart のマニフェストで指定された Bookmark アイコンが表示されていますので、これをクリックします。

アドオンが Gmail のデータにアクセスするのに必要な権限を与える必要があるので、 [アクセスを承認] をクリックします。

アカウント選択画面がでたら、自分のアカウントをクリックし、下記のようなダイアログに警告が表示されますが、ここは自分で認識して進めているので [Advanced] リンクをクリックします。

下に表示された [Go to Gmail Add-on Quickstart (unsafe)] をクリックします。繰り返しますが、デベロッパーアドオンなので unsafe になっています。今回は気にせず進みましょう。

さらに厳重に確認ダイアログが表示されるので、 Continue と入力して NEXT をクリックします。

またまた今度は与える権限について OAuth 画面の認可画面が開くので、一応確認して [ALLOW] をクリックします。

これでやっとアドオンが使えるようになりました。アドオン作成よりインストールのほうが面倒ですね(笑)

まぁこのアドオンはクイックスタートなので、あまり便利ではないですが、アドオンでどんなことができるかの雰囲気は感じることができます。いろいろ触ってみてください。

アンインストール

不要になったら、設定のアドオンタブから [アンインストール] を押して削除しましょう。特に他のデベロッパーアドオンを使用しないのであれば、デベロッパーアドオンを無効にしておいたほうが無難でしょう。

くれぐれもよくわからないところで配布されているアドオンをインストールしないようご注意ください。