【Googleドキュメント】自動生成した文書の共有権限が付かない時のスクリプト修正

Google Apps Script(GAS)で自動生成したGoogleドキュメントに対し、特定のユーザーやグループへの共有権限を付与しようとした際、権限が反映されない現象が発生することがあります。スクリプト自体はエラーなく終了しているのに、共有設定が有効にならないケースが多く、原因の特定に時間がかかる場合があります。本記事では、この問題の原因をコードレベルで切り分け、修正手順を具体的に解説します。特に、会社の管理下にあるアカウントで運用する場合の注意点についても触れます。

1. 共有権限が付かない原因を特定する

自動生成したドキュメントの共有権限が付かない原因は、大きく分けて「スクリプトのコード」「APIの有効化」「OAuthスコープ」「実行環境の制限」の4つに分類できます。それぞれの原因を順に確認することで、問題の切り分けが可能です。

1.1 コード上の問題:DriveApp.addEditor()の制限

もっとも多いのが、DriveApp.addEditor()を使用しているケースです。DriveApp.addEditor()は、スクリプト実行ユーザーがドキュメントのオーナーである場合にのみ機能します。スクリプトがサービスアカウントや別のユーザー権限で実行されていると、権限付与がスキップされたりエラーになったりします。また、DriveApp.addEditor()はドキュメントの共有設定を変更するための適切なスコープ(https://www.googleapis.com/auth/drive.file)を必要とします。

1.2 高度なGoogleサービス(Advanced Drive Service)の未有効化

より細かい権限制御が必要な場合は、高度なGoogleサービスであるDrive API(v2またはv3)を有効にして、Drive.Permissions.insert()やDrive.Permissions.create()を使用します。ただし、このサービスをスクリプトエディタで明示的に有効化していないと、スクリプト実行時に「ReferenceError: Drive is not defined」が発生します。権限が付かない現象の裏で、このエラーがキャッチされずに無視されているケースもあります。

1.3 OAuthスコープの不足

スクリプトに必要なスコープが設定されていない場合、権限付与が拒否されます。特に、会社のGoogle Workspaceアカウントでは、管理者がOAuthスコープを制限していることがあります。例えば、「drive.file」スコープだけでは、他のユーザーに権限を付与する操作が許可されない場合があります。実際には「drive」スコープ(広範なアクセス)が必要なケースもあります。

権限付与方法	必要なスコープ	オーナー制限	推奨用途
DriveApp.addEditor()	drive.file	あり(実行ユーザーがオーナー)	単純な権限追加
Drive.Permissions.insert()	drive (full) または drive.file + manage permissions	なし(オーナー権限不要)	複雑な権限設定

2. スクリプトの修正ポイント

原因を特定したら、コードを修正します。ここでは、代表的な修正方法を3つ紹介します。

2.1 DriveApp.addEditor()からDrive APIへの切り替え

DriveApp.addEditor()で権限が付かない場合、高度なGoogleサービスであるDrive APIを使用します。まず、スクリプトエディタの「リソース」→「高度なGoogleサービス」で「Drive API」を「オン」にします。次に、以下のようなコードで権限を追加します。

例:
var fileId = 'xxxxxxxx';
var resource = {
'type': 'user',
'role': 'writer',
'emailAddress': 'user@example.com'
};
Drive.Permissions.insert(resource, fileId);

2.2 スコープの明示的な指定

OAuthスコープが不足している場合は、スクリプトのマニフェストファイル(appsscript.json)にスコープを追加します。または、スクリプトエディタの「プロジェクトの設定」からスコープを確認し、必要に応じて再承認を促します。会社のアカウントでは、管理者が承認したスコープしか使えないため、管理者に追加を依頼してください。

2.3 実行モードの確認

スクリプトがトリガーやウェブアプリとして実行される場合、実行ユーザーがドキュメントのオーナーとは限りません。特に、時間主導型トリガーではトリガー作成者の権限で実行されます。そのため、ドキュメントのオーナーが実行ユーザーとは異なる場合、権限が付与されないことがあります。この問題を回避するには、サービスアカウントを使用するか、ドキュメントのオーナー権限をスクリプト実行ユーザーに委譲する必要があります。

3. 具体的な修正手順

ここでは、DriveApp.addEditor()からDrive APIに切り替える具体的な手順を説明します。以下の順序で進めてください。

1. スクリプトエディタを開き、メニューから「リソース」→「高度なGoogleサービス」をクリックします。
2. 表示された一覧から「Drive API」のスイッチを「オン」にし、下の「Google Cloud Platform(GCP)プロジェクト」のダイアログで「Drive API」を有効化します(まだの場合はリンクからAPIライブラリで有効化)。
3. スクリプトにDrive APIを使用するためのコードを追加します。既存のDriveApp.addEditor()をコメントアウトし、代わりにDrive.Permissions.insert()を使用します。
4. スクリプトのマニフェストファイル(appsscript.json)を開き、必要なOAuthスコープを追加します。例:”oauthScopes”: [“https://www.googleapis.com/auth/drive”]
5. 変更を保存し、スクリプトを再実行します。初回実行時には認証ダイアログが表示されるので、必要な権限を承認します。
6. 生成されたドキュメントの共有設定を確認し、権限が正しく付与されているか検証します。

手順4で追加するスコープは、会社のポリシーによっては承認されない場合があります。その場合は管理者に連絡し、プロジェクトのOAuth同意画面にスコープを追加してもらう必要があります。

4. 失敗パターンと対処法

実際によく発生する失敗パターンを3つ紹介します。

4.1 「Drive is not defined」エラー

高度なGoogleサービスを有効にしていない場合に発生します。対処法は、上記手順1〜2でDrive APIを有効にすることです。ただし、GCPプロジェクトが正しくリンクされていないと、有効化してもエラーが続くことがあります。その場合は、GCPコンソールでプロジェクトを確認し、Drive APIが有効になっているか直接チェックしてください。

4.2 権限は付与されたが表示されない

スクリプトが正常終了しても、ドキュメントの共有設定にユーザーが追加されていないように見える場合があります。これは、スクリプトが異なるファイル(コピーやテンプレート)に対して権限を設定している可能性が高いです。生成されたドキュメントのIDをログ出力して、正しいファイルを操作しているか確認してください。

4.3 会社アカウントで認証が通らない

会社のGoogle Workspaceアカウントでは、管理者がOAuthスコープのホワイトリストを設定しているため、承認画面で「このアプリはブロックされました」と表示されることがあります。この場合、管理者にスクリプトのスコープ(特にdriveスコープ)を承認してもらう必要があります。また、内部アプリとしてGoogle Workspace Marketplaceに公開する方法もあります。

5. 管理者に確認すべき設定

会社のGoogle Workspace環境でスクリプトを動作させる場合、以下の設定を管理者に確認してください。

• OAuthスコープの制限: 管理者コンソールの「APIとサービス」→「OAuth同意画面」で、利用可能なスコープが制限されていないか確認します。必要に応じて、driveスコープを追加してもらいます。
• APIの有効化: GCPプロジェクトでDrive APIが有効になっているか確認します。管理者がAPIの利用制限をかけている場合があります。
• サービスアカウントの利用: スクリプトをサービスアカウントで実行する場合、そのサービスアカウントにドメイン全体の権限委譲が必要なことがあります。管理者に依頼して設定してもらいます。

6. よくある質問

Q1. DriveApp.addEditor()でエラーは出ないのに権限が付かないのはなぜですか?
A. スクリプト実行ユーザーがドキュメントのオーナーでない場合、addEditor()は何もせずに終了することがあります。エラーを起こさないため気づきにくいですが、オーナー権限を確認してください。

Q2. Drive.Permissions.insert()を使用しても権限が付かない場合は?
A. スコープが不足している可能性が高いです。スクリプトの実行ログでGoogle APIsコンソールのエラーを確認するか、マニフェストファイルにdriveスコープを追加してみてください。

Q3. サービスの有効化は全てのユーザーに影響しますか?
A. 高度なGoogleサービスの有効化はスクリプトプロジェクト単位です。ただし、GCPプロジェクトのAPI有効化はプロジェクト全体に影響するため、他のスクリプトに影響を与える可能性があります。管理者と相談の上で行ってください。

7. まとめ

自動生成したGoogleドキュメントの共有権限が付かない場合、まずはスクリプトの権限付与方法とOAuthスコープを確認してください。DriveApp.addEditor()はシンプルですがオーナー制限があるため、高度なGoogleサービスのDrive APIを使う方が安定します。会社のアカウントでは管理者による制限が影響することが多いため、早めに管理者へ相談することをおすすめします。スクリプトの実行ユーザーとドキュメントのオーナーが一致しているかも重要なチェックポイントです。

📄

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

🔐

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