이 서비스를 사용하면 스크립트가 Google Drive에서 파일과 폴더를 만들고, 찾고, 수정할 수 있습니다.
스크립트에서 기본 Cloud 프로젝트 대신 표준 Cloud 프로젝트를 사용하는 경우 Drive API를 수동으로 사용 설정해야 합니다. 표준 Cloud 프로젝트에서 Drive API를 사용 설정합니다.
다음 코드 샘플은 사용자의 내 드라이브 폴더에 있는 각 파일의 이름을 로깅하는 방법을 보여줍니다.// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
클래스
이름 | 간략한 설명 |
---|---|
Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자 클래스를 나타내는 enum입니다. |
DriveApp | 스크립트가 Google Drive에서 파일과 폴더를 만들고, 찾고, 수정할 수 있도록 허용합니다. |
File | Google Drive의 파일 |
FileIterator | 스크립트가 잠재적으로 대규모인 파일 모음을 반복할 수 있는 반복자입니다. |
Folder | Google Drive의 폴더 |
FolderIterator | 스크립트가 잠재적으로 큰 폴더 모음을 반복할 수 있는 객체입니다. |
Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 enum입니다. |
User | Google Drive의 파일과 연결된 사용자입니다. |
Access
속성
속성 | 유형 | 설명 |
---|---|---|
ANYONE | Enum | 모든 인터넷 사용자가 찾아 액세스할 수 있습니다. |
ANYONE_WITH_LINK | Enum | 링크가 있는 모든 사용자가 액세스할 수 있습니다. |
DOMAIN | Enum | 도메인 내의 사용자가 찾아 액세스할 수 있습니다. |
DOMAIN_WITH_LINK | Enum | 링크가 있는 도메인 내 사용자는 누구나 액세스할 수 있습니다. |
PRIVATE | Enum | 명시적으로 권한이 부여된 사용자만 액세스할 수 있습니다. |
DriveApp
속성
속성 | 유형 | 설명 |
---|---|---|
Access | Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자 클래스를 나타내는 enum입니다. |
Permission | Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 enum입니다. |
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | 이전 반복자의 연속 토큰을 사용하여 파일 반복을 재개합니다. |
continueFolderIterator(continuationToken) | FolderIterator | 이전 반복기의 연속 토큰을 사용하여 폴더 반복을 재개합니다. |
createFile(blob) | File | 임의 데이터의 지정된 Blob 에서 사용자의 Drive 루트에 파일을 만듭니다. |
createFile(name, content) | File | 사용자 Drive의 루트에 지정된 이름과 콘텐츠가 포함된 텍스트 파일을 만듭니다. |
createFile(name, content, mimeType) | File | 지정된 이름, 콘텐츠, MIME 유형으로 사용자의 Drive 루트에 파일을 만듭니다. |
createFolder(name) | Folder | 사용자의 Drive 루트에 지정된 이름으로 폴더를 만듭니다. |
createShortcut(targetId) | File | 제공된 Drive 항목 ID의 바로가기를 만들고 반환합니다. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | 제공된 Drive 항목 ID 및 리소스 키의 바로가기를 만들고 반환합니다. |
enforceSingleParent(value) | void | 항목 상위에 영향을 미치는 모든 호출에 대해 enforceSingleParent 동작을 사용 설정하거나 사용 중지합니다. |
getFileById(id) | File | 지정된 ID의 파일을 가져옵니다. |
getFileByIdAndResourceKey(id, resourceKey) | File | 지정된 ID 및 리소스 키가 있는 파일을 가져옵니다. |
getFiles() | FileIterator | 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
getFilesByName(name) | FileIterator | 사용자의 Drive에 있는 지정된 이름의 모든 파일 컬렉션을 가져옵니다. |
getFilesByType(mimeType) | FileIterator | 지정된 MIME 유형의 파일이 포함된 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
getFolderById(id) | Folder | 지정된 ID의 폴더를 가져옵니다. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | 지정된 ID 및 리소스 키가 있는 폴더를 가져옵니다. |
getFolders() | FolderIterator | 사용자의 Drive에 있는 모든 폴더의 컬렉션을 가져옵니다. |
getFoldersByName(name) | FolderIterator | 사용자의 Drive에 있는 지정된 이름의 모든 폴더 모음을 가져옵니다. |
getRootFolder() | Folder | 사용자의 Drive 루트에 있는 폴더를 가져옵니다. |
getStorageLimit() | Integer | 사용자가 Drive에 저장할 수 있는 바이트 수를 가져옵니다. |
getStorageUsed() | Integer | 사용자가 현재 Drive에 저장 중인 바이트 수를 가져옵니다. |
getTrashedFiles() | FileIterator | 사용자의 Drive 휴지통에 있는 모든 파일의 컬렉션을 가져옵니다. |
getTrashedFolders() | FolderIterator | 사용자의 Drive 휴지통에 있는 모든 폴더의 컬렉션을 가져옵니다. |
searchFiles(params) | FileIterator | 지정된 검색 기준과 일치하는 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
searchFolders(params) | FolderIterator | 지정된 검색 기준과 일치하는 사용자의 Drive에 있는 모든 폴더의 컬렉션을 가져옵니다. |
File
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
addCommenter(emailAddress) | File | 지정된 사용자를 File 의 댓글 작성자 목록에 추가합니다. |
addCommenter(user) | File | 지정된 사용자를 File 의 댓글 작성자 목록에 추가합니다. |
addCommenters(emailAddresses) | File | 주어진 사용자 배열을 File 의 댓글 작성자 목록에 추가합니다. |
addEditor(emailAddress) | File | 지정된 사용자를 File 의 편집자 목록에 추가합니다. |
addEditor(user) | File | 지정된 사용자를 File 의 편집자 목록에 추가합니다. |
addEditors(emailAddresses) | File | 지정된 사용자 배열을 File 의 편집자 목록에 추가합니다. |
addViewer(emailAddress) | File | 지정된 사용자를 File 의 시청자 목록에 추가합니다. |
addViewer(user) | File | 지정된 사용자를 File 의 시청자 목록에 추가합니다. |
addViewers(emailAddresses) | File | 지정된 사용자 배열을 File 의 시청자 목록에 추가합니다. |
getAccess(email) | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
getAccess(user) | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
getAs(contentType) | Blob | 이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. |
getBlob() | Blob | 이 객체 내의 데이터를 blob으로 반환합니다. |
getDateCreated() | Date | File 가 생성된 날짜를 가져옵니다. |
getDescription() | String | File 에 대한 설명을 가져옵니다. |
getDownloadUrl() | String | 파일을 다운로드하는 데 사용할 수 있는 URL을 가져옵니다. |
getEditors() | User[] | 이 File 의 편집자 목록을 가져옵니다. |
getId() | String | File 의 ID를 가져옵니다. |
getLastUpdated() | Date | File 가 마지막으로 업데이트된 날짜를 가져옵니다. |
getMimeType() | String | 파일의 MIME 유형을 가져옵니다. |
getName() | String | File 의 이름을 가져옵니다. |
getOwner() | User | 파일 소유자를 가져옵니다. |
getParents() | FolderIterator | File 의 직속 상위 요소인 폴더 모음을 가져옵니다. |
getResourceKey() | String | 링크를 사용하여 공유된 항목에 액세스하는 데 필요한 File 의 리소스 키를 가져옵니다. |
getSecurityUpdateEligible() | Boolean | 이 File 가 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다. |
getSecurityUpdateEnabled() | Boolean | 링크를 사용하여 공유될 때 이 File 에 액세스하는 데 리소스 키가 필요한지 여부를 가져옵니다. |
getSharingAccess() | Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자 클래스를 가져옵니다. |
getSharingPermission() | Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다. |
getSize() | Integer | Drive에 File 를 저장하는 데 사용된 바이트 수를 가져옵니다. |
getTargetId() | String | 바로가기인 경우 가리키는 항목의 ID를 반환합니다. |
getTargetMimeType() | String | 바로가기인 경우 가리키는 항목의 mime 유형을 반환합니다. |
getTargetResourceKey() | String | 파일이 바로가기인 경우 가리키는 항목의 리소스 키를 반환합니다. |
getThumbnail() | Blob | 파일의 썸네일 이미지를 가져오거나 썸네일이 없는 경우 null 를 가져옵니다. |
getUrl() | String | Drive 또는 Docs와 같은 Google 앱에서 File 를 여는 데 사용할 수 있는 URL을 가져옵니다. |
getViewers() | User[] | 이 File 의 시청자 및 댓글 작성자 목록을 가져옵니다. |
isShareableByEditors() | Boolean | File 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 결정합니다. |
isStarred() | Boolean | File 가 사용자의 Drive에 별표표시되었는지 여부를 확인합니다. |
isTrashed() | Boolean | File 가 사용자의 Drive 휴지통에 있는지 확인합니다. |
makeCopy() | File | 파일의 사본을 만듭니다. |
makeCopy(destination) | File | 대상 디렉터리에 파일의 사본을 만듭니다. |
makeCopy(name) | File | 파일의 사본을 만들고 제공된 이름으로 이름을 지정합니다. |
makeCopy(name, destination) | File | 대상 디렉터리에 파일의 사본을 만들고 제공된 이름으로 이름을 지정합니다. |
moveTo(destination) | File | 이 항목을 제공된 대상 폴더로 이동합니다. |
removeCommenter(emailAddress) | File | File 의 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
removeCommenter(user) | File | File 의 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
removeEditor(emailAddress) | File | File 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
removeEditor(user) | File | File 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
removeViewer(emailAddress) | File | File 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
removeViewer(user) | File | File 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
revokePermissions(emailAddress) | File | 지정된 사용자에게 부여된 File 에 대한 액세스 권한을 취소합니다. |
revokePermissions(user) | File | 지정된 사용자에게 부여된 File 에 대한 액세스 권한을 취소합니다. |
setContent(content) | File | 지정된 대체 문자열로 파일의 콘텐츠를 덮어씁니다. |
setDescription(description) | File | File 의 설명을 설정합니다. |
setName(name) | File | File 의 이름을 설정합니다. |
setOwner(emailAddress) | File | File 의 소유자를 변경합니다. |
setOwner(user) | File | File 의 소유자를 변경합니다. |
setSecurityUpdateEnabled(enabled) | File | 링크를 사용하여 공유할 때 File 에 액세스하는 데 리소스 키가 필요한지 여부를 설정합니다. |
setShareableByEditors(shareable) | File | File 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다. |
setSharing(accessType, permissionType) | File | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자 클래스와 이러한 사용자에게 부여되는 권한을 설정합니다. |
setStarred(starred) | File | File 가 사용자의 Drive에 별표표시되어 있는지 여부를 설정합니다. |
setTrashed(trashed) | File | File 가 사용자의 Drive 휴지통에 있는지 여부를 설정합니다. |
FileIterator
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getContinuationToken() | String | 나중에 이 반복을 재개하는 데 사용할 수 있는 토큰을 가져옵니다. |
hasNext() | Boolean | next() 를 호출하면 항목이 반환되는지 확인합니다. |
next() | File | 파일 또는 폴더 모음에서 다음 항목을 가져옵니다. |
Folder
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
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 휴지통에 있는지 여부를 설정합니다. |
FolderIterator
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getContinuationToken() | String | 나중에 이 반복을 재개하는 데 사용할 수 있는 토큰을 가져옵니다. |
hasNext() | Boolean | next() 를 호출하면 항목이 반환되는지 여부를 결정합니다. |
next() | Folder | 파일 또는 폴더 모음에서 다음 항목을 가져옵니다. |
Permission
속성
속성 | 유형 | 설명 |
---|---|---|
VIEW | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 보거나 복사할 수만 있습니다. |
EDIT | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 수정할 수 있습니다. |
COMMENT | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 보거나, 복사하거나, 댓글을 달 수만 있습니다. |
OWNER | Enum | 사용자가 파일 또는 폴더를 소유하고 있습니다. |
ORGANIZER | Enum | 공유 드라이브 내에서 파일 및 폴더를 정리할 수 있는 사용자입니다. |
FILE_ORGANIZER | Enum | 공유 드라이브 내에서 콘텐츠를 수정, 휴지통에 추가, 이동할 수 있는 사용자입니다. |
NONE | Enum | 사용자에게 파일 또는 폴더에 대한 권한이 없습니다. |
User
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getDomain() | String | 사용자 계정과 연결된 도메인 이름을 가져옵니다. |
getEmail() | String | 사용자의 이메일 주소를 가져옵니다. |
getName() | String | 사용자의 이름을 가져옵니다. |
getPhotoUrl() | String | 사용자 사진의 URL을 가져옵니다. |