이 서비스를 사용하면 스크립트가 Google Drive에서 파일과 폴더를 만들고, 찾고, 수정할 수 있습니다. 기본 제공 Drive 서비스는 사용하기 쉽지만 몇 가지 제한사항이 있습니다. 최신 기능과 지원을 이용하고 공유 드라이브의 파일 또는 폴더에 액세스하려면 고급 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입니다. |
Drive | 스크립트가 Google Drive에서 파일과 폴더를 만들고, 찾고, 수정할 수 있도록 허용합니다. |
File | Google Drive의 파일 |
File | 스크립트가 잠재적으로 대규모인 파일 모음을 반복할 수 있는 반복자입니다. |
Folder | Google Drive의 폴더입니다. |
Folder | 스크립트가 잠재적으로 큰 폴더 모음을 반복할 수 있는 객체입니다. |
Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 enum입니다. |
User | Google Drive의 파일과 연결된 사용자입니다. |
Access
속성
속성 | 유형 | 설명 |
---|---|---|
ANYONE | Enum | 모든 인터넷 사용자가 찾아 액세스할 수 있습니다. |
ANYONE_WITH_LINK | Enum | 링크가 있는 모든 사용자가 액세스할 수 있습니다. |
DOMAIN | Enum | 내 도메인의 사용자가 찾아 액세스할 수 있습니다. |
DOMAIN_WITH_LINK | Enum | 링크가 있는 도메인 내 사용자는 누구나 액세스할 수 있습니다. |
PRIVATE | Enum | 명시적으로 권한이 부여된 사용자만 액세스할 수 있습니다. |
Drive App
속성
속성 | 유형 | 설명 |
---|---|---|
Access | Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자 클래스를 나타내는 enum입니다. |
Permission | Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 파일 또는 폴더에 액세스할 수 있는 사용자에게 부여된 권한을 나타내는 enum입니다. |
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
continue | File | 이전 반복자의 연속 토큰을 사용하여 파일 반복을 재개합니다. |
continue | Folder | 이전 반복기의 연속 토큰을 사용하여 폴더 반복을 재개합니다. |
create | File | 임의 데이터의 지정된 Blob 에서 사용자의 Drive 루트에 파일을 만듭니다. |
create | File | 사용자 Drive의 루트에 지정된 이름과 콘텐츠가 포함된 텍스트 파일을 만듭니다. |
create | File | 지정된 이름, 콘텐츠, MIME 유형으로 사용자의 Drive 루트에 파일을 만듭니다. |
create | Folder | 사용자의 Drive 루트에 지정된 이름으로 폴더를 만듭니다. |
create | File | 제공된 Drive 항목 ID의 바로가기를 만들고 반환합니다. |
create | File | 제공된 Drive 항목 ID 및 리소스 키의 바로가기를 만들고 반환합니다. |
enforce | void | 항목 상위에 영향을 미치는 모든 호출에 대해 enforceSingleParent 동작을 사용 설정하거나 사용 중지합니다. |
get | File | 지정된 ID의 파일을 가져옵니다. |
get | File | 지정된 ID 및 리소스 키가 있는 파일을 가져옵니다. |
get | File | 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
get | File | 사용자의 Drive에 있는 지정된 이름의 모든 파일 컬렉션을 가져옵니다. |
get | File | 지정된 MIME 유형의 파일이 포함된 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
get | Folder | 지정된 ID의 폴더를 가져옵니다. |
get | Folder | 지정된 ID 및 리소스 키가 있는 폴더를 가져옵니다. |
get | Folder | 사용자의 Drive에 있는 모든 폴더의 컬렉션을 가져옵니다. |
get | Folder | 사용자의 Drive에 있는 지정된 이름의 모든 폴더 모음을 가져옵니다. |
get | Folder | 사용자의 Drive 루트에 있는 폴더를 가져옵니다. |
get | Integer | 사용자가 Drive에 저장할 수 있는 바이트 수를 가져옵니다. |
get | Integer | 사용자가 현재 Drive에 저장 중인 바이트 수를 가져옵니다. |
get | File | 사용자의 Drive 휴지통에 있는 모든 파일의 컬렉션을 가져옵니다. |
get | Folder | 사용자의 Drive 휴지통에 있는 모든 폴더의 컬렉션을 가져옵니다. |
search | File | 지정된 검색 기준과 일치하는 사용자의 Drive에 있는 모든 파일의 컬렉션을 가져옵니다. |
search | Folder | 지정된 검색 기준과 일치하는 사용자의 Drive에 있는 모든 폴더의 컬렉션을 가져옵니다. |
File
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
add | File | 지정된 사용자를 File 의 댓글 작성자 목록에 추가합니다. |
add | File | 지정된 사용자를 File 의 댓글 작성자 목록에 추가합니다. |
add | File | 주어진 사용자 배열을 File 의 댓글 작성자 목록에 추가합니다. |
add | File | 지정된 사용자를 File 의 편집자 목록에 추가합니다. |
add | File | 지정된 사용자를 File 의 편집자 목록에 추가합니다. |
add | File | 지정된 사용자 배열을 File 의 편집자 목록에 추가합니다. |
add | File | 지정된 사용자를 File 의 시청자 목록에 추가합니다. |
add | File | 지정된 사용자를 File 의 시청자 목록에 추가합니다. |
add | File | 지정된 사용자 배열을 File 의 시청자 목록에 추가합니다. |
get | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
get | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
get | Blob | 이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. |
get | Blob | 이 객체 내의 데이터를 blob으로 반환합니다. |
get | Date | File 가 생성된 날짜를 가져옵니다. |
get | String | File 에 대한 설명을 가져옵니다. |
get | String | 파일을 다운로드하는 데 사용할 수 있는 URL을 가져옵니다. |
get | User[] | 이 File 의 편집자 목록을 가져옵니다. |
get | String | File 의 ID를 가져옵니다. |
get | Date | File 가 마지막으로 업데이트된 날짜를 가져옵니다. |
get | String | 파일의 MIME 유형을 가져옵니다. |
get | String | File 의 이름을 가져옵니다. |
get | User | 파일 소유자를 가져옵니다. |
get | Folder | File 의 직속 상위 요소인 폴더 모음을 가져옵니다. |
get | String | 링크를 사용하여 공유된 항목에 액세스하는 데 필요한 File 의 리소스 키를 가져옵니다. |
get | Boolean | 이 File 가 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다. |
get | Boolean | 링크를 사용하여 공유될 때 이 File 에 액세스하는 데 리소스 키가 필요한지 여부를 가져옵니다. |
get | Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자 클래스를 가져옵니다. |
get | Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다. |
get | Integer | Drive에 File 를 저장하는 데 사용된 바이트 수를 가져옵니다. |
get | String | 바로가기인 경우 가리키는 항목의 ID를 반환합니다. |
get | String | 바로가기인 경우 가리키는 항목의 mime 유형을 반환합니다. |
get | String | 파일이 바로가기인 경우, 파일이 가리키는 항목의 리소스 키를 반환합니다. |
get | Blob | 파일의 썸네일 이미지를 가져오거나 썸네일이 없는 경우 null 를 가져옵니다. |
get | String | Drive 또는 Docs와 같은 Google 앱에서 File 를 여는 데 사용할 수 있는 URL을 가져옵니다. |
get | User[] | 이 File 의 시청자 및 댓글 작성자 목록을 가져옵니다. |
is | Boolean | File 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 결정합니다. |
is | Boolean | File 가 사용자의 Drive에 별표표시되었는지 여부를 확인합니다. |
is | Boolean | File 가 사용자의 Drive 휴지통에 있는지 확인합니다. |
make | File | 파일의 사본을 만듭니다. |
make | File | 대상 디렉터리에 파일의 사본을 만듭니다. |
make | File | 파일의 사본을 만들고 제공된 이름으로 이름을 지정합니다. |
make | File | 대상 디렉터리에 파일의 사본을 만들고 제공된 이름으로 이름을 지정합니다. |
move | File | 이 항목을 제공된 대상 폴더로 이동합니다. |
remove | File | File 의 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
remove | File | File 의 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
remove | File | File 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
remove | File | File 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
remove | File | File 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
remove | File | File 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
revoke | File | 지정된 사용자에게 부여된 File 에 대한 액세스 권한을 취소합니다. |
revoke | File | 지정된 사용자에게 부여된 File 에 대한 액세스 권한을 취소합니다. |
set | File | 지정된 대체 문자열로 파일의 콘텐츠를 덮어씁니다. |
set | File | File 의 설명을 설정합니다. |
set | File | File 의 이름을 설정합니다. |
set | File | File 의 소유자를 변경합니다. |
set | File | File 의 소유자를 변경합니다. |
set | File | 링크를 사용하여 공유될 때 File 에 액세스하는 데 리소스 키가 필요한지 여부를 설정합니다. |
set | File | File 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다. |
set | File | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 File 에 액세스할 수 있는 사용자 클래스와 이러한 사용자에게 부여되는 권한을 설정합니다. |
set | File | File 가 사용자의 Drive에 별표표시되어 있는지 여부를 설정합니다. |
set | File | File 가 사용자의 Drive 휴지통에 있는지 여부를 설정합니다. |
File Iterator
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
get | String | 나중에 이 반복을 재개하는 데 사용할 수 있는 토큰을 가져옵니다. |
has | Boolean | next() 를 호출하면 항목이 반환되는지 여부를 결정합니다. |
next() | File | 파일 또는 폴더 모음의 다음 항목을 가져옵니다. |
Folder
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
add | Folder | 지정된 사용자를 Folder 의 편집자 목록에 추가합니다. |
add | Folder | 지정된 사용자를 Folder 의 편집자 목록에 추가합니다. |
add | Folder | 지정된 사용자 배열을 Folder 의 편집자 목록에 추가합니다. |
add | Folder | 지정된 사용자를 Folder 의 시청자 목록에 추가합니다. |
add | Folder | 지정된 사용자를 Folder 의 시청자 목록에 추가합니다. |
add | Folder | 지정된 사용자 배열을 Folder 의 시청자 목록에 추가합니다. |
create | File | 임의 데이터의 지정된 Blob 에서 현재 폴더에 파일을 만듭니다. |
create | File | 지정된 이름과 콘텐츠로 현재 폴더에 텍스트 파일을 만듭니다. |
create | File | 지정된 이름, 콘텐츠, MIME 유형으로 현재 폴더에 파일을 만듭니다. |
create | Folder | 현재 폴더에 지정된 이름으로 폴더를 만듭니다. |
create | File | 제공된 Drive 항목 ID의 바로가기를 만들고 반환합니다. |
create | File | 제공된 Drive 항목 ID 및 리소스 키의 바로가기를 만들고 반환합니다. |
get | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
get | Permission | 특정 사용자에게 부여된 권한을 가져옵니다. |
get | Date | Folder 가 생성된 날짜를 가져옵니다. |
get | String | Folder 에 대한 설명을 가져옵니다. |
get | User[] | 이 Folder 의 편집자 목록을 가져옵니다. |
get | File | 현재 폴더의 하위 폴더인 모든 파일의 컬렉션을 가져옵니다. |
get | File | 현재 폴더의 하위 요소이고 지정된 이름을 가진 모든 파일의 컬렉션을 가져옵니다. |
get | File | 현재 폴더의 하위 요소이고 지정된 MIME 유형을 가진 모든 파일의 컬렉션을 가져옵니다. |
get | Folder | 현재 폴더의 하위 폴더인 모든 폴더의 컬렉션을 가져옵니다. |
get | Folder | 현재 폴더의 하위 폴더이고 지정된 이름을 가진 모든 폴더의 컬렉션을 가져옵니다. |
get | String | Folder 의 ID를 가져옵니다. |
get | Date | Folder 가 마지막으로 업데이트된 날짜를 가져옵니다. |
get | String | Folder 의 이름을 가져옵니다. |
get | User | 이 Folder 의 소유자를 가져옵니다. |
get | Folder | Folder 의 직속 상위 요소인 폴더 모음을 가져옵니다. |
get | String | 링크를 사용하여 공유된 항목에 액세스하는 데 필요한 Folder 의 리소스 키를 가져옵니다. |
get | Boolean | 이 Folder 가 링크를 사용하여 공유될 때 액세스에 리소스 키가 필요한 보안 업데이트를 적용할 수 있는지 여부를 가져옵니다. |
get | Boolean | 링크를 사용하여 공유될 때 이 Folder 에 액세스하는 데 리소스 키가 필요한지 여부를 가져옵니다. |
get | Access | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 Folder 에 액세스할 수 있는 사용자 클래스를 가져옵니다. |
get | Permission | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 Folder 에 액세스할 수 있는 사용자에게 부여된 권한을 가져옵니다. |
get | Integer | Drive에 Folder 를 저장하는 데 사용된 바이트 수를 가져옵니다. |
get | String | Drive 또는 Docs와 같은 Google 앱에서 Folder 를 여는 데 사용할 수 있는 URL을 가져옵니다. |
get | User[] | 이 Folder 의 시청자 및 댓글 작성자 목록을 가져옵니다. |
is | Boolean | Folder 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 결정합니다. |
is | Boolean | Folder 가 사용자의 Drive에 별표표시되었는지 여부를 확인합니다. |
is | Boolean | Folder 가 사용자의 Drive 휴지통에 있는지 확인합니다. |
move | Folder | 이 항목을 제공된 대상 폴더로 이동합니다. |
remove | Folder | Folder 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
remove | Folder | Folder 의 편집자 목록에서 지정된 사용자를 삭제합니다. |
remove | Folder | Folder 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
remove | Folder | Folder 의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. |
revoke | Folder | 지정된 사용자에게 부여된 Folder 에 대한 액세스 권한을 취소합니다. |
revoke | Folder | 지정된 사용자에게 부여된 Folder 에 대한 액세스 권한을 취소합니다. |
search | File | 현재 폴더의 하위 폴더이고 지정된 검색 기준과 일치하는 모든 파일의 컬렉션을 가져옵니다. |
search | Folder | 현재 폴더의 하위 폴더이며 지정된 검색 기준과 일치하는 모든 폴더의 컬렉션을 가져옵니다. |
set | Folder | Folder 의 설명을 설정합니다. |
set | Folder | Folder 의 이름을 설정합니다. |
set | Folder | Folder 의 소유자를 변경합니다. |
set | Folder | Folder 의 소유자를 변경합니다. |
set | Folder | 링크를 사용하여 공유할 때 Folder 에 액세스하는 데 리소스 키가 필요한지 여부를 설정합니다. |
set | Folder | Folder 에 대한 수정 권한이 있는 사용자가 다른 사용자와 공유하거나 권한을 변경할 수 있는지 여부를 설정합니다. |
set | Folder | 명시적으로 액세스 권한이 부여된 개별 사용자 외에도 Folder 에 액세스할 수 있는 사용자 클래스와 이러한 사용자에게 부여되는 권한을 설정합니다. |
set | Folder | Folder 가 사용자의 Drive에 별표표시되어 있는지 여부를 설정합니다. |
set | Folder | Folder 가 사용자의 Drive 휴지통에 있는지 여부를 설정합니다. |
Folder Iterator
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
get | String | 나중에 이 반복을 재개하는 데 사용할 수 있는 토큰을 가져옵니다. |
has | Boolean | next() 를 호출하면 항목이 반환되는지 여부를 결정합니다. |
next() | Folder | 파일 또는 폴더 모음의 다음 항목을 가져옵니다. |
Permission
속성
속성 | 유형 | 설명 |
---|---|---|
VIEW | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 보거나 복사할 수만 있습니다. |
EDIT | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 수정할 수 있습니다. |
COMMENT | Enum | 파일 또는 폴더에 액세스할 수 있는 사용자는 파일을 보거나, 복사하거나, 댓글을 달 수만 있습니다. |
OWNER | Enum | 사용자가 파일 또는 폴더를 소유하고 있습니다. |
ORGANIZER | Enum | 공유 드라이브 내에서 파일 및 폴더를 정리할 수 있는 사용자입니다. |
FILE_ORGANIZER | Enum | 공유 드라이브 내에서 콘텐츠를 수정, 휴지통에 추가, 이동할 수 있는 사용자입니다. |
NONE | Enum | 사용자에게 파일 또는 폴더에 대한 권한이 없습니다. |
User
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
get | String | 사용자 계정과 연결된 도메인 이름을 가져옵니다. |
get | String | 사용자의 이메일 주소를 가져옵니다. |
get | String | 사용자의 이름을 가져옵니다. |
get | String | 사용자 사진의 URL을 가져옵니다. |