2026년 10월 26일자 Gemini API 출시 노트에 따르면, 유료 계정(有料枠)의 신규 프로젝트에서 Generate Content API의 요청 저장이 **기본적으로 켜짐(store=true)**으로 변경되었습니다.
코드를 수정하지 않아도 동작은 계속되므로 파괴적 변경(breaking change)은 아닙니다. 하지만, 프롬프트나 응답이 로그로 저장된다는 점을 유의해야 합니다. 개인 정보나 기밀 정보를 다루는 앱의 경우, 프라이버시, 컴플라이언스, 데이터 보존 정책 관점에서 확인이 필요합니다.
📌 영향을 받는 사람
- 유료 계정에서 Gemini API를 사용하는 새로운 프로젝트를 만드는 개발자
- 고객 데이터, 사내 문서, 개인 정보를 프롬프트에 포함하는 앱의 개발자 및 운영자
- 정보 보안, 법무, 컴플라이언스를 담당하는 사람
기존 프로젝트는 현재 설정 그대로 변경되지 않습니다.
대상은 Generate Content API의 다음 3가지 엔드포인트입니다. 이는 Interactions API의 기본 동작에 맞춘 변경 사항입니다.
저장을 막는 방법은 두 가지가 있습니다. 요청 단위로 막는 방법과, 프로젝트 단위로 막는 방법입니다.
| 항목 | 내용 |
|---|
| 발표일 | 2026년 10월 26일 |
| 대상 | 유료 계정에서 새로 만든 프로젝트 |
| 대상 엔드포인트 | generateContent / streamGenerateContent / batchGenerateContent |
| 새로운 기본값 | store=true (요청 저장) |
| 기존 프로젝트 | 현재 설정 그대로 유지 |
| 배경 | Interactions API의 기본 동작에 맞춤 |
| 파괴적 변경 여부 | 아니요 (코드 수정 없이 작동함) |
| 방법 | 범위 | 적합한 상황 |
|---|
요청마다 store=false 지정 | 해당 요청만 | 기밀성이 높은 호출만 저장하고 싶지 않을 경우 |
| Logs and Datasets 대시보드의 Settings 패널에서 Generate Content API 로그 기록을 끔 | 프로젝트 전체 | 프로젝트 전체에서 저장하지 않겠다는 방침인 경우 |
자세한 내용은 공식 문서 'Logs and datasets'에서 안내하고 있습니다.
릴리스 노트의 'Last updated' 날짜가 2026-10-14 UTC에서 2026-10-26 UTC로 변경되었습니다. 이는 상기 항목이 추가된 것이므로 기능적인 변경은 아닙니다.
신규 프로젝트 생성 직후 설정을 확인하세요
Logs and Datasets 대시보드의 Settings 패널에서 Generate Content API의 로그 기록 상태를 확인합니다. -
데이터 보존 정책과 비교하세요
저장되는 데이터의 처리가 사내 규정, 계약, 개인 정보 보호 방침에 적합한지 보안 담당자나 법무팀과 확인해야 합니다. -
저장하고 싶지 않다면 명시적으로 중단시키세요
프로젝트 단위라면 대시보드에서, 요청 단위라면 store=false를 지정합니다. -
운영 규칙에 남겨두세요
팀의 개발 가이드나 CLAUDE.md 등에 저장 기본값과 중단 방법을 기재해 둡니다.
💡 팁
신규 프로젝트 템플릿이나 설정 절차에 '로그 기록 설정 확인' 단계를 포함하면 누락을 방지할 수 있습니다. IaC(Infrastructure as Code)나 체크리스트에 통합하는 것도 효과적입니다.
⚠️ 주의
기존 프로젝트는 변하지 않지만, 신규 프로젝트만 기본값이 다릅니다. '이전 프로젝트에서는 저장되지 않았다'는 전제하에 코드를 재사용할 경우, 의도치 않게 저장될 가능성이 있습니다.
| 사용 사례 | 권장 확인 사항 |
|---|
| 사내 헬프데스크 봇 (사내 문서 포함) | 저장을 허용할 수 있는지 확인. 불필요하다면 로그 기록을 끔 |
| 고객 문의 요약 (개인 정보 포함) | store=false 또는 프로젝트 전체 비활성화를 고려 |
| 공개 정보만 다루는 배치 처리 | 저장을 허용할 수 있다면 기본값 그대로 두어도 무방함 |
| 개발 중 프롬프트 검증 | 로그를 다시 보고 싶다면, 저장이 도움이 될 수도 있음 |
요청마다 저장을 멈추는 경우의 예시입니다.
📌 주의
아래 내용은 제공된 정보(요청마다 store=false)
를 지정하는 것을 설명하기 위한 예시 이미지입니다. 실제 파라미터의 위치나 SDK에서의 지정 방법은 공식 'Logs and datasets' 문서를 확인해 주십시오.
Before (신규 프로젝트 기본값. 저장됨)
# 아무것도 지정하지 않은 경우, 신규 유료 계정 프로젝트에서는 store=true로 간주됩니다
response = client.models.generate_content(
model="<model-name>",
...
After (이 요청은 저장하지 않음)
# store=false를 명시합니다 (지정 방법은 공식 문서를 확인하십시오)
response = client.models.generate_content(
model="<model-name>",
...
Gemini API / 데이터 저장 및 개인정보 보호 설정
- 유료 계정의 신규 프로젝트에서는 Generate Content API (generateContent / streamGenerateContent / batchGenerateContent) 요청이 기본적으로 저장(
store=true)되도록 변경되었습니다. - 기존 프로젝트는 현재 설정 그대로 유지됩니다. 코드를 수정할 필요가 없어 파괴적 변경은 아닙니다.
- 저장을 중지하려면, 요청마다 지정하거나,
store=false를 사용하거나, 'Logs and Datasets' 대시보드의 Settings에서 로그 기록을 끄십시오. - 기밀 정보나 개인 정보를 다루는 경우에는, 신규 프로젝트를 생성했다면 먼저 설정을 확인하여 데이터 보존 방침과 비교해 주십시오. - 자세한 내용은 공식 'Logs and datasets' 문서를 확인해 주십시오.
