Se usó la API de Cloud Translation para traducir esta página.

Habilitar miniaturas

Se muestran miniaturas de los documentos que se muestran en los resultados de la búsqueda. Las miniaturas permiten al usuario identificar mejor la relevancia de los documentos que se muestran. Las miniaturas tienen las siguientes características:

Ancho: 1024 px.
La URL de las miniaturas de los archivos de Google Workspace está protegida por LCA. La URL de otros tipos de archivos no está protegida por LCA.
Las URLs vencen después de 5 minutos.
Las miniaturas no se generan para archivos de más de 50 MB.
Si no se puede generar una miniatura, se usa un ícono de marcador de posición. Si no se puede generar una miniatura para un elemento de Google Workspace, la URL de la miniatura muestra el mensaje "404 Not Found". Tu aplicación debe controlar este comportamiento.

Las miniaturas se crean automáticamente para los archivos de Google Drive que admiten miniaturas de forma natural, como los tipos de documentos de Google Workspace (Documentos, Hojas de cálculo, Presentaciones, etcétera). Además, Cloud Search crea automáticamente miniaturas para los siguientes tipos de archivos:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint (PPTX)
Formato de documento portátil de Adobe (PDF)
Formato de Texto Enriquecido (RTF)
Formato de Texto (TXT)
Lenguaje de marcación de hipertexto (HTML)
Lenguaje de marcación extensible (XML)

Las miniaturas solo se muestran para los elementos cuyas fuentes de datos y aplicaciones de búsqueda las tienen habilitadas.

Cómo habilitar URLs en miniatura para una fuente de datos

Tu proyecto de plataforma de Cloud Search contiene credenciales de cuentas de servicio. Sin embargo, para habilitar las URL de miniaturas, debes crear una clave de API y credenciales de aplicación web, y usar las credenciales de la aplicación web para obtener un token de acceso. Por último, utiliza estas credenciales para obtener y actualizar una fuente de datos.

Si aún no lo has hecho, crea o selecciona un proyecto para tu app y habilita la API. Para obtener información sobre estos dos pasos, consulta los pasos 1 y 2 de Configura el acceso a la API de Google Cloud Search.
Crea una clave de API:
1. En la consola de Google Cloud, haz clic en la lista desplegable Crear credenciales y selecciona Clave de API. Aparecerá la página "Se creó la clave de API".
2. Anota la clave de API.
3. Haga clic en Cerrar. La credencial creada recientemente aparecerá en "Claves de API".
Crear credenciales de aplicación web Usa https://developers.google.com/oauthplayground como URI de redireccionamiento. . Si quieres conocer los pasos para crear estas credenciales, consulta Crea credenciales de aplicación web (JavaScript del cliente).
En OAuth 2.0 Playground, haz clic en Configuración de OAuth 2.0 .
Marca Usa tus propias credenciales.
Ingresa el ID de cliente y el secreto de cliente generados en el paso 3.
En el campo de permisos, escribe https://www.googleapis.com/auth/cloud_search.settings y haz clic en Autorizar APIs.
(Opcional) Si aparece una pantalla de acceso, selecciona la cuenta que quieres usar.
Opcional: Si aparece una pantalla de autorización, haz clic en Aceptar.
Haz clic en Intercambiar código de autorización para tokens. Se muestra un token.
Identifica la fuente de datos para la que deseas habilitar los controles de miniaturas.

Llama a settings.datasources.get para obtener el ID de la 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

Donde:

datastore_id es el nombre de la fuente de datos que se recuperará.
YOUR_API_KEY es la clave de API de tu proyecto (obtenida en el paso 2).
YOUR_ACCESS_TOKEN es el token de acceso de OAuth 2.0 para tu proyecto (obtenido en el paso 10).

El resultado correcto de este comando es similar al siguiente:

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

Llama a setting.datasource.update con returnThumbnailUrls establecido en true para habilitar las URLs en miniatura de la fuente de datos:

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

Donde:

datastore_id es el ID de la fuente de datos que se recuperará.
YOUR_API_KEY es la clave de API de tu proyecto (obtenida en el paso 2).
YOUR_ACCESS_TOKEN es el token de acceso de OAuth 2.0 para tu proyecto (obtenido en el paso 10).
DataSource_DisplayName es el nombre visible que muestra el comando cURL anterior.
"returnThumbnailsUrls":true habilita las miniaturas.

El resultado correcto de este comando es similar al siguiente:

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

Habilitar URLs en miniatura para una aplicación de búsqueda

Tu proyecto de plataforma de Cloud Search contiene credenciales de cuentas de servicio. Sin embargo, para habilitar las URL de miniaturas, debes crear una clave de API y credenciales de aplicación web, y usar las credenciales de la aplicación web para obtener un token de acceso. Por último, usarás estas credenciales para obtener y actualizar una aplicación de búsqueda.

Si aún no lo has hecho, crea o selecciona un proyecto para tu app y habilita la API. Para obtener información sobre estos dos pasos, consulta los pasos 1 y 2 de Configura el acceso a la API de Google Cloud Search.
Crea una clave de API:
1. En la consola de Cloud, haz clic en la lista desplegable Crear credenciales y selecciona Clave de API. Aparecerá la página "Se creó la clave de API".
2. Anota la clave de API.
3. Haga clic en Cerrar. La credencial creada recientemente aparecerá en "Claves de API".
Crear credenciales de aplicación web Usa https://developers.google.com/oauthplayground como URI de redireccionamiento. . Si quieres conocer los pasos para crear estas credenciales, consulta Crea credenciales de aplicación web (JavaScript del cliente).
En OAuth 2.0 Playground, haz clic en Configuración de OAuth 2.0 .
Marca Usa tus propias credenciales.
Ingresa el ID de cliente y el secreto de cliente generados en el paso 3.
En el campo de permisos, escribe https://www.googleapis.com/auth/cloud_search.settings y haz clic en Autorizar APIs.
(Opcional) Si aparece una pantalla de acceso, selecciona la cuenta que quieres usar.
Opcional: Si aparece una pantalla de autorización, haz clic en Aceptar.
Haz clic en Intercambiar código de autorización para tokens. Se muestra un token.
Identifica la aplicación de búsqueda para la que deseas habilitar los controles de miniaturas.

Llama a settings.searchapplications.get para obtener el ID de la aplicación de búsqueda:

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

Donde:

es el ID de la aplicación de búsqueda que se recuperará.
YOUR_API_KEY es la clave de API de tu proyecto (obtenida en el paso 2).
YOUR_ACCESS_TOKEN es el token de acceso de OAuth 2.0 para tu proyecto (obtenido en el paso 10).

El resultado correcto de este comando es similar al siguiente:

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

Llama a setting.searchapplications.update con returnResultThumbnailUrls establecido en true a fin de habilitar las URL en miniatura para la aplicación de búsqueda:

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

Donde:

es el ID de la aplicación de búsqueda que se recuperará.
YOUR_API_KEY es la clave de API de tu proyecto (obtenida en el paso 2).
YOUR_ACCESS_TOKEN es el token de acceso de OAuth 2.0 para tu proyecto (obtenido en el paso 10).
SearchApp_DisplayName es el nombre visible que muestra el comando cURL anterior.
"returnResultThumbnailUrls":true habilita las miniaturas.

El resultado correcto de este comando es similar al siguiente:

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

Cómo acceder a las miniaturas

Para acceder a una miniatura de un archivo de Google Workspace en Drive, el usuario o la aplicación debe pasar las mismas credenciales de la cuenta que usa para acceder al elemento en Google Drive.