Ver3.5 Gemini + Google Sheets로 자동 리포트 작성 완전 정복: 반복 업무를 AI에게 맡기는 실전 가이드

Gemini + Google Sheets로 자동 리포트 작성 완전 정복: 반복 업무를 AI에게 맡기는 실전 가이드
📊 데이터 입력부터 리포트 완성까지, Gemini API와 Google Sheets의 찰떡 콜라보 완전 해부
야 솔직히 말해봐 ㅋㅋㅋ 매주 월요일마다 엑셀 열어서 데이터 복붙하고, 그래프 만들고, 리포트 쓰는 거... 진짜 너무 지치지 않음? 😩
그 반복 작업에 쏟는 시간이 아깝다는 거 다들 느끼잖아. 근데 이제 그거 Gemini + Google Sheets로 완전 자동화할 수 있음.
오늘은 그 방법을 처음부터 끝까지 낱낱이 파헤쳐볼 거야. 코드도 있고, 실전 팁도 있고, 삽질 방지 꿀팁도 있으니까 끝까지 봐줘! 🔥
💬 "Apps Script 써본 적 없는데 따라 할 수 있나요?"
💬 "리포트 자동화 진짜 되는 건가요 ㅋㅋ 반신반의임"
이런 질문들 다 해결해줄게. 진짜로 동작하는 코드랑 개념 설명 같이 가는 거니까 걱정 ㄴㄴ 😎
🧠 Gemini API가 뭔지부터 제대로 알고 가자
Gemini는 Google이 만든 멀티모달 AI 모델이야. GPT-4처럼 텍스트 생성, 분석, 요약, 코드 작성 등 다양한 작업을 처리할 수 있어.
근데 우리가 오늘 쓸 건 Gemini API — 즉, 이 AI를 우리 프로그램에서 직접 호출해서 쓰는 방식이야. 🔌
Gemini 모델 종류 (2024~2025 기준)
| 모델명 | 특징 | 무료 여부 | 추천 용도 |
|---|---|---|---|
| gemini-1.5-flash | 빠르고 가벼움, 비용 효율 최고 | ✅ 무료 티어 있음 | 리포트 자동화, 요약 |
| gemini-1.5-pro | 긴 컨텍스트(100만 토큰), 고품질 | ⚠️ 유료 (무료 한도 제한) | 복잡한 분석, 대용량 데이터 |
| gemini-2.0-flash | 최신 모델, 멀티모달 강화 | ✅ 실험적 무료 제공 | 최신 기능 테스트 |
속도도 빠르고, 무료 한도(분당 15회 요청, 하루 1500회)도 충분해서 소규모 팀이나 개인 프로젝트엔 딱이거든 ㅋㅋ
API 키 발급 방법 (5분이면 끝남)
API 키 발급 완료? 그럼 이제 진짜 시작이야 ㅋㅋ 🚀
📋 Google Sheets + Apps Script 기본 세팅
Google Sheets는 그냥 엑셀 같은 스프레드시트인데, 여기에 Apps Script라는 JavaScript 기반 스크립팅 환경이 내장되어 있어.
이걸 이용하면 Sheets 데이터를 읽고, Gemini API를 호출하고, 결과를 다시 Sheets에 쓰는 게 전부 가능해. 별도 서버 없이! 🎉
Apps Script 에디터 열기
myFunction() 지우고 우리 코드 작성 시작!const, let, 화살표 함수 등 편하게 써도 돼.단,
fetch() 대신 UrlFetchApp.fetch()를 써야 한다는 점만 기억해!
API 키 안전하게 저장하기 (Script Properties 활용)
API 키를 코드에 직접 하드코딩하면 절대 안 돼! 😱 대신 Script Properties를 사용해:
// Apps Script 에디터에서 한 번만 실행하면 됨
function setApiKey() {
const scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperty('GEMINI_API_KEY', '여기에_실제_API_키_입력');
Logger.log('API 키 저장 완료!');
}
// 이후 코드에서 이렇게 불러와서 사용
function getApiKey() {
return PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
}
setApiKey() 함수는 딱 한 번만 실행하고 나서 코드에서 삭제하거나 주석 처리해.Script Properties에 저장된 값은 코드 공유해도 노출 안 되니까 안전해 👍
🔌 Gemini API 호출 기본 코드 작성
이제 진짜 핵심 코드야. Gemini API를 Apps Script에서 호출하는 기본 함수를 만들어보자.
Gemini API 호출 함수 (기본형)
/**
* Gemini API를 호출하는 기본 함수
* @param {string} prompt - AI에게 보낼 프롬프트
* @returns {string} - AI의 응답 텍스트
*/
function callGeminiAPI(prompt) {
const API_KEY = getApiKey();
const MODEL = 'gemini-1.5-flash'; // 빠르고 무료 한도 넉넉한 모델
const API_URL = `https://generativelanguage.googleapis.com/v1beta/models/${MODEL}:generateContent?key=${API_KEY}`;
// 요청 바디 구성
const requestBody = {
contents: [
{
parts: [
{
text: prompt
}
]
}
],
generationConfig: {
temperature: 0.7, // 창의성 수준 (0~1, 리포트는 0.3~0.7 추천)
maxOutputTokens: 2048, // 최대 출력 토큰 수
topP: 0.8,
topK: 40
}
};
// HTTP POST 요청
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
payload: JSON.stringify(requestBody),
muteHttpExceptions: true // 에러 응답도 받아서 처리
};
try {
const response = UrlFetchApp.fetch(API_URL, options);
const responseCode = response.getResponseCode();
if (responseCode !== 200) {
Logger.log('API 에러: ' + response.getContentText());
return '오류 발생: ' + responseCode;
}
const responseData = JSON.parse(response.getContentText());
// 응답에서 텍스트 추출
return responseData.candidates[0].content.parts[0].text;
} catch (error) {
Logger.log('예외 발생: ' + error.toString());
return '처리 중 오류가 발생했습니다.';
}
}
- 0.5~0.7: 자연스러운 문체, 약간의 창의성 (일반 리포트)
- 0.8~1.0: 창의적, 다양한 표현 (마케팅 카피 등)
API 응답 구조 이해하기
Gemini API가 반환하는 JSON 구조는 이렇게 생겼어:
{
"candidates": [
{
"content": {
"parts": [
{
"text": "여기에 AI가 생성한 텍스트가 들어옴"
}
],
"role": "model"
},
"finishReason": "STOP",
"index": 0
}
],
"usageMetadata": {
"promptTokenCount": 150,
"candidatesTokenCount": 300,
"totalTokenCount": 450
}
}
그래서 응답 텍스트는 responseData.candidates[0].content.parts[0].text로 꺼내는 거야. 구조 알면 에러 디버깅도 쉬워짐 ㅋㅋ
🛠️ 실전! 주간 판매 리포트 자동화 전체 코드
이제 진짜 실전 코드야. 매주 월요일에 자동으로 실행되어서 지난 주 판매 데이터를 분석하고 리포트를 작성하는 시스템이야. 🔥
Sheets 구조는 이렇게 가정할게:
A열: 날짜 | B열: 상품명 | C열: 카테고리 | D열: 판매수량 | E열: 단가 | F열: 매출액
시트명: "리포트"
자동 생성된 리포트가 여기에 기록됨
전체 자동화 코드
// ==========================================
// 주간 판매 리포트 자동화 시스템
// Gemini API + Google Sheets
// ==========================================
// API 키 가져오기
function getApiKey() {
return PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
}
// ==========================================
// 1. 메인 함수 (트리거로 자동 실행됨)
// ==========================================
function generateWeeklyReport() {
Logger.log('📊 주간 리포트 생성 시작...');
// 스프레드시트 가져오기
const ss = SpreadsheetApp.getActiveSpreadsheet();
const dataSheet = ss.getSheetByName('판매데이터');
const reportSheet = ss.getSheetByName('리포트') || ss.insertSheet('리포트');
// 지난 주 날짜 범위 계산
const today = new Date();
const lastMonday = getLastMonday(today);
const lastSunday = new Date(lastMonday);
lastSunday.setDate(lastMonday.getDate() + 6);
Logger.log(`분석 기간: ${formatDate(lastMonday)} ~ ${formatDate(lastSunday)}`);
// 데이터 읽기
const rawData = dataSheet.getDataRange().getValues();
const headers = rawData[0];
const dataRows = rawData.slice(1);
// 지난 주 데이터 필터링
const weeklyData = filterByDateRange(dataRows, lastMonday, lastSunday);
if (weeklyData.length === 0) {
Logger.log('해당 기간 데이터 없음');
return;
}
// 데이터 집계
const summary = aggregateData(weeklyData);
// Gemini에게 분석 요청
const aiInsights = callGeminiForReport(summary, lastMonday, lastSunday);
// 리포트 시트에 작성
writeReportToSheet(reportSheet, summary, aiInsights, lastMonday, lastSunday);
// 이메일 발송 (선택사항)
// sendReportByEmail(summary, aiInsights, lastMonday, lastSunday);
Logger.log('✅ 주간 리포트 생성 완료!');
}
// ==========================================
// 2. 날짜 유틸리티 함수들
// ==========================================
function getLastMonday(date) {
const d = new Date(date);
const day = d.getDay(); // 0=일, 1=월, ..., 6=토
const diff = day === 0 ? -6 : 1 - day; // 지난 월요일로
d.setDate(d.getDate() + diff - 7); // 이번 주 월요일에서 7일 빼기
d.setHours(0, 0, 0, 0);
return d;
}
function formatDate(date) {
const y = date.getFullYear();
const m = String(date.getMonth() + 1).padStart(2, '0');
const d = String(date.getDate()).padStart(2, '0');
return `${y}-${m}-${d}`;
}
// ==========================================
// 3. 데이터 필터링 함수
// ==========================================
function filterByDateRange(rows, startDate, endDate) {
return rows.filter(row => {
const rowDate = new Date(row[0]); // A열: 날짜
rowDate.setHours(0, 0, 0, 0);
return rowDate >= startDate && rowDate <= endDate;
});
}
// ==========================================
// 4. 데이터 집계 함수
// ==========================================
function aggregateData(rows) {
const summary = {
totalRevenue: 0,
totalQuantity: 0,
productSales: {}, // 상품별 매출
categorySales: {}, // 카테고리별 매출
dailySales: {}, // 일별 매출
rowCount: rows.length
};
rows.forEach(row => {
const date = formatDate(new Date(row[0]));
const product = row[1];
const category = row[2];
const quantity = Number(row[3]) || 0;
const price = Number(row[4]) || 0;
const revenue = Number(row[5]) || (quantity * price);
summary.totalRevenue += revenue;
summary.totalQuantity += quantity;
// 상품별 집계
if (!summary.productSales[product]) {
summary.productSales[product] = { revenue: 0, quantity: 0 };
}
summary.productSales[product].revenue += revenue;
summary.productSales[product].quantity += quantity;
// 카테고리별 집계
if (!summary.categorySales[category]) {
summary.categorySales[category] = 0;
}
summary.categorySales[category] += revenue;
// 일별 집계
if (!summary.dailySales[date]) {
summary.dailySales[date] = 0;
}
summary.dailySales[date] += revenue;
});
// 베스트셀러 TOP 3 추출
summary.topProducts = Object.entries(summary.productSales)
.sort((a, b) => b[1].revenue - a[1].revenue)
.slice(0, 3)
.map(([name, data]) => ({ name, ...data }));
return summary;
}
// ==========================================
// 5. Gemini API 호출 함수 (리포트용)
// ==========================================
function callGeminiForReport(summary, startDate, endDate) {
const API_KEY = getApiKey();
const MODEL = 'gemini-1.5-flash';
const API_URL = `https://generativelanguage.googleapis.com/v1beta/models/${MODEL}:generateContent?key=${API_KEY}`;
// 데이터를 텍스트로 변환
const topProductsText = summary.topProducts
.map((p, i) => `${i+1}위: ${p.name} (매출 ${p.revenue.toLocaleString()}원, ${p.quantity}개)`)
.join('\n');
const categoryText = Object.entries(summary.categorySales)
.sort((a, b) => b[1] - a[1])
.map(([cat, rev]) => `${cat}: ${rev.toLocaleString()}원`)
.join(', ');
const dailyText = Object.entries(summary.dailySales)
.sort((a, b) => a[0].localeCompare(b[0]))
.map(([date, rev]) => `${date}: ${rev.toLocaleString()}원`)
.join('\n');
// 프롬프트 구성
const prompt = `당신은 전문 비즈니스 분석가입니다. 아래 주간 판매 데이터를 분석하여 경영진 보고용 리포트를 작성해주세요.
[분석 기간]
${formatDate(startDate)} ~ ${formatDate(endDate)}
[핵심 지표]
- 총 매출: ${summary.totalRevenue.toLocaleString()}원
- 총 판매 수량: ${summary.totalQuantity.toLocaleString()}개
- 거래 건수: ${summary.rowCount}건
- 평균 거래 단가: ${Math.round(summary.totalRevenue / summary.rowCount).toLocaleString()}원
[베스트셀러 TOP 3]
${topProductsText}
[카테고리별 매출]
${categoryText}
[일별 매출 추이]
${dailyText}
위 데이터를 바탕으로 다음 항목을 포함한 리포트를 한국어로 작성해주세요:
1. **이번 주 핵심 성과 요약** (3~4문장)
2. **주목할 만한 트렌드 및 인사이트** (3가지, 각 2~3문장)
3. **다음 주 권장 액션 아이템** (3가지, 구체적으로)
4. **리스크 또는 주의사항** (있다면 1~2가지)
전문적이고 간결한 문체로 작성하되, 숫자 데이터를 적극 활용해주세요.`;
const requestBody = {
contents: [{ parts: [{ text: prompt }] }],
generationConfig: {
temperature: 0.4,
maxOutputTokens: 2048,
topP: 0.8
}
};
const options = {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
payload: JSON.stringify(requestBody),
muteHttpExceptions: true
};
try {
const response = UrlFetchApp.fetch(API_URL, options);
if (response.getResponseCode() !== 200) {
Logger.log('API 에러: ' + response.getContentText());
return 'AI 분석 중 오류가 발생했습니다.';
}
const data = JSON.parse(response.getContentText());
return data.candidates[0].content.parts[0].text;
} catch (e) {
Logger.log('예외: ' + e.toString());
return 'AI 분석 처리 중 오류가 발생했습니다.';
}
}
// ==========================================
// 6. 리포트 시트에 작성하는 함수
// ==========================================
function writeReportToSheet(sheet, summary, aiInsights, startDate, endDate) {
// 새 리포트는 맨 위에 추가 (기존 내용 아래로 밀기)
sheet.insertRowsBefore(1, 30); // 30행 삽입
let row = 1;
// 제목
sheet.getRange(row, 1).setValue(`📊 주간 판매 리포트: ${formatDate(startDate)} ~ ${formatDate(endDate)}`);
sheet.getRange(row, 1).setFontSize(14).setFontWeight('bold').setBackground('#5b9bd5').setFontColor('#ffffff');
sheet.getRange(row, 1, 1, 4).merge();
row++;
// 생성 시간
sheet.getRange(row, 1).setValue(`생성 시간: ${new Date().toLocaleString('ko-KR')}`);
sheet.getRange(row, 1).setFontColor('#666666').setFontSize(10);
row += 2;
// 핵심 지표
sheet.getRange(row, 1).setValue('📈 핵심 지표');
sheet.getRange(row, 1).setFontWeight('bold').setBackground('#e8f4f8');
sheet.getRange(row, 1, 1, 4).merge();
row++;
const metrics = [
['총 매출', `${summary.totalRevenue.toLocaleString()}원`],
['총 판매 수량', `${summary.totalQuantity.toLocaleString()}개`],
['거래 건수', `${summary.rowCount}건`],
['평균 거래 단가', `${Math.round(summary.totalRevenue / summary.rowCount).toLocaleString()}원`]
];
metrics.forEach(([label, value]) => {
sheet.getRange(row, 1).setValue(label).setFontWeight('bold');
sheet.getRange(row, 2).setValue(value);
row++;
});
row++;
// 베스트셀러
sheet.getRange(row, 1).setValue('🏆 베스트셀러 TOP 3');
sheet.getRange(row, 1).setFontWeight('bold').setBackground('#e8f4f8');
sheet.getRange(row, 1, 1, 4).merge();
row++;
summary.topProducts.forEach((p, i) => {
sheet.getRange(row, 1).setValue(`${i+1}위`);
sheet.getRange(row, 2).setValue(p.name);
sheet.getRange(row, 3).setValue(`${p.revenue.toLocaleString()}원`);
sheet.getRange(row, 4).setValue(`${p.quantity}개`);
row++;
});
row++;
// AI 인사이트
sheet.getRange(row, 1).setValue('🤖 AI 분석 인사이트 (Gemini)');
sheet.getRange(row, 1).setFontWeight('bold').setBackground('#ddeeff');
sheet.getRange(row, 1, 1, 4).merge();
row++;
sheet.getRange(row, 1).setValue(aiInsights);
sheet.getRange(row, 1, 1, 4).merge();
sheet.getRange(row, 1).setWrap(true);
// 열 너비 자동 조정
sheet.autoResizeColumns(1, 4);
Logger.log('리포트 시트 작성 완료');
}
// ==========================================
// 7. 이메일 발송 함수 (선택사항)
// ==========================================
function sendReportByEmail(summary, aiInsights, startDate, endDate) {
const recipient = 'boss@company.com'; // 받는 사람 이메일
const subject = `[자동 리포트] 주간 판매 현황 ${formatDate(startDate)} ~ ${formatDate(endDate)}`;
const body = `
안녕하세요,
이번 주 판매 리포트를 자동으로 전송드립니다.
■ 핵심 지표
- 총 매출: ${summary.totalRevenue.toLocaleString()}원
- 총 판매 수량: ${summary.totalQuantity.toLocaleString()}개
- 거래 건수: ${summary.rowCount}건
■ AI 분석 인사이트
${aiInsights}
자세한 내용은 Google Sheets 리포트를 확인해주세요.
본 리포트는 Gemini AI + Google Sheets 자동화 시스템으로 생성되었습니다.
`;
GmailApp.sendEmail(recipient, subject, body);
Logger.log('이메일 발송 완료: ' + recipient);
}
처음엔
generateWeeklyReport()만 실행해보고, 동작 확인 후 트리거 설정하면 돼 ㅋㅋ
⏰ 트리거 설정으로 완전 자동화 완성
코드 작성했으면 이제 자동 실행 트리거를 설정해야 진짜 자동화가 완성돼.
사람이 버튼 누를 필요 없이 정해진 시간에 알아서 실행되는 거야! 🤩
트리거 설정 방법 (UI 방식)
코드로 트리거 설정하기 (프로그래밍 방식)
// 트리거를 코드로 설정하는 함수 (한 번만 실행)
function createWeeklyTrigger() {
// 기존 트리거 삭제 (중복 방지)
const triggers = ScriptApp.getProjectTriggers();
triggers.forEach(trigger => {
if (trigger.getHandlerFunction() === 'generateWeeklyReport') {
ScriptApp.deleteTrigger(trigger);
}
});
// 매주 월요일 오전 9시에 실행
ScriptApp.newTrigger('generateWeeklyReport')
.timeBased()
.onWeekDay(ScriptApp.WeekDay.MONDAY)
.atHour(9)
.create();
Logger.log('✅ 주간 트리거 설정 완료! 매주 월요일 오전 9시에 자동 실행됩니다.');
}
// 매일 실행하고 싶다면
function createDailyTrigger() {
ScriptApp.newTrigger('generateDailyReport')
.timeBased()
.everyDays(1)
.atHour(8) // 오전 8시
.create();
}
// 매월 1일에 실행하고 싶다면
function createMonthlyTrigger() {
ScriptApp.newTrigger('generateMonthlyReport')
.timeBased()
.onMonthDay(1) // 매월 1일
.atHour(9)
.create();
}
- 파일 → 프로젝트 설정 → 시간대를 "Asia/Seoul"로 설정해두면 한국 시간 기준으로 동작해.
- 무료 계정은 하루 최대 실행 시간 6분, 유료(Workspace)는 30분 제한 있음.
🎨 프롬프트 엔지니어링: 더 좋은 리포트 만들기
Gemini가 얼마나 좋은 리포트를 써주느냐는 프롬프트 품질에 달려 있어.
같은 데이터라도 프롬프트를 어떻게 쓰느냐에 따라 결과물이 천지차이야. 진짜로 ㅋㅋ 🎯
리포트 유형별 프롬프트 템플릿
const executiveSummaryPrompt = `
당신은 McKinsey 출신의 시니어 비즈니스 분석가입니다.
다음 데이터를 바탕으로 C-레벨 경영진을 위한 Executive Summary를 작성하세요.
[데이터]
${dataText}
[작성 요구사항]
- 분량: 300~400자 이내
- 구조: 현황 → 핵심 발견 → 권고사항
- 문체: 간결하고 직접적, 수동태 지양
- 숫자: 반드시 포함, % 변화율 명시
- 언어: 한국어
첫 문장은 가장 중요한 인사이트로 시작하세요.
`;
const marketingReportPrompt = `
당신은 디지털 마케팅 전문가입니다.
아래 캠페인 성과 데이터를 분석하여 마케팅 팀 주간 리포트를 작성하세요.
[캠페인 데이터]
${campaignData}
[포함할 항목]
1. 이번 주 캠페인 성과 하이라이트 (KPI 달성률 포함)
2. 채널별 성과 비교 분석
3. 개선이 필요한 영역 (구체적 수치 근거)
4. 다음 주 최적화 제안 (실행 가능한 액션 3가지)
[형식]
- 각 항목은 불릿 포인트로 작성
- 이모지 사용 가능 (가독성 향상)
- 한국어로 작성
`;
const techReportPrompt = `
당신은 시니어 소프트웨어 엔지니어입니다.
다음 시스템 모니터링 데이터를 분석하여 기술 팀 주간 리포트를 작성하세요.
[시스템 지표]
${systemMetrics}
[분석 항목]
1. 시스템 안정성 평가 (가용성, 에러율)
2. 성능 병목 구간 식별
3. 이번 주 주요 이슈 및 해결 현황
4. 다음 주 기술 부채 해소 우선순위
[주의]
- 기술적 용어 사용 가능
- 수치 데이터 정확히 인용
- 한국어로 작성
`;
Few-shot 프롬프팅으로 품질 올리기
Gemini에게 예시를 보여주면 훨씬 원하는 형식으로 출력해줘. 이걸 Few-shot 프롬프팅이라고 해:
const fewShotPrompt = `
다음 형식으로 판매 인사이트를 작성해주세요.
[예시 입력]
매출: 500만원, 전주 대비: +10%, 베스트셀러: A상품
[예시 출력]
✅ 이번 주 매출은 500만원으로 전주 대비 10% 성장했습니다. A상품이 전체 매출의 35%를 차지하며 성장을 견인했습니다. 이 추세가 지속된다면 월 목표 달성이 가능할 것으로 예상됩니다.
[실제 입력]
매출: ${summary.totalRevenue.toLocaleString()}원, 전주 대비: ${growthRate}%, 베스트셀러: ${topProduct}
위 예시와 동일한 형식으로 작성해주세요.
`;
② 출력 형식 명시: 글자 수, 구조, 불릿 포인트 여부 등
③ 예시 제공: 원하는 출력 형태를 직접 보여주기
④ 제약 조건: "~하지 마세요", "반드시 ~포함" 등
⑤ 언어 명시: "한국어로 작성" 꼭 넣기 (안 넣으면 영어로 나올 수 있음 ㅋㅋ)
🚀 고급 활용: 멀티 시트 & 조건부 리포트
기본 자동화가 됐으면 이제 더 고급 기능을 써보자. 실무에서 진짜 유용한 패턴들이야 ㅋㅋ 💪
패턴 1: 전주 대비 성장률 자동 계산
// 전주 데이터와 비교하여 성장률 계산
function calculateGrowthRate(currentData, previousData) {
const current = aggregateData(currentData);
const previous = aggregateData(previousData);
const growthRate = previous.totalRevenue > 0
? ((current.totalRevenue - previous.totalRevenue) / previous.totalRevenue * 100).toFixed(1)
: 0;
return {
current,
previous,
growthRate: Number(growthRate),
growthSign: growthRate >= 0 ? '▲' : '▼',
growthColor: growthRate >= 0 ? '#2ecc71' : '#e74c3c'
};
}
// 프롬프트에 성장률 포함
function buildPromptWithGrowth(current, previous, growth) {
return `
[이번 주 vs 지난 주 비교]
- 이번 주 매출: ${current.totalRevenue.toLocaleString()}원
- 지난 주 매출: ${previous.totalRevenue.toLocaleString()}원
- 성장률: ${growth.growthSign} ${Math.abs(growth.growthRate)}%
- 이번 주 거래 건수: ${current.rowCount}건
- 지난 주 거래 건수: ${previous.rowCount}건
위 비교 데이터를 바탕으로 성장/하락 원인을 분석하고
구체적인 개선 방안을 제시해주세요.
`;
}
패턴 2: 이상치 감지 + 알림
// 매출 이상치 감지 (평균 대비 ±30% 이상 차이)
function detectAnomalies(dailySales) {
const values = Object.values(dailySales);
const avg = values.reduce((a, b) => a + b, 0) / values.length;
const threshold = 0.3; // 30% 임계값
const anomalies = [];
Object.entries(dailySales).forEach(([date, revenue]) => {
const deviation = Math.abs(revenue - avg) / avg;
if (deviation > threshold) {
anomalies.push({
date,
revenue,
deviation: (deviation * 100).toFixed(1),
type: revenue > avg ? '급등' : '급락'
});
}
});
return anomalies;
}
// 이상치 발견 시 즉시 알림 이메일 발송
function sendAnomalyAlert(anomalies) {
if (anomalies.length === 0) return;
const alertText = anomalies.map(a =>
`${a.date}: ${a.type} (${a.revenue.toLocaleString()}원, 평균 대비 ${a.deviation}%)`
).join('\n');
// Gemini에게 이상치 원인 분석 요청
const analysisPrompt = `
다음 매출 이상치 데이터를 분석하고 가능한 원인과 대응 방안을 제시해주세요:
${alertText}
간결하게 3~5문장으로 작성해주세요.
`;
const aiAnalysis = callGeminiAPI(analysisPrompt);
GmailApp.sendEmail(
'alert@company.com',
'[긴급] 매출 이상치 감지',
`이상치 감지:\n${alertText}\n\nAI 분석:\n${aiAnalysis}`
);
}
패턴 3: Google Docs로 예쁜 리포트 생성
// Google Docs에 리포트 생성 (Sheets보다 문서 형태로 예쁘게)
function createReportInDocs(summary, aiInsights, startDate, endDate) {
// 새 Google Docs 문서 생성
const docTitle = `주간 판매 리포트 ${formatDate(startDate)} ~ ${formatDate(endDate)}`;
const doc = DocumentApp.create(docTitle);
const body = doc.getBody();
// 제목 스타일
const title = body.appendParagraph(docTitle);
title.setHeading(DocumentApp.ParagraphHeading.HEADING1);
// 생성 시간
body.appendParagraph(`생성: ${new Date().toLocaleString('ko-KR')}`).setItalic(true);
body.appendHorizontalRule();
// 핵심 지표 섹션
body.appendParagraph('핵심 지표').setHeading(DocumentApp.ParagraphHeading.HEADING2);
body.appendParagraph(`총 매출: ${summary.totalRevenue.toLocaleString()}원`);
body.appendParagraph(`총 판매 수량: ${summary.totalQuantity.toLocaleString()}개`);
body.appendParagraph(`거래 건수: ${summary.rowCount}건`);
// AI 인사이트 섹션
body.appendParagraph('AI 분석 인사이트').setHeading(DocumentApp.ParagraphHeading.HEADING2);
body.appendParagraph(aiInsights);
// 문서 저장 및 URL 반환
doc.saveAndClose();
const docUrl = doc.getUrl();
Logger.log('Docs 리포트 생성 완료: ' + docUrl);
return docUrl;
}
- Google Docs: 문서 형태, 긴 텍스트, 공유·출력 목적 리포트에 적합
- 둘 다 만들어서 링크로 연결하는 것도 좋은 방법이야 ㅋㅋ
💡 실무 적용 사례 & 아이디어
이 시스템을 어디에 쓸 수 있는지 실제 사례들을 보여줄게. 아이디어 뱅크 열어봐 ㅋㅋ 💡
활용 사례 1: 쇼핑몰 일일 매출 리포트
Gemini가 해주는 것:
- 어제 베스트셀러 분석 및 재고 보충 권고
- 리뷰 평점 하락 상품 경고
- 광고비 대비 ROAS 분석 코멘트
활용 사례 2: 팀 주간 업무 리포트
Gemini가 해주는 것:
- 팀 전체 업무 진행률 요약
- 반복되는 이슈 패턴 감지
- 리소스 배분 최적화 제안
활용 사례 3: 소셜미디어 성과 리포트
Gemini가 해주는 것:
- 고성과 콘텐츠 패턴 분석
- 팔로워 증감 원인 추론
- 다음 주 콘텐츠 주제 추천
활용 사례 4: 재능넷 프리랜서 수익 트래킹
Gemini가 해주는 것:
- 시간당 수익률이 높은 서비스 유형 분석
- 반복 클라이언트 vs 신규 클라이언트 비율 분석
- 수익 목표 달성 예측 및 전략 제안
⚡ 성능 최적화 & 비용 절감 팁
Gemini API를 효율적으로 쓰는 방법들이야. 무료 한도 안에서 최대한 활용하는 꿀팁! 🍯
토큰 절약 전략
| 전략 | 설명 | 절약 효과 |
|---|---|---|
| 데이터 요약 후 전달 | raw 데이터 전체 대신 집계된 요약 데이터만 전달 | 토큰 70~90% 절약 |
| 프롬프트 캐싱 | 동일한 시스템 프롬프트는 캐시 활용 (Gemini 1.5 지원) | 비용 75% 절약 |
| 배치 처리 | 여러 항목을 한 번의 API 호출로 처리 | 호출 횟수 감소 |
| maxOutputTokens 조절 | 필요한 만큼만 출력 토큰 설정 | 응답 비용 절약 |
| flash 모델 사용 | pro 대신 flash 모델 사용 | 비용 10배 이상 절약 |
Rate Limit 대응 코드
// 재시도 로직이 포함된 안전한 API 호출 함수
function callGeminiWithRetry(prompt, maxRetries = 3) {
for (let attempt = 1; attempt <= maxRetries; attempt++) {
try {
const result = callGeminiAPI(prompt);
// 에러 응답 체크
if (result.startsWith('오류 발생:')) {
if (result.includes('429')) {
// Rate limit: 지수 백오프 (1초, 2초, 4초...)
const waitTime = Math.pow(2, attempt) * 1000;
Logger.log(`Rate limit 감지. ${waitTime/1000}초 후 재시도... (${attempt}/${maxRetries})`);
Utilities.sleep(waitTime);
continue;
}
throw new Error(result);
}
return result; // 성공
} catch (e) {
if (attempt === maxRetries) {
Logger.log('최대 재시도 횟수 초과: ' + e.toString());
return '분석 실패 (재시도 한도 초과)';
}
Utilities.sleep(2000); // 2초 대기 후 재시도
}
}
}
// 여러 섹션을 배치로 처리하는 함수
function generateReportInBatches(sections) {
const results = [];
sections.forEach((section, index) => {
// API 호출 간 1초 간격 (Rate limit 방지)
if (index > 0) {
Utilities.sleep(1000);
}
const result = callGeminiWithRetry(section.prompt);
results.push({ title: section.title, content: result });
Logger.log(`섹션 ${index + 1}/${sections.length} 완료: ${section.title}`);
});
return results;
}
- gemini-1.5-pro: 분당 2회, 하루 50회 (무료 한도 매우 제한적)
- 한도는 변경될 수 있으니 Google AI Studio에서 최신 정보 확인 필수!
🔐 보안 & 운영 베스트 프랙티스
자동화 시스템 만들 때 보안 놓치면 나중에 진짜 큰일 나. 꼭 챙겨야 할 것들 정리했어 🔒
보안 체크리스트
개인정보 익명화 예시
// 고객 데이터 익명화 함수
function anonymizeData(rows) {
return rows.map(row => {
const anonymized = [...row];
// 이름 마스킹 (홍*동)
if (anonymized[1] && anonymized[1].length > 1) {
anonymized[1] = anonymized[1][0] + '*'.repeat(anonymized[1].length - 2) + anonymized[1].slice(-1);
}
// 전화번호 마스킹 (010-****-1234)
if (anonymized[2]) {
anonymized[2] = anonymized[2].replace(/(\d{3})-(\d{4})-(\d{4})/, '$1-****-$3');
}
// 이메일 마스킹 (h***@gmail.com)
if (anonymized[3] && anonymized[3].includes('@')) {
const [local, domain] = anonymized[3].split('@');
anonymized[3] = local[0] + '***@' + domain;
}
return anonymized;
});
}
// 사용 예시
const rawData = dataSheet.getDataRange().getValues();
const safeData = anonymizeData(rawData.slice(1)); // 헤더 제외
// safeData를 Gemini API에 전달
📱 실전 Q&A: 자주 묻는 질문들
A: 두 가지 방법이 있어!
① 데이터 청크 분할: 한 번에 처리할 행 수를 제한하고, 처리 위치를 Properties에 저장해서 다음 실행 때 이어서 처리
② 요약 데이터만 AI에 전달: 전체 raw 데이터 대신 집계된 요약 통계만 Gemini에 보내면 토큰도 줄고 처리 시간도 단축됨
A:
temperature 값을 낮춰봐! 0.1~0.3 정도로 설정하면 훨씬 일관된 출력이 나와.또한 프롬프트에 출력 형식을 매우 구체적으로 명시하면 (예: "반드시 다음 형식으로만 작성하세요: ...") 일관성이 올라가.
A: gemini-1.5-flash 기준 하루 1,500회 호출이면 웬만한 소규모 팀은 충분해.
주간 리포트 1개 생성에 보통 3~5회 API 호출이면 되거든. 일일 리포트도 하루 5~10회면 충분하고.
사용량이 많아지면 유료 플랜 전환하면 되는데, 가격도 꽤 합리적이야.
A: 개인 Gmail 계정으로도 Apps Script 사용 가능해! 다만 일부 기능(GmailApp 발송 한도 등)에서 차이가 있을 수 있어.
비즈니스 목적이라면 Google Workspace 계정 쓰는 게 더 안정적이긴 해.
A: 당연하지! Python + google-generativeai 라이브러리 + gspread 라이브러리 조합으로도 동일한 기능 구현 가능해.
근데 Apps Script는 별도 서버 없이 Google 인프라에서 바로 실행되니까 진입 장벽이 훨씬 낮아. 서버 비용도 0원이고 ㅋㅋ
🎯 마무리: 자동화의 진짜 가치
자 이제 Gemini + Google Sheets 자동 리포트 시스템의 전체 그림이 보이지? 😊
처음엔 코드 작성하는 데 시간이 좀 걸리겠지만, 한 번 만들어두면 그 다음부터는 진짜 아무것도 안 해도 돼.
매주 월요일 아침에 커피 한 잔 마시면서 자동으로 생성된 리포트 확인하는 그 느낌... 진짜 꿀이야 ㅋㅋㅋ ☕
🎯 정확성 향상: 수동 계산 실수 제거, 일관된 형식 유지
🤖 AI 인사이트: 사람이 놓칠 수 있는 패턴과 트렌드 자동 감지
📈 의사결정 속도: 데이터 기반 인사이트를 즉시 확인
💰 비용 절감: 반복 업무 인건비 절감, Gemini 무료 티어 활용
프로그램 개발 카테고리에서 AI 자동화는 이제 선택이 아니라 필수가 되고 있어.
Gemini + Google Sheets 조합은 진입 장벽이 낮으면서도 실무에서 바로 쓸 수 있는 강력한 도구야.
오늘 배운 내용으로 당장 내일부터 자동화 시작해봐! 처음엔 작은 것부터, 그리고 점점 확장해나가면 돼. 💪
코드 짜다가 막히는 부분 있으면 Gemini한테 물어봐도 되고 ㅋㅋㅋ (AI한테 AI 코드 짜달라고 하는 거 진짜 레전드 아님? 😂)
관련 키워드
댓글 작성
이 글에 대한 여러분의 생각을 들려주세요
로그인이 필요합니다
댓글을 작성하려면 먼저 로그인해주세요.
댓글 0
지식인의 숲 - 지적 재산권 보호 고지
지적 재산권 보호 고지
- 저작권 및 소유권: 본 컨텐츠는 재능넷의 독점 AI 기술로 생성되었으며, 대한민국 저작권법 및 국제 저작권 협약에 의해 보호됩니다.
- AI 생성 컨텐츠의 법적 지위: 본 AI 생성 컨텐츠는 재능넷의 지적 창작물로 인정되며, 관련 법규에 따라 저작권 보호를 받습니다.
- 사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
- 데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
- AI 학습 제한: 재능넷의 AI 생성 컨텐츠를 타 AI 모델 학습에 무단 사용하는 행위는 금지되며, 이는 지적 재산권 침해로 간주됩니다.
아직 댓글이 없습니다.