Class DriveApp

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Drive 앱

스크립트로 Google Drive에 있는 파일과 폴더를 만들고 찾고 수정할 수 있습니다.

// Log the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  Logger.log(file.getName());
}

속성

속성유형설명
AccessAccess액세스 권한을 명시적으로 부여받은 개별 사용자 외에 파일이나 폴더에 액세스할 수 있는 사용자 클래스를 나타내는 enum입니다.
PermissionPermission액세스 권한을 명시적으로 부여받은 개별 사용자 이외에 파일이나 폴더에 액세스할 수 있는 사용자에게 부여되는 권한을 나타내는 열거형입니다.

메서드

메서드반환 유형간략한 설명
continueFileIterator(continuationToken)FileIterator이전 반복자의 연속 토큰을 사용하여 파일 반복을 재개합니다.
continueFolderIterator(continuationToken)FolderIterator이전 반복자의 연속 토큰을 사용하여 폴더 반복을 재개합니다.
createFile(blob)File임의의 Blob의 지정된 데이터에서 사용자의 Drive 루트에 파일을 만듭니다.
createFile(name, content)File사용자 드라이브의 루트에 지정된 이름과 콘텐츠로 텍스트 파일을 만듭니다.
createFile(name, content, mimeType)File지정된 사용자 이름, 콘텐츠, MIME 유형으로 사용자 드라이브의 루트에 파일을 생성합니다.
createFolder(name)Folder사용자 드라이브의 루트에 지정된 이름으로 폴더를 만듭니다.
createShortcut(targetId)File제공된 Drive 항목 ID에 대한 바로가기를 만들어 반환합니다.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)File제공된 Drive 항목 ID와 리소스 키의 바로가기를 만들어 반환합니다.
enforceSingleParent(value)void항목 상위 요소에 영향을 미치는 모든 호출에 시행SingleParent 동작을 사용 설정 또는 사용 중지합니다.
getFileById(id)File지정된 ID의 파일을 가져옵니다.
getFileByIdAndResourceKey(id, resourceKey)File지정된 ID와 리소스 키가 있는 파일을 가져옵니다.
getFiles()FileIterator사용자 드라이브에 있는 모든 파일의 컬렉션을 가져옵니다.
getFilesByName(name)FileIterator사용자 Drive에서 지정된 이름의 모든 파일 컬렉션을 가져옵니다.
getFilesByType(mimeType)FileIterator사용자의 드라이브에 있는 MIME 유형의 모든 파일 컬렉션을 가져옵니다.
getFolderById(id)Folder지정된 ID가 있는 폴더를 가져옵니다.
getFolderByIdAndResourceKey(id, resourceKey)Folder지정된 ID와 리소스 키가 있는 폴더를 가져옵니다.
getFolders()FolderIterator사용자 드라이브에 있는 모든 폴더의 컬렉션을 가져옵니다.
getFoldersByName(name)FolderIterator사용자 드라이브에 지정된 이름의 모든 폴더 컬렉션을 가져옵니다.
getRootFolder()Folder사용자 Drive의 루트에 있는 폴더를 가져옵니다.
getStorageLimit()Integer사용자가 Drive에 저장할 수 있는 바이트 수를 가져옵니다.
getStorageUsed()Integer사용자가 현재 Drive에 저장한 바이트 수를 가져옵니다.
getTrashedFiles()FileIterator사용자의 휴지통에 있는 모든 파일 컬렉션을 가져옵니다.
getTrashedFolders()FolderIterator사용자의 휴지통에 있는 모든 폴더 컬렉션을 가져옵니다.
searchFiles(params)FileIterator지정된 Drive 기준과 일치하는 사용자 Drive의 모든 파일 컬렉션을 가져옵니다.
searchFolders(params)FolderIterator지정된 Drive 기준과 일치하는 사용자 Drive의 모든 폴더 컬렉션을 가져옵니다.

자세한 문서

continueFileIterator(continuationToken)

이전 반복자의 연속 토큰을 사용하여 파일 반복을 재개합니다. 이 메서드는 한 실행에서 반복기를 처리할 때 최대 실행 시간을 초과하는 경우에 유용합니다. 지속 토큰은 일반적으로 1주일 동안 유효합니다.

매개변수

이름유형설명
continuationTokenString이전 파일 반복자의 연속 토큰

Return

FileIterator — 연속 토큰이 생성되었을 때 이전 반복자에 남아 있는 파일 컬렉션


continueFolderIterator(continuationToken)

이전 반복자의 연속 토큰을 사용하여 폴더 반복을 재개합니다. 이 메서드는 한 실행에서 반복기를 처리할 때 최대 실행 시간을 초과하는 경우에 유용합니다. 지속 토큰은 일반적으로 1주일 동안 유효합니다.

매개변수

이름유형설명
continuationTokenString이전 폴더 반복자의 연속 토큰

Return

FolderIterator — 연속 토큰이 생성되었을 때 이전 반복자에 남아 있는 폴더 컬렉션


createFile(blob)

임의의 Blob의 지정된 데이터에서 사용자의 Drive 루트에 파일을 만듭니다.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.createFile(blob);

매개변수

이름유형설명
blobBlobSource새 파일의 데이터입니다.

Return

File: 새 파일입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

createFile(name, content)

사용자 드라이브의 루트에 지정된 이름과 콘텐츠로 텍스트 파일을 만듭니다. content이 50MB보다 크면 예외가 발생합니다.

// Create a text file with the content "Hello, world!"
DriveApp.createFile('New Text File', 'Hello, world!');

매개변수

이름유형설명
nameString새 파일의 이름입니다.
contentString새 파일의 콘텐츠입니다.

Return

File: 새 파일입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

createFile(name, content, mimeType)

지정된 사용자 이름, 콘텐츠, MIME 유형으로 사용자 드라이브의 루트에 파일을 생성합니다. content이 10MB보다 크면 예외가 발생합니다.

// Create an HTML file with the content "Hello, world!"
DriveApp.createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

매개변수

이름유형설명
nameString새 파일의 이름입니다.
contentString새 파일의 콘텐츠입니다.
mimeTypeString새 파일의 MIME 유형입니다.

Return

File: 새 파일입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

createFolder(name)

사용자 드라이브의 루트에 지정된 이름으로 폴더를 만듭니다.

매개변수

이름유형설명
nameString새 폴더의 이름입니다.

Return

Folder — 새 폴더입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

createShortcut(targetId)

제공된 Drive 항목 ID에 대한 바로가기를 만들어 반환합니다.

매개변수

이름유형설명
targetIdString타겟 파일 또는 폴더의 파일 ID

Return

File — 새로운 바로가기입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

제공된 Drive 항목 ID와 리소스 키의 바로가기를 만들어 반환합니다. 리소스 키는 링크를 사용하여 공유된 대상 파일 또는 폴더에 액세스하기 위해 전달되어야 하는 추가 매개변수입니다.

매개변수

이름유형설명
targetIdString대상 파일 또는 폴더의 ID
targetResourceKeyString대상 파일 또는 폴더의 리소스 키입니다.

Return

File — 새로운 바로가기입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

enforceSingleParent(value)

항목 상위 요소에 영향을 미치는 모든 호출에 시행SingleParent 동작을 사용 설정 또는 사용 중지합니다.

자세한 내용은 Google Drive 폴더 구조 간소화 및 모델 공유 블로그를 참고하세요.

매개변수

이름유형설명
valueBooleanforceSingleParent 플래그의 새 상태입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive

getFileById(id)

지정된 ID의 파일을 가져옵니다. 파일이 없거나 사용자에게 파일 액세스 권한이 없으면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
idString파일의 ID

Return

File: 지정된 ID가 있는 파일

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFileByIdAndResourceKey(id, resourceKey)

지정된 ID와 리소스 키가 있는 파일을 가져옵니다. 리소스 키는 링크를 사용하여 공유된 파일에 액세스하기 위해 전달되어야 하는 추가 매개변수입니다.

파일이 없거나 사용자에게 파일 액세스 권한이 없으면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
idString파일의 ID.
resourceKeyString폴더의 리소스 키입니다.

Return

File - 지정된 ID가 있는 파일

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFiles()

사용자 드라이브에 있는 모든 파일의 컬렉션을 가져옵니다.

Return

FileIterator: 사용자의 드라이브에 있는 모든 파일의 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByName(name)

사용자 Drive에서 지정된 이름의 모든 파일 컬렉션을 가져옵니다.

매개변수

이름유형설명
nameString찾을 파일의 이름입니다.

Return

FileIterator: 사용자의 드라이브에 특정 이름을 가진 모든 파일의 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByType(mimeType)

사용자의 드라이브에 있는 MIME 유형의 모든 파일 컬렉션을 가져옵니다.

매개변수

이름유형설명
mimeTypeString찾을 파일의 MIME 유형입니다.

Return

FileIterator: 지정된 MIME 유형을 가진 사용자 드라이브의 모든 파일 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolderById(id)

지정된 ID가 있는 폴더를 가져옵니다. 폴더가 없거나 사용자에게 폴더에 액세스할 권한이 없는 경우 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
idString폴더의 ID

Return

Folder: 지정된 ID가 있는 폴더

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolderByIdAndResourceKey(id, resourceKey)

지정된 ID와 리소스 키가 있는 폴더를 가져옵니다. 리소스 키는 링크를 사용하여 공유된 폴더에 액세스하기 위해 전달해야 하는 추가 매개변수입니다.

폴더가 없거나 사용자에게 폴더에 액세스할 수 있는 권한이 없으면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
idString폴더의 ID입니다.
resourceKeyString폴더의 리소스 키입니다.

Return

Folder: 지정된 ID가 있는 폴더입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolders()

사용자 드라이브에 있는 모든 폴더의 컬렉션을 가져옵니다.

Return

FolderIterator: 사용자 드라이브에 있는 모든 폴더의 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFoldersByName(name)

사용자 드라이브에 지정된 이름의 모든 폴더 컬렉션을 가져옵니다.

매개변수

이름유형설명
nameString찾을 폴더의 이름입니다.

Return

FolderIterator: 사용자 드라이브에 있는 특정 폴더의 모든 폴더 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getRootFolder()

사용자 Drive의 루트에 있는 폴더를 가져옵니다.

Return

Folder: 사용자 드라이브의 루트 폴더

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getStorageLimit()

사용자가 Drive에 저장할 수 있는 바이트 수를 가져옵니다.

Return

Integer: 사용자가 Drive에 저장할 수 있는 바이트 수

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getStorageUsed()

사용자가 현재 Drive에 저장한 바이트 수를 가져옵니다.

Return

Integer: 사용자가 현재 Drive에 저장한 바이트 수

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTrashedFiles()

사용자의 휴지통에 있는 모든 파일 컬렉션을 가져옵니다.

Return

FileIterator — 휴지통의 파일 모음

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTrashedFolders()

사용자의 휴지통에 있는 모든 폴더 컬렉션을 가져옵니다.

Return

FolderIterator — 휴지통의 폴더 모음

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFiles(params)

지정된 Drive 기준과 일치하는 사용자 Drive의 모든 파일 컬렉션을 가져옵니다. 검색 기준은 Google Drive SDK 문서에 자세히 설명되어 있습니다. params 인수는 문자열 값을 포함할 수 있는 쿼리 문자열이므로 따옴표를 올바르게 이스케이프 처리해야 합니다 (예: "title contains 'Gulliver\\'s Travels'" 또는 'title contains "Gulliver\'s Travels"').

// Log the name of every file in the user's Drive that modified after February 28,
// 2013 whose name contains "untitled".
var files = DriveApp.searchFiles(
    'modifiedDate > "2013-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  Logger.log(file.getName());
}

매개변수

이름유형설명
paramsStringGoogle Drive SDK 문서에 설명된 검색 기준입니다.

Return

FileIterator — 검색 기준과 일치하는 사용자 Drive의 모든 파일 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFolders(params)

지정된 Drive 기준과 일치하는 사용자 Drive의 모든 폴더 컬렉션을 가져옵니다. 검색 기준은 Google Drive SDK 문서에 자세히 설명되어 있습니다. params 인수는 문자열 값을 포함할 수 있는 쿼리 문자열이므로 따옴표를 올바르게 이스케이프 처리해야 합니다 (예: "title contains 'Gulliver\\'s Travels'" 또는 'title contains "Gulliver\'s Travels"').

// Log the name of every folder in the user's Drive that you own and is starred.
var folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

매개변수

이름유형설명
paramsStringGoogle Drive SDK 문서에 설명된 검색 기준입니다.

Return

FolderIterator — 검색 기준과 일치하는 사용자 Drive의 모든 폴더 모음입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

지원 중단된 메서드