미리보기 이미지 사용

썸네일은 사용자가 관련 검색 결과를 식별하는 데 도움이 됩니다. 이러한 특성이 있습니다.

• 너비 1024px
• Google Workspace 파일 썸네일의 URL은 ACL로 보호됩니다. 다른 파일 형식은 지원되지 않습니다.
• URL은 5분 후에 만료됩니다.
• 생성용 최대 파일 크기는 50MB입니다.
• 생성에 실패하면 Cloud Search에서 자리표시자 아이콘을 반환합니다. Google Workspace 항목의 경우 URL이 '404 Not Found'를 반환합니다. 애플리케이션에서 이를 처리해야 합니다.

Google Drive는 Docs, Sheets, Slides와 같은 지원되는 유형의 썸네일을 자동으로 생성합니다. Cloud Search는 다음 항목의 썸네일도 생성합니다.

• Microsoft Word (DOC, DOCX)
• Microsoft Excel (XLS, XLSX)
• Microsoft PowerPoint (PPT, PPTX)
• Adobe PDF
• RTF, TXT, HTML, XML

데이터 소스 및 검색 애플리케이션에 썸네일을 사용 설정한 경우에만 Cloud Search에서 항목의 썸네일을 반환합니다.

데이터 소스의 썸네일 URL 사용 설정

썸네일 URL을 사용 설정하려면 API 키와 웹 애플리케이션 사용자 인증 정보를 만드세요. 이를 사용하여 액세스 토큰을 획득하여 데이터 소스를 업데이트합니다.

1. 프로젝트를 만들거나 선택하고 API를 사용 설정합니다. Cloud Search API에 대한 액세스 구성을 참고하세요.
2. Google Cloud 콘솔에서 API 키를 만들고 값을 기록합니다.
3. 웹 애플리케이션 사용자 인증 정보를 만듭니다. https://developers.google.com/oauthplayground을 리디렉션 URI로 사용합니다. 사용자 인증 정보 만들기를 참고하세요.
4. OAuth 2.0 Playground에서 OAuth 2.0 구성 을 엽니다.
5. 자체 사용자 인증 정보 사용을 선택하고 클라이언트 ID와 보안 비밀을 입력합니다.
6. 범위 필드에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
7. 승인 코드를 토큰으로 교환합니다.

8. settings.datasources.get를 호출하여 데이터 소스 ID를 가져옵니다.

   curl 'https://cloudsearch.googleapis.com/v1/settings/DATASOURCE_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

9. returnThumbnailUrls이 true로 설정된 상태에서 settings.datasources.update를 호출합니다.

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/datasources/DATASOURCE_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"source":{"name":"datasources/DATASOURCE_ID","displayName":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

검색 애플리케이션의 썸네일 URL 사용 설정

검색 애플리케이션에서 썸네일도 사용 설정해야 합니다.

1. 이전 섹션에 설명된 것과 동일한 방법으로 API 키와 액세스 토큰을 가져옵니다.

2. settings.searchapplications.get를 호출하여 애플리케이션 ID를 가져옵니다.

   curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

3. returnResultThumbnailUrls이 true로 설정된 상태로 settings.searchapplications.update를 호출합니다.

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
   --compressed
   

썸네일 액세스

Drive 파일의 썸네일에 액세스하려면 사용자 또는 애플리케이션이 원본 항목에 액세스하는 데 사용한 것과 동일한 계정 사용자 인증 정보를 사용해야 합니다.