9ura00

Sheet Widget が drive.file を選んだ理由と、Google OAuth・Picker 実装で確認したこと

Sheet Widget は、Google スプレッドシートの指定範囲を iPhone のホーム画面に表示するアプリです。シートを一般公開せず、利用者が選んだファイルを読むために、Google の drive.file スコープを採用しました。

この記事は、保存している2026年7〜8月の開発記録と、2026年10月16日時点の実装・Google公式資料を照合して更新しています。以前の「審査も100人制限もない」という説明は不正確だったため、手続きと公開状態を分けて説明します。

drive.file は「ファイル単位」でアクセスを絞る権限

drive.file は、アプリが作成したファイルや、利用者がアプリで開く・共有することを許可したファイルを扱うスコープです。Google Picker での選択は、その許可を得る方法の一つです。ドライブ全体を読む権限とは異なります。

ただし、読み取り専用のスコープではありません。権限には作成・変更も含まれます。Sheet Widget がシートの読み取りに使っていることと、Google が付与する権限の範囲は分けて考える必要があります。Google の Drive API スコープ一覧

検討時に重視したのは、次の違いです。

方法 Sheet Widget での判断
シートを「ウェブに公開」して読む 家計簿などを公開することを前提にしたくないため、不採用
spreadsheets.readonly を使う 最初に検討・申請した方法。個別ファイルを選んで許可する方式へ変更
drive.file と Picker を使う 選択したファイルを扱う現在の方式。ファイル選択の実装が必要

「非機密」でも公開準備は必要

Google は drive.file を非機密スコープに分類しています。機密・制限付きスコープ向けの追加検証とは区別されますが、これだけで OAuth アプリの公開準備がすべて不要になるわけではありません。

アプリ名・ロゴ・ホームページ・プライバシーポリシーなどのブランド情報、ドメインの所有確認は別の確認事項です。例外に当たるかも含め、ブランド確認の公式手順を確認します。

利用人数の制限も、二つを混同しないようにします。

設定・状態 確認すること
公開状態が Testing 登録できるテストユーザーは最大100人。drive.file を使う場合もこの設定を確認する
未承認の機密・制限付きスコープを要求 未確認アプリの警告と、それに伴うユーザー上限の対象になり得る
In production 公開状態の変更と、必要な検証の完了は別。要求スコープと検証状態を確認する

「Testing の100人」と「未確認アプリのユーザー上限」は別の仕組みです。Google の公開状態・ユーザー上限の説明

開発記録に残っている変更の順序

保存した審査対応記録では、次の順に進んでいます。日付は当時の記録によるもので、審査にかかる標準日数を示すものではありません。

日付(2026年) 記録に残っている対応
7月1日 デモ動画に OAuth 同意画面の流れが不足しているとの対応依頼
7月2日 同意画面を含めた動画を作り直し、字幕あり・なしの2本で返信
7月8日 Google から、より狭い drive.file の利用を検討するよう提案
7月9日 スコープを変更。既存の検証リクエストは変更に伴ってキャンセル
7月11日 プロジェクトが Approved 状態で、追加対応不要との確認
8月4日 drive.file と Picker 側の再ログインを組み合わせた実機検証を完了

動画の作り直しで確認したのは、ログイン画面だけでなく、どの権限を求めているか分かる同意画面が映っているかです。すでに許可済みのテストアカウントでは同じ画面が出ないこともあるので、撮影前に認可状態を確認しました。

iOS の Picker で困ったこと

当時の開発記録には、ASWebAuthenticationSession 内で初回は選択できても、次回に Cookie アクセスの確認へ進めない事象が残っています。Google に相談し、ファイル選択ページを開くたびにログインする方式で実機検証を進めました。

これは当時の Sheet Widget の実装・検証環境で起きた事象です。Picker 全体や現在のすべての iOS 環境で「必ず2回目に失敗する」とは言えません。手元の記録だけでは試行ごとの OS・ブラウザ版を確定できないため、一般的な互換性表としては扱っていません。

現在の実装で、ログインとファイル選択を分ける

2026年10月16日に確認した実装では、次の構成になっています。

  1. アプリの Google サインインで drive.file を要求する。
  2. ファイルを選ぶときは、SFSafariViewController で自サイトの Picker ページを開く。
  3. Picker ページ自身が Google へログインし、ファイルを選択する。
  4. アプリ用のコールバック URL で選択結果を受け取り、選択画面を閉じる。

アプリのアクセストークンを Picker ページへ渡す実装にはしていません。アプリ側の認証と、ブラウザでのファイル選択を別の処理にしたことで、画面遷移と認証情報の扱いを分けて確認できます。

同様のアプリを作るなら、最初に「必要なデータは選択されたファイルだけで足りるか」を決め、その後にブランド情報・公開状態・要求スコープを個別に確認するのがよいと思います。スコープを狭くしても、実機でのファイル選択や再ログインの確認は残ります。

← ブログの一覧へ