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 hanno le seguenti caratteristiche:

Larghezza di 1024 px.
L'URL per le miniature dei file di Google Workspace è protetto da ACL. L'URL di 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". L'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 le 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 testo (TXT)
Hypertext Markup Language (HTML)
XML (Extensible Markup Language)

Le miniature vengono restituite solo per gli elementi per cui sono state attivate nelle origini dati e nelle 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 abilitare gli URL in miniatura, 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, utilizzerai queste credenziali per recuperare e aggiornare un'origine dati.

Se non lo hai già fatto, crea o seleziona un progetto per la tua app e abilita 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 nella sezione "Chiavi API".
Crea le credenziali per l'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Creare credenziali per applicazione web (JavaScript lato client).
In OAuth 2.0 Playground, fai clic su OAuth 2.0 Configuration .
Seleziona Use your own credentials (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 visualizzi una schermata di accesso, seleziona l'account da utilizzare.
(Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta.
Fai clic su Exchange authorization code for tokens (Scambia codice di autorizzazione per i token). Viene restituito un token.
Identifica l'origine dati per cui vuoi abilitare 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 indica il nome dell'origine dati da recuperare.
YOUR_API_KEY è la chiave API per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo progetto (ottenuto nel passaggio 10).

Il risultato corretto di questo comando è simile al seguente:

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

Chiamata setting.datasource.update con returnThumbnailUrls impostato su true per attivare gli URL delle miniature 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 indica l'ID dell'origine dati da recuperare.
YOUR_API_KEY è la chiave API per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo progetto (ottenuto nel passaggio 10).
DataSource_DisplayName è il nome visualizzato restituito dal precedente comando cURL.
"returnThumbnailsUrls":true attiva le miniature.

Il risultato corretto 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

Se non lo hai già fatto, crea o seleziona un progetto per la tua app e abilita 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 nella sezione "Chiavi API".
Crea le credenziali per l'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Creare credenziali per applicazione web (JavaScript lato client).
In OAuth 2.0 Playground, fai clic su OAuth 2.0 Configuration .
Seleziona Use your own credentials (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 visualizzi una schermata di accesso, seleziona l'account da utilizzare.
(Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta.
Fai clic su Exchange authorization code for tokens (Scambia codice di autorizzazione per i token). Viene restituito un token.
Identifica l'applicazione di ricerca per la quale vuoi attivare i controlli delle miniature.

Chiama il numero 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 per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo progetto (ottenuto nel passaggio 10).

Il risultato corretto 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 per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo progetto (ottenuto nel passaggio 10).
SearchApp_DisplayName è il nome visualizzato restituito dal precedente comando cURL.
"returnResultThumbnailUrls":true attiva le miniature.

Il risultato corretto 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 passare le stesse credenziali dell'account che utilizzano per accedere all'elemento su Google Drive.