【Googleドキュメント】Apps Scriptで文書を複製できない時の権限エラー確認

GoogleドキュメントをApps Scriptで自動複製する処理を実装したものの、「権限がありません」というエラーが出て困った経験はありませんか。このエラーは、スクリプトが正しく動作するために必要な権限が不足していることが主な原因です。権限エラーは一見複雑に見えますが、原因を段階的に切り分けることで解決できます。本記事では、会社のGoogle Workspace環境でApps Scriptを使って文書を複製する際に発生する権限エラーの確認手順と、具体的な対処方法を詳しく解説します。

Google Apps Scriptで文書を複製する際の権限の仕組み

Apps ScriptがGoogleドキュメントを複製するには、スクリプト自身が適切な権限(スコープ)を持っていることと、実行するアカウントが複製元・複製先に対してアクセス権を持っていることの両方が必要です。権限エラーが発生するメカニズムを理解するために、まずはこれらの仕組みを確認しましょう。

スクリプトの実行に必要な権限(スコープ)

Apps ScriptでGoogleドキュメントの操作を行うには、Drive APIのスコープを明示的にリクエストする必要があります。複製処理で一般的に使うスコープは以下のとおりです。

• drive.file: スクリプトが作成または開いたファイルのみにアクセスする制限的なスコープ。複製先のフォルダ指定が不要な場合に最低限必要です。
• drive.readonly: ファイルの読み取りのみ。複製元ファイルを開くために必要です。
• drive: 全てのファイルへのフルアクセス。広範囲のアクセスが必要な場合に使いますが、管理者の承認が必要なことが多いです。

これらのスコープが不足していると、スクリプトはファイルの読み取りや書き込みができず権限エラーが発生します。

複製先のフォルダやアカウントの権限

スクリプトが正しいスコープを持っていても、実行するユーザーアカウントが複製元ファイルを閲覧できる権限や、複製先フォルダに書き込む権限を持っていなければなりません。また、会社の共有ドライブを複製先にする場合は、その共有ドライブ内での編集権限も必要です。

権限エラーが発生する主な原因

実際にエラーが起きる原因を3つのカテゴリーに分類しました。自分の状況に当てはめて確認してください。

スクリプトの認証スコープ不足

スクリプトを初めて実行する際、認証ダイアログで許可するスコープが表示されます。そこで許可しなかったスコープや、コードでリクエストしていないスコープがあると、後でエラーになります。特に複製処理では、読み取りと書き込みの両方のスコープが必要です。

アカウントのアクセス権限不足

複製元のドキュメントに対する「閲覧者」権限が不足している、または複製先のフォルダに対する「編集者」権限がない場合に発生します。また、共有ドライブを複製先にする場合は、共有ドライブへのアクセス権限と「ファイルを追加」する権限が必要です。

組織のポリシーによる制限

会社のGoogle Workspace管理者が、Apps Scriptに特定のスコープを許可していない場合や、OAuthクライアントIDをホワイトリスト方式で制限している場合があります。この場合、ユーザー側でスコープを追加してもエラーが解消されません。

権限エラーの確認手順

以下の手順を順番に試して、エラーの原因を特定してください。各手順の結果を記録しておくと、管理者に問い合わせる際に役立ちます。

1. エラーメッセージを記録する: スクリプトエディタの実行ログやブラウザのコンソールに表示されるエラーを確認します。よく見られるメッセージは「Exception: You do not have permission to access the document.」や「Drive API returned an error: 403, Insufficient Permission」などです。メッセージをコピーして保存してください。
2. スクリプトの認証スコープを確認する: スクリプトエディタで「プロジェクトの設定」→「認証スコープ」を開き、現在リクエストされているスコープの一覧を確認します。「drive.file」や「drive」が含まれているかをチェックしてください。もし不足している場合は、コードに必要なスコープを明示的に追加します(例:DriveApp.getRootFolder() を使うと自動的に drive スコープが要求されます)。
3. スクリプトを再認証する: スコープを変更した後は、再度認証を行う必要があります。スクリプトエディタで「実行」→「関数を実行」を選び、表示される認証ダイアログで必要な権限を許可してください。以前に拒否したスコープがある場合は、Googleアカウントの「サードパーティのアプリとサービス」から該当するアプリのアクセスを削除してから再試行します。
4. 複製元と複製先のファイル権限を確認する: ブラウザで複製元のドキュメントを開き、「共有」設定を確認します。自分が「閲覧者」以上の権限を持っているか確認します。複製先のフォルダ(または共有ドライブ)でも同様に、自分が「編集者」以上の権限を持っているか確認します。共有ドライブの場合はさらに、「ファイルを追加」権限が必要です。
5. 別のGoogleアカウントで試す: 可能であれば、管理者権限を持つ別のアカウントで同じスクリプトを実行してみてください。成功した場合は、アカウントの権限不足が原因です。失敗した場合は、スクリプト自体か組織のポリシーが問題です。
6. 管理者に問い合わせる: 上記の手順で解決しない場合、管理者に以下の情報を伝えてください(後述の「管理者へ伝えるべき情報」を参照)。

失敗パターンとその対処法

実際に発生しやすい権限エラーのパターンと、それぞれの対処方法を表にまとめました。自分のエラーに近いものを探してみてください。

エラーパターン	原因	対処法
Drive API returned an error: 403, Insufficient Permission	スクリプトのスコープが不足している	コード内で明示的にDriveApp.getRootFolder()を呼び出し、driveスコープをリクエストする。またはマニフェストファイルにスコープを追加する。
You do not have permission to access the document.	複製元のドキュメントに対する読み取り権限がない	複製元ドキュメントの共有設定で、自分のアカウントが閲覧者として追加されているか確認する。必要に応じてファイルの所有者に共有を依頼する。
指定されたフォルダが見つかりません(404)	複製先フォルダに対するアクセス権限がないか、フォルダIDが間違っている	フォルダIDを再確認する。共有ドライブの場合は、フォルダの共有設定で自分が編集者以上の権限を持っているか確認する。共有ドライブ自体に対するアクセス権限も必要。
スクリプトがタイムアウトする	大量のファイルを複製するなど、実行時間が6分を超えた	処理を分割するか、スプレッドシートにログを保存しながらバッチ処理に変更する。権限エラーとは直接関係ありませんが、併発することがあります。

管理者へ伝えるべき情報

権限エラーの原因が組織のポリシーにある場合、管理者の協力が必要です。以下の情報を整理して伝えると、問題解決がスムーズに進みます。

• エラーメッセージのスクリーンショット: 日時とともに表示されたエラーを画像で保存します。
• スクリプトのプロジェクトID( スクリプトID): スクリプトエディタの「プロジェクトの設定」→「スクリプトID」から確認できます。
• リクエストしているスコープの一覧: 同じく「プロジェクトの設定」→「認証スコープ」からコピーします。
• 実行したGoogleアカウントのメールアドレス: エラーが発生したアカウントを特定します。
• 複製元と複製先のファイル/フォルダID: URLの末尾から確認できます。

管理者はこれらの情報をもとに、Google Workspace管理コンソールで「OAuthクライアントアクセス許可」や「APIの制御」設定を確認し、必要に応じてスクリプトを信頼済みとして追加するなどの対応が可能です。

よくある質問(FAQ)

Q1: 複製処理をトリガーで定期的に実行すると権限エラーになります。どうすればいいですか?

トリガーで実行する場合、トリガーを設定したアカウントの権限で動作します。そのアカウントが複製元と複製先にアクセスできるか確認してください。また、トリガーから呼び出す関数内でDriveAppを使う場合、認証スコープがトリガー実行時にも有効である必要があります。一度手動でスクリプトを実行して認証を通しておく必要があります。

Q2: 共有ドライブ内のファイルを複製しようとするとエラーが出ます。

共有ドライブでは、ファイルの複製に特別な権限が必要です。共有ドライブに対する「ファイルの追加」権限がないと複製できません。また、スクリプトが共有ドライブを操作するには、driveスコープ(drive.fileでは不十分)が必要です。管理者に共有ドライブのアクセス権限を確認してもらい、必要ならスコープをdriveに変更してください。

Q3: 「403: Rate Limit Exceeded」というエラーが出ます。権限エラーですか?

これはAPIの呼び出し制限に達したエラーです。権限エラーとは異なりますが、大量のファイルを短時間に複製しようとすると発生します。対処法として、Utilities.sleep()で遅延を入れるか、処理を分割してください。

まとめ

GoogleドキュメントをApps Scriptで複製できない権限エラーは、スクリプトのスコープ設定、アカウントのファイル権限、そして組織のポリシーの3つの視点で切り分けることが重要です。エラーメッセージを正確に読み取り、本記事で紹介した手順を順に実行することで、ほとんどの原因を特定できます。特に会社の環境では管理者の設定が影響するケースが多いため、必要な情報を整理して問い合わせる準備をしておきましょう。もし自己解決が難しい場合は、早めに担当者へ連絡することをおすすめします。

📄

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

🔐

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