Questa pagina è stata tradotta dall'API Cloud Translation.

Attiva miniature

Le miniature vengono mostrate per i documenti restituiti dai risultati di ricerca. Le miniature consentono all'utente di identificare meglio la pertinenza dei documenti restituiti. Le miniature devono avere le seguenti caratteristiche:

Larghezza di 1024 px.
L'URL per le miniature dei file di Google Workspace è protetto da ACL. L'URL per altri tipi di file non è protetto da ACL
Gli URL scadono dopo 5 minuti.
Le miniature non vengono generate per i file di dimensioni superiori a 50 MB.
Se non è possibile generare una miniatura, viene utilizzata un'icona segnaposto. Se non è possibile generare una miniatura per un elemento di Google Workspace, l'URL della miniatura restituisce "404 Not Found". La tua applicazione deve gestire questo comportamento.

Le miniature vengono create automaticamente per i file di Google Drive che supportano naturalmente le miniature, ad esempio i tipi di documenti di Google Workspace (Documenti, Fogli, Presentazioni e così via). Inoltre, Cloud Search crea automaticamente miniature per i seguenti tipi di file:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint (PPTX)
Adobe Portable Document Format (PDF)
Rich Text Format (RTF)
Formato di testo (TXT)
Hypertext Markup Language (HTML)
Extensible Markup Language (XML)

Le miniature vengono restituite solo per gli elementi per i quali sono attivate le origini dati e le applicazioni di ricerca.

Attivare gli URL delle miniature per un'origine dati

Il progetto della piattaforma Cloud Search contiene le credenziali dell'account di servizio. Tuttavia, per attivare gli URL delle miniature, devi creare una chiave API e le credenziali dell'applicazione web e utilizzare le credenziali dell'applicazione web per ottenere un token di accesso. Infine, utilizza queste credenziali per recuperare e aggiornare un'origine dati.

Se non l'hai ancora fatto, crea o seleziona un progetto per la tua app e attiva l'API. Per informazioni su questi due passaggi, consulta i passaggi 1 e 2 di Configurare l'accesso all'API Google Cloud Search.
Crea una chiave API:
1. Nella console Google Cloud, fai clic sull'elenco a discesa Crea credenziali e seleziona Chiave API. Viene visualizzata la pagina "Chiave API creata".
2. Prendi nota della chiave API.
3. Fai clic su Chiudi. La credenziale appena creata viene visualizzata in "Chiavi API".
Crea le credenziali dell'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per la procedura di creazione di queste credenziali, consulta Creare credenziali per le applicazioni web (JavaScript lato client).
In OAuth 2.0 Playground, fai clic su Configurazione OAuth 2.0 .
Seleziona Usa le tue credenziali.
Inserisci l'ID client e il client secret generati nel passaggio 3.
Nel campo degli ambiti, digita https://www.googleapis.com/auth/cloud_search.settings e fai clic su Autorizza API.
(Facoltativo) Se viene visualizzata una schermata di accesso, seleziona l'account da utilizzare.
(Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta.
Fai clic su Scambia codice di autorizzazione per i token. Viene restituito un token.
Identifica l'origine dati per la quale vuoi attivare i controlli delle miniature.

Chiama settings.datasources.get per ottenere l'ID dell'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

Dove:

datasource_id è il nome dell'origine dati da recuperare.
YOUR_API_KEY è la chiave API del tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il progetto (ottenuto dal passaggio 10).

Il risultato positivo di questo comando è simile al seguente:

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

Chiama setting.datasource.update con returnThumbnailUrls impostato su true per attivare gli URL miniatura per l'origine dati:

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

Dove:

datasource_id è l'ID dell'origine dati da recuperare.
YOUR_API_KEY è la chiave API del tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il progetto (ottenuto dal passaggio 10).
DataSource_DisplayName è il nome visualizzato restituito dal precedente comando cURL.
"returnThumbnailsUrls":true attiva le miniature.

Il risultato positivo di questo comando è simile al seguente:

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

Attivare gli URL delle miniature per un'applicazione di ricerca

Il progetto della piattaforma Cloud Search contiene le credenziali dell'account di servizio. Tuttavia, per attivare gli URL delle miniature, devi creare una chiave API e le credenziali dell'applicazione web e utilizzare le credenziali dell'applicazione web per ottenere un token di accesso. Infine, utilizzi queste credenziali per ottenere e aggiornare un'applicazione di ricerca.

Se non l'hai ancora fatto, crea o seleziona un progetto per la tua app e attiva l'API. Per informazioni su questi due passaggi, consulta i passaggi 1 e 2 di Configurare l'accesso all'API Google Cloud Search.
Crea una chiave API:
1. Nella console Cloud, fai clic sull'elenco a discesa Crea credenziali e seleziona Chiave API. Viene visualizzata la pagina "Chiave API creata".
2. Prendi nota della chiave API.
3. Fai clic su Chiudi. La credenziale appena creata viene visualizzata in "Chiavi API".
Crea le credenziali dell'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per la procedura di creazione di queste credenziali, consulta Creare credenziali per le applicazioni web (JavaScript lato client).
In OAuth 2.0 Playground, fai clic su Configurazione OAuth 2.0 .
Seleziona Usa le tue credenziali.
Inserisci l'ID client e il client secret generati nel passaggio 3.
Nel campo degli ambiti, digita https://www.googleapis.com/auth/cloud_search.settings e fai clic su Autorizza API.
(Facoltativo) Se viene visualizzata una schermata di accesso, seleziona l'account da utilizzare.
(Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta.
Fai clic su Scambia codice di autorizzazione per i token. Viene restituito un token.
Identifica l'applicazione di ricerca per cui vuoi attivare i controlli delle miniature.

Chiama settings.searchapplications.get per ottenere l'ID dell'applicazione di ricerca:

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

Dove:

è l'ID dell'applicazione di ricerca da recuperare.
YOUR_API_KEY è la chiave API del tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il progetto (ottenuto dal passaggio 10).

Il risultato positivo di questo comando è simile al seguente:

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

Chiama setting.searchapplications.update con returnResultThumbnailUrls impostato su true per attivare gli URL delle miniature per l' applicazione di ricerca:

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

Dove:

è l'ID dell'applicazione di ricerca da recuperare.
YOUR_API_KEY è la chiave API del tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il progetto (ottenuto dal passaggio 10).
SearchApp_DisplayName è il nome visualizzato restituito dal precedente comando cURL.
"returnResultThumbnailUrls":true attiva le miniature.

Il risultato positivo di questo comando è simile al seguente:

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

Accedere alle miniature

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