9ura00

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 で別に判定して、その場合だけ専用のメッセージを出しています。

選んだときに気づけるようにした

エラー文を直すだけでなく、シートを選んだ時点で取り違えに気づけるようにもしました。

  1. Picker のページで、ファイルを選んだときに、そのときログインしていた Google アカウントのメールアドレスも取得して、アプリに返す
  2. アプリは、そのメールアドレスが、アプリに登録されているアカウントに含まれているかを確認する
  3. 含まれていない、かつ実際にシートの読み込みに失敗した場合だけ、「別のアカウントで選んだようです」という案内を表示する

「登録されていないアカウント」というだけで案内を出すと、問題なく読めている場合にも出てしまうことがあります。実際に読み込めなかったときだけに絞って、誤った警告を出さないようにしました。

案内のボタンは、プランによって分けています。

プラン 案内に出すボタン
Pro(複数アカウントに対応) 「〈選んだアカウント〉を追加」。押すと、そのメールアドレスを候補にしてログインし、成功したらシートを読み直す
無料(アカウントは1つ) Pro の説明。無料版は、アカウント1つで使う前提のため

無料版は、Picker にアカウントのヒントを渡す

無料版では、アプリに登録できる Google アカウントは1つだけです。そこで、Picker を開くときに、アプリでログインしているアカウントのメールアドレスをヒントとして渡し、そのアカウントで選ぶための案内に使っています。ヒントは認証を強制するものではなく、選択結果と実際の読み込みも確認します。

Pro では、複数のアカウントを使い分ける前提なので、ヒントは渡さず、Picker の中でアカウントを選べる状態のままにしています。

まとめ

  • drive.file の許可は「アカウント × ファイル」の組み合わせ
  • ファイル選択とアプリ本体のログインが別になっていると、アカウントの取り違えが起きる
  • エラー文は、実際の失敗の傾向を確かめてから書く(思い込みで書くと、逆方向に案内してしまう)
  • 選んだ時点のアカウントを確かめて、実際に失敗したときだけ案内する
  • アカウントが1つの前提なら、Picker にヒントを渡して取り違えを防ぐ

Sheet Widget は App Store で公開しています。

← ブログの一覧へ