Google グループアドレス・所属メンバー・権限取得スクリプト

2023年3月10日 10:44

はじめまして、株式会社Mobility Technologies IT戦略本部 IT戦略部の宇佐美です。
このページでは、Google グループアドレスの取得、およびグループアドレスに所属するメンバーと権限を一括で取得するスクリプトをご紹介します。

概要

Googleのグループアドレスですが、Google Workspaceにはグループの一覧をエクスポートする手段がなく、どのグループに、どのメンバーが所属しているかを一覧で確認する手段がありません。
なお、同様のスクリプトがないか検索すると、Googleの仕様で200行までしか取得できず、全件取得するにはページネーションを考慮する必要があります。
このページで紹介するスクリプトは、ページネーションを気にせずに一覧を取得できる方法になります！

準備

スクリプト実行するには、ユーザー閲覧とドライブ管理者権限が必要です。両方の権限をもつGoogleアカウントをご用意ください。
リストを表示するためのスプレッドシートを新規作成しておきます。
スプレッドシートのファイル名を任意で入力します。
作成したスプレッドシートの「拡張機能」→「Apps Script」をクリックします。

プロジェクトの名前を任意で入力してください。
Apps Script画面の、サービスを開きます。

「Admin SDK API」の「directory_v1」を選択し、「追加」をクリックします。

同様に、サービスから「Groups Settings API」の「v1」を選択し、「追加」をクリックします

作成

いよいよ作成です！
ファイル名を決めて、以下のコードを貼り付けて保存してください。

//スプレッドシートにメニューを追加
function onOpen() {
  var ui = SpreadsheetApp.getUi();
  var menu = ui.createMenu("実行");
  menu.addItem("グループ・権限取得", "listAllGroupsMembers");
  menu.addToUi();
}

function listAllGroupsMembers() {
 
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var k = 2;
 
  var pageToken, page;
  do {
    page = AdminDirectory.Groups.list({
      domain: 'XXXXXX', //利用中ドメインに書き換えてください
      maxResults: 300,
      pageToken: pageToken
    });
    var groups = page.groups;
    if (groups) {
      for (var i = 0; i < groups.length; i++) {
        var group = groups[i];
          var members = AdminDirectory.Members.list(group.email).members;
          if (members){
            for (var l = 0;l < members.length;l++){
              var member = members[l];
              if (sheet.getRange(k,2) + sheet.getRange(k,3) == group.email + member.email){
              }else{
                sheet.getRange(k,1).setValue(group.name);
                sheet.getRange(k,2).setValue(group.email);
                sheet.getRange(k,3).setValue(member.email);
                sheet.getRange(k,4).setValue(member.role);
                var user;
                try{
                  user = AdminDirectory.Users.get(member.email);
                  if (user){
                    sheet.getRange(k,5).setValue(user.name.fullName);
                  }
                }catch(e){
                  Logger.log(e.message);
                }
                k ++; 
              }
            }
          }
      }
    } else {
      Logger.log('グループがありません');
    }
    pageToken = page.nextPageToken;
  } while (pageToken);
  MailApp.sendEmail("メールアドレス", "処理完了", "listAllGroupMembersの処理が完了しました。"); 
　　　　// 「メールアドレス」に処理が完了したら、完了メールを通知させたメールアドレスを適宜入力してください
}