Włącz miniatury

Miniatury pomagają użytkownikom identyfikować trafne wyniki wyszukiwania. Charakteryzują się one:

• Szerokość 1024 pikseli.
• Adresy URL miniatur plików Google Workspace są chronione listą ACL. Inne typy plików nie są obsługiwane.
• Adresy URL wygasają po 5 minutach.
• Maksymalny rozmiar pliku do wygenerowania to 50 MB.
• Jeśli generowanie się nie powiedzie, Cloud Search zwróci ikonę zastępczą. W przypadku elementów Google Workspace adres URL zwraca błąd „404 Nie znaleziono”. Twoja aplikacja musi sobie z tym poradzić.

Dysk Google automatycznie tworzy miniatury obsługiwanych typów plików, takich jak Dokumenty, Arkusze i Prezentacje. Cloud Search generuje też miniatury:

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

Cloud Search zwraca miniatury elementów tylko wtedy, gdy włączysz miniatury dla źródła danych i aplikacji do wyszukiwania.

Włączanie adresów URL miniatur dla źródła danych

Aby włączyć adresy URL miniatur, utwórz klucz interfejsu API i dane logowania aplikacji internetowej. Użyj ich, aby uzyskać token dostępu do aktualizacji źródła danych.

1. Utwórz lub wybierz projekt i włącz interfejs API. Zobacz Konfigurowanie dostępu do interfejsu Cloud Search API.
2. Utwórz klucz interfejsu API w konsoli Google Cloud i zanotuj jego wartość.
3. Utwórz dane logowania aplikacji internetowej. Użyj identyfikatora URI przekierowania https://developers.google.com/oauthplayground. Więcej informacji znajdziesz w artykule Tworzenie danych logowania.
4. W OAuth 2.0 Playground otwórz Konfiguracja OAuth 2.0 .
5. Wybierz Use your own credentials (Użyj własnych danych logowania) i wpisz identyfikator klienta oraz tajny klucz.
6. Wpisz https://www.googleapis.com/auth/cloud_search.settings w polu zakresów i kliknij Autoryzuj interfejsy API.
7. Wymień kod autoryzacji na tokeny.

8. Wywołaj settings.datasources.get, aby uzyskać identyfikator źródła danych:

   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. Zadzwoń pod numer settings.datasources.update, używając returnThumbnailUrls ustawionego na 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
   

Włączanie adresów URL miniatur w aplikacji do wyszukiwania

Musisz też włączyć miniatury w aplikacji do wyszukiwania.

1. Uzyskaj klucz interfejsu API i token dostępu, korzystając z tej samej metody, która została opisana w poprzedniej sekcji.

2. Zadzwoń pod numer settings.searchapplications.get, aby uzyskać identyfikator aplikacji:

   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. Zadzwoń pod numer settings.searchapplications.update, używając returnResultThumbnailUrls ustawionego na 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
   

Dostęp do miniatur

Aby uzyskać dostęp do miniatury pliku na Dysku, użytkownik lub aplikacja musi użyć tych samych danych logowania, które zostały użyte do uzyskania dostępu do oryginalnego elementu.