Na tej stronie samouczka Google Cloud Search pokazujemy, jak skonfigurować niestandardową wyszukiwarkę za pomocą umieszczonego widżetu wyszukiwania. Aby zacząć od początku tego samouczka, zapoznaj się z samouczkiem wprowadzającym do Cloud Search.
Instalowanie zależności
Jeśli oprogramowanie sprzęgające nadal indeksuje repozytorium, otwórz nową powłokę i tam przejdź dalej.
W wierszu poleceń zmień katalog na
cloud-search-samples/end-to-end/search-interface
.Aby pobrać zależności wymagane do uruchomienia serwera WWW, uruchom to polecenie:
npm install
Tworzenie danych logowania do wyszukiwarki
Aby móc wywoływać interfejsy Cloud Search API, oprogramowanie sprzęgające wymaga danych logowania do konta usługi. Aby utworzyć dane logowania:
Wróć do konsoli Google Cloud.
W menu po lewej stronie kliknij Dane logowania.
Z listy Utwórz dane logowania wybierz Identyfikator klienta OAuth. Pojawi się strona „Tworzenie identyfikatora klienta OAuth”.
Opcjonalnie: Jeśli nie masz skonfigurowanego ekranu zgody, kliknij SKONFIGURUJ EKRAN ZGODY. Pojawi się ekran „Zgoda OAuth”.
Kliknij Wewnętrzne i wybierz UTWÓRZ. Pojawi się kolejny ekran „Zgoda OAuth”.
Wypełnij wymagane pola. Dalsze instrukcje znajdziesz w sekcji dotyczącej zgody użytkownika w artykule Konfigurowanie protokołu OAuth 2.0.
Kliknij listę Typ aplikacji i wybierz Aplikacja internetowa.
W polu Nazwa wpisz „tutorial”.
W polu Autoryzowane źródła JavaScript kliknij DODAJ URI. Pojawi się puste pole „Identyfikatory URI”.
W polu Identyfikatory URI wpisz
http://localhost:8080
.Kliknij UTWÓRZ. Pojawi się ekran „Klient OAuth utworzony”.
Zapisz identyfikator klienta. Ta wartość służy do identyfikowania aplikacji w przypadku żądania autoryzacji użytkownika za pomocą protokołu OAuth2. W tej implementacji nie jest wymagany tajny klucz klienta.
Kliknij OK.
Tworzenie wyszukiwarki
Następnie utwórz wyszukiwarkę w konsoli administracyjnej. Wyszukiwarka to wirtualna reprezentacja interfejsu wyszukiwania i jego domyślnej konfiguracji.
- Wróć do konsoli administracyjnej Google.
- Kliknij ikonę Aplikacje. Pojawi się strona „Administracja aplikacjami”.
- Kliknij Google Workspace. Pojawi się strona „Administrowanie aplikacjami w Google Workspace”.
- Przewiń w dół i kliknij Cloud Search. Pojawi się strona „Ustawienia Google Workspace”.
- Kliknij Wyszukiwarki. Pojawi się strona „Wyszukaj aplikacje”.
- Kliknij okrągły żółty przycisk +. Pojawi się okno „Utwórz nową wyszukiwarkę”.
- W polu Wyświetlana nazwa wpisz „tutorial”.
- Kliknij UTWÓRZ.
- Kliknij ikonę ołówka obok nowo utworzonej wyszukiwarki („Edytuj wyszukiwarkę”). Pojawi się strona „Szczegóły wyszukiwarki”.
- Zapisz identyfikator aplikacji.
- Po prawej stronie opcji Źródła danych kliknij ikonę ołówka.
- Obok opcji „samouczek” kliknij przełącznik Włącz. Ten przełącznik włącza źródło danych samouczka dla nowo utworzonej wyszukiwarki.
- Na prawo od źródła danych „samouczek” kliknij Opcje wyświetlania.
- Sprawdź wszystkie aspekty.
- Kliknij ZAPISZ.
- Kliknij GOTOWE.
Skonfiguruj aplikację internetową
Po utworzeniu danych logowania i aplikacji do wyszukiwania zaktualizuj konfigurację aplikacji, aby uwzględnić te wartości w następujący sposób:
- W wierszu poleceń zmień katalog na „cloud-search-samples/end-to-end/search-interface/public”.
- Otwórz plik
app.js
w edytorze tekstu. - Znajdź zmienną
searchConfig
u góry pliku. - Zastąp
[client-id]
utworzonym wcześniej identyfikatorem klienta OAuth. - Zastąp
[application-id]
identyfikatorem wyszukiwarki zanotowanym w poprzedniej sekcji. - Zapisz plik.
Uruchamianie aplikacji
Uruchom aplikację, korzystając z tego polecenia:
npm run start
Wykonywanie zapytania w indeksie
Aby wysłać zapytanie do indeksu za pomocą widżetu wyszukiwania:
- Otwórz przeglądarkę i wejdź na stronę
http://localhost:8080
. - Kliknij Sign in (Zaloguj się), aby autoryzować aplikację do wysyłania zapytań do Cloud Search w Twoim imieniu.
- W polu wyszukiwania wpisz zapytanie, na przykład słowo „test”, i naciśnij Enter. Strona powinna wyświetlać wyniki zapytania wraz z aspektami i elementami sterującymi podziału na strony, aby umożliwić nawigację między wynikami.
Sprawdzanie kodu
W pozostałych sekcjach omawiamy projekt interfejsu.
Wczytuję widżet
Widżet i powiązane biblioteki są wczytywane w dwóch etapach. Najpierw wczytywany jest skrypt wczytywania:
Następnie, gdy skrypt jest gotowy, wywoływane jest wywołanie zwrotne onLoad
. Następnie wczytuje klienta interfejsu API Google, Logowanie przez Google oraz biblioteki widżetów Cloud Search.
Pozostała inicjalizacja aplikacji jest obsługiwana przez initializeApp
po wczytaniu wszystkich wymaganych bibliotek.
Autoryzacja obsługi
Użytkownicy muszą upoważnić aplikację do wysyłania zapytań w ich imieniu. Widżet może prosić użytkowników o autoryzację, ale możesz poprawić komfort użytkowników, przeprowadzając autoryzację samodzielnie.
W przypadku interfejsu wyszukiwania aplikacja prezentuje 2 różne widoki w zależności od stanu logowania użytkownika.
Podczas inicjowania włączony jest właściwy widok, a moduły obsługi zdarzeń logowania i wylogowywania są skonfigurowane:
Tworzenie interfejsu wyszukiwania
Widżet wyszukiwania wymaga niewielkiej ilości znaczników HTML na potrzeby danych wejściowych wyszukiwania i przechowywania wyników:
Widżet jest inicjowany i powiązany z elementami danych wejściowych i kontenerem podczas inicjowania:
Gratulujemy! Udało Ci się ukończyć samouczek. Dalej znajdziesz instrukcje czyszczenia.