雑記

Classroomにおいては一部の生徒にのみお知らせを流したい, という場面が結構ある。これをGUIで行うのは結構大変なので、Google classroomで特定の生徒にのみストリーム投稿を流すコンテナバインドGASをGeminiに書かせてみました。事前にサービス[+]からClassroom APIを追加しておく必要があるので注意。

function postAnnouncementToSpecificStudents() {

  // ==========================================

  // ▼ 設定エリア

  // ==========================================

  // 1. 対象のコースID (ClassroomのURL末尾の数字)

  // 対象のURL

  var url = "URLを入力";

  // 1-1. URLの不要な部分を削除

  // replaceを使って指定の文字列を空文字に置換します

  var encodedString = url.replace("https://classroom.google.com/c/", "");

  // 1-2. GAS専用の機能でBase64をデコードする

  // Utilities.base64Decode を使い、バイト配列を文字列に変換します

  var decodedBytes = Utilities.base64Decode(encodedString);

  var COURSE_ID = Utilities.newBlob(decodedBytes).getDataAsString();

  // 2. 投稿するメッセージ

  const MESSAGE_TEXT = '対象の生徒のみなさんへのお知らせです。';

  // ==========================================

  // ▲ 処理実行

  // ==========================================

  try {

    // 1. アクティブなスプレッドシートから対象者（E列が〇）のメールアドレスを取得

    //    ※シートのURL指定は不要になりました

    const targetEmails = getTargetEmailsFromSheet_();

    if (targetEmails.length === 0) {

      console.log('E列に「〇」がついている対象者が見つかりませんでした。処理を終了します。');

      return;

    }

    console.log(`スプレッドシート上の対象者数: ${targetEmails.length}名`);

    // 2. メールアドレスからClassroom上の生徒ID（userId）を検索・取得

    const targetStudentIds = getStudentIdsByEmails_(COURSE_ID, targetEmails);

    if (targetStudentIds.length === 0) {

      console.log('Classroom内で対象の生徒IDを特定できませんでした。');

      return;

    }

    // 3. 投稿データを作成

    const announcementResource = {

      text: MESSAGE_TEXT,

      state: 'PUBLISHED',

      assigneeMode: 'INDIVIDUAL_STUDENTS', // 個別指定モード

      individualStudentsOptions: {

        studentIds: targetStudentIds

      }

    };

    // 4. API経由で投稿

    const response = Classroom.Courses.Announcements.create(announcementResource, COURSE_ID);

    console.log('投稿が完了しました。');

    console.log(`投稿ID: ${response.id}`);

    console.log(`対象人数: ${targetStudentIds.length}名`);

  } catch (e) {

    console.error(`エラーが発生しました: ${e.message}`);

    if (e.message.includes('not found')) {

      console.error('ヒント: コースIDが正しいか確認してください。');

    }

  }

}

/**

 * アクティブなスプレッドシートの1枚目のシートを読み込み、

 * E列が'〇'の行のA列(メールアドレス)を返す関数

 */

function getTargetEmailsFromSheet_() {

  // コンテナバインドされている現在のスプレッドシートを取得

  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // 一番左のシートを取得（必要に応じて getSheetByName('シート名') に変更してください）

  const sheet = ss.getSheets()[0];

  // データ範囲を取得

  const data = sheet.getDataRange().getValues();

  const emails = [];

  // 1行目はヘッダーと仮定し、2行目(index 1)からループ

  for (let i = 1; i < data.length; i++) {

    const row = data[i];

    const email = row[0]; // A列 (index 0)

    const mark = row[4];  // E列 (index 4)

    // E列が '〇' かつ メールアドレスがある場合

    if (mark === '〇' && email) {

      emails.push(email.toString().trim());

    }

  }

  return emails;

}

/**

 * コース内の全生徒を取得し、指定されたメールアドレスに一致する生徒のIDリストを返す関数

 * (この関数は前回のまま変更ありません)

 */

function getStudentIdsByEmails_(courseId, targetEmails) {

  let studentIds = [];

  let pageToken = null;

  const targetEmailSet = new Set(targetEmails.map(e => e.toLowerCase()));

  do {

    const response = Classroom.Courses.Students.list(courseId, {

      pageToken: pageToken,

      pageSize: 100

    });

    const students = response.students;

    if (students && students.length > 0) {

      students.forEach(student => {

        const email = student.profile.emailAddress.toLowerCase();

        if (targetEmailSet.has(email)) {

          studentIds.push(student.userId);

        }

      });

    }

    pageToken = response.nextPageToken;

  } while (pageToken);

  return studentIds;

}