Ta strona została przetłumaczona przez Cloud Translation API.

Włącz miniatury

Miniatury są wyświetlane w przypadku dokumentów zwróconych przez wyniki wyszukiwania. Miniatury umożliwiają użytkownikowi lepsze określenie trafności zwróconych dokumentów. Miniatury mają te cechy:

Szerokość: 1024 pikseli.
Adres URL miniatur plików Google Workspace jest chroniony przez listę 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 komunikat „404 Not Found” (Nie znaleziono). Aplikacja musi obsługiwać takie działanie.

Miniatury są tworzone automatycznie w przypadku plików Dysku Google, które obsługują miniatury, takich jak typy dokumentów Google Workspace (Dokumenty, Arkusze, Prezentacje itp.). Dodatkowo Cloud Search automatycznie tworzy miniatury dla 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)
Format tekstu sformatowanego (RTF)
Format tekstowy (TXT)
Hypertext Markup Language (HTML)
Extensible Markup Language (XML)

Miniatury są zwracane tylko w przypadku elementów, dla których źródło danych i aplikacje do wyszukiwania mają włączone miniatury.

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

Twój 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 do aplikacji internetowej, a następnie użyć tych danych, aby uzyskać token dostępu. W końcu używasz tych danych logowania do pobierania i aktualizowania źródła danych.

Utwórz lub wybierz projekt dla aplikacji i włącz interfejs API. Informacje o tych 2 krokach znajdziesz w kroku 1 i 2 artykułu Konfigurowanie dostępu do interfejsu Google Cloud Search API.
Utwórz klucz interfejsu API:
1. W konsoli Google Cloud kliknij menu Utwórz dane logowania i wybierz Klucz interfejsu API. Pojawi się strona „Utworzono klucz interfejsu API”.
2. Zapisz klucz interfejsu API.
3. Kliknij „Zamknij”. Nowo utworzone dane logowania pojawią się w sekcji „Klucze API”.
Utwórz dane logowania do aplikacji internetowej. Jako identyfikator URI przekierowania użyj wartości https://developers.google.com/oauthplayground. . Instrukcje tworzenia tych danych logowania znajdziesz w artykule Tworzenie danych logowania do aplikacji internetowej (JavaScript po stronie klienta).
W sekcji Playground OAuth 2.0 kliknij Konfiguracja OAuth 2.0 .
Zaznacz Użyj własnych danych logowania.
Wpisz identyfikator i klucz tajny klienta wygenerowane w kroku 3.
W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settingsi kliknij Autoryzuj interfejsy API.
(opcjonalnie) Jeśli pojawi się ekran logowania, wybierz konto, którego chcesz użyć.
(Opcjonalnie) Jeśli wyświetli się ekran autoryzacji, kliknij Akceptuj.
Kliknij Kod autoryzacji wymiany dla tokenów. Zwracany jest token.
Określ źródło danych, dla którego chcesz włączyć kontrolki miniatur.

Aby uzyskać identyfikator źródła danych, wywołaj funkcję 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

Gdzie:

datasource_id to nazwa źródła danych, które chcesz pobrać.
YOUR_API_KEY to klucz interfejsu API Twojego projektu (pozyskany w kroku 2).
YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 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
     }
   ]
 }
}

Aby włączyć adresy URL miniatur dla źródła danych, wywołaj funkcję setting.datasource.update, ustawiając parametr 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":"DataSource_Display_Name","itemsVisibility":
    [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
  --compressed

Gdzie:

datasource_id to identyfikator źródła danych, które ma zostać pobrane.
YOUR_API_KEY to klucz interfejsu API Twojego projektu (pozyskany w kroku 2).
YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 Twojego projektu (uzyskany w kroku 10).
DataSource_DisplayName to wyświetlana nazwa zwrócona przez poprzednią komendę 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 wyszukiwarce

Twój 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 do aplikacji internetowej, a następnie użyć tych danych, aby uzyskać token dostępu. W końcu używasz tych danych do uzyskiwania dostępu do aplikacji wyszukiwania i jej aktualizowania.

Jeśli jeszcze tego nie zrobiono, utwórz lub wybierz projekt dla aplikacji i włącz interfejs API. Informacje o tych 2 krokach znajdziesz w kroku 1 i 2 artykułu Konfigurowanie dostępu do interfejsu Google Cloud Search API.
Utwórz klucz interfejsu API:
1. W konsoli Google Cloud kliknij menu Utwórz dane logowania i wybierz Klucz interfejsu API. Pojawi się strona „Utworzono klucz interfejsu API”.
2. Zapisz klucz interfejsu API.
3. Kliknij „Zamknij”. Nowo utworzone dane logowania pojawią się w sekcji „Klucze API”.
Utwórz dane logowania do aplikacji internetowej. Jako identyfikator URI przekierowania użyj wartości https://developers.google.com/oauthplayground. . Instrukcje tworzenia tych danych logowania znajdziesz w artykule Tworzenie danych logowania do aplikacji internetowych (JavaScript po stronie klienta).
W sekcji Playground OAuth 2.0 kliknij Konfiguracja OAuth 2.0 .
Zaznacz Użyj własnych danych logowania.
Wpisz identyfikator i klucz tajny klienta wygenerowane w kroku 3.
W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settingsi kliknij Autoryzuj interfejsy API.
(opcjonalnie) Jeśli pojawi się ekran logowania, wybierz konto, którego chcesz użyć.
(Opcjonalnie) Jeśli wyświetli się ekran autoryzacji, kliknij Akceptuj.
Kliknij Kod autoryzacji wymiany dla tokenów. Zwracany jest token.
Odszukaj aplikację wyszukiwania, dla której chcesz włączyć kontrolki miniatur.

Aby uzyskać identyfikator wyszukiwarki, zadzwoń pod numer settings.searchapplications.get:

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, którą chcesz pobrać.
YOUR_API_KEY to klucz interfejsu API Twojego projektu (pozyskany w kroku 2).
YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 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"
     }
   }
 ]
}

Wywołaj funkcję setting.searchapplications.update, gdy parametr returnResultThumbnailUrls ma wartość true, aby włączyć adresy URL miniatur dla aplikacji wyszukiwania:

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, którą chcesz pobrać.
YOUR_API_KEY to klucz interfejsu API Twojego projektu (pozyskany w kroku 2).
YOUR_ACCESS_TOKEN to token dostępu OAuth 2.0 Twojego projektu (uzyskany w kroku 10).
SearchApp_DisplayName to wyświetlana nazwa zwrócona przez poprzednią komendę 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 muszą przekazać te same dane logowania do konta, których używają do uzyskiwania dostępu do elementu na Dysku Google.