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 | 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의 휴지통에 있는지 여부를 설정합니다. |
자세한 문서
addEditor(emailAddress)
addEditor(user)
addEditors(emailAddresses)
addViewer(emailAddress)
addViewer(user)
addViewers(emailAddresses)
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)
createShortcut(targetId)
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()
getDescription()
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()
getLastUpdated()
getName()
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());
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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()
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()
getSharingPermission()
명시적으로 액세스 권한이 부여된 개별 사용자 외에 Folder
에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다.
리턴
Permission
: Folder
에 액세스할 수 있는 사용자에게 부여된 권한
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
getUrl()
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
isStarred()
isTrashed()
moveTo(destination)
removeEditor(emailAddress)
지정된 사용자를 Folder
의 편집자 목록에서 삭제합니다. 일반 액세스 권한이 있는 사용자 클래스에 속한 경우(예: Folder
가 사용자의 전체 도메인과 공유되거나 Folder
가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 이 메서드는 사용자가 Folder
에 액세스하는 것을 차단하지 않습니다.
Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddress | String | 삭제할 사용자의 이메일 주소입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive
removeEditor(user)
지정된 사용자를 Folder
의 편집자 목록에서 삭제합니다. 일반 액세스 권한이 있는 사용자 클래스에 속한 경우(예: Folder
가 사용자의 전체 도메인과 공유되거나 Folder
가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 이 메서드는 사용자가 Folder
에 액세스하는 것을 차단하지 않습니다.
Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
user | User | 삭제할 사용자의 표현입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Folder
의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 사용자가 뷰어나 댓글 작성자가 아닌 편집자인 경우에는 이 메서드가 영향을 미치지 않습니다. 또한 이 메서드는 일반 액세스 권한이 있는 사용자 클래스에 속한 경우(예: Folder
가 사용자의 전체 도메인과 공유되거나 Folder
가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) Folder
에 액세스하는 것을 차단하지 않습니다.
Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddress | String | 삭제할 사용자의 이메일 주소입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Folder
의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 사용자가 뷰어가 아닌 편집자인 경우에는 이 메서드가 영향을 미치지 않습니다. 또한 이 메서드는 일반 액세스 권한이 있는 사용자 클래스에 속한 경우(예: Folder
가 사용자의 전체 도메인과 공유되거나 Folder
가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) Folder
에 액세스하는 것을 차단하지 않습니다.
Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
user | User | 삭제할 사용자의 표현입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
revokePermissions(user)
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()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
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의 필드 차이를 검토하세요.
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)
setName(name)
setOwner(emailAddress)
setOwner(user)
setSecurityUpdateEnabled(enabled)
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 에 액세스할 수 있는 사용자에게 부여해야 하는 권한 |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/drive