파일 만들기 및 관리

이 가이드에서는 Google Drive에서 파일을 만들고 관리하는 방법을 설명합니다.

파일 만들기

메타데이터나 콘텐츠가 포함되지 않은 파일을 Drive에 만들려면 매개변수가 없는 files.create 메서드를 사용합니다. 파일에는 kind(drive.file), id, name('제목 없음'), mimeType(application/octet-stream)이 할당됩니다. uploadType는 필수로 표시되지만 기본값은 media이므로 실제로 제공할 필요가 없습니다.

Drive 파일 한도에 대한 자세한 내용은 파일 및 폴더 제한을 참고하세요.

메타데이터 전용 파일 만들기

메타데이터 전용 파일에는 콘텐츠가 포함되지 않습니다. 메타데이터는 파일을 설명하는 데이터 (예: name, mimeType, createdTime)입니다. name와 같은 필드는 사용자와 무관하며 각 사용자에게 동일하게 표시되는 반면 viewedByMeTime와 같은 필드는 사용자별 값을 포함합니다.

메타데이터 전용 파일의 한 가지 예는 MIME 유형이 application/vnd.google-apps.folder인 폴더입니다. 자세한 내용은 폴더 만들기 및 채우기를 참고하세요. 또 다른 예는 MIME 유형 application/vnd.google-apps.shortcut인 Drive의 다른 파일을 가리키는 바로가기입니다. 자세한 내용은 Drive 파일의 바로가기 만들기를 참고하세요.

썸네일 이미지 관리

썸네일은 사용자가 Drive 파일을 식별하는 데 도움이 됩니다. Drive에서 일반적인 파일 형식의 썸네일을 자동으로 생성할 수 있으며 앱에서 생성한 썸네일 이미지를 제공할 수도 있습니다. 자세한 내용은 썸네일 업로드를 참고하세요.

기존 파일 복사

파일을 복사하고 요청된 업데이트를 적용하려면 files.copy 메서드를 사용합니다. 복사할 fileId를 찾으려면 files.list 메서드를 사용합니다.

호출을 승인하려면 적절한 Drive API 범위를 사용해야 합니다. Drive 범위에 관한 자세한 내용은 Google Drive API 범위 선택하기를 참고하세요.

제한사항 및 고려사항

파일을 복사할 때 다음 제한사항과 고려사항에 유의하세요.

  • 권한:

    • copyRequiresWriterPermission 파일 제한은 파일을 복사할 수 있는 사용자를 결정합니다. 자세한 내용은 사용자가 파일을 다운로드, 인쇄, 복사하지 못하도록 차단하기를 참고하세요.
    • files 리소스의 capabilities/canCopy 필드는 사용자가 파일을 복사할 수 있는지 여부를 결정합니다. 자세한 내용은 기능을 참고하세요.
    • 사본을 만든 사용자가 복사된 파일을 소유합니다. 소스 파일의 다른 공유 설정은 복제되지 않습니다. 사본이 공유 폴더에 생성되면 해당 폴더의 권한이 상속됩니다.
    • 복사된 파일의 소유권이 변경될 수 있으며 사본이 원본 파일의 공유 설정을 상속받지 못할 수도 있습니다. 이 설정을 재설정해야 할 수 있습니다.

  • 파일 관리:

    • 서드 파티 바로가기와 같은 일부 파일은 복사할 수 없습니다.
    • 파일은 하나의 상위 폴더에만 복사할 수 있습니다. 여러 상위 요소를 지정하는 기능은 지원되지 않습니다. parents 필드가 지정되지 않으면 파일은 소스 파일에서 검색 가능한 모든 상위 요소를 상속합니다.
    • 폴더는 파일의 한 유형이지만 폴더는 복사할 수 없습니다. 대신 대상 폴더를 만들고 기존 파일의 parents 필드를 대상 폴더로 설정합니다. 그런 다음 원본 소스 폴더를 삭제할 수 있습니다.
    • 새 파일 이름이 지정되지 않으면 files.copy 메서드는 원본과 동일한 이름의 파일을 생성합니다.
    • files.copy를 과도하게 사용하면 Drive API 할당량 한도가 초과될 수 있습니다. 자세한 내용은 사용량 한도를 참고하세요.

다음과 같은 몇 가지 단계를 수행할 수 있습니다.