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

Drive Service

이 서비스를 사용하면 스크립트를 통해 Google Drive

스크립트에서 표준 Cloud 프로젝트 기본 Cloud 프로젝트 대신 수동으로 Drive API를 사용 설정할 수 있습니다. 표준 Cloud 프로젝트에서 Drive API를 사용 설정합니다.

<ph type="x-smartling-placeholder"></ph> 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`	파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 열거형입니다. 명시적으로 액세스 권한이 부여된 모든 개별 사용자입니다.
`User`	Google Drive의 파일과 연결된 사용자입니다.

`Access`

속성

속성	유형	설명
`ANYONE`	`Enum`	모든 인터넷 사용자가 찾아서 액세스할 수 있습니다.
`ANYONE_WITH_LINK`	`Enum`	링크가 있는 모든 사용자가 액세스할 수 있습니다.
`DOMAIN`	`Enum`	도메인의 사용자가 찾아서 액세스할 수 있습니다.
`DOMAIN_WITH_LINK`	`Enum`	링크가 있는 도메인 내 사용자가 액세스할 수 있습니다.
`PRIVATE`	`Enum`	명시적으로 권한이 부여된 사용자만 액세스할 수 있습니다.

`DriveApp`

속성

속성	유형	설명
`Access`	`Access`	개별 사용자 외에 파일 또는 폴더에 액세스할 수 있는 사용자 클래스를 나타내는 enum입니다. 명시적으로 액세스 권한을 부여받은 사용자입니다.
`Permission`	`Permission`	파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 열거형입니다. 명시적으로 액세스 권한이 부여된 모든 개별 사용자입니다.

메서드

메서드	반환 유형	간략한 설명
`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`	항목 상위 요소에 영향을 주는 모든 호출에 대해EnforcementSingleParent 동작을 사용 설정하거나 사용 중지합니다.
`getFileById(id)`	`File`	지정된 ID가 있는 파일을 가져옵니다.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	지정된 ID와 리소스 키가 있는 파일을 가져옵니다.
`getFiles()`	`FileIterator`	사용자 드라이브에 있는 모든 파일의 컬렉션을 가져옵니다.
`getFilesByName(name)`	`FileIterator`	지정된 이름을 가진 사용자 드라이브에 있는 모든 파일 모음을 가져옵니다.
`getFilesByType(mimeType)`	`FileIterator`	지정된 MIME 유형을 가진 사용자 드라이브에 있는 모든 파일의 컬렉션을 가져옵니다.
`getFolderById(id)`	`Folder`	지정된 ID가 있는 폴더를 가져옵니다.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	지정된 ID와 리소스 키가 있는 폴더를 가져옵니다.
`getFolders()`	`FolderIterator`	사용자 드라이브에 있는 모든 폴더의 컬렉션을 가져옵니다.
`getFoldersByName(name)`	`FolderIterator`	지정된 이름을 가진 사용자 드라이브에 있는 모든 폴더의 컬렉션을 가져옵니다.
`getRootFolder()`	`Folder`	사용자 Drive의 루트에 있는 폴더를 가져옵니다.
`getStorageLimit()`	`Integer`	사용자가 드라이브에 저장할 수 있는 바이트 수를 가져옵니다.
`getStorageUsed()`	`Integer`	사용자가 현재 드라이브에 저장 중인 바이트 수를 가져옵니다.
`getTrashedFiles()`	`FileIterator`	사용자 드라이브의 휴지통에 있는 모든 파일의 컬렉션을 가져옵니다.
`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`	Drive에 `File`를 저장하는 데 사용되는 바이트 수를 가져옵니다.
`getTargetId()`	`String`	바로가기인 경우, 바로가기가 가리키는 항목의 ID를 반환합니다.
`getTargetMimeType()`	`String`	바로가기인 경우 가리키는 항목의 MIME 유형을 반환합니다.
`getTargetResourceKey()`	`String`	파일이 바로가기인 경우, 파일이 가리키는 항목의 리소스 키를 반환합니다.
`getThumbnail()`	`Blob`	파일의 썸네일 이미지를 가져오거나 썸네일이 없는 경우 `null`를 가져옵니다.
`getUrl()`	`String`	다음과 같은 Google 앱에서 `File`을 여는 데 사용할 수 있는 URL을 가져옵니다. Drive 또는 Docs.
`getViewers()`	`User[]`	이 `File`의 뷰어 및 댓글 작성자 목록을 가져옵니다.
`isShareableByEditors()`	`Boolean`	`File`에 대한 수정 권한이 있는 사용자가 다음 작업을 할 수 있는지 결정합니다. 다른 사용자와 공유하거나 권한을 변경할 수 없습니다.
`isStarred()`	`Boolean`	사용자의 Drive에서 `File`가 별표표시되었는지 확인합니다.
`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`	사용자의 Drive에서 `File`의 별표표시 여부를 설정합니다.
`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`	다음과 같은 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의 휴지통에 있는지 여부를 설정합니다.

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