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 px.
• Les URL des miniatures de fichiers Google Workspace sont protégées par des listes de contrôle d'accès. Les autres types de fichiers ne le sont pas.
• 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 le message "404 Not Found". Votre application doit gérer cette situation.

Google Drive crée automatiquement des miniatures pour les types de fichiers compatibles, comme Docs, Sheets et Slides. Cloud Search génère également des miniatures pour :

• 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 les activez 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 permettant 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 sa 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 OAuth 2.0 Playground, ouvrez Configuration OAuth 2.0 .
5. Sélectionnez 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 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.