파일 만들기

메타데이터 또는 콘텐츠가 포함되지 않은 파일을 만들려면 매개변수 없이 files.create 메서드를 사용합니다. 파일에는 drive.filekind, id, 'Untitled'의 name, application/octet-streammimeType가 지정됩니다. uploadType는 필수로 표시되지만 기본값이 media이므로 실제로 제공할 필요는 없습니다.

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

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

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

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

썸네일 업로드

Drive는 Google Docs, Sheets, Slides와 같은 여러 일반적인 파일 형식의 썸네일을 자동으로 생성합니다. 썸네일은 사용자가 Drive 파일을 더 잘 식별하는 데 도움이 됩니다.

드라이브에서 표준 썸네일을 생성할 수 없는 파일 형식의 경우 애플리케이션에서 생성한 썸네일 이미지를 제공할 수 있습니다. 파일 생성 또는 업데이트 중에 files 리소스에서 contentHints.thumbnail 필드를 설정하여 썸네일을 업로드합니다.

특히 다음에 주의해야 합니다.

  • contentHints.thumbnail.image 필드를 URL 및 파일 이름 안전 base64 인코딩 이미지로 설정합니다 (RFC 4648 섹션 5 참고).
  • contentHints.thumbnail.mimeType 필드를 썸네일의 적절한 MIME 유형으로 설정합니다.

Drive가 파일에서 썸네일을 생성할 수 있는 경우, 자동으로 생성된 썸네일을 사용하고 사용자가 업로드한 썸네일은 무시합니다. 썸네일을 생성할 수 없으면 제공된 썸네일을 사용합니다.

썸네일은 다음 규칙을 준수해야 합니다.

  • PNG, GIF, JPG 형식으로 업로드할 수 있습니다.
  • 권장 너비는 1600픽셀입니다.
  • 최소 너비는 220픽셀입니다.
  • 최대 파일 크기는 2MB입니다.
  • 저장할 때마다 애플리케이션에서 업데이트해야 합니다.

자세한 내용은 files 리소스를 참고하세요.

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