このページは、フェイスが提供する学習支援AIツールを初めて起動したときに必要となる「Googleアカウント認証」の手順を、画面と一緒にご案内するためのものです。4つのツール(読解アシスタント/英語・国語・理数の問題解説アシスタント)で、ほぼ同じ手順となります。
Googleアカウントでの認証は、ツールが塾生の Google ドライブや Google ドキュメント(または Google スプレッドシート)に解説・学習ログを保存するために必要となる、一度だけの設定です。設定が完了すれば、2回目以降の起動では自動的に認証が通るため、この操作を繰り返す必要はありません。
この認証で、何を許可することになるのか
この手順の中で、塾生は自分のGoogleアカウントに対して、ツールが特定のGoogleサービスを使うことを許可することになります。ツールが要求するアクセス範囲(スコープ)は、必要最小限に絞っています。
英語・国語・理数の
問題解説アシスタント
- Google ドキュメント:解説をドキュメントとして書き出す権限
- Google ドライブ:アプリが作成したファイルへのアクセス権限(アプリが作ったもの以外にはアクセスしません)
英語読解アシスタント
- Google ドライブ:学習ログ保存先のフォルダを選ぶための権限
- Google スプレッドシート:学習ログ(単語・文章)を書き出す権限
学習・共通テストの計画プランナー
- Google ドライブ:作成した学習戦略や計画ファイルのアクスル権限
- Google スプレッドシート:学習戦略や計画やスケジュールを書き出す権限
いずれのアプリも、塾生の Gmail・既存の個人ファイル・写真などにアクセスすることはありません。メールや連絡先を読み取る権限は、一切要求していません。
認証の全体像
初回認証は、おおまかに次の順で進みます。各ステップの詳細は後述します。
- アプリを起動すると、ブラウザが自動的に立ち上がります
- ブラウザで、塾生ご自身のGoogleアカウントにログインします
- 「このアプリは Google で確認されていません」という警告画面が表示されます(回避方法は後述)
- アクセスを「許可」します
- ブラウザに「認証完了」の表示が出て、自動的にアプリへ戻ります
- アプリ側で
token.jsonというファイルが作成され、以降は自動認証になります
所要時間は、ブラウザの立ち上がりを含めて2〜3分程度です。
手順
ステップ1:アプリを起動する
塾からお渡ししたアプリを起動します。起動後、Googleドキュメント(または Sheets)出力を初めて使うタイミングで、ブラウザが自動的に立ち上がります。
読解アシスタントの場合は「Sheet」ボタンを初めて押したとき、問題解説アシスタントの場合は「Google Docs 出力」を初めて選んだとき、それぞれ認証フローが開始されます。
認証処理が始まると、しばらくして自動的にブラウザが開きます。
ステップ2:Googleアカウントを選ぶ
ブラウザが立ち上がり、Googleのアカウント選択画面が表示されます。複数のアカウントがブラウザに登録されている場合は、ここで塾生ご自身のアカウントを選んでください。
塾生ご自身のGoogleアカウントを選択してください。
まだアカウントにログインしていない場合は、ログイン画面(メールアドレス/パスワードの入力)が先に表示されます。指示に従ってログインしてください。
ステップ3:「確認されていません」警告を通過する
アカウントを選ぶと、次のような警告画面が表示されることがあります。
「このアプリは Google で確認されていません」という警告が表示されます。
この警告は、一般ユーザー向けの公開審査をまだ受けていないアプリに対して、Google が一律で表示する注意文です。フェイスの塾内向け非公開ツールであるため、この審査は受けていません。塾生の皆さんにお渡ししている範囲では、通常通りご利用いただいて差し支えありません。
通過する手順は以下の通りです。
- 画面下部の「詳細」というリンクをクリックします
「安全なページ」という強い言葉が表示されますが、これは Google の審査を通していないというだけの意味で、ウイルスやマルウェアを含むという意味ではありません。ご安心ください。
ステップ4:アクセスを「許可」する
次に、アプリが要求するアクセス権限(スコープ)の一覧が表示されます。
要求されている権限を確認し、「すべてを選択」をクリックします。
内容を確認したうえで、「続行」をクリックしてください。前述の通り、要求している範囲(機能)はそのアプリの動作に必要な最小限です。
ステップ5:認証完了画面が表示される
許可が完了すると、ブラウザには「認証が完了しました。このタブは閉じて構いません」といった趣旨の画面が表示されます。
この画面が出たら、ブラウザのタブを閉じてアプリに戻ってください。
このタブは閉じて構いません。アプリ側では、認証情報を自動的に受け取り、token.json というファイルが作られます。以降、このファイルがある限り、ブラウザが立ち上がる認証フローは繰り返されません。
保存される情報について
認証が完了すると、アプリの実行フォルダの中に token.json というファイルが作られます。これは、Googleから発行された「ツールがあなたのアカウントを操作するための許可証」のようなものです。
- 中身は、短期の「アクセストークン」と、長期の「リフレッシュトークン」で構成されています
- アクセストークンは通常1時間ほどで期限切れになりますが、リフレッシュトークンで自動的に再発行されるため、塾生が手動で再認証する必要はありません
- このファイルが消えた場合、次回の起動時にもう一度ブラウザ経由の認証フローが必要になります
- このファイルを他人と共有しないでください。このファイル=アカウントの操作許可を持ち歩いているのと同じ意味になります
認証を取り消したい場合は、Googleアカウントの「サードパーティーのアクセス」設定から、該当するツールへのアクセス権をいつでも削除できます。
トラブルシューティング
ブラウザが立ち上がらない
- 既定のブラウザが正しく設定されているかを確認してください
- アプリを再起動してから、もう一度認証を開始してください
認証の途中でブラウザを閉じてしまった/「キャンセル」を押してしまった
認証はキャンセルされた状態で止まっています。アプリを再度起動(または出力操作を再度実行)すれば、認証フローが最初から始まります。
「認証が完了しました」の画面が出ない/いつまでもブラウザがぐるぐる回る
- インターネット接続が安定しているか確認してください
- セキュリティソフトやファイアウォールが、ローカル通信(
localhost)を遮断していないか確認してください - ポートが別のアプリで使われている場合、ツールは自動で別ポートを試しますが、改善しない場合はアプリを再起動してから再度お試しください
「このアプリは Google で確認されていません」から先に進めない
本ページのステップ3を再度ご確認ください。「詳細」というリンクが小さく表示されているため、見逃しやすい場所です。
認証したのに、別のアカウントが使われている
ブラウザに複数のGoogleアカウントが登録されている場合、意図しないアカウントが選ばれることがあります。token.json を削除してから認証をやり直すと、再度アカウント選択画面から始まります。
それでも解決しないとき
アプリの再起動で多くの問題は改善します。改善しない場合は、エラー文言をメモのうえ、講師までご連絡ください。
安全にご利用いただくためのお願い
- 塾生ご本人のGoogleアカウントで認証してください。ご家族のアカウントや、学校から貸与されたアカウントは避けてください
token.jsonは他人に渡さないでください(共有PCを使う場合は特にご注意ください)- 共有PCでの一時利用後は、Googleアカウントの権限設定から、アクセス権を削除しておくと安心です