管理者向けセットアップガイド（組織一括導入）

組織のセキュリティ設定で、TateGaki が必要とする OAuth スコープ（Google Drive の drive.file、メールアドレスの userinfo.email など）が「未承認／未信頼」の状態だと、利用者が同意できず、アクセス権・drive.files.insert 権限のエラーになります。

確認・対処手順

1. 管理者アカウントで admin.google.com にログインします。
2. セキュリティ ＞ アクセスとデータの管理 ＞ API の制御 を開きます。
3. アプリのアクセス制御を管理（サードパーティ製アプリ／Google Workspace Marketplace アプリ）で TateGaki を探します。見つからない場合は「アプリを追加」→ Marketplace アプリから TateGaki を選択します。
4. TateGaki を 「信頼できる（Trusted）」 に設定し、要求される Drive（drive.file）・メールアドレス（userinfo.email）などのスコープへのアクセスを承認します。
5. 対象の組織部門（OU）に設定が適用されていることを確認します。

※ 設定変更の反映には時間がかかる場合があります。反映後、利用者にブラウザの再読み込みとアドオンの再起動を依頼してください。

Marketplace から組織インストールする際、配布対象が「一部の組織部門・グループのみ」に限定されていると、対象外のユーザーはアプリを利用できず、アクセス権エラーになります。

確認・対処手順

1. 管理者アカウントで admin.google.com にログインします。
2. アプリ ＞ Google Workspace Marketplace アプリ ＞ アプリリスト を開きます。
3. 一覧から TateGaki を選択します。
4. 配布（利用可能なユーザー） の設定で、利用させたい組織部門（OU）またはグループを「オン（利用可能）」にします。全社利用の場合は最上位の組織に対してオンにします。
5. 必要に応じて、個々のユーザーがインストールできるよう Marketplace の許可設定（ホワイトリスト等）も確認します。

※ 反映に数十分〜数時間かかることがあります。時間をおいてから、対象ユーザーに再試行を依頼してください。

管理者側の設定（User Access / Data Access）が正しくても、この症状は起こります。まず下記の切り分けを利用者に案内してください。

症状：アドオンは開くのに、「Docsから取り込み」「Docsに書き出し」「Driveに保存」だけが権限エラー（Authorization is required to perform that action.）になります。アドオンの起動自体が失敗することもあります。

原因：複数のGoogleアカウントに同時にログインしていると、アドオンを実行するアカウントと、権限を許可したアカウントが食い違うことがあります。Google側の仕組みによるもので、アドオン側では回避できません。

利用者に案内する対処（どれか1つで解決します）

1. シークレットウィンドウで、使うアカウントだけログインして開いてもらう。
2. 使うアカウントを既定（最初にログインしたアカウント）にしてもらう。
3. Chromeのプロフィールをアカウントごとに分けてもらう。

※ この症状は組織の設定変更では解消しません。利用者側のログイン状態の切り分けが必要です。