🍒 구글 스프레드시트 × 그라운드 API 연동 가이드

/**
 * 그라운드 API 설정
 * ⚠️ 실제 API 키와 클래스 ID로 변경하세요!
 */
const GROWND_API_KEY = 'sk_live_your_api_key_here'; // 발급받은 API 키
const GROWND_CLASS_ID = 'your_class_id_here'; // 클래스 ID
const GROWND_API_URL = 'https://growndcard.com/api/v1'; 

/**
 * 메뉴에 커스텀 버튼 추가
 */
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('🎯 그라운드')
    .addItem('선택한 학생에게 포인트 부여', 'awardPointsToSelected')
    .addItem('전체 학생에게 포인트 부여', 'awardPointsToAll')
    .addSeparator()
    .addItem('설정', 'showSettings')
    .addToUi();
}

/**
 * 선택한 학생에게 포인트 부여
 */
function awardPointsToSelected() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const ui = SpreadsheetApp.getUi();
  
  // 확인 대화상자
  const response = ui.alert(
    '포인트 부여 확인',
    '선택된 학생들에게 포인트를 부여하시겠습니까?',
    ui.ButtonSet.YES_NO
  );
  
  if (response !== ui.Button.YES) {
    return;
  }

  // 데이터 범위 가져오기 (2행부터 시작, 헤더 제외)
  const dataRange = sheet.getRange(2, 1, sheet.getLastRow() - 1, 6);
  const data = dataRange.getValues();
  
  let successCount = 0;
  let failCount = 0;

  // 각 행 처리
  for (let i = 0; i < data.length; i++) {
    const [checked, studentCode, name, points, description, status] = data[i];
    
    // 체크박스가 선택된 행만 처리
    if (checked === true) {
      // 상태 업데이트: 처리 중
      sheet.getRange(i + 2, 6).setValue('⏳ 처리 중...');
      SpreadsheetApp.flush(); // 즉시 화면 업데이트
      
      try {
        const result = awardPointToStudent(studentCode, points, description);
        
        if (result.success) {
          sheet.getRange(i + 2, 6).setValue(`✅ ${points}P 부여 완료`);
          successCount++;
        } else {
          sheet.getRange(i + 2, 6).setValue(`❌ ${result.error}`);
          failCount++;
        }
      } catch (error) {
        sheet.getRange(i + 2, 6).setValue(`❌ ${error.message}`);
        failCount++;
      }
      
      SpreadsheetApp.flush();
    }
  }

  // 결과 알림
  ui.alert(
    '포인트 부여 완료',
    `성공: ${successCount}명\n실패: ${failCount}명`,
    ui.ButtonSet.OK
  );
}

/**
 * 전체 학생에게 포인트 부여
 */
function awardPointsToAll() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const ui = SpreadsheetApp.getUi();
  
  // 확인 대화상자
  const response = ui.alert(
    '전체 포인트 부여 확인',
    '전체 학생에게 포인트를 부여하시겠습니까?',
    ui.ButtonSet.YES_NO
  );
  
  if (response !== ui.Button.YES) {
    return;
  }

  const dataRange = sheet.getRange(2, 2, sheet.getLastRow() - 1, 5); // 체크박스 제외
  const data = dataRange.getValues();
  
  let successCount = 0;
  let failCount = 0;

  for (let i = 0; i < data.length; i++) {
    const [studentCode, name, points, description, status] = data[i];
    
    if (studentCode && points) {
      sheet.getRange(i + 2, 6).setValue('⏳ 처리 중...');
      SpreadsheetApp.flush();
      
      try {
        const result = awardPointToStudent(studentCode, points, description);
        
        if (result.success) {
          sheet.getRange(i + 2, 6).setValue(`✅ ${points}P 부여 완료`);
          successCount++;
        } else {
          sheet.getRange(i + 2, 6).setValue(`❌ ${result.error}`);
          failCount++;
        }
      } catch (error) {
        sheet.getRange(i + 2, 6).setValue(`❌ ${error.message}`);
        failCount++;
      }
      
      SpreadsheetApp.flush();
    }
  }

  ui.alert(
    '포인트 부여 완료',
    `성공: ${successCount}명\n실패: ${failCount}명`,
    ui.ButtonSet.OK
  );
}

/**
 * 개별 학생에게 포인트 부여 (내부 함수)
 */
function awardPointToStudent(studentCode, points, description) {
  const url = `${GROWND_API_URL}/classes/${GROWND_CLASS_ID}/students/${studentCode}/points`;
  
  const options = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      'X-API-Key': GROWND_API_KEY
    },
    payload: JSON.stringify({
      type: 'reward',
      points: points,
      description: description || '스프레드시트에서 부여',
      source: 'google_sheets'
    }),
    muteHttpExceptions: true
  };

  try {
    const response = UrlFetchApp.fetch(url, options);
    const statusCode = response.getResponseCode();
    const contentText = response.getContentText();
    
    // HTML 응답 체크 (에러 페이지 방지)
    if (contentText.startsWith('<')) {
      console.error('HTML 응답:', contentText.substring(0, 200));
      return { 
        success: false, 
        error: `API 응답 오류 (상태 ${statusCode}). URL을 확인하세요.` 
      };
    }
    
    const result = JSON.parse(contentText);
    
    return result.success 
      ? { success: true } 
      : { success: false, error: result.error.message };
      
  } catch (error) {
    console.error('API 호출 에러:', error);
    return { success: false, error: error.message };
  }
}

/**
 * 설정 대화상자
 */
function showSettings() {
  const ui = SpreadsheetApp.getUi();
  ui.alert(
    '⚙️ API 설정',
    `현재 설정:\n\n` +
    `API 키: ${GROWND_API_KEY.substring(0, 15)}...\n` +
    `클래스 ID: ${GROWND_CLASS_ID}\n\n` +
    `설정을 변경하려면 Apps Script 코드를 수정하세요.`,
    ui.ButtonSet.OK
  );
}