Habilitar miniaturas

Las miniaturas ayudan a los usuarios a identificar resultados de la búsqueda relevantes. Tienen las siguientes características:

• Ancho de 1024 px
• Las URLs de las miniaturas de archivos de Google Workspace están protegidas por ACL. Otros tipos de archivos no lo están.
• Las URLs vencen después de 5 minutos.
• El tamaño máximo de archivo para la generación es de 50 MB.
• Si falla la generación, Cloud Search muestra un ícono de marcador de posición. En el caso de los elementos de Google Workspace, la URL muestra "404 Not Found". Tu aplicación debe controlar esto.

Google Drive crea automáticamente miniaturas para tipos compatibles, como Documentos, Hojas de Cálculo y Presentaciones. Cloud Search también genera miniaturas para lo siguiente:

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

Cloud Search solo muestra miniaturas de elementos cuando habilitas las miniaturas para la fuente de datos y la aplicación de búsqueda.

Habilita las URLs de miniaturas para una fuente de datos

Para habilitar las URLs de miniaturas, crea una clave de API y credenciales de aplicación web. Úsalas para obtener un token de acceso para actualizar tu fuente de datos.

1. Crea o selecciona un proyecto y habilita la API. Consulta Configura el acceso a la API de Cloud Search.
2. Crea una clave de API en la consola de Google Cloud y anota el valor.
3. Crea credenciales de aplicación web. Usa https://developers.google.com/oauthplayground como el URI de redireccionamiento. Consulta Crea credenciales.
4. En el OAuth 2.0 Playground, abre la configuración de OAuth 2.0 Configuration .
5. Selecciona Use your own credentials y, luego, ingresa tu ID de cliente y secreto.
6. Ingresa https://www.googleapis.com/auth/cloud_search.settings en el campo de alcances y haz clic en Authorize APIs.
7. Intercambia el código de autorización por tokens.

8. Llama a settings.datasources.get para obtener el ID de tu fuente de datos:

   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. Llama a settings.datasources.update con returnThumbnailUrls configurado como 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
   

Habilita las URLs de miniaturas para una aplicación de búsqueda

También debes habilitar las miniaturas en tu aplicación de búsqueda.

1. Obtén una clave de API y un token de acceso con el mismo método que se describe en la sección anterior.

2. Llama a settings.searchapplications.get para obtener el ID de tu aplicación:

   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. Llama a settings.searchapplications.update con returnResultThumbnailUrls configurado como 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
   

Accede a las miniaturas

Para acceder a una miniatura de un archivo de Drive, el usuario o la aplicación deben usar las mismas credenciales de la cuenta que se usaron para acceder al elemento original.