Google Sheets 데이터를 기반으로 모두싸인 문서 생성하기

const SHEET_NAME = "테스트";
const API_URL = "https://api.modusign.co.kr/documents/request-with-template";
const EMAIL = "[email protected]"; // <-- 본인의 이메일 입력
const API_KEY = PropertiesService.getScriptProperties().getProperty("API_KEY"); // <-- 본인의 API Key 입력
const TEMPLATE_ID = "cecaea70-307f-11f0-a0e2-5f510e16c1d3"; // <-- 템플릿 ID 입력
const START_COLUMN = 7; // '문서편집' 입력란 필드 시작
const NUM_COLUMNS = 6; // '문서편집' 입력란 필드 갯수
const TRIGGER_COLUMN_INDEX = 13; // 문서전송 트리거 컬럼: N열 (0-indexed)


function sendRowToModusign(sheet, rowNumber) {
  Logger.log(`🚀 sendRowToModusign 실행: rowNumber = ${rowNumber}`);
  const { row, headerRow } = getRowAndHeader(sheet, rowNumber);

  const payload = buildPayload(TEMPLATE_ID, headerRow, row, START_COLUMN, NUM_COLUMNS);

  Logger.log("📥 요청 페이로드: " + JSON.stringify(payload));
  Logger.log("📤 요청 전송 시작");

  const options = buildRequestOptions(EMAIL, API_KEY, payload);

  const response = UrlFetchApp.fetch(API_URL, options);
  const responseCode = response.getResponseCode();
  const responseText = response.getContentText();

  Logger.log("📤 응답 코드: " + responseCode);

  if (responseCode >= 400) {
    const message = `❌ 전송 실패 [${responseCode}]: ${parseModusignError(responseCode, responseText)}`;
    Logger.log(message);
    const html = HtmlService.createHtmlOutput(`
      <div style="padding:20px; font-family:sans-serif;">
        ${message}
      </div>
    `).setWidth(400).setHeight(200);
    SpreadsheetApp.getUi().showModalDialog(html, "전송 실패");


    sheet.getRange(rowNumber, TRIGGER_COLUMN_INDEX + 1).setValue("전송 실패");
    return;
  }
  else if(responseCode === 201){
  const message = `✅ ${row[2]}님의 문서 전송 성공`;
  const html = HtmlService.createHtmlOutput(`
      <div class="modal-body">
        <p>${message}</p>
      </div>
`).setWidth(400).setHeight(200);
  SpreadsheetApp.getUi().showModalDialog(html, "알림");
  sheet.getRange(rowNumber, TRIGGER_COLUMN_INDEX + 1).setValue("전송 완료");
  }

}

function createInputMappings(headerRow, row, startColumn, numColumns) {
  const mappings = [];

  for (let j = 0; j < numColumns; j++) {
    const header = headerRow[startColumn + j]?.trim();
    const cellValue = row[startColumn + j];

    if (!header) continue;

    // "계약 연봉 총액:text" → dataLabel = "계약 연봉 총액", fieldType = "text"
    const [dataLabel, fieldType = "text"] = header.split(":");

    // 타입에 따른 value 처리
    let parsedValue;
    if (fieldType === "checkbox") {
      // Google Sheets에서 checkbox는 true/false 또는 체크/미체크로 반환됨
      parsedValue = cellValue === true || String(cellValue).toLowerCase() === "true";
    } else {
      parsedValue = String(cellValue);
    }

    mappings.push({
      dataLabel,
      value: parsedValue
    });
  }

  return mappings;
}

function buildPayload(templateId, headerRow, row, startColumn, numColumns) {
  const name = row[2]; // C열
  const title = row[3]; // D열
  const methodType = row[4]; // E열
  const contact = methodType === "EMAIL" ? row[5] : row[6];
  const requesterInputMappings = createInputMappings(headerRow, row, startColumn, numColumns);

  return {
    templateId: templateId,
    document: {
      title,
      participantMappings: [
        {
          role: "임직원",  //템플릿에 설정된 'role' 값으로 설정 필요
          name: name,
          signingMethod: {
            type: methodType,
            value: contact,
          },
        },
      ],
      requesterInputMappings: requesterInputMappings
    }
  };
}

function buildRequestOptions(email, apiKey, payload) {
  return {
    method: "post",
    contentType: "application/json",
    headers: {
      Authorization: "Basic " + Utilities.base64Encode(email + ":" + apiKey),
      "Content-Type": "application/json",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  };
}


function getRowAndHeader(sheet, rowNumber) {
  return {
    row: sheet.getRange(rowNumber, 1, 1, sheet.getLastColumn()).getValues()[0],
    headerRow: sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0]
  };
}

function parseModusignError(responseCode, responseText) {
  try {
    const errorJson = JSON.parse(responseText);
    if (responseCode === 403 && errorJson.type === "ForbiddenException") {
      return "권한 오류입니다. API 키 또는 이메일 인증을 확인해주세요.";
    }
    if (responseCode === 422 && errorJson.type === "RequesterInputDataLabelNotMatchedException" && errorJson.title === "Data label of requester input is not matched") {
      return "템플릿에 정의되지 않은 필드 이름(dataLabel)이 포함되어 있습니다. 시트의 H~M 열 제목을 템플릿에 맞춰 수정해주세요.";
    }
    if (responseCode === 422 && errorJson.type === "UnprocessableEntityException") {
      return "서명자 필드를 필드 이름에 포함되어 있습니다. 문서 편집 필드에 맞춰 수정해주세요.";
    }
    if (responseCode === 401 && errorJson.type === "UnauthorizedException" && errorJson.title === "Unauthorized") {
      return "API Key가 맞는지 확인해주세요.";
    }
    return errorJson.message || responseText;
  } catch (err) {
    return responseText;
  }
}

function onEditHandler(e) {
  const sheet = e.source.getActiveSheet();
  const editedRow = e.range.getRow();
  const editedColumn = e.range.getColumn();
  const triggerValue = e.value;
  const oldValue = e.oldValue || "";

  if (sheet.getName() !== SHEET_NAME) return;

  // N열: 전송 트리거
  if (
    editedColumn === TRIGGER_COLUMN_INDEX + 1 &&
    triggerValue === "전송" &&
    oldValue !== "전송"
  ) {
    Logger.log("📤 전송 조건 만족, sendRowToModusign 실행!");
    sendRowToModusign(sheet, editedRow);
    return;
  }
}