Class Folder

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

Google Drive의 폴더 폴더는 DriveApp에서 액세스하거나 만들 수 있습니다.

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

메서드

메서드반환 유형간략한 설명
addEditor(emailAddress)Folder지정된 사용자를 Folder의 편집자 목록에 추가합니다.
addEditor(user)Folder지정된 사용자를 Folder의 편집자 목록에 추가합니다.
addEditors(emailAddresses)Folder지정된 사용자 배열을 Folder의 편집자 목록에 추가합니다.
addViewer(emailAddress)Folder지정된 사용자를 Folder의 뷰어 목록에 추가합니다.
addViewer(user)Folder지정된 사용자를 Folder의 뷰어 목록에 추가합니다.
addViewers(emailAddresses)Folder지정된 사용자 배열을 Folder의 시청자 목록에 추가합니다.
createFile(blob)File임의의 Blob 데이터를 사용하여 현재 폴더에 파일을 만듭니다.
createFile(name, content)File지정된 폴더에 지정된 내용 및 이름으로 텍스트 파일을 만듭니다.
createFile(name, content, mimeType)File지정된 이름, 콘텐츠, MIME 유형으로 현재 폴더에 파일을 만듭니다.
createFolder(name)Folder현재 폴더에 지정된 이름으로 폴더를 만듭니다.
createShortcut(targetId)File제공된 Drive 항목 ID에 대한 바로가기를 만들어 반환합니다.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)File제공된 Drive 항목 ID와 리소스 키의 바로가기를 만들어 반환합니다.
getAccess(email)Permission지정된 사용자에게 부여된 권한을 가져옵니다.
getAccess(user)Permission지정된 사용자에게 부여된 권한을 가져옵니다.
getDateCreated()DateFolder가 생성된 날짜를 가져옵니다.
getDescription()StringFolder의 설명을 가져옵니다.
getEditors()User[]Folder의 편집자 목록을 가져옵니다.
getFiles()FileIterator현재 폴더의 하위 요소인 모든 파일의 컬렉션을 가져옵니다.
getFilesByName(name)FileIterator현재 폴더의 하위 요소이며 지정된 이름을 가진 모든 파일의 컬렉션을 가져옵니다.
getFilesByType(mimeType)FileIterator현재 폴더의 하위 요소이며 지정된 MIME 유형을 가진 모든 파일의 컬렉션을 가져옵니다.
getFolders()FolderIterator현재 폴더의 하위 폴더인 모든 폴더의 컬렉션을 가져옵니다.
getFoldersByName(name)FolderIterator현재 폴더의 하위 요소이며 지정된 이름을 가진 모든 폴더의 컬렉션을 가져옵니다.
getId()StringFolder의 ID를 가져옵니다.
getLastUpdated()DateFolder가 마지막으로 업데이트된 날짜를 가져옵니다.
getName()StringFolder의 이름을 가져옵니다.
getOwner()UserFolder의 소유자를 가져옵니다.
getParents()FolderIteratorFolder의 직계 상위 요소인 폴더 컬렉션을 가져옵니다.
getResourceKey()String링크를 사용하여 공유된 항목에 액세스하는 데 필요한 Folder의 리소스 키를 가져옵니다.
getSecurityUpdateEligible()BooleanFolder이(가) 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다.
getSecurityUpdateEnabled()BooleanFolder가 링크를 사용하여 공유될 때 액세스를 위한 리소스 키가 필요한지 여부를 가져옵니다.
getSharingAccess()Access명시적으로 액세스 권한을 부여받은 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스를 가져옵니다.
getSharingPermission()Permission명시적으로 액세스 권한을 부여받은 개별 사용자 이외에 Folder에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다.
getSize()IntegerFolder를 Drive에 저장하는 데 사용된 바이트 수를 가져옵니다.
getUrl()StringDrive 또는 Docs와 같은 Google 앱에서 Folder을 여는 데 사용할 수 있는 URL을 가져옵니다.
getViewers()User[]Folder의 뷰어 및 댓글 작성자 목록을 가져옵니다.
isShareableByEditors()BooleanFolder 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 결정합니다.
isStarred()Boolean사용자의 Drive에서 Folder이(가) 별표표시되었는지 확인합니다.
isTrashed()BooleanFolder가 사용자 Drive의 휴지통에 있는지 확인합니다.
moveTo(destination)Folder이 항목을 제공된 대상 폴더로 이동합니다.
removeEditor(emailAddress)FolderFolder의 편집자 목록에서 지정된 사용자를 삭제합니다.
removeEditor(user)FolderFolder의 편집자 목록에서 지정된 사용자를 삭제합니다.
removeViewer(emailAddress)FolderFolder의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다.
removeViewer(user)FolderFolder의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다.
revokePermissions(user)Folder지정된 사용자에게 부여된 Folder에 대한 액세스 권한을 취소합니다.
revokePermissions(user)Folder지정된 사용자에게 부여된 Folder에 대한 액세스 권한을 취소합니다.
searchFiles(params)FileIterator현재 폴더의 하위 요소이며 지정된 검색 기준과 일치하는 모든 파일의 컬렉션을 가져옵니다.
searchFolders(params)FolderIterator현재 폴더의 하위 요소이며 지정된 검색 기준과 일치하는 모든 폴더의 컬렉션을 가져옵니다.
setDescription(description)FolderFolder의 설명을 설정합니다.
setName(name)FolderFolder의 이름을 설정합니다.
setOwner(emailAddress)FolderFolder의 소유자를 변경합니다.
setOwner(user)FolderFolder의 소유자를 변경합니다.
setSecurityUpdateEnabled(enabled)FolderFolder가 링크를 사용하여 액세스할 때 리소스 키가 필요한지 여부를 설정합니다.
setShareableByEditors(shareable)FolderFolder 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다.
setSharing(accessType, permissionType)Folder명시적으로 액세스 권한을 부여받은 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스와 사용자에게 부여되는 권한을 설정합니다.
setStarred(starred)Folder사용자의 Drive에서 Folder에 별표표시할지 여부를 설정합니다.
setTrashed(trashed)FolderFolder이(가) 사용자 Drive의 휴지통에 있는지 설정합니다.

자세한 문서

addEditor(emailAddress)

지정된 사용자를 Folder의 편집자 목록에 추가합니다. 사용자가 이미 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
emailAddressString추가할 사용자의 이메일 주소입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

addEditor(user)

지정된 사용자를 Folder의 편집자 목록에 추가합니다. 사용자가 이미 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
userUser추가할 사용자의 표현입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

addEditors(emailAddresses)

지정된 사용자 배열을 Folder의 편집자 목록에 추가합니다. 뷰어 목록에 이미 있는 사용자가 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
emailAddressesString[]추가할 사용자의 이메일 주소 배열입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

addViewer(emailAddress)

지정된 사용자를 Folder의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있다면 이 메서드는 적용되지 않습니다.

매개변수

이름유형설명
emailAddressString추가할 사용자의 이메일 주소입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

addViewer(user)

지정된 사용자를 Folder의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있다면 이 메서드는 적용되지 않습니다.

매개변수

이름유형설명
userUser추가할 사용자의 표현입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

addViewers(emailAddresses)

지정된 사용자 배열을 Folder의 시청자 목록에 추가합니다. 이미 편집자 목록에 있는 사용자가 있는 경우 이 메서드는 사용자에게 영향을 미치지 않습니다.

매개변수

이름유형설명
emailAddressesString[]추가할 사용자의 이메일 주소 배열입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

createFile(blob)

임의의 Blob 데이터를 사용하여 현재 폴더에 파일을 만듭니다.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().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.getRootFolder().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.getRootFolder().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

getAccess(email)

지정된 사용자에게 부여된 권한을 가져옵니다.

매개변수

이름유형설명
emailString권한을 확인해야 하는 사용자의 이메일 주소

Return

Permission: 사용자에게 부여된 권한

승인

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

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

getAccess(user)

지정된 사용자에게 부여된 권한을 가져옵니다.

매개변수

이름유형설명
userUser권한을 확인해야 하는 사용자 표현

Return

Permission: 사용자에게 부여된 권한

승인

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

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

getDateCreated()

Folder가 생성된 날짜를 가져옵니다.

Return

Date: Folder가 만들어진 날짜입니다.

승인

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

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

getDescription()

Folder의 설명을 가져옵니다.

Return

String: Folder에 대한 설명

승인

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

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

getEditors()

Folder의 편집자 목록을 가져옵니다. 스크립트를 실행하는 사용자에게 Folder에 대한 수정 액세스 권한이 없으면 이 메서드는 빈 배열을 반환합니다.

Return

User[]: 수정 권한이 있는 사용자의 배열입니다.

승인

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

  • 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)

현재 폴더의 하위 요소이며 지정된 이름을 가진 모든 파일의 컬렉션을 가져옵니다.

매개변수

이름유형설명
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

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

getId()

Folder의 ID를 가져옵니다.

Return

String: Folder의 ID입니다.

승인

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

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

getLastUpdated()

Folder가 마지막으로 업데이트된 날짜를 가져옵니다.

Return

Date: Folder가 마지막으로 업데이트된 날짜

승인

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

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

getName()

Folder의 이름을 가져옵니다.

Return

String: Folder의 이름입니다.

승인

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

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

getOwner()

Folder의 소유자를 가져옵니다.

Return

User: 소유자를 나타내는 User 객체

승인

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

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

getParents()

Folder의 직계 상위 요소인 폴더 컬렉션을 가져옵니다.

Return

FolderIterator: Folder의 직계 상위 폴더 폴더입니다.

승인

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

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

getResourceKey()

링크를 사용하여 공유된 항목에 액세스하는 데 필요한 Folder의 리소스 키를 가져옵니다.

Return

String: Folder의 리소스 키입니다.

승인

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

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

getSecurityUpdateEligible()

Folder이(가) 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다.

Drive에서 링크를 사용하여 공유된 일부 파일 또는 폴더에 액세스하려면 리소스 키가 필요합니다. 이번 변경사항은 보안 업데이트의 일부입니다. 이 업데이트는 대상 파일 및 폴더에 기본적으로 사용 설정됩니다. 적합한 파일에 리소스 키 요구사항을 사용 또는 사용 중지하려면 setSecurityUpdateEnabled을 사용합니다.

Google Drive의 보안 업데이트에 관해 자세히 알아보세요.

Return

Boolean: Folder에 리소스 키 요구사항을 적용할 수 있는지 여부입니다.

승인

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

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

getSecurityUpdateEnabled()

Folder가 링크를 사용하여 공유될 때 액세스를 위한 리소스 키가 필요한지 여부를 가져옵니다. 이 요구사항은 대상 파일 및 폴더에 대해 기본적으로 사용 설정되어 있습니다. 적합한 파일에 리소스 키 요구사항을 사용 또는 사용 중지하려면 setSecurityUpdateEnabled을 사용합니다.

Google Drive의 보안 업데이트에 관해 자세히 알아보세요.

Return

Boolean: 이 Folder에 리소스 키 요구사항이 사용 설정되었는지 여부입니다.

승인

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

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

getSharingAccess()

명시적으로 액세스 권한을 부여받은 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스를 가져옵니다.

Return

Access: Folder에 액세스할 수 있는 사용자 클래스

승인

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

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

getSharingPermission()

명시적으로 액세스 권한을 부여받은 개별 사용자 이외에 Folder에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다.

Return

Permission: Folder에 액세스할 수 있는 사용자에게 부여되는 권한입니다.

승인

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

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

getSize()

Folder를 Drive에 저장하는 데 사용된 바이트 수를 가져옵니다. Google Workspace 애플리케이션 파일은 Drive 스토리지 한도에 포함되지 않으므로 0바이트가 반환됩니다.

Return

Integer: Drive에 Folder를 저장하는 데 사용된 바이트 수

승인

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

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

getUrl()

Drive 또는 Docs와 같은 Google 앱에서 Folder을 여는 데 사용할 수 있는 URL을 가져옵니다.

Return

String: Drive 또는 Docs와 같은 Google 앱에서 이 Folder를 보는 데 사용할 수 있는 URL입니다.

승인

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

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

getViewers()

Folder의 뷰어 및 댓글 작성자 목록을 가져옵니다. 스크립트를 실행하는 사용자에게 Folder에 대한 수정 액세스 권한이 없으면 이 메서드는 빈 배열을 반환합니다.

Return

User[]: 보기 또는 댓글 권한이 있는 사용자의 배열

승인

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

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

isShareableByEditors()

Folder 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 결정합니다.

Return

Boolean — 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는 경우 true, 권한이 없는 경우 false

승인

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

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

isStarred()

사용자의 Drive에서 Folder이(가) 별표표시되었는지 확인합니다.

Return

BooleanFolder가 사용자의 Drive에 별표표시된 경우 true, 그렇지 않은 경우 false

승인

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

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

isTrashed()

Folder가 사용자 Drive의 휴지통에 있는지 확인합니다.

Return

BooleanFolder가 사용자 Drive의 휴지통에 있는 경우 true, 그렇지 않은 경우 false입니다.

승인

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

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

moveTo(destination)

이 항목을 제공된 대상 폴더로 이동합니다.

항목을 대상 폴더로 이동하려면 현재 사용자가 파일의 소유자이거나 항목의 현재 상위 폴더에 대한 수정 액세스 권한이 있어야 합니다.

매개변수

이름유형설명
destinationFolder새 상위 항목이 될 폴더입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

removeEditor(emailAddress)

Folder의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Folder이 사용자의 전체 도메인과 공유되었거나 사용자가 액세스할 수 있는 공유 드라이브에 Folder가 있는 경우) 사용자가 Folder에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
emailAddressString삭제할 사용자의 이메일 주소입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

removeEditor(user)

Folder의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Folder이 사용자의 전체 도메인과 공유되었거나 사용자가 액세스할 수 있는 공유 드라이브에 Folder가 있는 경우) 사용자가 Folder에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
userUser삭제할 사용자의 표현입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

removeViewer(emailAddress)

Folder의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다. 이 메서드는 사용자가 뷰어나 댓글 작성자가 아닌 편집자인 경우 아무런 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Folder이 사용자의 전체 도메인에 공유된 경우 또는 Folder이 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 사용자가 Folder에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
emailAddressString삭제할 사용자의 이메일 주소입니다.

Return

Folder: 체이닝용 Folder입니다.

승인

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

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

removeViewer(user)

Folder의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다. 이 방법은 사용자가 뷰어가 아닌 편집자인 경우 아무런 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Folder가 사용자의 전체 도메인과 공유되었거나 사용자가 액세스할 수 있는 공유 드라이브에 Folder가 있는 경우) 사용자가 Folder에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
userUser삭제할 사용자의 표현입니다.

Return

Folder: 체이닝용 Folder입니다.

승인

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

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

revokePermissions(user)

지정된 사용자에게 부여된 Folder에 대한 액세스 권한을 취소합니다. 이 메서드는 사용자가 일반 액세스 권한을 가진 사용자 클래스에 속해 있는 경우(예: Folder이 사용자의 전체 도메인과 공유된 경우) Folder에 액세스하는 것을 차단하지 않습니다.

매개변수

이름유형설명
userString액세스 권한을 취소해야 하는 사용자의 이메일 주소

Return

Folder: 이 Folder, 체이닝용

승인

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

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

revokePermissions(user)

지정된 사용자에게 부여된 Folder에 대한 액세스 권한을 취소합니다. 이 메서드는 사용자가 일반 액세스 권한을 가진 사용자 클래스에 속해 있는 경우(예: Folder이 사용자의 전체 도메인과 공유된 경우) Folder에 액세스하는 것을 차단하지 않습니다.

매개변수

이름유형설명
userUser액세스 권한을 취소해야 하는 사용자 표현

Return

Folder: 이 Folder, 체이닝용

승인

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

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

searchFiles(params)

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

// Log the name of every file that are children of the current folder and modified after February 28,
// 2013 whose name contains "untitled".
var files = DriveApp.getRootFolder().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 — 현재 폴더의 하위 요소이며 검색 기준과 일치하는 모든 파일의 모음입니다.

승인

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

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

searchFolders(params)

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

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

매개변수

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

Return

FolderIterator — 현재 폴더의 하위 요소이며 검색 기준과 일치하는 모든 폴더의 모음입니다.

승인

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

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

setDescription(description)

Folder의 설명을 설정합니다.

매개변수

이름유형설명
descriptionStringFolder의 새 설명

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setName(name)

Folder의 이름을 설정합니다.

매개변수

이름유형설명
nameStringFolder의 새 이름

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setOwner(emailAddress)

Folder의 소유자를 변경합니다. 또한 이 메서드는 이전 소유자에게 Folder에 대한 명시적인 수정 액세스 권한을 부여합니다.

매개변수

이름유형설명
emailAddressString새 소유자가 되어야 하는 사용자의 이메일 주소

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setOwner(user)

Folder의 소유자를 변경합니다. 또한 이 메서드는 이전 소유자에게 Folder에 대한 명시적인 수정 액세스 권한을 부여합니다.

매개변수

이름유형설명
userUser새 소유자가 되어야 하는 사용자 표현

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setSecurityUpdateEnabled(enabled)

Folder가 링크를 사용하여 액세스할 때 리소스 키가 필요한지 여부를 설정합니다. 사용 가능한 파일 및 폴더는 기본적으로 사용 설정되어 있습니다.

Google Drive의 보안 업데이트에 관해 자세히 알아보세요.

매개변수

이름유형설명
enabledBooleanFolder의 리소스 키 요구사항을 사용 설정할지 여부입니다.

Return

Folder: 체이닝을 위한 Folder입니다.

승인

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

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

setShareableByEditors(shareable)

Folder 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다. 새 Folder의 기본값은 true입니다.

매개변수

이름유형설명
shareableBoolean수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있어야 하는 경우 true, 그렇지 않은 경우 false

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setSharing(accessType, permissionType)

명시적으로 액세스 권한을 부여받은 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스와 사용자에게 부여되는 권한을 설정합니다.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

매개변수

이름유형설명
accessTypeAccessFolder에 액세스할 수 있는 사용자 클래스
permissionTypePermissionFolder에 액세스할 수 있는 사용자에게 부여해야 하는 권한입니다.

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setStarred(starred)

사용자의 Drive에서 Folder에 별표표시할지 여부를 설정합니다. 새 Folder의 기본값은 false입니다.

매개변수

이름유형설명
starredBoolean사용자의 드라이브에 Folder가 별표표시되어야 하는 경우 true, 그렇지 않은 경우 false

Return

Folder: 이 Folder, 체이닝용

승인

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

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

setTrashed(trashed)

Folder이(가) 사용자 Drive의 휴지통에 있는지 설정합니다. 소유자만 Folder를 휴지통으로 이동할 수 있습니다. 새 Folder의 기본값은 false입니다.

매개변수

이름유형설명
trashedBooleanFolder를 사용자 Drive의 휴지통으로 이동해야 하는 경우 true, 그렇지 않은 경우 false

Return

Folder: 이 Folder, 체이닝용

승인

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

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

지원 중단된 메서드