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 delle 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 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 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 cui sono attivate l'origine dati e le applicazioni di ricerca.

Attivare gli URL delle miniature per un'origine dati

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

Se non l'hai ancora 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 in "Chiavi API".
Crea le credenziali dell'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Creare credenziali dell'applicazione 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 Exchange authorization code for tokens (Scambio codice di autorizzazione per i token). Viene restituito un token.
Identifica l'origine dati per la quale vuoi attivare i controlli delle miniature.

Chiama il numero 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 per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo 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 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 è 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 dal passaggio 10).
DataSource_DisplayName è il nome visualizzato restituito dal comando cURL precedente.
"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

Se non l'hai ancora 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 in "Chiavi API".
Crea le credenziali dell'applicazione web. Utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Creare credenziali dell'applicazione 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 Exchange authorization code for tokens (Scambio 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 per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo 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 per il tuo progetto (ottenuta nel passaggio 2).
YOUR_ACCESS_TOKEN è il token di accesso OAuth 2.0 per il tuo progetto (ottenuto dal passaggio 10).
SearchApp_DisplayName è il nome visualizzato restituito dal comando cURL precedente.
"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 Google Workspace in Drive, l'utente o l'applicazione deve superare le stesse credenziali dell'account che utilizza per accedere all'elemento in Google Drive.

Attiva miniature Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Attivare gli URL delle miniature per un'origine dati

Attivare gli URL delle miniature per un'applicazione di ricerca

Accedere alle miniature

Attiva miniature