이 가이드에서는 Google Drive에서 파일을 만들고 관리하는 방법을 설명합니다.
파일 만들기
메타데이터 또는 콘텐츠가 포함되지 않은 파일을 드라이브에서 만들려면 매개변수 없이 files.create
메서드를 사용합니다. 파일에는 drive.file
의 kind
, id
, 'Untitled'의 name
, application/octet-stream
의 mimeType
가 지정됩니다. uploadType
는 필수로 표시되지만 기본값은 media
이므로 실제로 제공할 필요는 없습니다.
Drive 파일 한도에 대한 자세한 내용은 파일 및 폴더 한도를 참고하세요.
메타데이터 전용 파일 만들기
메타데이터 전용 파일에는 콘텐츠가 없습니다. 메타데이터는 파일을 설명하는 데이터 (예: name
, mimeType
, createdTime
)입니다. name
와 같은 필드는 사용자 제약이 없으며 각 사용자에게 동일하게 표시되는 반면, viewedByMeTime
와 같은 필드에는 사용자별 값이 포함되어 있습니다.
메타데이터 전용 파일의 한 가지 예로는 MIME 유형이 application/vnd.google-apps.folder
인 폴더가 있습니다. 자세한 내용은 폴더 만들기 및 채우기를 참고하세요. 또 다른 예는 MIME 유형 application/vnd.google-apps.shortcut
인 Drive의 다른 파일을 가리키는 바로가기입니다. 자세한 내용은 Drive 파일 바로가기 만들기를 참고하세요.
썸네일 이미지 관리
썸네일은 사용자가 Drive 파일을 식별하는 데 도움이 됩니다. 드라이브는 일반적인 파일 형식의 썸네일을 자동으로 생성하거나 개발자가 앱에서 생성한 썸네일 이미지를 제공할 수 있습니다. 자세한 내용은 썸네일 업로드를 참고하세요.
기존 파일 복사
파일을 복사하고 요청된 업데이트를 적용하려면 files.copy
메서드를 사용합니다. 복사할 fileId
를 찾으려면 files.list
메서드를 사용합니다.
호출을 승인하려면 적절한 Drive API 범위를 사용해야 합니다. 드라이브 범위에 대한 자세한 내용은 Google Drive API 범위 선택을 참고하세요.
제한사항 및 고려사항
파일 복사를 준비할 때 다음 한도 및 고려사항에 유의하세요.
권한:
copyRequiresWriterPermission
파일 제한에 따라 파일을 복사할 수 있는 사용자가 결정됩니다. 자세한 내용은 사용자가 파일을 다운로드, 인쇄, 복사하지 못하도록 차단을 참고하세요.files
리소스의capabilities/canCopy
필드는 사용자가 파일을 복사할 수 있는지 여부를 결정합니다. 자세한 내용은 기능을 참조하세요.- 사본을 만든 사용자가 복사된 파일을 소유합니다. 소스 파일의 다른 공유 설정은 복제되지 않습니다. 공유 폴더에 사본이 생성되면 해당 폴더의 권한을 상속합니다.
- 복사된 파일의 소유권이 변경될 수 있으며 사본이 원본 파일의 공유 설정을 상속받지 않을 수 있습니다. 이 설정을 재설정해야 할 수도 있습니다.
파일 관리:
- 서드 파티 바로가기와 같은 일부 파일은 복사할 수 없습니다.
- 파일은 하나의 상위 폴더에만 복사할 수 있습니다. 여러 상위 요소를 지정하는 것은 지원되지 않습니다.
parents
필드가 지정되지 않은 경우 파일은 소스 파일에서 검색 가능한 모든 상위 항목을 상속합니다. - 폴더는 파일 형식이지만 폴더를 복사할 수는 없습니다.
대신 대상 폴더를 만들고 기존 파일의
parents
필드를 대상 폴더로 설정합니다. 그런 다음 원본 소스 폴더를 삭제할 수 있습니다. - 새 파일 이름이 지정되지 않으면
files.copy
메서드는 원본과 같은 이름의 파일을 생성합니다. files.copy
를 과도하게 사용하면 Drive API 할당량 한도를 초과할 수 있습니다. 자세한 내용은 사용량 한도를 참고하세요.
관련 주제
다음 단계를 시도해 보세요.
파일을 만들거나 업데이트할 때 파일 데이터를 업로드하려면 파일 데이터 업로드를 참고하세요.
특정 폴더에 파일을 만들려면 특정 폴더에서 파일 만들기를 참조하세요.
파일 메타데이터를 사용하려면 파일 메타데이터 관리를 참조하세요.
파일을 삭제하려면 파일 및 폴더 휴지통 또는 삭제를 참조하세요.