Включить миниатюры

Миниатюры помогают пользователям определять релевантные результаты поиска. Они обладают следующими характеристиками:

• Ширина 1024 пикселя.
• URL-адреса для миниатюр файлов в Google Workspace защищены ACL. Для других типов файлов такой защиты нет.
• Срок действия URL-адресов истекает через 5 минут.
• Максимальный размер файла для генерации составляет 50 МБ.
• Если генерация не удалась, Cloud Search возвращает значок-заполнитель. Для элементов Google Workspace URL-адрес возвращает ошибку "404 Not Found". Ваше приложение должно обрабатывать это.

Google Drive автоматически создает эскизы для поддерживаемых типов документов, таких как «Документы», «Таблицы» и «Презентации». Облачный поиск также генерирует эскизы для:

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

Облачный поиск отображает миниатюры элементов только в том случае, если вы включили отображение миниатюр для источника данных и поискового приложения.

Включить отображение URL-адресов миниатюр для источника данных

Чтобы включить отображение URL-адресов миниатюр, создайте ключ API и учетные данные веб-приложения. Используйте их для получения токена доступа для обновления источника данных.

1. Создайте или выберите проект и включите API. См. раздел «Настройка доступа к API Cloud Search» .
2. Создайте ключ API в консоли Google Cloud и запишите его значение.
3. Создайте учетные данные для веб-приложения. Используйте https://developers.google.com/oauthplayground в качестве URI перенаправления. См. раздел «Создание учетных данных» .
4. В среде разработки OAuth 2.0 Playground откройте конфигурации OAuth 2.0 .
5. Выберите « Использовать свои учетные данные» и введите свой идентификатор клиента и секретный ключ.
6. В поле «Области действия» введите https://www.googleapis.com/auth/cloud_search.settings и нажмите «Авторизовать API» .
7. Обменяйте код авторизации на токены.

8. Для получения идентификатора источника данных вызовите settings.datasources.get :

   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. Вызовите settings.datasources.update с returnThumbnailUrls , установленным в true :

   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 :

   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. Вызовите settings.searchapplications.update с returnResultThumbnailUrls , установленным в true :

   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
   

Доступ к миниатюрам

Для доступа к миниатюре файла в Google Диска пользователь или приложение должны использовать те же учетные данные, которые использовались для доступа к исходному файлу.