미리보기 이미지 사용

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

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

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