이 페이지는 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)
서식 있는 텍스트 (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 키' 아래에 표시됩니다.
웹 애플리케이션 사용자 인증 정보를 만듭니다. 리디렉션 URI로 https://developers.google.com/oauthplayground를 사용합니다. . 이러한 사용자 인증 정보를 만드는 단계는 웹 애플리케이션 사용자 인증 정보 만들기 (클라이언트 측 자바스크립트)를 참조하세요.
OAuth 2.0 플레이그라운드에서 OAuth 2.0 구성 을 클릭합니다.
자체 사용자 인증 정보 사용을 선택합니다.
3단계에서 생성한 클라이언트 ID와 클라이언트 비밀번호를 입력합니다.
범위 필드에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
(선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
(선택사항) 승인 화면이 표시되면 수락을 클릭합니다.
Exchange 인증 코드를 토큰으로 교환을 클릭합니다. 토큰이 반환됩니다.
썸네일 컨트롤을 사용 설정할 데이터 소스를 확인합니다.
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 키' 아래에 표시됩니다.
웹 애플리케이션 사용자 인증 정보를 만듭니다. 리디렉션 URI로 https://developers.google.com/oauthplayground를 사용합니다. . 이러한 사용자 인증 정보를 만드는 단계는 웹 애플리케이션 사용자 인증 정보 만들기 (클라이언트 측 자바스크립트)를 참조하세요.
OAuth 2.0 플레이그라운드에서 OAuth 2.0 구성 을 클릭합니다.
자체 사용자 인증 정보 사용을 선택합니다.
3단계에서 생성한 클라이언트 ID와 클라이언트 비밀번호를 입력합니다.
범위 필드에 https://www.googleapis.com/auth/cloud_search.settings를 입력하고 API 승인을 클릭합니다.
(선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
(선택사항) 승인 화면이 표시되면 수락을 클릭합니다.
Exchange 인증 코드를 토큰으로 교환을 클릭합니다. 토큰이 반환됩니다.
썸네일 컨트롤을 사용 설정할 검색 애플리케이션을 식별합니다.

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의 항목에 액세스하는 데 사용하는 것과 동일한 계정 사용자 인증 정보를 전달해야 합니다.