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()Boolean링크를 사용하여 공유할 때 이 Folder에서 액세스를 위해 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다.
getSecurityUpdateEnabled()Boolean링크를 사용하여 공유할 때 이 Folder에 액세스를 위한 리소스 키가 필요한지 여부를 가져옵니다.
getSharingAccess()Access명시적으로 액세스 권한이 부여된 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스를 가져옵니다.
getSharingPermission()Permission명시적으로 액세스 권한이 부여된 개별 사용자 외에 Folder에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다.
getSize()IntegerDrive에 Folder를 저장하는 데 사용되는 바이트 수를 가져옵니다.
getUrl()StringDrive 또는 Docs와 같은 Google 앱에서 Folder을 여는 데 사용할 수 있는 URL을 가져옵니다.
getViewers()User[]Folder의 뷰어 및 댓글 작성자 목록을 가져옵니다.
isShareableByEditors()BooleanFolder에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 결정합니다.
isStarred()BooleanFolder가 사용자의 Drive에서 별표표시되었는지 확인합니다.
isTrashed()BooleanFolder이(가) 사용자 Drive의 휴지통에 있는지 확인합니다.
moveTo(destination)Folder이 항목을 제공된 대상 폴더로 이동합니다.
removeEditor(emailAddress)Folder지정된 사용자를 Folder의 편집자 목록에서 삭제합니다.
removeEditor(user)Folder지정된 사용자를 Folder의 편집자 목록에서 삭제합니다.
removeViewer(emailAddress)FolderFolder의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
removeViewer(user)FolderFolder의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
revokePermissions(emailAddress)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)Folder링크를 사용하여 공유할 때 Folder에 액세스를 위한 리소스 키가 필요한지 여부를 설정합니다.
setShareableByEditors(shareable)FolderFolder에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다.
setSharing(accessType, permissionType)Folder명시적으로 액세스 권한이 부여된 개별 사용자 외에 Folder에 액세스할 수 있는 사용자 클래스와 해당 사용자에게 부여할 권한을 설정합니다.
setStarred(starred)Folder사용자의 Drive에서 Folder의 별표표시 여부를 설정합니다.
setTrashed(trashed)FolderFolder이(가) 사용자 Drive의 휴지통에 있는지 여부를 설정합니다.

자세한 문서

addEditor(emailAddress)

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

매개변수

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

리턴

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

승인

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

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

addEditor(user)

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

매개변수

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

리턴

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

승인

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

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

addEditors(emailAddresses)

지정된 사용자 배열을 Folder의 편집자 목록에 추가합니다. 사용자가 이미 뷰어 목록에 있다면 이 메서드는 해당 사용자를 뷰어 목록 밖으로 승격시킵니다.

매개변수

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

리턴

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

승인

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

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

addViewer(emailAddress)

지정된 사용자를 Folder의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있었다면 이 메서드는 아무런 영향을 미치지 않습니다.

매개변수

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

리턴

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

승인

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

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

addViewer(user)

지정된 사용자를 Folder의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있었다면 이 메서드는 아무런 영향을 미치지 않습니다.

매개변수

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

리턴

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

승인

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

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

addViewers(emailAddresses)

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

매개변수

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

리턴

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새 파일의 데이터입니다.

리턴

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새 파일의 콘텐츠입니다.

리턴

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 유형입니다.

리턴

File - 새 파일입니다.

승인

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

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

createFolder(name)

현재 폴더에 지정된 이름으로 폴더를 만듭니다.

매개변수

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

리턴

Folder - 새 폴더입니다.

승인

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

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

createShortcut(targetId)

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

매개변수

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

리턴

File - 새 단축키입니다.

승인

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

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

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

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

매개변수

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

리턴

File - 새 단축키입니다.

승인

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

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

getAccess(email)

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

매개변수

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

리턴

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

승인

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

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

getAccess(user)

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

매개변수

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

리턴

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

승인

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

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

getDateCreated()

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

리턴

Date: Folder가 생성된 날짜

승인

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

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

getDescription()

Folder의 설명을 가져옵니다.

리턴

String: Folder의 설명

승인

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

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

getEditors()

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

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

리턴

User[] - 사용자에게 수정 액세스 권한이 있는 경우 이 Folder의 편집자 목록, 그렇지 않은 경우 빈 배열입니다.

승인

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

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

getFiles()

현재 폴더의 하위 요소인 모든 파일의 컬렉션을 가져옵니다.

리턴

FileIterator - 현재 폴더의 하위 항목인 모든 파일의 모음입니다.

승인

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

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

getFilesByName(name)

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

매개변수

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

리턴

FileIterator - 현재 폴더의 하위 항목이며 지정된 이름을 가진 모든 파일의 컬렉션입니다.

승인

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

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

getFilesByType(mimeType)

현재 폴더의 하위 항목이며 지정된 MIME 유형을 가진 모든 파일의 컬렉션을 가져옵니다.

매개변수

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

리턴

FileIterator - 현재 폴더의 하위 항목이며 지정된 MIME 유형을 가진 모든 파일의 모음입니다.

승인

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

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

getFolders()

현재 폴더의 하위 폴더인 모든 폴더의 컬렉션을 가져옵니다.

리턴

FolderIterator - 현재 폴더의 하위 폴더인 모든 폴더의 컬렉션입니다.

승인

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

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

getFoldersByName(name)

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

매개변수

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

리턴

FolderIterator - 현재 폴더의 하위 항목이며 지정된 이름을 가진 모든 폴더의 컬렉션입니다.

승인

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

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

getId()

Folder의 ID를 가져옵니다.

리턴

String: Folder의 ID

승인

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

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

getLastUpdated()

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

리턴

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

승인

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

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

getName()

Folder의 이름을 가져옵니다.

리턴

String: Folder의 이름

승인

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

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

getOwner()

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

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

리턴

User: 이 Folder의 소유자입니다.

승인

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

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

getParents()

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

리턴

FolderIterator: Folder의 직계 상위 폴더인 폴더 컬렉션

승인

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

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

getResourceKey()

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

리턴

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

승인

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

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

getSecurityUpdateEligible()

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

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

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

리턴

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

승인

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

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

getSecurityUpdateEnabled()

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

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

리턴

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

승인

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

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

getSharingAccess()

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

리턴

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

승인

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

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

getSharingPermission()

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

리턴

Permission: Folder에 액세스할 수 있는 사용자에게 부여된 권한

승인

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

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

getSize()

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

리턴

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

승인

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

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

getUrl()

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

리턴

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

승인

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

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

getViewers()

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

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

리턴

User[] - 사용자에게 수정 권한이 있는 경우 이 Folder의 뷰어 및 댓글 작성자 목록, 그렇지 않은 경우 빈 배열입니다.

승인

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

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

isShareableByEditors()

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

리턴

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

승인

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

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

isStarred()

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

리턴

Boolean: 사용자의 Drive에서 Folder이 별표표시된 경우 true, 그렇지 않은 경우 false

승인

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

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

isTrashed()

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

리턴

Boolean: Folder가 사용자 Drive의 휴지통에 있는 경우 true, 없는 경우 false

승인

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

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

moveTo(destination)

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

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

매개변수

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

리턴

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

승인

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

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

removeEditor(emailAddress)

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

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

매개변수

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

리턴

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

승인

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

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

removeEditor(user)

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

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

매개변수

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

리턴

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

승인

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

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

removeViewer(emailAddress)

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

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

매개변수

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

리턴

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

승인

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

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

removeViewer(user)

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

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

매개변수

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

리턴

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

승인

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

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

revokePermissions(emailAddress)

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

매개변수

이름유형설명
emailAddressString액세스 권한이 취소되어야 하는 사용자의 이메일 주소입니다.

리턴

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

승인

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

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

revokePermissions(user)

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

매개변수

이름유형설명
userUser액세스 권한이 취소되어야 하는 사용자를 나타냅니다.

리턴

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

승인

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

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

searchFiles(params)

현재 폴더의 하위 요소이고 지정된 검색 기준과 일치하는 모든 파일의 컬렉션을 가져옵니다. 검색 기준은 Google Drive SDK 문서에 자세히 설명되어 있습니다. Drive 서비스는 Drive API v2를 사용하며 일부 쿼리 필드는 v3와 다릅니다. v2와 v3의 필드 차이를 검토하세요.

params 인수는 문자열 값을 포함할 수 있는 쿼리 문자열이므로 따옴표를 올바르게 이스케이프 처리해야 합니다 (예: "title contains 'Gulliver\\'s Travels'" 또는 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

매개변수

이름유형설명
paramsString검색 기준(Google Drive SDK 문서에 설명됨)

리턴

FileIterator - 현재 폴더의 하위 항목이며 검색 기준과 일치하는 모든 파일의 모음입니다.

승인

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

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

searchFolders(params)

현재 폴더의 하위 항목이며 지정된 검색 기준과 일치하는 모든 폴더의 컬렉션을 가져옵니다. 검색 기준은 Google Drive SDK 문서에 자세히 설명되어 있습니다. Drive 서비스는 Drive API v2를 사용하며 일부 쿼리 필드는 v3와 다릅니다. v2와 v3의 필드 차이를 검토하세요.

params 인수는 문자열 값을 포함할 수 있는 쿼리 문자열이므로 따옴표를 올바르게 이스케이프 처리해야 합니다 (예: "title contains 'Gulliver\\'s Travels'" 또는 'title contains "Gulliver\'s Travels"').

// Logs 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();
  console.log(folder.getName());
}

매개변수

이름유형설명
paramsString검색 기준(Google Drive SDK 문서에 설명됨)

리턴

FolderIterator - 현재 폴더의 하위 항목이며 검색 기준과 일치하는 모든 폴더의 컬렉션입니다.

승인

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

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

setDescription(description)

Folder의 설명을 설정합니다.

매개변수

이름유형설명
descriptionStringFolder의 새 설명

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setName(name)

Folder의 이름을 설정합니다.

매개변수

이름유형설명
nameStringFolder의 새 이름

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setOwner(emailAddress)

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

매개변수

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

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setOwner(user)

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

매개변수

이름유형설명
userUser새 소유자가 되어야 하는 사용자를 나타냅니다.

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setSecurityUpdateEnabled(enabled)

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

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

매개변수

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

리턴

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

승인

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

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

setShareableByEditors(shareable)

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

매개변수

이름유형설명
shareableBoolean수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경하도록 허용해야 하는 경우 true, 권한이 없는 경우 false

리턴

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에 액세스할 수 있는 사용자에게 부여해야 하는 권한

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setStarred(starred)

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

매개변수

이름유형설명
starredBoolean사용자의 Drive에서 Folder에 별표표시해야 하는 경우 true, 그렇지 않으면 false

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

setTrashed(trashed)

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

매개변수

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

리턴

Folder: 이 Folder, 체이닝용

승인

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

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

지원 중단된 메서드