Włącz miniatury

Miniatury są wyświetlane w przypadku dokumentów zwróconych w wynikach wyszukiwania. Miniatury pozwalają użytkownikowi lepiej określić trafność zwróconych dokumentów. Miniatury mają te cechy:

  • Szerokość 1024 pikseli.
  • Adresy URL miniatur plików Google Workspace są chronione przez listy ACL. Adres URL innych typów plików nie jest chroniony przez listę ACL
  • Adresy URL wygasają po 5 minutach.
  • Miniatury nie są generowane w przypadku plików większych niż 50 MB.
  • Jeśli nie można wygenerować miniatury, używana jest ikona zastępcza. Jeśli nie można wygenerować miniatury elementu Google Workspace, adres URL miniatury zwraca błąd „404 Not Found”. Aplikacja musi obsługiwać takie zachowanie.

Miniatury są tworzone automatycznie w przypadku plików na Dysku Google, które naturalnie obsługują miniatury, np. dokumentów Google Workspace (Dokumentów, Arkuszy, Prezentacji itp.). Cloud Search automatycznie tworzy miniatury tych typów plików:

  • Microsoft Word (DOC)
  • Microsoft Word (DOCX)
  • Microsoft Excel (XLS)
  • Microsoft Excel (XLSX)
  • Microsoft Powerpoint (PPT)
  • Microsoft Powerpoint (PPTX)
  • Adobe Portable Document Format (PDF)
  • Tekst sformatowany (RTF)
  • Format tekstowy (TXT)
  • Hypertext Markup Language (HTML)
  • Extensible Markup Language (XML)

Miniatury są zwracane tylko w przypadku elementów, w których źródle danych i aplikacjach do wyszukiwania są one włączone.

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

Projekt platformy Cloud Search zawiera dane logowania do konta usługi. Aby jednak włączyć adresy URL miniatur, musisz utworzyć klucz API i dane logowania aplikacji internetowej oraz użyć tych danych do uzyskania tokena dostępu. Na koniec używasz tych danych logowania, aby pobrać i zaktualizować źródło danych.

  1. Jeśli nie masz jeszcze projektu dla aplikacji, utwórz go lub wybierz istniejący i włącz interfejs API. Informacje o tych 2 krokach znajdziesz w sekcjach 1 i 2 artykułu Konfigurowanie dostępu do interfejsu Google Cloud Search API.
  2. Utwórz klucz interfejsu API:
    1. W konsoli Google Cloud kliknij listę rozwijaną Utwórz dane logowania i wybierz Klucz interfejsu API. Pojawi się strona „Utworzono klucz API”.
    2. Zapisz klucz interfejsu API.
    3. Kliknij „Zamknij”. Nowo utworzone dane logowania pojawią się w sekcji „Klucze API”.
  3. Utwórz dane logowania aplikacji internetowej. Użyj https://developers.google.com/oauthplayground jako identyfikatora URI przekierowania. . Instrukcje tworzenia tych danych logowania znajdziesz w artykule Tworzenie danych logowania aplikacji internetowej (JavaScript po stronie klienta).
  4. W OAuth 2.0 Playground kliknij Konfiguracja OAuth 2.0 .
  5. Zaznacz opcję Użyj własnych danych logowania.
  6. Wpisz identyfikator i tajny klucz klienta wygenerowane w kroku 3.
  7. W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Authorize APIs (Autoryzuj interfejsy API).
  8. (opcjonalnie) Jeśli pojawi się ekran logowania, wybierz konto, którego chcesz użyć.
  9. (opcjonalnie) Jeśli pojawi się ekran autoryzacji, kliknij Akceptuj.
  10. Kliknij Wymień kod autoryzacji na tokeny. Zwracany jest token.
  11. Wskaż źródło danych, dla którego chcesz włączyć elementy sterujące miniaturami.

  12. 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

    Gdzie:

    • datasource_id to nazwa źródła danych do pobrania.
    • YOUR_API_KEY to klucz interfejsu API Twojego projektu (uzyskany w kroku 2).
    • YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 dla Twojego projektu (uzyskany w kroku 10).

    Wynik tego polecenia jest podobny do tego:

    {
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}

  13. Wywołaj funkcję setting.datasource.update, ustawiając wartość parametru returnThumbnailUrls na true, aby włączyć adresy URL miniatur dla źródła danych:

    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

    Gdzie:

    • datasource_id to identyfikator źródła danych do pobrania.
    • YOUR_API_KEY to klucz interfejsu API Twojego projektu (uzyskany w kroku 2).
    • YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 dla Twojego projektu (uzyskany w kroku 10).
    • DataSource_DisplayName to wyświetlana nazwa zwrócona przez poprzednie polecenie cURL.
    • "returnThumbnailsUrls":true włącza miniatury.

    Wynik tego polecenia jest podobny do tego:

    {
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

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

Projekt platformy Cloud Search zawiera dane logowania do konta usługi. Aby jednak włączyć adresy URL miniatur, musisz utworzyć klucz API i dane logowania aplikacji internetowej oraz użyć tych danych do uzyskania tokena dostępu. Na koniec używasz tych danych logowania, aby pobrać i zaktualizować aplikację do wyszukiwania.

  1. Jeśli nie masz jeszcze projektu dla aplikacji, utwórz go lub wybierz istniejący i włącz interfejs API. Informacje o tych 2 krokach znajdziesz w sekcjach 1 i 2 artykułu Konfigurowanie dostępu do interfejsu Google Cloud Search API.
  2. Utwórz klucz interfejsu API:
    1. W konsoli Google Cloud kliknij listę rozwijaną Utwórz dane logowania i wybierz Klucz interfejsu API. Pojawi się strona „Utworzono klucz API”.
    2. Zapisz klucz interfejsu API.
    3. Kliknij „Zamknij”. Nowo utworzone dane logowania pojawią się w sekcji „Klucze API”.
  3. Utwórz dane logowania aplikacji internetowej. Użyj https://developers.google.com/oauthplayground jako identyfikatora URI przekierowania. . Instrukcje tworzenia tych danych logowania znajdziesz w artykule Tworzenie danych logowania aplikacji internetowej (JavaScript po stronie klienta).
  4. W OAuth 2.0 Playground kliknij Konfiguracja OAuth 2.0 .
  5. Zaznacz opcję Użyj własnych danych logowania.
  6. Wpisz identyfikator i tajny klucz klienta wygenerowane w kroku 3.
  7. W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Authorize APIs (Autoryzuj interfejsy API).
  8. (opcjonalnie) Jeśli pojawi się ekran logowania, wybierz konto, którego chcesz użyć.
  9. (opcjonalnie) Jeśli pojawi się ekran autoryzacji, kliknij Akceptuj.
  10. Kliknij Wymień kod autoryzacji na tokeny. Zwracany jest token.
  11. Znajdź aplikację wyszukiwarki, w przypadku której chcesz włączyć elementy sterujące miniaturami.

  12. Wywołaj funkcję settings.searchapplications.get, aby uzyskać identyfikator wyszukiwarki:

    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

    Gdzie:

    • to identyfikator wyszukiwarki do pobrania.
    • YOUR_API_KEY to klucz interfejsu API Twojego projektu (uzyskany w kroku 2).
    • YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 dla Twojego projektu (uzyskany w kroku 10).

    Wynik tego polecenia jest podobny do tego:

    {
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}

  13. Wywołaj setting.searchapplications.update z parametrem returnResultThumbnailUrls ustawionym na true, aby włączyć adresy URL miniatur w aplikacji wyszukiwarki:

    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

    Gdzie:

    • to identyfikator wyszukiwarki do pobrania.
    • YOUR_API_KEY to klucz interfejsu API Twojego projektu (uzyskany w kroku 2).
    • YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 dla Twojego projektu (uzyskany w kroku 10).
    • SearchApp_DisplayName to wyświetlana nazwa zwrócona przez poprzednie polecenie cURL.
    • "returnResultThumbnailUrls":true włącza miniatury.

    Wynik tego polecenia jest podobny do tego:

    {
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

Dostęp do miniatur

Aby uzyskać dostęp do miniatury pliku Google Workspace na Dysku, użytkownik lub aplikacja musi podać te same dane logowania, których używa do uzyskiwania dostępu do elementu na Dysku Google.