Włącz miniatury

Miniatury pomagają użytkownikom identyfikować trafne wyniki wyszukiwania. Mają one te cechy:

• Szerokość 1024 piksele.
• Adresy URL miniatur plików Google Workspace są chronione przez listy ACL. Inne typy plików nie są.
• 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 komunikat „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 w źródle danych i aplikacji do wyszukiwania.

Włączanie adresów URL miniatur w źródle danych

Aby włączyć adresy URL miniatur, utwórz klucz interfejsu API i dane logowania do 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 Cloud Search API.
2. Utwórz klucz interfejsu API w konsoli Google Cloud i zanotuj jego wartość.
3. Utwórz dane logowania do aplikacji internetowej. Jako identyfikator URI przekierowania użyj https://developers.google.com/oauthplayground. Zobacz Tworzenie danych logowania.
4. W OAuth 2.0 Playground, otwórz Konfiguracja OAuth 2.0 .
5. Wybierz Użyj własnych danych logowania i wpisz identyfikator klienta oraz tajny klucz.
6. W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Autoryzuj interfejsy API.
7. Wymień kod autoryzacji na tokeny.

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

   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. Wywołaj settings.datasources.update z ustawioną wartością returnThumbnailUrls 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 opisanej w poprzedniej sekcji.

2. Aby uzyskać identyfikator aplikacji, wywołaj settings.searchapplications.get:

   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. Wywołaj settings.searchapplications.update z ustawioną wartością returnResultThumbnailUrls 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
   

Uzyskiwanie dostępu 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.