Habilitar miniaturas

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

• Ancho de 1,024 px
• Las URLs de las miniaturas de archivos de Google Workspace están protegidas por ACL. Los demás tipos de archivos no lo son.
• Las URLs vencen después de 5 minutos.
• El tamaño máximo del 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 devuelve el error "404 Not Found". Tu aplicación debe controlar esta situación.

Google Drive crea automáticamente miniaturas para los tipos admitidos, como Documentos, Hojas de cálculo y Presentaciones. Cloud Search también genera miniaturas para los siguientes elementos:

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

Cloud Search solo muestra miniaturas de los 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. Úsalos para obtener un token de acceso y 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 URI de redireccionamiento. Consulta Crea credenciales.
4. En OAuth 2.0 Playground, abre Configuración de OAuth 2.0 .
5. Selecciona Usa tus propias credenciales y, luego, ingresa tu ID de cliente y tu secreto.
6. Ingresa https://www.googleapis.com/auth/cloud_search.settings en el campo de permisos y haz clic en Autorizar 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 establecido en 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 establecido en 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
   

Cómo acceder a las miniaturas

Para acceder a la 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.