drive.file と複数の Google アカウント——「シートを表示できません」で確認したいアカウントの組み合わせ
Sheet Widget は、Google の drive.file という権限で、利用者が選んだスプレッドシートだけを読んでいます(この権限を選んだ理由)。
drive.file はファイル単位にアクセスを絞るための権限ですが、複数の Google アカウントを持っている人では、思わぬ形でシートが読めなくなることがありました。
drive.file の許可は「アカウントごと・ファイルごと」
ここでは、Picker で新しくファイルを選ぶ場面を考えます。必要なのは、そのファイルの利用権限と、読み取りに使うアカウントの認証・認可がそろうことです。drive.file はアプリが作成したファイルなども扱えるため、「Picker で選んだものだけ」という定義ではありません(Google のスコープ一覧)。
- アカウント A でファイル X を選ぶ → アカウント A のログイン情報で、ファイル X を読める
- アカウント B では、X へのアクセス権やアプリへの許可が不足していれば読めない
Sheet Widget では、ファイルを選ぶ画面(Google Picker)を、アプリ本体のログインとは別の、Web のログインで開いています(理由はこちらの記事)。この2つのログインはつながっていないので、アプリにはアカウント A でログインしているのに、Picker ではアカウント B を選んでしまう、ということが起こります。その場合、A で必要な権限がそろっていなければ読み込みに失敗します。
エラー文が、利用者を逆方向に案内していた
最初、シートを読めなかったときのウィジェットのエラー文は、「ファイルが削除されたか、名前が変わった可能性があります」という内容を主な原因として案内していました。
開発記録では、アカウントの取り違えを重要な原因として挙げています。ただし、今回確認できた資料に件数別の集計はありません。「失敗のほとんどがこの原因」と割合を断定せず、削除・権限変更・通信の問題などと分けて案内する必要があります。
そこで、エラー文を次のように書き直しました。
- まず「別の Google アカウントで選んでいないか」を確認してもらう
- 「+」から、正しいアカウントでシートを選び直してもらう
ゴミ箱に移されたファイルは、Google Drive の API で別に判定して、その場合だけ専用のメッセージを出しています。
選んだときに気づけるようにした
エラー文を直すだけでなく、シートを選んだ時点で取り違えに気づけるようにもしました。
- Picker のページで、ファイルを選んだときに、そのときログインしていた Google アカウントのメールアドレスも取得して、アプリに返す
- アプリは、そのメールアドレスが、アプリに登録されているアカウントに含まれているかを確認する
- 含まれていない、かつ実際にシートの読み込みに失敗した場合だけ、「別のアカウントで選んだようです」という案内を表示する
「登録されていないアカウント」というだけで案内を出すと、問題なく読めている場合にも出てしまうことがあります。実際に読み込めなかったときだけに絞って、誤った警告を出さないようにしました。
案内のボタンは、プランによって分けています。
| プラン | 案内に出すボタン |
|---|---|
| Pro(複数アカウントに対応) | 「〈選んだアカウント〉を追加」。押すと、そのメールアドレスを候補にしてログインし、成功したらシートを読み直す |
| 無料(アカウントは1つ) | Pro の説明。無料版は、アカウント1つで使う前提のため |
無料版は、Picker にアカウントのヒントを渡す
無料版では、アプリに登録できる Google アカウントは1つだけです。そこで、Picker を開くときに、アプリでログインしているアカウントのメールアドレスをヒントとして渡し、そのアカウントで選ぶための案内に使っています。ヒントは認証を強制するものではなく、選択結果と実際の読み込みも確認します。
Pro では、複数のアカウントを使い分ける前提なので、ヒントは渡さず、Picker の中でアカウントを選べる状態のままにしています。
まとめ
drive.fileの許可は「アカウント × ファイル」の組み合わせ- ファイル選択とアプリ本体のログインが別になっていると、アカウントの取り違えが起きる
- エラー文は、実際の失敗の傾向を確かめてから書く(思い込みで書くと、逆方向に案内してしまう)
- 選んだ時点のアカウントを確かめて、実際に失敗したときだけ案内する
- アカウントが1つの前提なら、Picker にヒントを渡して取り違えを防ぐ
Sheet Widget は App Store で公開しています。