이 문서에서는 파일 이름을 지정하고 썸네일 및 색인 생성 가능한 텍스트와 같은 메타데이터를 사용할 때 중요한 고려사항을 다룹니다. 파일 삽입 및 검색을 시작하려면 파일 참조를 확인하세요.
파일 이름 및 확장자 지정
앱은 API로 파일을 삽입할 때 제목 속성에 파일 확장자를 지정해야 합니다. 예를 들어 JPEG 파일을 삽입하는 작업은 메타데이터에 "name": "cat.jpg"와 같은 것을 지정해야 합니다.
후속 GET 응답에는 원래 name 속성에 지정된 확장 프로그램으로 채워진 읽기 전용 fileExtension 속성이 포함될 수 있습니다. Google Drive 사용자가 파일 다운로드를 요청하거나 동기화 클라이언트를 통해 파일이 다운로드되면 Drive는 제목을 기반으로 전체 파일 이름 (확장자 포함)을 빌드합니다. 확장 프로그램이 없으면 Drive는 파일의 MIME 유형을 기반으로 확장 프로그램을 결정하려고 시도합니다.
색인 생성 가능 텍스트 저장
Drive에서는 파일 형식(텍스트 문서, PDF, 텍스트가 포함된 이미지, 기타 일반 유형 포함)을 인식하면 검색할 수 있도록 문서의 색인을 자동으로 생성합니다.
앱이 다른 유형의 파일 (예: 그림, 동영상, 단축키)을 저장하는 경우 파일의 contentHints.indexableText 필드에 색인 생성이 가능한 텍스트를 제공하여 검색 가능성을 개선할 수 있습니다.
색인 생성이 가능한 텍스트는 HTML로 색인이 생성됩니다. 색인 생성이 가능한 텍스트 문자열 <section attribute="value1">Here's some text</section>를 저장하면 '여기에서 텍스트'의 색인이 생성되지만 'value1'은 색인이 생성되지 않습니다. 따라서 XML을 색인 생성 가능한 텍스트로 저장하는 것은 HTML을 저장하는 것만큼 유용하지 않습니다.
indexableText를 지정할 때는 다음 사항에도 유의하세요.
contentHints.indexableText의 크기 제한은 128KB입니다.- 사용자가 검색할 것으로 예상되는 주요 용어와 개념을 파악합니다.
- 색인 생성기가 이 작업을 효율적으로 실행하므로 텍스트를 중요도 순으로 정렬하지 마세요.
- 애플리케이션은 저장할 때마다 색인 생성이 가능한 텍스트를 업데이트해야 합니다.
- 텍스트가 파일의 콘텐츠 또는 메타데이터와 관련이 있는지 확인합니다.
이 요점은 당연해 보일 수 있지만 중요합니다. 자주 검색되는 용어를 추가하여 파일을 검색결과에 강제로 표시하는 것은 좋지 않습니다. 이로 인해 사용자가 답답해할 수 있으며 사용자가 파일을 삭제하라고 동기를 부여할 수도 있습니다.
썸네일 업로드
Drive는 여러 일반적인 파일 형식의 썸네일을 자동으로 생성합니다. Drive에서 렌더링할 수 없는 바로가기 및 기타 파일 형식의 경우 애플리케이션에서 생성한 썸네일 이미지를 제공할 수 있습니다. create 또는 update 호출 중에 파일 리소스에서 contentHints.thumbnail 속성을 설정하여 다음과 같이 썸네일을 업로드합니다.
contentHints.thumbnail.image을 URL 보안 Base64로 인코딩된 이미지로 설정합니다 (RFC 4648 5조 참고).contentHints.thumbnail.mimeType를 이미지 형식에 적합한 유형으로 설정합니다.
Drive가 파일에서 썸네일 이미지를 생성할 수 있으면 생성된 썸네일을 사용하고 업로드한 모든 이미지는 무시됩니다. 썸네일을 생성할 수 없는 경우 썸네일을 제공한 경우 항상 썸네일을 사용합니다. 주의사항:
- 썸네일은 PNG, GIF 또는 JPG 형식으로 업로드할 수 있습니다.
- 권장 너비는 1600픽셀입니다.
- 썸네일의 최대 파일 크기는 2MB입니다.
- 썸네일 이미지의 최소 너비는 220픽셀입니다.
- 저장할 때마다 애플리케이션에서 썸네일을 업데이트해야 합니다.
자세한 내용은 파일 참조를 확인하세요.