【GAS入門#50】Googleドライブのファイル閲覧権限を自動付与!File.addViewer()の使い方と権限管理の完全ガイド

業務やイベントの準備で、「この資料、メンバーに閲覧権限をつけておいて!」「勉強会の参加者全員にPDFの閲覧許可を出してほしい」と頼まれることはありませんか?

手動でGoogleドライブの「共有」ボタンを押し、メールアドレスを1人ずつ入力して、権限を「閲覧者」に切り替えて送信する……。対象が数人ならすぐ終わりますが、十数人〜数十人となるとかなりの時間と手間がかかりますよね。入力ミスや権限の指定ミスも心配です。

そこで活躍するのが、Google Apps Script(GAS)でファイルの閲覧権限を自動付与できる File.addViewer() です!

今回は、札幌で開催される「札幌ITエンジニア勉強会」の配布資料を題材に、指定したファイルに同僚や参加者の閲覧権限を一括で自動付与する方法を分かりやすく解説します。フェーズ5(Google Drive・ファイル管理)の集大成となる第50回、ぜひマスターしていきましょう!

1. そもそも File.addViewer() とは?

File.addViewer() は、Googleドライブ上の特定のファイル(Fileオブジェクト)に対して、指定したユーザー(メールアドレス)に 「閲覧者(Viewer)」の権限を追加する命令(メソッド) です。

コードの基本構造

// 1. ファイルを取得する(引き出しからファイルを取り出す)
var file = DriveApp.getFileById("FILE_ID");

// 2. 指定したメールアドレスに閲覧権限を付与する
file.addViewer("member@example.com");

Googleドライブの3大権限とGASメソッドの比較

Googleドライブでは、ユーザーごとにアクセス権限を細かく設定できます。GASにもそれぞれの権限に対応したメソッドが用意されています。

アクセス権限ドライブ上の表示ユーザーができること単一ユーザー付与メソッド複数ユーザー(配列)付与メソッド
閲覧者閲覧者ファイルの閲覧・ダウンロードのみ(編集不可)File.addViewer() ★今回!File.addViewers()
閲覧者(コメント可)閲覧者(コメント可)閲覧に加えて、コメントの追加が可能File.addCommenter()File.addCommenters()
編集者編集者ファイルの編集、削除、権限の変更が可能File.addEditor()File.addEditors()

「資料を共有したいけれど、勝手に内容を書き換えられたくない!」という場面では、今回扱う File.addViewer() が最も安全で最適な選択肢となります。

2. STEP1:準備!「札幌エンジニア勉強会資料」を用意しよう

まずは、GASで共有設定テストを行うためのファイルを用意し、その「ファイルID」を取得しましょう。

手順

  1. Googleドライブを開く
    Googleドライブにアクセスします。
  2. テスト用ファイルを用意する
    ドライブ上に適当なファイル(例:Googleドキュメント、Googleスライド、またはPDFファイル)を作成またはアップロードし、名前を 「札幌エンジニア勉強会資料」 に変更します。
  3. ファイルIDを取得する
    ファイルを開いた際のブラウザのURLから、ファイルID(ランダムな英数字の文字列)をコピーします。
    • 例:https://docs.google.com/document/d/1a2b3c4d5e6f7g8h9i0j_EXAMPLE_ID/edit の場合、1a2b3c4d5e6f7g8h9i0j_EXAMPLE_ID の部分がファイルIDです。

3. STEP2:【実践】1人のユーザーに閲覧権限を付与してみよう!

準備ができたら、GASのエディタを開いて基本のコードを書いていきましょう。

1. コードを入力する

スプレッドシートまたは独立したGASエディタ(拡張機能 > Apps Script)を開き、以下のコードを貼り付けます。ファイルIDとメールアドレスは、ご自身のテスト環境のものに書き換えてください。

function addSingleViewer() {
  // ① 操作対象のファイルIDを指定
  var fileId = "PASTE_YOUR_FILE_ID_HERE"; // ご自身のファイルIDに置き換えてください
  
  // ② ファイルオブジェクトを取得(第41回〜第44回でおなじみの操作!)
  var file = DriveApp.getFileById(fileId);
  
  // ③ 付与したい同僚のメールアドレスを指定
  var userEmail = "sapporo.member@example.com"; // 実在するアカウントまたはテスト用アドレス
  
  // ④ 閲覧権限(Viewer)を付与
  file.addViewer(userEmail);
  
  // ⑤ ログに出力して完了確認
  Logger.log("ファイル「" + file.getName() + "」に " + userEmail + " さんの閲覧権限を付与しました!");
}

2. コードの解説

  • DriveApp.getFileById(fileId)
    第44回や第49回でも登場した命令ですね。指定したIDをもとにGoogleドライブからファイル全体(Fileオブジェクト)を取得します。
  • file.addViewer(userEmail)
    取得したファイルに対して .addViewer() を呼び出し、引数にメールアドレス(文字列)を渡します。これだけでGoogleドライブの共有設定が更新され、対象ユーザーに閲覧者権限が付与されます。

3. 実行して結果を確認する

  1. エディタ上部の 「保存(フロッピーマーク)」 をクリックします。
  2. 関数を addSingleViewer に合わせて 「実行」 をクリックします。※初回実行時はGoogleドライブへのアクセス承認画面が表示されますので、画面の指示に従ってアクセスを許可してください(第2回で解説した手順と同様です)。
  3. Googleドライブで該当ファイルの「共有」設定を開いてみましょう。指定したメールアドレスが「閲覧者」として追加されていれば成功です!

4. STEP3:実務で大活躍!スプレッドシートの参加者リストから一括共有(応用例)

実務やコミュニティ運営では、「スプレッドシートに入力された参加者リスト全員に、自動で閲覧権限を付与したい」というケースがほとんどですよね。

第7回で学んだ Range.getValues() や配列処理を組み合わせて、スプレッドシートのメールアドレス一覧から一括で addViewer() を実行する実践的なスクリプトを作成してみましょう!

1. 練習用スプレッドシートの用意

スプレッドシートに「参加者一覧」シートを作成し、以下のようにデータを準備します。

ABC
1氏名役職/所属メールアドレス
2札幌 太郎エンジニアtaro@example.com
3大通 花子デザイナーhanako@example.com
4すすきの 次郎ディレクターjiro@example.com

2. 一括共有コード

function addViewersFromSheet() {
  // ① 勉強会資料のファイルIDと、スプレッドシートの取得
  var fileId = "PASTE_YOUR_FILE_ID_HERE";
  var file = DriveApp.getFileById(fileId);
  
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("参加者一覧");
  
  // ② データが存在する最終行を取得(第11回で学んだ getLastRow)
  var lastRow = sheet.getLastRow();
  if (lastRow < 2) {
    Logger.log("対象のデータが存在しません。");
    return;
  }
  
  // ③ C2セルから最終行までのメールアドレスを一括取得(第13回 getValues)
  // getRange(開始行, 開始列, 行数, 列数)
  var emailValues = sheet.getRange(2, 3, lastRow - 1, 1).getValues();
  
  // ④ 取得したメールアドレスを順に処理
  var addedCount = 0;
  for (var i = 0; i < emailValues.length; i++) {
    var email = emailValues[i][0];
    
    // 空欄でないかチェック
    if (email !== "") {
      file.addViewer(email);
      Logger.log((i + 1) + "人目: " + email + " に閲覧権限を付与しました");
      addedCount++;
    }
  }
  
  Logger.log("【処理完了】合計 " + addedCount + " 名に「" + file.getName() + "」の閲覧権限を自動付与しました!");
}

💡 複数人にまとめて付与する addViewers() を使うアプローチ

GASには、1人ずつ繰り返し addViewer() を実行する代わりに、メールアドレスの配列をまとめて渡せる File.addViewers()(末尾に s がつく複数形)も用意されています。

// メールアドレスの配列を一括で渡す例
var emailList = ["taro@example.com", "hanako@example.com", "jiro@example.com"];
file.addViewers(emailList);

人数が非常に多い場合は、addViewers() を使うことでGASの処理時間を短縮し、スマートに記述できます!

5. 初心者が絶対につまずく!4大トラップと完全対処法

File.addViewer() を使用する際によく発生するエラーやハマりポイントをまとめました。

トラップ1:addViewer(単数)と addViewers(複数)の渡し間違い

  • 単数形 addViewer("email"):引数に 文字列(1つのメールアドレス) を渡します。
  • 複数形 addViewers(["email1", "email2"]):引数に 配列(メールアドレスのリスト) を渡します。

addViewer(["email1", "email2"]) のように単数形のメソッドに配列を渡してしまうと、型エラーが発生するか、正しく共有が行われません。引数のデータ型に合わせて使い分けましょう。

トラップ2:自分のアカウントに権限変更の権限がない

Googleドライブのファイル権限を変更できるのは、原則として 「ファイルのオーナー(所有者)」 または 「編集権限を持つユーザー」 のみです。

閲覧権限しか持っていないファイルをGASから操作しようとすると、Exception: You do not have permission to call DriveApp.getFileById... やアクセス権限エラーが発生します。GASを実行するアカウントがそのファイルの編集権限以上を持っているか確認してください。

トラップ3:メールアドレスの入力ミスや組織外ドメイン制限

  • メールアドレスの綴りが間違っていると、権限付与に失敗します。
  • 企業のGoogle Workspaceアカウントを使用している場合、管理者設定によって「組織外のドメインへのファイル共有」が制限されていることがあります。その場合、外部のアドレス(@gmail.comなど)を追加しようとするとエラーになります。

トラップ4:通知メールが送信されるタイミング

addViewer() を実行すると、Googleの仕様により対象ユーザーへ「ファイルが共有されました」という通知メールが自動的に送信される場合があります。

テスト実行時に同僚のアドレスを指定すると、意図せずテストメールが届いてしまう可能性があるため、まずは自分のサブアカウントや承認を得たテスト用アドレスで動作確認を行うのがおすすめです。

6. フェーズ5(Google Drive・ファイル管理)完結!おさらいと次回予告

第41回からスタートした「フェーズ5:Google Drive・ファイル管理」も、今回の第50回で見事完結となります!

ここで一度、フェーズ5でマスターしたDrive操作の命令をおさらいしてみましょう。

  • 第41回:DriveApp.getFolderById() でフォルダを特定
  • 第42回:Folder.createFile() で新規ファイルを作成
  • 第43回:Folder.getFiles() でフォルダ内のファイル一覧を取得
  • 第44回:File.makeCopy() でテンプレートファイルを複製
  • 第45回:File.setName() でファイル名を動的にリネーム
  • 第46回:File.moveTo() でファイルを指定フォルダへ自動移動
  • 第47回:File.setTrashed() で不要ファイルをゴミ箱へ移動
  • 第48回:DriveApp.createFolder() で新しいフォルダを動的生成
  • 第49回:File.getDownloadUrl() でダウンロード直リンクを取得
  • 第50回:File.addViewer() でファイルの閲覧権限を自動付与 ★今回!

スプレッドシートやGmailの操作だけでなく、Googleドライブ上のファイル生成・整理・権限管理までプログラミングで自在にコントロールできるスキルが身につきましたね!

次回からは、いよいよ 「フェーズ6:Docs・Slides・Forms連携(第51回〜第60回)」 に突入します!