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

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()`	`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`	다음과 같은 Google 앱에서 `Folder`을 여는 데 사용할 수 있는 URL을 가져옵니다. Drive 또는 Docs.
`getViewers()`	`User[]`	이 `Folder`의 뷰어 및 댓글 작성자 목록을 가져옵니다.
`isShareableByEditors()`	`Boolean`	`Folder`에 대한 수정 권한이 있는 사용자가 다음 작업을 할 수 있는지 결정합니다. 다른 사용자와 공유하거나 권한을 변경할 수 없습니다.
`isStarred()`	`Boolean`	사용자의 Drive에서 `Folder`가 별표표시되었는지 확인합니다.
`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)`

지정된 사용자를 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에서 현재 폴더에 파일을 만듭니다.

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

매개변수

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

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

매개변수

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

리턴

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

승인

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

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

`getAccess(user)`

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

매개변수

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

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

리턴

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

승인

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

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

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

리턴

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와 다릅니다. 필드를 검토합니다. 차이점에 대해 자세히 알아보세요.

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

매개변수

이름	유형	설명
`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와 다릅니다. 필드를 검토합니다. 차이점에 대해 자세히 알아보세요.

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

매개변수

이름	유형	설명
`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.)
var 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`	`true`: 사용자의`Folder` 드라이브; 그렇지 않은 경우 `false`

리턴

Folder: 이 Folder(체이닝용)

승인

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

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

`setTrashed(trashed)`

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

매개변수

이름	유형	설명
`trashed`	`Boolean`	`Folder`을(를) 휴지통으로 이동해야 하는 경우 `true` 사용자의 Drive 그렇지 않은 경우 `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