シートを中継サーバーに預けない設計——Sheet Widget の保存先と通信先
Sheet Widget は、端末から Google API を利用してシートを取得します。シートの内容を保管・中継する独自のバックエンドを設けていないことが、データ配置の基本方針です。
一方、ファイル選択には公式サイトのWebページとGoogleの認証・Pickerを使います。Google APIや、利用者が有効にした場合のiCloudにも通信します。「サーバーを一切使わない」「どこにも通信しない」という意味ではありません。
最終更新:2026年10月16日。アプリと公開用Pickerの実装を確認し、保存先と通信先を整理しました。
どこに何を置くか
| データ・処理 | 置き場所・通信先 | 目的 |
|---|---|---|
| Googleの認証トークン | 端末のKeychain | アプリ・ウィジェットからの認証付き取得 |
| ウィジェットの設定と取得済みデータ | 端末のApp Group | アプリとウィジェット拡張で共有 |
| シート内の画像のキャッシュ | App Group内のファイル | 描画時にローカルで読み出す |
| 設定の端末間同期 | 利用者自身のiCloud、任意 | 別端末で設定を利用する |
| ファイル選択画面 | sheetwidget.com/picker/ とGoogle |
ファイル選択と認可 |
| セルの値・書式の取得 | 端末からGoogle Sheets APIへ | 最新データを取得する |
静的ページを配信する仕組みと、利用者のシートを保存するデータベースは別です。後者は設けていませんが、前者はアプリのファイル選択に必要です。
認証情報はKeychainで共有する
確認した KeychainStore では、トークンを kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly で保存しています。アプリ本体とウィジェット拡張は、同じKeychainアクセスグループを使います。
この属性では、端末の再起動後に利用者が一度ロックを解除するまで項目へアクセスできず、その後は次の再起動までアクセス可能になります。バックグラウンド処理で必要な項目向けの属性です。Appleの属性説明
ThisDeviceOnly の意味は、別の端末へ復元・移行されないことです。以前の「バックアップにも入らない」という説明は、この属性の意味として不正確でした。Appleは、バックアップ時に端末固有の保護が適用され、別端末へ復元しても使えないクラスとして説明しています。AppleのKeychainデータ保護
また、App GroupはKeychainの代わりになる秘密情報保管庫ではありません。過去に設定領域へ保存したトークンをKeychainへ移す処理が実装されています。端末間の設定同期を有効にしても、認証トークンをそのJSONへ混ぜる設計にはしていません。新しい端末では、Googleへの認証を別途行います。
App Groupは設定とキャッシュを渡す場所
アプリ本体とウィジェット拡張は別の実行単位なので、設定や取得済みデータの受け渡しに共有コンテナを使います。
画像については、CellImageStore で取得時にダウンロードし、長辺480pxを上限に縮小して保存しています。これはウィジェット表示用のキャッシュです。元のスプレッドシート内の画像を書き換える処理ではありません。
この方式なら表示時はローカルの画像を読み出せます。一方、シートの IMAGE() などで外部URLを指定している場合、その画像の取得には指定先への通信が発生します。「Google以外には一切通信しない」という説明にもできません。
Web Pickerが必要な理由と、受け渡すもの
現在の実装では、アプリ内の SFSafariViewController で sheetwidget.com/picker/ を開きます。ページ側がGoogleへログインし、Pickerでファイルを選んだ後、ファイルID・名前・選択アカウントのメールアドレスをアプリ用URLで返します。
アプリ本体のアクセストークンをそのページへ渡す構成にはしていません。ただし、ページ側にもGoogle認証で得たアクセストークンを扱うJavaScriptがあります。このトークンはブラウザ内の処理で扱うため、「認証情報を扱うのはネイティブアプリだけ」という説明でもありません。
ページの配信時には通常のHTTP通信が発生します。ここで区別しているのは、Webページを取得する通信と、開発者のデータ保管APIへシートの中身を送る処理です。後者は設けていません。権限と画面の構成は、drive.fileとPickerの実装記事にもまとめています。
自動更新と通知は、取得できたタイミングに依存する
ウィジェット拡張はGoogle APIを呼び、取得したデータを更新します。自動更新の実行時刻はiOSが管理するため、一定間隔や変更直後の反映は保証されません。手動の更新操作でも、通信や認証に失敗すれば新しいデータは取得できません。
変更通知は、端末で取得前後の内容を比較し、ローカル通知を登録する実装です。Googleからシートの変更が即時にプッシュされる構成ではありません。したがって、シートを編集した時刻と通知が届く時刻には差が生じます。まずウィジェットの更新日時を確認する必要があります。
iCloudへ送るのは設定、既定はオフ
ICloudConfigSync は、NSUbiquitousKeyValueStore に設定JSONと更新の版を保存します。利用者が有効にした場合だけ動作し、既定はオフです。
同期対象はウィジェットの設定であり、認証トークンや取得したセル内容を一緒に同期する処理にはしていません。ただし、設定にも参照するファイルや範囲などの情報は含まれます。「設定だけなら利用者の情報を含まない」という意味ではありません。
アプリ内の設定同期と、OSによる端末バックアップは別の仕組みです。この記事の同期対象の説明を、端末全体のバックアップ対象の保証として読まないでください。
この構成で確認しておきたいこと
同じ構成を採る場合、通常時の表示だけでなく、次の切り分けが役立ちます。
- 再起動後、最初のロック解除前と後で認証情報を読める状態がどう変わるか
- 通信できないときに、古いキャッシュと取得失敗をどう表示するか
- Googleの認可を取り消したときに、再認証へ進めるか
- 別端末へ設定だけ同期したときに、認証なしでデータを表示しようとしないか
- Web Pickerのログイン・選択・アプリ復帰が、実機で最後までつながるか
これは設計上の確認項目で、すべての端末条件で実施済みとする一覧ではありません。独自バックエンドを省くことでデータを預かる範囲を減らせますが、その代わり、OSの実行時刻や認証状態に応じた端末側の処理が必要になります。