【Googleドキュメント】スクリプト実行者と文書オーナーが違う時の共有トラブル対策

GoogleドキュメントでGoogle Apps Script(GAS)を使った自動化を行っていると、スクリプトを実行するユーザーと文書のオーナーが異なるケースが少なくありません。この違いが原因で、スクリプトが正しく動作しなかったり、共有設定が意図通りに適用されないトラブルが発生します。本記事では、こうしたトラブルの原因を明確にし、具体的な確認手順や対応策を解説します。会社で共有ドキュメントを運用する際に役立つ内容ですので、ぜひ参考にしてください。

スクリプト実行者と文書オーナーの違いが原因で起こるトラブルの仕組み

Googleドキュメントにバインドされたスクリプトは、文書のオーナーとは別のユーザーが編集者として実行できます。しかし、スクリプトが使用するAPI(Gmail送信、スプレッドシート操作など)には、実行者がそのAPIへのアクセス権限(スコープ)を承認している必要があります。文書オーナーが承認したスコープは、スクリプト実行者には引き継がれません。そのため、実行者が未承認のスコープを必要とするスクリプトを実行すると、実行時エラーが発生します。

また、スクリプトが文書の共有設定を変更する場合(例えば、特定のユーザーを追加する)、スクリプト実行者がその操作を実行できるかは、文書の共有権限に依存します。一般に、文書のオーナーだけが共有設定を変更できる場合、実行者はDrive APIの適切なスコープを持っていても拒否されることがあります。

よくある失敗パターン:スクリプトによるメール一斉送信の例

例えば、ドキュメント内のリストを元にGmailでメールを送信するスクリプトを考えます。文書オーナーがスクリプトを承認し、正しく動作していたとしても、別の編集者がそのスクリプトを実行しようとすると、「Exception: Service invoked too many times for one day」や「Authorization is required to perform that action」といったエラーが表示されます。これは、実行者がGmail APIのスコープを承認していない、または1日の実行制限に達しているためです。

トラブル発生時の確認手順

以下の手順で、問題の原因を特定してください。各手順は順番に実行することをおすすめします。

1. 文書のオーナーとスクリプト実行者のアカウントを確認する:ドキュメントの共有設定を開き、オーナーと現在の実行者のメールアドレスを確認します。
2. スクリプトエディタの承認状態を確認する:スクリプトエディタを開き、メニューから「実行」→「承認を確認」を選択します。実行者がスコープを承認しているかどうかを確認します。
3. スクリプトが使用するスコープをリストアップする:スクリプト内で使用しているサービス(GmailApp、SpreadsheetApp、DriveAppなど)を確認し、それに対応するスコープを記録します。
4. 実行者としてスクリプトを手動実行し、エラーメッセージを取得する:スクリプトエディタで実際にスクリプトを実行し、表示されるエラーをメモします。エラー内容が権限に関するものか、実行制限に関するものかを見極めます。
5. 文書の共有権限を確認する:スクリプトが共有設定を変更する場合は、現在の実行者が編集者として十分な権限を持っているかを確認します。オーナーのみが変更可能な設定(例:一般公開設定)は、実行者には変更できません。

状況別の対応方法と比較表

原因が特定できたら、以下の対応方法を参考にしてください。表に状況と対策をまとめました。

状況	発生しやすい問題	対応策
スクリプト実行者が未承認のスコープを要求する場合	実行時に「Authorization is required」エラー	実行者自身がスクリプトを一度実行し、承認ダイアログで必要なスコープを許可する。またはオーナーが実行者を一時的にオーナー権限にする。
スクリプトが文書の共有設定を変更する場合	「権限がありません」エラー、共有設定変更が反映されない	スクリプト実行者を文書のオーナーにするか、スクリプト内でDrive APIのスコープ(drive.fileなど)を明示的に要求する。管理者に依頼して実行者に共有設定変更の権限を付与する。
実行者がGoogle Workspaceアカウントで、スコープが管理者により制限されている場合	承認ダイアログが表示されない、または承認後に「アクセスがブロックされました」エラー	管理者に連絡し、該当ユーザーに必要なスコープ(例:Gmail API)の利用を許可するよう依頼する。管理コンソールで「APIアクセス」設定を確認してもらう。

管理者に確認すべき設定項目

会社のGoogle Workspace環境では、管理者が特定のスコープへのアクセスを制限している場合があります。以下の項目を管理者に確認してください。

• 該当ユーザーがスクリプトの承認を行う際に、必要なAPIスコープが組織の許可リストに含まれているか。
• 「Google Apps Script」の「未承認のスクリプトの実行」が許可されているか(デフォルトでは制限されることがあります)。
• 管理コンソールの「セキュリティ」→「API制御」で、サードパーティ製アプリや内部スクリプトのアクセスがブロックされていないか。

再発防止のためのベストプラクティス

トラブルを繰り返さないために、以下の運用ルールをチーム内で徹底することをおすすめします。

• スクリプトのドキュメントは専用のオーナーアカウントで管理する:共有ドキュメントのオーナーを、スクリプトを定期的に実行するアカウント(サービスアカウントや専用ユーザー)に設定します。
• スクリプトの実行前に承認フローを明確にする:新しい編集者がスクリプトを実行する際は、必ず最初に手動で承認を行うよう周知します。
• スクリプト内でエラーハンドリングを実装する:権限不足や実行制限に備え、例外処理(try…catch)を入れて、わかりやすいメッセージを出力するようスクリプトを改修します。
• 定期的に権限を見直す:文書オーナーが退職した場合や異動があった場合、スクリプトの実行に影響が出ないよう、オーナー権限を適切に移行します。

よくある質問

Q1. スクリプトの実行者が文書オーナーと同じであれば、これらのトラブルは起こりませんか?

基本的には起こりません。ただし、スクリプトがオーナー以外のユーザーによって編集された場合、そのユーザーがスクリプトを実行するときに新たな承認が必要になることがあります。また、オーナー自身がスコープを承認している状態でも、別のユーザーがスクリプトを複製して実行すると、同様のトラブルが発生します。

Q2. スクリプトをデプロイ(ウェブアプリなど)した場合はどうなりますか?

デプロイされたスクリプトは、実行ユーザーとして「自分」か「デプロイ時の実行者」かを選択できます。「自分」として実行する場合、エンドユーザーはスクリプトの承認画面に遭遇しませんが、スクリプトがオーナー権限を必要とする操作を行う場合は、デプロイオーナーが関連スコープを承認している必要があります。詳細はGoogleのドキュメントを参照してください。

Q3. 文書のオーナーを変更するリスクはありますか?

オーナーを変更すると、元のオーナーは文書へのアクセス権を失います(共有されていれば引き続き編集可能ですが、オーナー権限は戻りません)。また、スクリプトの承認情報は新しいオーナーに引き継がれず、新しいオーナーが再承認する必要があります。変更前によく検討してください。

まとめ

スクリプト実行者と文書オーナーが異なる場合のトラブルは、承認スコープと共有権限の不一致が主な原因です。まずは実行者の承認状態を確認し、必要なスコープを許可することで多くの問題は解決します。管理者による制限が疑われる場合は、迅速に管理者へ問い合わせてください。再発防止策として、スクリプト用の専用アカウントの利用やエラーハンドリングの実装を検討しましょう。これらの対策を実践することで、Googleドキュメントのスクリプトを安定して運用できるようになります。

📄

Googleドキュメントトラブル完全解決データベースこの記事以外にも、書式・共有・Apps Script・引用など様々な困りごとへの解決策をまとめています。逆引きに活用してください。

🔐

会社アカウント・認証トラブル完全解決データベース 職場または学校アカウント、MFA、Authenticator、VPN、権限、会社ポリシーで止まる問題を横断的に確認できます。