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

Drive Service

이 서비스를 통해 스크립트는 Google Drive에 있는 파일과 폴더를 만들고 찾고 수정할 수 있습니다.

// Log the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  Logger.log(file.getName());
}

참고: Google Workspace 도메인의 관리자는 도메인의 Drive SDK를 사용 중지할 수 있으므로 사용자가 Google Drive 앱을 설치하고 사용할 수 없습니다. 또한 이 설정은 사용자가 Drive SDK를 사용 중지하기 전에 문제의 부가기능 또는 웹 앱을 설치했더라도 Drive 서비스 또는 고급 Drive 서비스를 사용하는 Apps Script 스크립트, 웹 앱, 부가기능을 사용할 수 없습니다.

하지만 Drive 서비스를 사용하는 부가기능이 도메인 전체 설치용으로 게시되었고 도메인 내 일부 또는 모든 사용자의 경우 또는 도메인 관리자가 OAuth 클라이언트 허용 목록을 추가한 Apps Script를 설치할 경우, 도메인에서 Drive SDK가 사용 중지된 경우에도 이러한 사용자의 부가기능 기능은 작동합니다.

클래스

이름	간략한 설명
`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`	지정된 이름과 콘텐츠로 사용자 드라이브의 루트에 텍스트 파일을 만듭니다.
`createFile(name, content, mimeType)`	`File`	지정된 이름, 콘텐츠, MIME 유형으로 사용자 드라이브의 루트에 파일을 만듭니다.
`createFolder(name)`	`Folder`	지정된 이름을 사용하여 사용자 드라이브의 루트에 폴더를 만듭니다.
`createShortcut(targetId)`	`File`	제공된 Drive 항목 ID에 대한 바로가기를 만들어 반환합니다.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	제공된 Drive 항목 ID와 리소스 키의 바로가기를 만들어 반환합니다.
`enforceSingleParent(value)`	`void`	항목 상위 항목에 영향을 미치는 모든 호출에서 applySingleParent 동작을 사용 설정하거나 사용 중지합니다.
`getFileById(id)`	`File`	지정된 ID의 파일을 가져옵니다.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	지정된 ID와 리소스 키가 있는 파일을 가져옵니다.
`getFiles()`	`FileIterator`	사용자의 드라이브에 있는 모든 파일 컬렉션을 가져옵니다.
`getFilesByName(name)`	`FileIterator`	지정된 이름을 가진 사용자 Drive의 모든 파일 컬렉션을 가져옵니다.
`getFilesByType(mimeType)`	`FileIterator`	지정된 MIME 유형을 가진 사용자 Drive의 모든 파일 컬렉션을 가져옵니다.
`getFolderById(id)`	`Folder`	지정된 ID가 있는 폴더를 가져옵니다.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	지정된 ID와 리소스 키가 있는 폴더를 가져옵니다.
`getFolders()`	`FolderIterator`	사용자의 드라이브에 있는 모든 폴더 컬렉션을 가져옵니다.
`getFoldersByName(name)`	`FolderIterator`	지정된 이름을 가진 사용자 Drive의 모든 폴더 컬렉션을 가져옵니다.
`getRootFolder()`	`Folder`	사용자 Drive의 루트에 있는 폴더를 가져옵니다.
`getStorageLimit()`	`Integer`	사용자가 Drive에 저장할 수 있는 바이트 수를 가져옵니다.
`getStorageUsed()`	`Integer`	사용자가 현재 Drive에 저장 중인 바이트 수를 가져옵니다.
`getTrashedFiles()`	`FileIterator`	사용자의 Drive 휴지통에 있는 모든 파일 컬렉션을 가져옵니다.
`getTrashedFolders()`	`FolderIterator`	사용자 드라이브의 휴지통에 있는 모든 폴더 컬렉션을 가져옵니다.
`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`	`File`를 Drive에 저장하는 데 사용되는 바이트 수를 가져옵니다.
`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`가 사용자 드라이브의 휴지통에 있는지 확인합니다.
`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`	사용자의 Drive에서 `File`에 별표표시할지 여부를 설정합니다.
`setTrashed(trashed)`	`File`	`File`가 사용자 드라이브의 휴지통에 있는지 여부를 설정합니다.

`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`	`Folder`를 Drive에 저장하는 데 사용되는 바이트 수를 가져옵니다.
`getUrl()`	`String`	Drive 또는 Docs와 같은 Google 앱에서 `Folder`을 여는 데 사용할 수 있는 URL을 가져옵니다.
`getViewers()`	`User[]`	이 `Folder`의 뷰어 및 댓글 작성자 목록을 가져옵니다.
`isShareableByEditors()`	`Boolean`	`Folder`에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 결정합니다.
`isStarred()`	`Boolean`	`Folder`가 사용자의 Drive에 별표표시되었는지 확인합니다.
`isTrashed()`	`Boolean`	`Folder`가 사용자 드라이브의 휴지통에 있는지 확인합니다.
`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`가 사용자 드라이브의 휴지통에 있는지 여부를 설정합니다.

`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을 가져옵니다.