이 문서에서는 파일 이름 지정 및 파일 작업 시 중요한 고려사항을 다룹니다.
색인을 생성할 수 있는 텍스트, 썸네일 등의
메타데이터도 제공합니다 파일을 삽입하고 검색하려면 다음을 참조하세요.
files 리소스
파일 이름 및 확장자 지정
파일을 삽입할 때 앱에서 제목 속성에 파일 확장자를 지정해야 합니다.
Google Drive API와 함께 사용하면 됩니다. 예를 들어, JPEG 파일을 삽입하는 작업은
메타데이터에 "name": "cat.jpg" 등을 지정합니다.
후속 GET 응답에는 읽기 전용 fileExtension 속성이 포함될 수 있습니다.
원래 name 속성에 지정된 확장자로 채워집니다. 사용자가
Google Drive 사용자가 파일 다운로드를 요청한 경우 또는 파일이 다운로드된 경우
동기화 클라이언트를 통해 드라이브가 파일 이름 (전체 파일 이름)을
확장)이 표시됩니다. 확장 프로그램이 누락된 경우
Drive는 파일의 확장 프로그램을 결정하기 위해
MIME 유형입니다.
색인 생성 가능한 텍스트 저장
Drive가 문서를 검색할 때 자동으로 색인을 생성합니다.
텍스트 문서, PDF, 텍스트가 있는 이미지 및
기타 일반적인 유형 앱이 다른 유형의 파일 (예: 그림,
동영상, 바로 가기)에서 제공하는 다른 매개변수를 제공하여 검색 가능성을
파일의 contentHints.indexableText 필드에 있는 색인 생성 가능 텍스트입니다.
색인 생성 가능한 텍스트는 HTML로 색인이 생성됩니다. 색인 생성이 가능한 텍스트 문자열을 저장하는 경우
<section attribute="value1">Here's some text</section> 후 '다음은
text" 색인이 생성되었지만 'value1'이(가) 있습니다. 아닙니다. 따라서 XML을 색인 생성 가능한 것으로 저장하면
HTML 저장만큼 유용하지는 않습니다.
indexableText를 지정할 때는 다음 사항도 유의해야 합니다.
contentHints.indexableText의 크기 제한은 128KB입니다.- 사용자가 검색할 것으로 예상되는 주요 용어와 개념을 파악합니다.
- 색인 생성기가 중요도 순으로 텍스트를 정렬하지 않음 효율적으로 관리할 수 있습니다
- 애플리케이션은 저장할 때마다 색인 생성이 가능한 텍스트를 업데이트해야 합니다.
- 텍스트가 파일의 콘텐츠 또는 메타데이터와 관련이 있는지 확인하세요.
마지막 요점이 당연해 보일 수 있지만 중요합니다. 자주 사용하는 검색어를 추가하여 검색결과에 파일을 강제로 표시 이 사용자를 짜증 나게 할 수 있으며 파일을 삭제하도록 동기를 부여할 수도 있습니다.
썸네일 업로드
Drive에서 여러 일반 파일의 썸네일을 자동으로 생성 Google Docs, Sheets, Slides와 같은 파일 형식에 기반합니다. 썸네일은 사용자가 Drive 파일을 더 쉽게 식별하는 데 도움이 됩니다.
Drive에서 표준 썸네일을 생성할 수 없는 파일 형식
애플리케이션에서 생성한 썸네일 이미지를 제공할 수 있습니다. 기간 중
썸네일을 업로드하는 경우
files 리소스의 contentHints.thumbnail 필드
특히 다음에 주의해야 합니다.
contentHints.thumbnail.image필드를 URL 및 파일 이름 안전성으로 설정합니다. base64 인코딩 이미지 (RFC 4648 섹션 참조) 5)contentHints.thumbnail.mimeType필드를 적절한 MIME 유형으로 설정합니다. 를 사용합니다.
Drive가 파일에서 썸네일을 생성할 수 있는 경우 사용자가 업로드한 파일은 무시합니다. 확인할 수 없는 경우 내가 제공한 썸네일을 사용하여 썸네일을 생성합니다.
썸네일은 다음 규칙을 준수해야 합니다.
- PNG, GIF, JPG 형식으로 업로드할 수 있습니다.
- 권장 너비는 1600픽셀입니다.
- 최소 너비는 220픽셀입니다.
- 최대 파일 크기는 2MB입니다.
- 저장할 때마다 애플리케이션에서 업데이트해야 합니다.
자세한 내용은 files 리소스를 참고하세요.
썸네일 가져오기
썸네일을 포함한 Drive 파일의 메타데이터를 가져올 수 있습니다.
썸네일 정보는 thumbnailLink
files 리소스
특정 썸네일 반환
다음 코드 샘플은
files.get 메서드 요청:
여러 필드를 쿼리 매개변수로 사용하여 다음에 대한 thumbnailLink 메타데이터를 반환함
지정할 수 있습니다. 자세한 내용은
파일을 참고하세요.
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
FILE_ID를 원하는 파일의 fileId로 바꿉니다.
찾습니다.
사용 가능한 경우 요청에서 파일의 썸네일에 단기 URL을 반환합니다.
일반적으로 링크는 몇 시간 동안 지속됩니다. 이 필드는
요청 앱이 파일의 콘텐츠에 액세스할 수 있는지 확인합니다. 파일이 공유되지 않은 경우
공개적으로 전달하려면 thumbnailLink에서 반환된 URL을
사용자 인증 정보 요청.
썸네일 목록 반환
다음 코드 샘플은
files.list 메서드 요청:
여러 필드를 쿼리 매개변수로 사용하여 다음에 대한 thumbnailLink 메타데이터를 반환함
파일 목록입니다 자세한 내용은 파일 검색 및
폴더를 참조하세요.
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
검색결과를 특정 파일 형식으로 제한하려면 쿼리 문자열을 MIME 유형을 설정합니다. 예를 들어 다음 코드 샘플은 Google Sheets 파일로 내보낼 수 있습니다. MIME 유형에 대한 자세한 내용은 을 참조하세요. Google Workspace 및 Google Drive 지원 MIME 유형이 있습니다.
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)