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

Habilitar miniaturas

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

Ancho de 1,024 px.
La URL de las miniaturas de los archivos de Google Workspace está protegida por LCA. La URL para que otros tipos de archivos no estén protegidos por LCA.
Las URLs vencen después de 5 minutos.
Las miniaturas no se generan para archivos que superan los 50 MB.
Si no se puede generar una miniatura, se usará un ícono de marcador de posición. Si se muestra una miniatura para un elemento de Google Workspace, la URL de la miniatura muestra “404 No encontrado”. Tu aplicación debe controlar este comportamiento.

Las miniaturas se crean automáticamente para los archivos de Google Drive que Admiten miniaturas, como los tipos de documentos de Google Workspace (Documentos, Hojas de cálculo, Presentaciones, etc.). Además, Cloud Search crea miniaturas automáticamente 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 marcado de hipertexto (HTML)
Lenguaje de marcación extensible (XML)

Las miniaturas solo se muestran para los elementos cuya fuente de datos y aplicaciones de búsqueda. tenerlos habilitados.

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

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

Si aún no lo hiciste, crea o selecciona un proyecto para tu app y habilítalo 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. La "Clave de API creada" .
2. Anota la clave de API.
3. Haga clic en Cerrar. La credencial nueva aparecerá en “Claves de API”.
Crear credenciales de aplicaciones web Usar https://developers.google.com/oauthplayground como el URI de redireccionamiento. . Si quieres conocer los pasos para crear estas credenciales, consulta Crea credenciales de aplicaciones web (JavaScript del cliente).
En el Playground de OAuth 2.0, Haz clic en Configuración de OAuth 2.0 .
Marca la opción Use your own credentials.
Ingresa el ID de cliente y el secreto del 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 la pantalla de acceso, selecciona la cuenta que deseas 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 la miniatura controles de seguridad.

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

Aquí:

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

El resultado exitoso 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 de miniatura para los datos fuente:

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

Aquí:

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

El resultado exitoso de este comando es similar al siguiente:

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

Cómo habilitar las URLs de miniaturas para una aplicación de búsqueda

Si aún no lo hiciste, crea o selecciona un proyecto para tu app y habilítalo 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. La "Clave de API creada" .
2. Anota la clave de API.
3. Haga clic en Cerrar. La credencial nueva aparecerá en “Claves de API”.
Crear credenciales de aplicaciones web Usar https://developers.google.com/oauthplayground como el URI de redireccionamiento. . Si quieres conocer los pasos para crear estas credenciales, consulta Crea credenciales de aplicaciones web (JavaScript del cliente).
En el Playground de OAuth 2.0, Haz clic en Configuración de OAuth 2.0 .
Marca la opción Use your own credentials.
Ingresa el ID de cliente y el secreto del 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 la pantalla de acceso, selecciona la cuenta que deseas 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

Aquí:

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

El resultado exitoso 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 para habilitar las URLs de miniaturas para el 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

Aquí:

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

El resultado exitoso de este comando es similar al siguiente:

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

Acceder a las miniaturas

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