파일 만들기 및 관리

이 가이드에서는 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 할당량 한도를 초과할 수 있습니다. 자세한 내용은 사용량 한도를 참고하세요.

다음 단계를 시도해 보세요.