Questa pagina è stata tradotta dall'API Cloud Translation.

Attiva miniature

Le miniature vengono visualizzate per i documenti restituiti dai risultati della ricerca. Le miniature consentono all'utente per 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 sono protetti 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 una miniatura di un elemento di Google Workspace non può essere generato, l'URL della miniatura restituisce "404 - Non trovato." L'applicazione deve gestire questo comportamento.

Le miniature vengono create automaticamente per i file di Google Drive che, naturalmente, supportano miniature, ad esempio i tipi di documenti di Google Workspace (Documenti, Fogli, slide 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)
Extensible Markup Language (XML)

Le miniature vengono restituite solo per gli elementi le cui origini dati e applicazioni di ricerca. abilitarle.

Attivare gli URL miniatura per un'origine dati

Il progetto della piattaforma Cloud Search contiene le credenziali dell'account di servizio. Tuttavia, per abilitare gli URL delle miniature, devi creare un'immagine Chiave API e credenziali dell'applicazione web e utilizzo delle credenziali dell'applicazione web per ottenere un token di accesso. Infine, utilizzerai 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, fai riferimento ai passaggi 1 e 2 della Configura 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. La colonna "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. Usa https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Crea le credenziali dell'applicazione web (JavaScript lato client).
In OAuth 2.0 Playground, Fai clic su Configurazione OAuth 2.0 .
Seleziona Utilizza le tue credenziali.
Inserisci l'ID client e il client secret generati nel passaggio 3.
Nel campo 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 ti viene mostrata 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 attivare la miniatura i controlli di sicurezza.

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 del tuo progetto (ottenuta dal passaggio 2).
YOUR_ACCESS_TOKEN è un 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 il numero setting.datasource.update con returnThumbnailUrls impostato su true per attivare gli URL miniatura per i dati fonte:

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 dal passaggio 2).
YOUR_ACCESS_TOKEN è un token di accesso OAuth 2.0 per il tuo progetto (ottenuto dal passaggio 10).
DataSource_DisplayName è il nome visualizzato restituito dalla precedente 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 un'immagine Chiave API e credenziali dell'applicazione web e utilizzo delle credenziali dell'applicazione web per ottenere un token di accesso. Infine, utilizzerai 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 abilita l'API. Per informazioni su questi due passaggi, fai riferimento ai passaggi 1 e 2 della Configura 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. La colonna "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. Usa https://developers.google.com/oauthplayground come URI di reindirizzamento. . Per i passaggi per creare queste credenziali, consulta Crea le credenziali dell'applicazione web (JavaScript lato client).
In OAuth 2.0 Playground, Fai clic su Configurazione OAuth 2.0 .
Seleziona Utilizza le tue credenziali.
Inserisci l'ID client e il client secret generati nel passaggio 3.
Nel campo 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 ti viene mostrata 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 cui vuoi attivare i controlli per le 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 del tuo progetto (ottenuta dal passaggio 2).
YOUR_ACCESS_TOKEN è un 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 il numero setting.searchapplications.update con returnResultThumbnailUrls impostato su true per attivare gli URL miniatura per il 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 dal passaggio 2).
YOUR_ACCESS_TOKEN è un token di accesso OAuth 2.0 per il tuo progetto (ottenuto dal passaggio 10).
SearchApp_DisplayName è il nome visualizzato restituito dalla precedente 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 alla miniatura di un file di Google Workspace in Drive, l'utente o l'applicazione deve passare le stesse credenziali dell'account che utilizza per accedere su Google Drive.