Attiva miniature

Le miniature aiutano gli utenti a identificare i risultati di ricerca pertinenti. Hanno le seguenti caratteristiche:

  • Larghezza di 1024 px.
  • Gli URL delle miniature dei file di Google Workspace sono protetti da ACL. Altri tipi di file non lo sono.
  • Gli URL scadono dopo 5 minuti.
  • La dimensione massima del file per la generazione è 50 MB.
  • Se la generazione non va a buon fine, Cloud Search restituisce un'icona segnaposto. Per gli elementi di Google Workspace, l'URL restituisce "404 Not Found". La tua applicazione deve gestire questo aspetto.

Google Drive crea automaticamente miniature per i tipi supportati come Documenti, Fogli e Presentazioni. Cloud Search genera anche miniature per:

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

Cloud Search restituisce le miniature degli elementi solo quando le attivi per l'origine dati e l'applicazione di ricerca.

Attivare gli URL delle miniature per un'origine dati

Per attivare gli URL delle miniature, crea una chiave API e le credenziali dell'applicazione web. Utilizzali per ottenere un token di accesso per aggiornare l'origine dati.

  1. Crea o seleziona un progetto e abilita l'API. Consulta Configurare l'accesso all'API Cloud Search.
  2. Crea una chiave API nella console Google Cloud e annota il valore.
  3. Crea le credenziali dell'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. Vedi Crea credenziali.
  4. In OAuth 2.0 Playground, apri Configurazione OAuth 2.0 .
  5. Seleziona Usa le tue credenziali e inserisci l'ID client e il client secret.
  6. Inserisci https://www.googleapis.com/auth/cloud_search.settings nel campo degli ambiti e fai clic su Autorizza API.
  7. Scambia il codice di autorizzazione con i token.

  8. Chiama il numero settings.datasources.get per ottenere l'ID origine dati:

    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. Chiamata a settings.datasources.update con returnThumbnailUrls impostato su 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

Attivare gli URL delle miniature per un'applicazione di ricerca

Devi anche attivare le miniature nell'applicazione di ricerca.

  1. Ottieni una chiave API e un token di accesso utilizzando lo stesso metodo descritto nella sezione precedente.

  2. Chiama il numero settings.searchapplications.get per ottenere l'ID applicazione:

    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. Chiama settings.searchapplications.update con returnResultThumbnailUrls impostato su 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

Accedere alle miniature

Per accedere a una miniatura di un file di Drive, l'utente o l'applicazione deve utilizzare le stesse credenziali dell'account utilizzate per accedere all'elemento originale.