Google Apps Script で Google Drive のフォルダ配下のオーナー権限を一括で譲渡する #JavaScript

はじめに

Google Drive の Web UI 上で特定のフォルダ配下のファイル群のオーナー権限を譲渡しようとすると、ファイル毎に権限移譲の操作をしなければなりません。他のプロジェクトに移る際など、一括で権限を譲りたいケースがあるので、 Google Apps Script で一括で譲渡できるスクリプトを実装しました。

※ G Suite には、あるユーザーの全てのファイルを他者に移譲する機能がありますが、これは基本的に離職時に一括移行するためのものです。今回作ったものは、プロジェクト毎にフォルダ管理している場合など、より細かい単位で権限移譲を行うためのものです。

コード全文

コードは GitHub の tanabee/chown-drive-folder に上げています。

コード全文は以下で 30 行ほどで実装できます。以下に簡単にコードの説明をしていきます。

var BASE_FOLDER_ID = PropertiesService.getScriptProperties().getProperty('FOLDER_ID');
var NEW_OWNER = PropertiesService.getScriptProperties().getProperty('NEW_OWNER');
var me = Session.getActiveUser().getEmail();

function main() {
  var folder = DriveApp.getFolderById(BASE_FOLDER_ID);
  chownWithFolder(folder);
}

function chownIfNeeded(fileOrFolder) {
  if (fileOrFolder.getOwner().getEmail() === me) {
    fileOrFolder.setOwner(NEW_OWNER);
  }
}

function chownWithFolder(folder) {
  chownIfNeeded(folder);

  var files = folder.searchFiles('"me" in owners');
  while (files.hasNext()) {
    var file = files.next();
    console.log('file: ', file.getName());
    chownIfNeeded(file);
  }

  var folders = folder.getFolders();
  while (folders.hasNext()) {
    var folder = folders.next();
    console.log('folder: ', folder.getName());
    chownWithFolder(folder);
  }
}

コードの説明

最初の 2 行でフォルダの ID と新しく指定するオーナーをスクリプトプロパティから取得します。スクリプトプロパティは Google Apps Script エディタの ファイル > プロジェクトのプロパティ > スクリプトのプロパティ から指定します。フォルダ ID は Google Drive でフォルダを開いた際の URL でいうと "drive.google.com/drive/u/0/folders/[ここ]" の部分に相当します。スクリプトプロパティを使わずに文字列をベタ書きしてもらっても大丈夫です。

var BASE_FOLDER_ID = PropertiesService.getScriptProperties().getProperty('FOLDER_ID');
var NEW_OWNER = PropertiesService.getScriptProperties().getProperty('NEW_OWNER');

自分自身のメールアドレスは Session クラスから参照します。

var me = Session.getActiveUser().getEmail();

実際に実行する関数です。DriveApp.getFolderById() で指定のフォルダを開いて、 chownWithFolder 関数に渡します。

function main() {
  var folder = DriveApp.getFolderById(BASE_FOLDER_ID);
  chownWithFolder(folder);
}

実際に権限譲渡を行う関数です。自分がオーナーの場合に setOwner 関数を実行し、引数に譲渡するオーナーを指定します。

function chownIfNeeded(fileOrFolder) {
  if (fileOrFolder.getOwner().getEmail() === me) {
    fileOrFolder.setOwner(NEW_OWNER);
  }
}

フォルダを再帰的に探索して、引数で指定されたフォルダ配下のファイル群とフォルダ群の権限変更を行います。 Folder.searchFiles 関数と Folder.getFolders 関数の返り値は配列ではなくイテレーターであり、その後のループ処理の実装が配列の処理と異なるのはそのためです。

function chownWithFolder(folder) {
  chownIfNeeded(folder);

  var files = folder.searchFiles('"me" in owners');
  while (files.hasNext()) {
    var file = files.next();
    console.log('file: ', file.getName());
    chownIfNeeded(file);
  }

  var folders = folder.getFolders();
  while (folders.hasNext()) {
    var folder = folders.next();
    console.log('folder: ', folder.getName());
    chownWithFolder(folder);
  }
}

使い方

README にまとめましたので、そちらを参照してください。

まとめ

以上、権限一括譲渡のスクリプトを実装できました。手作業でポチポチするのはつらいので使ってみてください。本当は Drive の Add-ons の機能が用意されていればそちらで実装したかったのですが、現状は用意されていないようです。用意されたらそちらで実装してみようかと思います。

Google Apps Script で Google Drive のフォルダ配下のオーナー権限を一括で譲渡する

はじめに

コード全文

コードの説明

使い方

まとめ

関連記事