Activer les miniatures

Les miniatures aident les utilisateurs à identifier les résultats de recherche pertinents. Elles présentent les caractéristiques suivantes :

• Largeur de 1 024 pixels.
• Les URL des miniatures de fichiers Google Workspace sont protégées par une liste de contrôle d'accès. Ce n'est pas le cas des autres types de fichiers.
• Les URL expirent au bout de cinq minutes.
• La taille maximale des fichiers pour la génération est de 50 Mo.
• Si la génération échoue, Cloud Search renvoie une icône d'espace réservé. Pour les éléments Google Workspace, l'URL renvoie "404 Not Found" (404 Introuvable). Votre application doit gérer ce cas.

Google Drive crée automatiquement des miniatures pour les types compatibles, tels que Docs, Sheets et Slides. Cloud Search génère également des miniatures pour les éléments suivants :

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

Cloud Search ne renvoie des miniatures pour les éléments que si vous activez les miniatures pour la source de données et l'application de recherche.

Activer les URL de miniatures pour une source de données

Pour activer les URL de miniatures, créez une clé API et des identifiants d'application Web. Utilisez-les pour obtenir un jeton d'accès afin de mettre à jour votre source de données.

1. Créez ou sélectionnez un projet, puis activez l'API. Consultez Configurer l'accès à l'API Cloud Search.
2. Créez une clé API dans la console Google Cloud et notez la valeur.
3. Créez des identifiants d'application Web. Utilisez https://developers.google.com/oauthplayground comme URI de redirection. Consultez Créer des identifiants.
4. Dans le OAuth 2.0 Playground, ouvrez les paramètres de configuration OAuth 2.0 .
5. Sélectionnez Use your own credentials (Utiliser vos propres identifiants), puis saisissez votre ID client et votre code secret.
6. Saisissez https://www.googleapis.com/auth/cloud_search.settings dans le champ des autorisations, puis cliquez sur Authorize APIs (Autoriser les API).
7. Échangez le code d'autorisation contre des jetons.

8. Appelez settings.datasources.get pour obtenir l'ID de votre source de données :

   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. Appelez settings.datasources.update avec returnThumbnailUrls défini sur 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
   

Activer les URL de miniatures pour une application de recherche

Vous devez également activer les miniatures dans votre application de recherche.

1. Obtenez une clé API et un jeton d'accès en utilisant la même méthode que celle décrite dans la section précédente.

2. Appelez settings.searchapplications.get pour obtenir l'ID de votre application :

   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. Appelez settings.searchapplications.update avec returnResultThumbnailUrls défini sur 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
   

Accéder aux miniatures

Pour accéder à la miniature d'un fichier Drive, l'utilisateur ou l'application doit utiliser les mêmes identifiants de compte que ceux utilisés pour accéder à l'élément d'origine.