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`	사용자의 Drive에서 `Folder`에 별표가 표시되는지 여부를 설정합니다.
`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)`

매개변수

이름	유형	설명
`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에 대한 명시적 수정 액세스 권한도 부여합니다.

Drive에서는 gmail.com 계정이 소유한 항목의 소유권 변경을 지원하지 않으며, Workspace 계정의 경우 지원됩니다.

매개변수

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

리턴

Folder - 이 Folder(연결용)

승인

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

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

`setOwner(user)`

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

Drive에서는 gmail.com 계정이 소유한 항목의 소유권 변경을 지원하지 않으며, Workspace 계정의 경우 지원됩니다.

매개변수

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

사용자의 Drive에서 Folder에 별표가 표시되는지 여부를 설정합니다. 새 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

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

메서드

지원 중단된 메서드

자세한 문서

addEditor(emailAddress)

매개변수

리턴

승인

addEditor(user)

매개변수

리턴

승인

addEditors(emailAddresses)

매개변수

리턴

승인

addViewer(emailAddress)

매개변수

리턴

승인

addViewer(user)

매개변수

리턴

승인

addViewers(emailAddresses)

매개변수

리턴

승인

createFile(blob)

매개변수

리턴

승인

createFile(name, content)

매개변수

리턴

승인

createFile(name, content, mimeType)

매개변수

리턴

승인

createFolder(name)

매개변수

리턴

승인

createShortcut(targetId)

매개변수

리턴

승인

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

매개변수

리턴

승인

getAccess(email)

매개변수

리턴

승인

getAccess(user)

매개변수

리턴

승인

getDateCreated()

리턴

승인

getDescription()

리턴

승인

getEditors()

리턴

승인

getFiles()

리턴

승인

getFilesByName(name)

매개변수

리턴

승인

getFilesByType(mimeType)

매개변수

리턴

승인

Class Folder

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`createFile(blob)`

`createFile(name, content)`

`createFile(name, content, mimeType)`

`createFolder(name)`

`createShortcut(targetId)`

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

`getAccess(email)`

`getAccess(user)`

`getDateCreated()`

`getDescription()`

`getEditors()`

`getFiles()`

`getFilesByName(name)`

`getFilesByType(mimeType)`

`getFolders()`

`getFoldersByName(name)`

`getId()`

`getLastUpdated()`

`getName()`

`getOwner()`

`getParents()`

`getResourceKey()`

`getSecurityUpdateEligible()`

`getSecurityUpdateEnabled()`

`getSharingAccess()`

`getSharingPermission()`

`getSize()`

`getUrl()`

`getViewers()`

`isShareableByEditors()`

`isStarred()`

`isTrashed()`

`moveTo(destination)`

`removeEditor(emailAddress)`

`removeEditor(user)`

`removeViewer(emailAddress)`