이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class Folder

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

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const 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()`	`Date`	`Folder`가 생성된 날짜를 가져옵니다.
`getDescription()`	`String`	`Folder`에 대한 설명을 가져옵니다.
`getEditors()`	`User[]`	이 `Folder`의 편집자 목록을 가져옵니다.
`getFiles()`	`FileIterator`	현재 폴더의 하위 폴더인 모든 파일의 컬렉션을 가져옵니다.
`getFilesByName(name)`	`FileIterator`	현재 폴더의 하위 요소이고 지정된 이름을 가진 모든 파일의 컬렉션을 가져옵니다.
`getFilesByType(mimeType)`	`FileIterator`	현재 폴더의 하위 요소이고 지정된 MIME 유형을 가진 모든 파일의 컬렉션을 가져옵니다.
`getFolders()`	`FolderIterator`	현재 폴더의 하위 폴더인 모든 폴더의 컬렉션을 가져옵니다.
`getFoldersByName(name)`	`FolderIterator`	현재 폴더의 하위 폴더이고 지정된 이름을 가진 모든 폴더의 컬렉션을 가져옵니다.
`getId()`	`String`	`Folder`의 ID를 가져옵니다.
`getLastUpdated()`	`Date`	`Folder`가 마지막으로 업데이트된 날짜를 가져옵니다.
`getName()`	`String`	`Folder`의 이름을 가져옵니다.
`getOwner()`	`User`	이 `Folder`의 소유자를 가져옵니다.
`getParents()`	`FolderIterator`	`Folder`의 직속 상위 요소인 폴더 모음을 가져옵니다.
`getResourceKey()`	`String`	링크를 사용하여 공유된 항목에 액세스하는 데 필요한 `Folder`의 리소스 키를 가져옵니다.
`getSecurityUpdateEligible()`	`Boolean`	이 `Folder`가 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다.
`getSecurityUpdateEnabled()`	`Boolean`	링크를 사용하여 공유될 때 이 `Folder`에 액세스하는 데 리소스 키가 필요한지 여부를 가져옵니다.
`getSharingAccess()`	`Access`	명시적으로 액세스 권한이 부여된 개별 사용자 외에도 `Folder`에 액세스할 수 있는 사용자 클래스를 가져옵니다.
`getSharingPermission()`	`Permission`	명시적으로 액세스 권한이 부여된 개별 사용자 외에도 `Folder`에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다.
`getSize()`	`Integer`	Drive에 `Folder`를 저장하는 데 사용된 바이트 수를 가져옵니다.
`getUrl()`	`String`	Drive 또는 Docs와 같은 Google 앱에서 `Folder`를 열 때 사용할 수 있는 URL을 가져옵니다.
`getViewers()`	`User[]`	이 `Folder`의 시청자 및 댓글 작성자 목록을 가져옵니다.
`isShareableByEditors()`	`Boolean`	`Folder`에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 결정합니다.
`isStarred()`	`Boolean`	`Folder`가 사용자의 Drive에 별표표시되었는지 여부를 확인합니다.
`isTrashed()`	`Boolean`	`Folder`가 사용자의 Drive 휴지통에 있는지 확인합니다.
`moveTo(destination)`	`Folder`	이 항목을 제공된 대상 폴더로 이동합니다.
`removeEditor(emailAddress)`	`Folder`	`Folder`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeEditor(user)`	`Folder`	`Folder`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeViewer(emailAddress)`	`Folder`	`Folder`의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
`removeViewer(user)`	`Folder`	`Folder`의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
`revokePermissions(emailAddress)`	`Folder`	지정된 사용자에게 부여된 `Folder`에 대한 액세스 권한을 취소합니다.
`revokePermissions(user)`	`Folder`	지정된 사용자에게 부여된 `Folder`에 대한 액세스 권한을 취소합니다.
`searchFiles(params)`	`FileIterator`	현재 폴더의 하위 폴더이고 지정된 검색 기준과 일치하는 모든 파일의 컬렉션을 가져옵니다.
`searchFolders(params)`	`FolderIterator`	현재 폴더의 하위 폴더이며 지정된 검색 기준과 일치하는 모든 폴더의 컬렉션을 가져옵니다.
`setDescription(description)`	`Folder`	`Folder`의 설명을 설정합니다.
`setName(name)`	`Folder`	`Folder`의 이름을 설정합니다.
`setOwner(emailAddress)`	`Folder`	`Folder`의 소유자를 변경합니다.
`setOwner(user)`	`Folder`	`Folder`의 소유자를 변경합니다.
`setSecurityUpdateEnabled(enabled)`	`Folder`	링크를 사용하여 공유될 때 `Folder`에 액세스하는 데 리소스 키가 필요한지 여부를 설정합니다.
`setShareableByEditors(shareable)`	`Folder`	`Folder`에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다.
`setSharing(accessType, permissionType)`	`Folder`	명시적으로 액세스 권한이 부여된 개별 사용자 외에도 `Folder`에 액세스할 수 있는 사용자 클래스와 이러한 사용자에게 부여되는 권한을 설정합니다.
`setStarred(starred)`	`Folder`	`Folder`가 사용자의 Drive에 별표표시되어 있는지 여부를 설정합니다.
`setTrashed(trashed)`	`Folder`	`Folder`가 사용자의 Drive 휴지통에 있는지 여부를 설정합니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`addFile(child)`	`Folder`	지정된 파일을 현재 폴더에 추가합니다.
`addFolder(child)`	`Folder`	지정된 폴더를 현재 폴더에 추가합니다.
`removeFile(child)`	`Folder`	현재 폴더에서 지정된 파일을 삭제합니다.
`removeFolder(child)`	`Folder`	현재 폴더에서 지정된 폴더를 삭제합니다.

자세한 문서

`addEditor(emailAddress)`

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

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addEditor(user)`

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

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addEditors(emailAddresses)`

지정된 사용자 배열을 Folder의 편집자 목록에 추가합니다. 이미 시청자 목록에 있는 사용자는 이 메서드에 의해 시청자 목록에서 승격됩니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addViewer(emailAddress)`

지정된 사용자를 Folder의 시청자 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 효과가 없습니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addViewer(user)`

지정된 사용자를 Folder의 시청자 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 효과가 없습니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addViewers(emailAddresses)`

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

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`createFile(blob)`

임의 데이터의 지정된 Blob에서 현재 폴더에 파일을 만듭니다.

매개변수

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

리턴

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!');

매개변수

이름	유형	설명
`name`	`String`	새 파일의 이름입니다.
`content`	`String`	새 파일의 콘텐츠입니다.

리턴

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

매개변수

이름	유형	설명
`name`	`String`	새 파일의 이름입니다.
`content`	`String`	새 파일의 콘텐츠입니다.
`mimeType`	`String`	새 파일의 MIME 유형입니다.

리턴

File: 새 파일입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`createFolder(name)`

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

매개변수

이름	유형	설명
`name`	`String`	새 폴더의 이름입니다.

리턴

Folder: 새 폴더입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`createShortcut(targetId)`

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

매개변수

이름	유형	설명
`targetId`	`String`	대상 파일 또는 폴더의 파일 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(),
  );
}

매개변수

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

리턴

File: 새 바로가기입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getAccess(email)`

특정 사용자에게 부여된 권한을 가져옵니다. 이 메서드는 Google 그룹의 권한 또는 Google 그룹을 통해 상속된 권한을 반환하지 않습니다.

매개변수

이름	유형	설명
`email`	`String`	권한을 확인해야 하는 사용자의 이메일 주소입니다. Google 그룹스는 지원되지 않습니다.

리턴

Permission: 사용자에게 부여된 권한입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getAccess(user)`

특정 사용자에게 부여된 권한을 가져옵니다. 이 메서드는 Google 그룹의 권한 또는 Google 그룹을 통해 상속된 권한을 반환하지 않습니다.

매개변수

이름	유형	설명
`user`	`User`	권한을 확인해야 하는 사용자의 표현입니다.

리턴

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 (const 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)`

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

매개변수

이름	유형	설명
`name`	`String`	찾을 파일의 이름입니다.

리턴

FileIterator: 현재 폴더의 하위 폴더이며 지정된 이름을 가진 모든 파일의 모음입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getFilesByType(mimeType)`

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

매개변수

이름	유형	설명
`mimeType`	`String`	찾을 파일의 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)`

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

매개변수

이름	유형	설명
`name`	`String`	찾을 폴더의 이름입니다.

리턴

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 (const 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: Folder가 사용자의 Drive에서 별표표시된 경우 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)`

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

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

매개변수

이름	유형	설명
`destination`	`Folder`	새 상위 폴더가 되는 폴더입니다.

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeEditor(emailAddress)`

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

Drive 파일의 경우 사용자를 보기 권한 사용자 목록에서도 삭제합니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeEditor(user)`

Drive 파일의 경우 사용자를 보기 권한 사용자 목록에서도 삭제합니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeViewer(emailAddress)`

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

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

매개변수

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

리턴

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeViewer(user)`

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

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

매개변수

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

리턴

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`revokePermissions(emailAddress)`

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

매개변수

이름	유형	설명
`emailAddress`	`String`	액세스 권한을 취소할 사용자의 이메일 주소입니다.

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`revokePermissions(user)`

매개변수

이름	유형	설명
`user`	`User`	액세스 권한을 취소해야 하는 사용자의 표현입니다.

리턴

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.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

매개변수

이름	유형	설명
`params`	`String`	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의 필드 차이점을 검토하세요.

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

매개변수

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

리턴

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setDescription(description)`

Folder의 설명을 설정합니다.

매개변수

이름	유형	설명
`description`	`String`	`Folder`의 새 설명

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setName(name)`

Folder의 이름을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	`Folder`의 새 이름

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setOwner(emailAddress)`

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

매개변수

이름	유형	설명
`emailAddress`	`String`	새 소유자가 될 사용자의 이메일 주소

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setOwner(user)`

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

매개변수

이름	유형	설명
`user`	`User`	새 소유자가 될 사용자의 표현

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setSecurityUpdateEnabled(enabled)`

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

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

매개변수

이름	유형	설명
`enabled`	`Boolean`	`Folder`에 리소스 키 요구사항을 사용 설정할지 여부입니다.

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setShareableByEditors(shareable)`

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

매개변수

이름	유형	설명
`shareable`	`Boolean`	수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있어야 하는 경우 `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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

매개변수

이름	유형	설명
`accessType`	`Access`	`Folder`에 액세스할 수 있는 사용자 클래스
`permissionType`	`Permission`	`Folder`에 액세스할 수 있는 사용자에게 부여해야 하는 권한

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setStarred(starred)`

Folder가 사용자의 Drive에 별표표시되어 있는지 여부를 설정합니다. 새 Folder의 기본값은 false입니다.

매개변수

이름	유형	설명
`starred`	`Boolean`	`Folder`가 사용자의 Drive에서 별표표시되어야 하는 경우 `true`, 그렇지 않은 경우 `false`

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setTrashed(trashed)`

Folder가 사용자의 Drive 휴지통에 있는지 여부를 설정합니다. 소유자만 Folder를 휴지통에 버릴 수 있습니다. 새 Folder의 기본값은 false입니다.

매개변수

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

리턴

Folder — 체이닝을 위한 이 Folder

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

지원 중단된 메서드

`addFile(child)`

지원 중단되었습니다. 대신 File.moveTo(destination) 또는 createShortcut(targetId)를 사용하세요.

지정된 파일을 현재 폴더에 추가합니다. 이 메서드는 파일을 기존 상위 폴더 외부로 이동하지 않습니다. 파일은 동시에 두 개 이상의 상위 요소를 가질 수 있습니다.

매개변수

이름	유형	설명
`child`	`File`	추가할 하위 파일입니다.

리턴

Folder: 하위 요소로 추가된 파일의 새 상위 요소입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`addFolder(child)`

지원 중단되었습니다. 대신 moveTo(destination) 또는 createShortcut(targetId)를 사용하세요.

지정된 폴더를 현재 폴더에 추가합니다. 이 메서드는 폴더를 기존 상위 폴더 외부로 이동하지 않습니다. 폴더에 두 개 이상의 상위 폴더가 동시에 있을 수 있습니다.

매개변수

이름	유형	설명
`child`	`Folder`	추가할 하위 폴더입니다.

리턴

Folder: 하위 폴더로 추가된 폴더의 새 상위 폴더입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeFile(child)`

지원 중단되었습니다. 대신 File.moveTo(destination)을 사용하세요.

현재 폴더에서 지정된 파일을 삭제합니다. 이 방법은 파일을 삭제하지 않지만 파일이 모든 상위 요소에서 삭제되면 파일을 검색하거나 '모든 항목' 보기를 사용하지 않는 한 Drive에 표시되지 않습니다.

매개변수

이름	유형	설명
`child`	`File`	삭제할 하위 파일입니다.

리턴

Folder: 하위 요소의 이전 상위 요소입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`removeFolder(child)`

지원 중단되었습니다. 대신 moveTo(destination)을 사용하세요.

현재 폴더에서 지정된 폴더를 삭제합니다. 이 방법은 폴더나 폴더의 콘텐츠를 삭제하지는 않지만, 폴더가 모든 상위 폴더에서 삭제되면 Drive에서 검색하거나 '모든 항목' 보기를 사용하지 않는 한 볼 수 없습니다.

매개변수

이름	유형	설명
`child`	`Folder`	삭제할 하위 폴더입니다.

리턴

Folder: 하위 요소의 이전 상위 요소입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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