# Google Drive 파일 이름 변경을 위한 Apps Script 스크립트

> 이름 매핑이 이미 포함된 Google Apps Script 스크립트를 생성하세요. 이 스크립트는 당신의 계정에서 테스트 모드(dry run)가 활성화된 상태로 실행되며, 재개 가능한 배치와 최종 보고서를 제공합니다. 당신의 Drive에 대한 접근 권한을 저희에게 주지 않습니다.

- **출처 (source):** https://kr.aitoolsforapps.com/google-drive-pa-il-pol-deo-gwon-han-jeong-ri-271/f/apps-script-drive-rename-script
- **플랫폼 (platform):** AiToolsForApps
- **언어 (language):** ko

## 요약

- 사용자 본인의 Google Drive에서, 저희에게 접근 권한을 주지 않고 이름을 바꾸는 스크립트
- 사용자 매핑이 이미 포함된 Google Apps Script 스크립트를 드립니다. 계정에 붙여넣고 직접 실행하면, 첫 실행 시에는 어떤 작업을 수행할지 미리 보여줍니다.
- OAuth 없음, 토큰 없음
- 테스트 모드 기본 활성화
- 작업 전 확인

## 사용자 본인의 Google Drive에서, 저희에게 접근 권한을 주지 않고 이름을 바꾸는 스크립트

이름을 변경할 «현재 이름 → 새 이름» 매핑 테이블이 준비되면, 이 기능은 해당 매핑을 이름 쌍이 내부에 작성된 Google Apps Script 스크립트로 변환합니다. 채워야 하는 일반적인 템플릿이 아닙니다. 바로 붙여넣을 수 있는 사용자 매핑입니다.

스크립트는 사용자 본인의 Google 계정 내, 사용자 본인의 Apps Script 프로젝트에서 실행됩니다. 저희는 OAuth를 요청하지 않으며, 사용자 Google Drive 토큰을 보유하지 않고, 저희 서버는 사용자 파일을 건드리지 않습니다. 사용자 본인이 스크립트를 승인하고 직접 실행합니다. 따라서 회사에서 타사 애플리케이션 설치를 허용하지 않더라도 동일하게 작동합니다.

스크립트에는 테스트 모드가 기본적으로 활성화되어 있습니다 (편집 가능한 첫 번째 줄에 DRY_RUN = true). 첫 실행 시에는 아무것도 이름을 변경하지 않고, 파일별로 어떤 작업을 수행할지 로그에만 기록합니다. 로그가 만족스러우면 DRY_RUN = false로 변경하고 다시 실행합니다.

각 파일을 처리하기 전에 예상했던 이름으로 계속 불리는지 확인합니다. 만약 누군가 이미 이름을 변경했거나, 이동했거나, 해당 폴더에 없는 경우, 맹목적으로 이름을 변경하는 대신 «찾을 수 없음»으로 표시합니다. 200개 파일 단위로 일괄 처리하며 진행 상황을 저장하므로, Apps Script가 시간 제한으로 중단되더라도 다시 실행하면 중단된 지점부터 계속 진행됩니다. 마지막에는 변경된 파일, 변경되지 않은 파일, 찾을 수 없는 파일의 개수를 출력합니다.

## 포함된 내용

- **OAuth 없음, 토큰 없음** — 저희는 어떠한 경우에도 사용자 Google Drive에 대한 접근을 요청하지 않습니다. 스크립트는 사용자 계정에 존재하며, 사용자 본인이 승인하고, 저희 서버는 사용자 파일을 보거나, 열거나, 저장하지 않습니다.
- **테스트 모드 기본 활성화** — DRY_RUN 변수가 true로 설정되어 있어 첫 실행 시에는 어떤 작업을 수행할지 로그에만 기록합니다. 실제로 이름을 변경하는 것은 의식적인 결정이지, 우연이 아닙니다.
- **작업 전 확인** — 지정한 폴더 내에서 각 파일은 현재 이름으로 검색됩니다. 이름이 변경되었다면 건너뛰고 «찾을 수 없음»으로 기록됩니다. 잘못된 파일은 절대 이름이 변경되지 않습니다.
- **200개 파일씩 재개 가능한 배치** — 스크립트가 중단된 지점을 사용자 프로젝트의 속성에 저장합니다. Apps Script가 실행 시간 초과로 중단되면 다시 실행하면 이어서 진행됩니다. 배치를 처음부터 다시 시작하는 기능도 있습니다.
- **로그에 최종 보고서** — DRY_RUN을 비활성화하기 전까지는 «테스트 모드» 표시가 명확하게 보이는 상태로, 이름이 변경된 파일, 변경되지 않은 파일, 찾을 수 없는 파일 목록이 제공됩니다. 탭을 닫기 전에 정확히 무슨 일이 일어났는지 알 수 있습니다.
- **대용량 배치를 자동으로 분할** — 매핑이 400쌍을 초과하면, Apps Script가 붙여넣기 시 버벅거리지 않도록 «파트 2 복사», «파트 3 복사»… 버튼이 있는 여러 개의 번호가 매겨진 스크립트로 나눕니다.
- **모바일에서 시작하여 컴퓨터에서 완료하도록 설계** — «스크립트 복사»와 «컴퓨터로 보내기» (이메일, 채팅 또는 메모로 공유; 브라우저가 공유 기능을 지원하지 않으면 클립보드에 복사)가 동일한 수준으로 제공되며, script.new로 바로 연결되는 링크도 있습니다.
- 세션 동안 체크된 상태로 유지되는 체크박스가 있는 4단계와, «확인되지 않은 앱» 경고, Apps Script를 차단하는 회사 도메인, 중간에 중단되는 경우, 그리고 나타나지 않는 파일 등 발생하기 전에 해결되는 예상 가능한 4가지 오류에 대한 드롭다운이 있습니다.

## 자주 묻는 질문

### Google Drive 파일 이름을 스크립트로 어떻게 변경하나요?

Google 계정에 포함된 자동화 언어인 Google Apps Script를 사용하세요. 직접 프로그래밍할 필요가 없습니다. 파일 이름 목록을 붙여넣고, 앱이 제안하는 «현재 이름 → 새 이름» 매핑을 검토한 후 «이름 변경 스크립트»를 누르세요. 이름 쌍이 이미 작성된 스크립트를 받게 됩니다. script.new에서 열고 붙여넣은 다음, 폴더 ID(Drive URL의 /folders/ 뒤에 있음)를 지정하고, 실행하여 본인의 프로젝트를 승인합니다. 첫 실행 시에는 아무것도 변경하지 않습니다. 단지 로그에 어떤 작업을 수행할지 보여줄 뿐입니다.

### 앱에 Google 권한을 부여해야 하나요?

아닙니다. 이 앱은 Google Drive에 연결되지 않습니다. 사용자가 붙여넣은 이름 목록으로만 작동하며, 어떤 파일도 보거나 열거나 저장하지 않습니다. 스크립트를 실행할 때 나타나는 승인은 사용자 계정 내의 본인 Apps Script 프로젝트에 대한 것입니다. 즉, 사용자 본인에게 권한을 부여하는 것입니다. 그래서 Google에서 «앱이 확인되지 않았습니다»라고 알림을 표시하는 것입니다. 이것은 사용자의 스크립트이며, «고급 설정»에서 계속 진행할 수 있습니다.

### 스크립트가 중간에 멈추면 어떻게 되나요?

Apps Script는 실행 시간이 긴 작업을 시간 제한으로 중단시키므로, 스크립트는 200개 파일씩 배치로 작업하고 프로젝트 속성에 진행 상황을 저장합니다. 만약 중단되면, 다시 실행할 때 중단된 지점부터 이어서 진행하며 이미 처리된 작업은 반복하지 않습니다. 원하시면 해당 지점을 삭제하고 처음부터 배치 작업을 시작할 수 있는 기능도 포함되어 있습니다.

### 스크립트가 잘못된 파일의 이름을 변경할 수도 있나요?

그럴 가능성은 낮습니다. 이름을 변경하기 전에, 스크립트는 지정된 폴더 안에서 각 파일을 현재 이름으로 찾습니다. 만약 그 이름이 더 이상 존재하지 않는다면 (누군가 이름을 변경했거나, 이동했거나, 다른 폴더에 있기 때문입니다), 해당 파일을 건너뛰고 보고서에 «찾을 수 없음»으로 기록합니다. 무작정 이름을 변경하기보다는 아무것도 건드리지 않는 것을 선호합니다. 그리고 DRY_RUN이 true로 설정되어 있는 동안에는 단 하나의 파일도 수정되지 않습니다.

### 저희 회사가 Apps Script 실행을 허용하지 않는다면 어떻게 해야 하나요?

일부 Google Workspace 도메인에서는 Apps Script 사용을 관리자로 제한합니다. 이 경우 동일한 매핑을 CSV 또는 XLSX 파일로 받을 수 있습니다. 스크립트는 아무것도 실행하지 않으며, 수동으로 이름을 변경하거나 권한이 있는 사람이 적용할 수 있는 작업 시트로 활용할 수 있습니다. 스크립트는 지름길일 뿐, 유일한 방법은 아닙니다.

- [Google Drive: AI로 파일, 폴더, 권한 정리](https://kr.aitoolsforapps.com/google-drive-pa-il-pol-deo-gwon-han-jeong-ri-271)

## 플랫폼 소개

**Google Drive: AI로 파일, 폴더, 권한 정리** — 앱 개발: AiToolsForApps. 이용 가능 위치:: https://kr.aitoolsforapps.com/google-drive-pa-il-pol-deo-gwon-han-jeong-ri-271/f/apps-script-drive-rename-script

### 다른 언어

- `es`: https://kr.aitoolsforapps.com/es/organizar-google-drive-nombres-carpetas-y-permisos-271/f/script-apps-script-renombrar-drive
- `en`: https://kr.aitoolsforapps.com/en/organize-google-drive-file-names-folders-permissions-271/f/script-apps-script-rename-drive
- `fr`: https://kr.aitoolsforapps.com/fr/organiser-google-drive-noms-dossiers-et-autorisations-271/f/script-apps-script-renommer-drive
- `it`: https://kr.aitoolsforapps.com/it/organizzare-google-drive-nomi-cartelle-e-permessi-271/f/script-apps-script-rinomina-drive
- `pt`: https://kr.aitoolsforapps.com/pt/organizar-google-drive-nomes-pastas-e-permissoes-271/f/script-apps-script-renomear-drive
- `de`: https://kr.aitoolsforapps.com/de/google-drive-dateien-ordner-und-berechtigungen-ordnen-271/f/skript-apps-script-umbenennen-drive
- `bg`: https://kr.aitoolsforapps.com/bg/organizirane-na-google-drive-imena-papki-i-prava-271/f/apps-script-drive
- `ja`: https://kr.aitoolsforapps.com/ja/google-drive-file-folder-permission-seiri-271/f/apps-script-drive-rename-script
- `nl`: https://kr.aitoolsforapps.com/nl/google-drive-ordenen-bestandsnamen-mappen-en-rechten-271/f/script-apps-script-hernoemen-drive
- `sv`: https://kr.aitoolsforapps.com/sv/ordna-google-drive-filnamn-mappar-och-behorigheter-271/f/skript-apps-script-dopa-om-drive
- `da`: https://kr.aitoolsforapps.com/da/organiser-google-drive-filenavne-mapper-og-tilladelser-271/f/script-apps-script-omdoeb-drive
