이 페이지는 Cloud Translation API를 통해 번역되었습니다.

미리보기 이미지 사용

검색 결과에서 반환된 문서에 썸네일이 표시됩니다. 썸네일을 사용하면 사용자가 반환된 문서의 관련성을 더 잘 파악할 수 있습니다. 썸네일의 특성은 다음과 같습니다.

너비가 1,024픽셀입니다.
Google Workspace 파일 썸네일의 URL은 ACL로 보호됩니다. 다른 파일 형식의 URL이 ACL로 보호되지 않음
URL은 5분 후에 만료됩니다.
파일 크기가 50MB를 초과하면 썸네일이 생성되지 않습니다.
썸네일을 생성할 수 없는 경우 자리표시자 아이콘이 사용됩니다. Google Workspace 항목의 썸네일을 생성할 수 없는 경우 썸네일 URL에 '404 Not Found'가 반환됩니다. 애플리케이션에서 이 동작을 처리해야 합니다.

Google Workspace 문서 유형 (Docs, Sheets, Slides 등)과 같이 썸네일을 자연스럽게 지원하는 Google Drive 파일의 경우 썸네일이 자동으로 생성됩니다. 또한 Cloud Search는 다음 파일 형식의 썸네일을 자동으로 만듭니다.

Microsoft Word (DOC)
Microsoft Word(DOCX)
Microsoft Excel (XLS)
Microsoft Excel(XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint(PPTX)
Adobe Portable Document Format (PDF)
Rich Text Format (RTF)
텍스트 형식 (TXT)
하이퍼텍스트 마크업 언어 (HTML)
확장 가능한 마크업 언어 (XML)

썸네일은 데이터 소스와 검색 애플리케이션에서 사용 설정한 항목에 대해서만 반환됩니다.

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

Cloud Search Platform 프로젝트에 서비스 계정 사용자 인증 정보가 포함되어 있습니다. 하지만 썸네일 URL을 사용 설정하려면 API 키와 웹 애플리케이션 사용자 인증 정보를 만들고 웹 애플리케이션 사용자 인증 정보를 사용하여 액세스 토큰을 가져와야 합니다. 마지막으로 이 사용자 인증 정보를 사용하여 데이터 소스를 가져오고 업데이트합니다.

아직 앱의 프로젝트를 만들지 않았다면 프로젝트를 만들거나 선택하고 API를 사용 설정합니다. 이 두 단계에 대한 자세한 내용은 Google Cloud Search API에 대한 액세스 구성의 1단계와 2단계를 참고하세요.
API 키를 만듭니다.
1. Google Cloud 콘솔에서 사용자 인증 정보 만들기 드롭다운 목록을 클릭하고 API 키를 선택합니다. 'API 키 생성 완료' 페이지가 표시됩니다.
2. API 키를 기록합니다.
3. 닫기를 클릭합니다. 새로 생성된 사용자 인증 정보가 'API 키' 아래에 표시됩니다.
웹 애플리케이션 사용자 인증 정보를 만듭니다. https://developers.google.com/oauthplayground을 리디렉션 URI로 사용합니다. . 이러한 사용자 인증 정보를 만드는 단계는 웹 애플리케이션 사용자 인증 정보 만들기 (클라이언트 측 JavaScript)를 참고하세요.
OAuth 2.0 플레이그라운드에서 OAuth 2.0 구성 을 클릭합니다.
자체 사용자 인증 정보 사용을 선택합니다.
3단계에서 생성된 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
범위 입력란에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
(선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
(선택사항) 승인 화면이 표시되면 수락을 클릭합니다.
승인 코드를 토큰으로 교환을 클릭합니다. 토큰이 반환됩니다.
썸네일 컨트롤을 사용 설정할 데이터 소스를 식별합니다.
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
```
각 항목의 의미는 다음과 같습니다.
- datasource_id는 가져올 데이터 소스의 이름입니다.
- YOUR_API_KEY는 프로젝트의 API 키입니다 (2단계에서 가져옴).
- YOUR_ACCESS_TOKEN는 프로젝트의 OAuth 2.0 액세스 토큰입니다 (10단계에서 가져옴).
이 명령어의 성공 결과는 다음과 유사합니다.
```
{
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}
```

returnThumbnailUrls을 true로 설정하여 setting.datasource.update를 호출하여 데이터 소스의 썸네일 URL을 사용 설정합니다.

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":"DataSource_Display_Name","itemsVisibility":
    [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
  --compressed

각 항목의 의미는 다음과 같습니다.

datasource_id는 가져올 데이터 소스의 ID입니다.
YOUR_API_KEY는 프로젝트의 API 키입니다 (2단계에서 가져옴).
YOUR_ACCESS_TOKEN는 프로젝트의 OAuth 2.0 액세스 토큰입니다 (10단계에서 가져옴).
DataSource_DisplayName는 이전 cURL 명령어에서 반환된 표시 이름입니다.
"returnThumbnailsUrls":true는 썸네일을 사용 설정합니다.

이 명령어의 성공 결과는 다음과 유사합니다.

{
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

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

Cloud Search Platform 프로젝트에 서비스 계정 사용자 인증 정보가 포함되어 있습니다. 하지만 썸네일 URL을 사용 설정하려면 API 키와 웹 애플리케이션 사용자 인증 정보를 만들고 웹 애플리케이션 사용자 인증 정보를 사용하여 액세스 토큰을 가져와야 합니다. 마지막으로 이러한 사용자 인증 정보를 사용하여 검색 애플리케이션을 가져오고 업데이트합니다.

아직 앱의 프로젝트를 만들지 않았다면 프로젝트를 만들거나 선택하고 API를 사용 설정합니다. 이 두 단계에 대한 자세한 내용은 Google Cloud Search API에 대한 액세스 구성의 1단계와 2단계를 참고하세요.
API 키를 만듭니다.
1. Cloud 콘솔에서 사용자 인증 정보 만들기 드롭다운 목록을 클릭하고 API 키를 선택합니다. 'API 키 생성 완료' 페이지가 표시됩니다.
2. API 키를 기록합니다.
3. 닫기를 클릭합니다. 새로 생성된 사용자 인증 정보가 'API 키' 아래에 표시됩니다.
웹 애플리케이션 사용자 인증 정보를 만듭니다. https://developers.google.com/oauthplayground을 리디렉션 URI로 사용합니다. . 이러한 사용자 인증 정보를 만드는 단계는 웹 애플리케이션 사용자 인증 정보 만들기 (클라이언트 측 JavaScript)를 참고하세요.
OAuth 2.0 플레이그라운드에서 OAuth 2.0 구성 을 클릭합니다.
자체 사용자 인증 정보 사용을 선택합니다.
3단계에서 생성된 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
범위 입력란에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
(선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
(선택사항) 승인 화면이 표시되면 수락을 클릭합니다.
승인 코드를 토큰으로 교환을 클릭합니다. 토큰이 반환됩니다.
썸네일 컨트롤을 사용 설정할 검색 애플리케이션을 식별합니다.

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

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

각 항목의 의미는 다음과 같습니다.

는 검색할 검색 애플리케이션의 ID입니다.
YOUR_API_KEY는 프로젝트의 API 키입니다 (2단계에서 가져옴).
YOUR_ACCESS_TOKEN는 프로젝트의 OAuth 2.0 액세스 토큰입니다 (10단계에서 가져옴).

이 명령어의 성공 결과는 다음과 유사합니다.

{
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}

returnResultThumbnailUrls를 true로 설정하여 setting.searchapplications.update를 호출하여 검색 애플리케이션의 썸네일 URL을 사용 설정합니다.

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

각 항목의 의미는 다음과 같습니다.

는 검색할 검색 애플리케이션의 ID입니다.
YOUR_API_KEY는 프로젝트의 API 키입니다 (2단계에서 가져옴).
YOUR_ACCESS_TOKEN는 프로젝트의 OAuth 2.0 액세스 토큰입니다 (10단계에서 가져옴).
SearchApp_DisplayName는 이전 cURL 명령어에서 반환된 표시 이름입니다.
"returnResultThumbnailUrls":true는 썸네일을 사용 설정합니다.

이 명령어의 성공 결과는 다음과 유사합니다.

{
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

썸네일 액세스

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