쿠팡 파트너스 수익 극대화를 위한 자동 링크 변환기 구축 방법

// ==== GMT 날짜 형식 생성 함수 (YYMMDD'T'HHmmss'Z' 포맷) ====
function cpServer_getCoupangApiDate() {
const date = new Date();
const year = date.getUTCFullYear().toString().substring(2);
const month = (date.getUTCMonth() + 1).toString().padStart(2, '0');
const day = date.getUTCDate().toString().padStart(2, '0');
const hours = date.getUTCHours().toString().padStart(2, '0');
const minutes = date.getUTCMinutes().toString().padStart(2, '0');
const seconds = date.getUTCSeconds().toString().padStart(2, '0');

const datetime = `$year}$month}$day}T$hours}$minutes}$seconds}Z`;
Logger.log(`[cpServer_getCoupangApiDate] 생성된 날짜/시간: "$datetime}"`);
return datetime;
}

// ==== HMAC Signature 생성 함수 ====
function cpServer_generateCoupangSignature(method, uri, secretKey, accessKey) {
const parts = uri.split('?');
const path = parts[0];
const query = (parts.length === 2) ? parts[1] : '';

const datetime = cpServer_getCoupangApiDate();
const stringToSign = `$datetime}$method}$path}$query}`; // 쿼리 문자열 앞에 '?' 없음

Logger.log(`[cpServer_generateCoupangSignature] 서명할 문자열 (stringToSign): "$stringToSign}"`);

// SECRET_KEY 유효성 검사 강화
const actualSecretKey = String(secretKey).trim(); // String() 강제 변환 및 공백 제거
if (typeof actualSecretKey !== 'string' || actualSecretKey.length === 0) {
Logger.log("[cpServer_generateCoupangSignature] ❗ 오류: SECRET_KEY가 유효한 문자열이 아니거나 비어 있습니다. Apps Script 설정값을 확인하세요.");
throw new Error("Invalid or empty SECRET_KEY configured in Apps Script.");
}

try {
const signatureBytes = Utilities.computeHmacSha256Signature(stringToSign, actualSecretKey);
const signatureHex = cpServer_bytesToHex(signatureBytes);
Logger.log(`[cpServer_generateCoupangSignature] 생성된 시그니처 (Hex): $signatureHex}`);

const authorizationHeader = `CEA algorithm=HmacSHA256, access-key=$accessKey}, signed-date=$datetime}, signature=$signatureHex}`;
Logger.log(`[cpServer_generateCoupangSignature] 최종 Authorization 헤더: "$authorizationHeader}"`);
return authorizationHeader;
} catch (e) {
Logger.log(`[cpServer_generateCoupangSignature] ❗ 치명적 오류: HMAC 서명 생성 중 예외 발생. SECRET_KEY 설정 확인. 메시지: $e.message}`);
throw new Error(`Failed to generate HMAC signature. Please check SECRET_KEY in Apps Script: $e.message}`);
}
}

// ==== 바이트 배열을 16진수 문자열로 변환 ====
function cpServer_bytesToHex(bytes) {
if (!bytes) {
Logger.log("[cpServer_bytesToHex] ❗ 경고: bytes 인수가 undefined 이거나 null 입니다. 이는 SECRET_KEY 문제로 인해 서명 바이트가 생성되지 않았을 수 있습니다.");
return "";
}
return Array.from(bytes, function(byte) {
return ('0' + (byte & 0xFF).toString(16)).slice(-2);
}).join('');
}

// ==== 딥링크 변환 API 호출 함수 (주요 로직) ====
function cpServer_callCoupangDeeplinkApi(originalUrl) {
const method = 'POST'; // 딥링크 API는 POST 요청
const requestBody = {
coupangUrls: [originalUrl]
};

// URI는 DEEPLINK_PATH와 _E_ 파라미터를 포함
const uri = `$COUPANG_CONFIG.DEEPLINK_PATH}?_E_=$COUPANG_CONFIG.AFFILIATE_ID}`;
const url = COUPANG_CONFIG.API_BASE_URL + uri;

Logger.log(`[cpServer_callCoupangDeeplinkApi] 원본 URL: $originalUrl}`);
Logger.log(`[cpServer_callCoupangDeeplinkApi] 딥링크 요청 URI: $uri}`);
Logger.log(`[cpServer_callCoupangDeeplinkApi] 딥링크 요청 URL: $url}`);
Logger.log(`[cpServer_callCoupangDeeplinkApi] 요청 본문: $JSON.stringify(requestBody)}`);

try {
const authorizationHeader = cpServer_generateCoupangSignature(method, uri, COUPANG_CONFIG.SECRET_KEY, COUPANG_CONFIG.ACCESS_KEY);

const options = {
method: method,
headers: {
'Authorization': authorizationHeader,
'Content-Type': 'application/json;charset=UTF-8',
},
payload: JSON.stringify(requestBody),
muteHttpExceptions: true // HTTP 오류 시 예외 발생 대신 응답 객체 반환
};

const response = UrlFetchApp.fetch(url, options);
const responseCode = response.getResponseCode();
const responseBody = response.getContentText();

Logger.log(`[cpServer_callCoupangDeeplinkApi] 응답 코드: $responseCode}`);
Logger.log(`[cpServer_callCoupangDeeplinkApi] 응답 본문: $responseBody}`);

if (responseCode === 200) {
const responseJson = JSON.parse(responseBody);
// rCode가 '0' 또는 '0000' (둘 중 하나라도) 일 때 성공으로 처리
if ((responseJson.rCode === '0' || responseJson.rCode === '0000') && responseJson.data && responseJson.data.length 0) {
return { success: true, shortenUrl: responseJson.data[0].shortenUrl };
} else {
// 쿠팡 API 응답은 200이지만 rCode가 성공이 아니거나 데이터가 없는 경우
Logger.log(`[cpServer_callCoupangDeeplinkApi] ❗ 쿠팡 API 응답 오류 (rCode != 0 또는 0000 또는 데이터 없음): $responseBody}`);
return { success: false, error: `쿠팡 API 응답 오류: $responseJson.message || responseBody || '알 수 없음'}` };
}
} else {
// HTTP 오류 발생 (200 OK가 아닌 경우)
let errorMessage = `HTTP 오류 ($responseCode}): `;
try {
const errorJson = JSON.parse(responseBody);
if (errorJson.code && errorJson.message) {
errorMessage += `코드: $errorJson.code}, 메시지: $errorJson.message}`;
} else {
errorMessage += `응답 본문: $responseBody}`; // JSON 파싱 실패 시 원본 본문 포함
}
} catch (e) {
errorMessage += `응답 본문 파싱 실패 또는 본문 없음: $responseBody}`;
}
Logger.log(`[cpServer_callCoupangDeeplinkApi] ❗ HTTP 오류 상세: $errorMessage}`);
return { success: false, error: `HTTP 오류: $errorMessage}` };
}
} catch (e) {
// UrlFetchApp 자체 예외 또는 서명 생성 중 예외 발생
Logger.log(`[cpServer_callCoupangDeeplinkApi] ❗ Apps Script 서버 예외 발생: $e.message}`);
return { success: false, error: `Apps Script 서버 오류: $e.message}` };
}
}

// ==== JSON 응답 생성 헬퍼 함수 ====
function cpServer_createJsonResponse(data) {
return ContentService.createTextOutput(JSON.stringify(data))
.setMimeType(ContentService.MimeType.JSON);
}

// ==== 웹 앱 GET 요청 처리 (클라이언트의 요청을 받음) ====
function doGet(e) {
Logger.log("[doGet] GET 요청 수신 시작.");

const rawUrls = e.parameter.urls;
let urlsToProcess = [];

if (Array.isArray(rawUrls) && rawUrls.length 0) {
urlsToProcess = [rawUrls[0]]; // 배열로 들어온 경우 첫 번째만
} else if (typeof rawUrls === 'string' && rawUrls) {
urlsToProcess = [rawUrls]; // 단일 문자열로 들어온 경우
} else {
Logger.log("[doGet] 오류: 변환할 URL이 GET 요청 파라미터에 없습니다.");
return cpServer_createJsonResponse({ success: false, error: "변환할 URL을 찾을 수 없습니다." });
}

const originalUrl = urlsToProcess[0];
Logger.log(`[doGet] 처리할 URL: $originalUrl}`);

const apiResult = cpServer_callCoupangDeeplinkApi(originalUrl);

if (apiResult.success) {
return cpServer_createJsonResponse({ success: true, shortenUrl: apiResult.shortenUrl });
} else {
return cpServer_createJsonResponse({ success: false, error: apiResult.error });
}
}

div class="action-buttons"
button class="convert-btn" onclick="cpClient_convertLinks()"링크 변환/button
button class="reset-btn" onclick="cpClient_clearAll()"초기화/button
/div

// === DOM Element References ===
const cpClient_elements = {
urlInput: document.querySelector('.coupang-converter .url-input'),
resultDiv: document.getElementById('cpClient_result'),
convertBtn: document.querySelector('.coupang-converter .convert-btn'),
resetBtn: document.querySelector('.coupang-converter .reset-btn')
};

// === Main Link Conversion Function ===
async function cpClient_convertLinks() {
cpClient_setLoadingState(true);

const inputUrlsText = cpClient_elements.urlInput.value.trim();

if (!inputUrlsText) {
cpClient_showResult('error', '변환할 쿠팡 상품 URL을 입력해주세요.');
cpClient_setLoadingState(false);
return;
}

const firstValidUrl = inputUrlsText.split('
')
.map(url = url.trim())
.find(url = url.startsWith('http') && url.includes('coupang.com'));

if (!firstValidUrl) {
cpClient_showResult('error', '유효한 쿠팡 상품 URL을 찾을 수 없습니다. 실제 쿠팡 상품 페이지 링크를 입력해주세요.');
cpClient_setLoadingState(false);
return;
}

try {
const queryParams = new URLSearchParams();
queryParams.append('urls', firstValidUrl);

const fetchUrl = `$API_ENDPOINT}?$queryParams.toString()}`;
console.log('클라이언트 fetch URL (GET):', fetchUrl); // 디버깅용 로그

const response = await fetch(fetchUrl);

if (!response.ok) {
const errorDetail = await response.text();
cpClient_showResult('error', `오류 발생: $response.status} - $errorDetail}. 웹 앱 URL 및 배포 권한을 확인해주세요.`);
throw new Error(`Server responded with an error: HTTP $response.status} - $errorDetail}`);
}

const responseData = await response.json();

if (responseData.success && responseData.shortenUrl) {
cpClient_showConvertedLink(responseData.shortenUrl);
} else {
// 서버에서 success: false를 반환하거나 shortenUrl이 없는 경우
cpClient_showResult('error', responseData.error || '링크 변환 실패. 입력한 URL이 정확한지 확인해주세요.');
console.error('서버 응답 오류:', responseData.error);
}
} catch (error) {
// 네트워크 오류 또는 기타 예상치 못한 오류
cpClient_showResult('error', `오류 발생: $error.message}. 웹 앱 URL 및 배포 권한을 확인해주세요.`);
console.error('Fetch Error:', error);
} finally {
cpClient_setLoadingState(false);
}
}

function cpClient_showConvertedLink(shortenUrl) {
const resultDiv = cpClient_elements.resultDiv;
resultDiv.className = 'result-container success';

const htmlContent = `
p변환 결과/p
div class="link-item"
div class="converted-link"
a href="$shortenUrl}" target="_blank"$shortenUrl}/a
/div
button class="copy-btn" onclick="cpClient_copyToClipboard('$shortenUrl}')"링크 복사/button
/div
`;
resultDiv.innerHTML = htmlContent;
}

function cpClient_showResult(type, message) {
const resultDiv = cpClient_elements.resultDiv;
resultDiv.className = `result-container $type}`;
resultDiv.innerHTML = `p$message}/p`;
}

// === 초기화 함수 ===
function cpClient_clearAll() {
cpClient_elements.urlInput.value = '';
cpClient_elements.resultDiv.innerHTML = '';
cpClient_elements.resultDiv.className = 'result-container';
}

function cpClient_copyToClipboard(text) {
navigator.clipboard.writeText(text)
.then(() = alert('링크가 클립보드에 복사되었습니다!'))
.catch(err = {
console.error('복사 실패:', err);
alert('링크 복사에 실패했습니다. 수동으로 복사해주세요.');
});
}

function cpClient_setLoadingState(isLoading) {
const resultDiv = cpClient_elements.resultDiv;
const convertBtn = cpClient_elements.convertBtn;
const resetBtn = cpClient_elements.resetBtn;

/* 제목 스타일 */
.coupang-converter h1 {
font-size: 20px;
margin-top: 0;
margin-bottom: 15px;
color: #333;
text-align: center;
}

/* 설명 문구 스타일 */
.coupang-converter p {
font-size: 14px;
color: #555;
margin-bottom: 15px;
text-align: center;
}

/* 입력 영역 스타일 */
.coupang-converter .input-area {
margin-bottom: 20px;
}
.coupang-converter .url-input {
width: 100%;
height: 120px;
padding: 10px;
border: 1px solid #ddd;
border-radius: 4px;
resize: vertical; /* 세로 크기 조절 가능 */
box-sizing: border-box; /* 패딩이 너비에 포함되도록 */
font-size: 14px;
}

/* 버튼 컨테이너 스타일 */
.coupang-converter .action-buttons {
display: flex; /* 버튼을 가로로 정렬 */
gap: 10px; /* 버튼 사이 간격 */
margin-bottom: 20px;
justify-content: center; /* 버튼 중앙 정렬 */
}
/* 공통 버튼 스타일 */
.coupang-converter .convert-btn,
.coupang-converter .reset-btn {
padding: 10px 15px;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 14px;
transition: background-color 0.3s ease; /* 호버 효과 부드럽게 */
}
.coupang-converter .convert-btn {
background: #4285f4; /* 구글 블루 색상 */
color: white;
}
.coupang-converter .convert-btn:hover {
background: #3367d6; /* 마우스 오버 시 어두운 블루 */
}
.coupang-converter .reset-btn {
background: #e0e0e0; /* 연한 회색 */
color: #333;
}
.coupang-converter .reset-btn:hover {
background: #c7c7c7; /* 마우스 오버 시 약간 진한 회색 */
}

/* 결과 컨테이너 스타일 */
.coupang-converter .result-container {
min-height: 50px; /* 결과창 최소 높이 */
padding: 15px;
border-radius: 4px;
overflow-wrap: break-word; /* 긴 URL이 넘치지 않도록 */
}
/* 성공 메시지 스타일 */
.coupang-converter .result-container.success {
background: #e8f5e9; /* 연한 초록색 */
border: 1px solid #c8e6c9;
}
/* 오류 메시지 스타일 */
.coupang-converter .result-container.error {
background: #ffebee; /* 연한 빨간색 */
border: 1px solid #ffcdd2;
color: #d32f2f; /* 오류 메시지 텍스트 색상 */
}

/* 개별 링크 아이템 스타일 (단일 URL 처리에 맞게 간소화) */
.coupang-converter .link-item {
padding: 10px;
background: white;
border-radius: 4px;
border: 1px solid #ddd;
box-shadow: 0 1px 3px rgba(0,0,0,0.05);
text-align: center; /* 중앙 정렬 */
}
.coupang-converter .converted-link {
word-break: break-all;
margin: 5px 0;
font-size: 14px;
color: #4285f4;
font-weight: bold;
}
/* 복사 버튼 스타일 */
.coupang-converter .copy-btn {
background: #34a853;
color: white;
border: none;
padding: 5px 10px;
border-radius: 3px;
cursor: pointer;
margin-top: 10px; /* 위쪽 여백 늘림 */
font-size: 12px;
transition: background-color 0.3s ease;
}
.coupang-converter .copy-btn:hover {
background: #2b8c3f;
}