Na tej stronie samouczka Google Cloud Search znajdziesz informacje o tym, jak skonfigurować niestandardowe za pomocą osadzonego widżetu wyszukiwania. Aby zacząć od początku tego samouczka, zapoznaj się z artykułem Samouczek dla początkujących dotyczący Cloud Search
Instalowanie zależności
Jeśli oprogramowanie sprzęgające nadal indeksuje repozytorium, otwórz nową powłokę i przejdź tutaj.
W wierszu poleceń zmień katalog na
cloud-search-samples/end-to-end/search-interface
Aby pobrać wymagane zależności dla uruchamiając serwer WWW, uruchom to polecenie:
npm install
Tworzenie danych logowania do wyszukiwarki
Oprogramowanie sprzęgające wymaga danych logowania konta usługi do wywoływania Cloud Search API. Aby utworzyć dane logowania:
Wróć do konsoli Google Cloud.
W menu po lewej stronie kliknij Dane logowania.
Na liście Utwórz dane logowania wybierz Identyfikator klienta OAuth. Pole „Utwórz identyfikator klienta OAuth”
Opcjonalnie: Jeśli nie masz skonfigurowanego ekranu zgody, kliknij SKONFIGURUJ EKRAN ZGODY. Strona „Zgoda OAuth” ekranu.
Kliknij kolejno Wewnętrzny i UTWÓRZ. inna opcja „Zgoda OAuth”; Ekran
Wypełnij wymagane pola. Dalsze instrukcje można znaleźć sekcji zgody dotyczącej Konfigurowanie protokołu OAuth 2.0.
Kliknij listę Typ aplikacji i wybierz Aplikacja internetowa.
W polu Name (Nazwa) wpisz „tutorial” (samouczek).
W polu Autoryzowane źródła JavaScript kliknij DODAJ URI. Puste „Identyfikatory URI” .
W polu Identyfikatory URI wpisz
http://localhost:8080
.Kliknij UTWÓRZ. „Utworzono klienta OAuth” ekranu.
Zapisz identyfikator klienta. Ta wartość służy do identyfikowania aplikacji, gdy żądania autoryzacji użytkownika za pomocą protokołu OAuth2. Tajny klucz klienta nie jest wymagany na potrzeby tej implementacji.
Kliknij OK.
Tworzenie wyszukiwarki
Następnie utwórz wyszukiwarkę w konsoli administracyjnej. Wyszukiwarka to wirtualna reprezentacja interfejsu wyszukiwania konfiguracji.
- Wróć do konsoli administracyjnej Google.
- Kliknij ikonę Aplikacje. W sekcji „Administracja aplikacjami”
- Kliknij Google Workspace. Sekcja „Administracja aplikacjami Google Workspace”
- Przewiń w dół i kliknij Cloud Search. Ustawienia Google Workspace strona
- Kliknij Wyszukiwarki. Wyszukiwarka
- Kliknij okrągły żółty symbol +. Opcja „Utwórz nową wyszukiwarkę” które się wyświetla.
- W polu Wyświetlana nazwa wpisz „tutorial”.
- Kliknij UTWÓRZ.
- Kliknij ikonę ołówka obok nowo utworzonej wyszukiwarki. („Edytuj wyszukiwarkę”). 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 umożliwia włączenie źródła danych samouczka dla nowo utworzonej wyszukiwarki.
- Po prawej stronie „samouczka” źródła danych, kliknij Opcje wyświetlania.
- Sprawdź wszystkie aspekty.
- Kliknij ZAPISZ.
- Kliknij GOTOWE.
Konfigurowanie aplikacji internetowej
Po utworzeniu danych logowania i wyszukiwarki zaktualizuj aplikację , tak aby zawierały te wartości:
- W wierszu poleceń zmień katalog na `cloud-search-samples/end-to-end/search-interface/public.'
- Otwórz plik
app.js
w edytorze tekstu. - Odszukaj zmienną
searchConfig
u góry pliku. - Zastąp
[client-id]
wcześniej utworzonym identyfikatorem klienta OAuth. - Zastąp
[application-id]
identyfikatorem wyszukiwarki podanym w polu poprzedniej sekcji. - Zapisz plik.
Uruchamianie aplikacji
Uruchom aplikację, wykonując to polecenie:
npm run start
Wykonywanie zapytania dotyczącego indeksu
Aby wysłać zapytanie do indeksu przy użyciu widżetu wyszukiwania:
- Otwórz przeglądarkę i wejdź na
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, np. „test”, i naciśnij Enter. Na stronie powinny wyświetlić się wyniki zapytania wraz z aspektami i elementy sterujące podziałem na strony.
Sprawdzanie kodu
W pozostałych sekcjach przedstawiamy sposób tworzenia interfejsu użytkownika.
Wczytuję widżet
Widżet i powiązane z nim biblioteki są ładowane w 2 etapach. Po pierwsze, skrypt został wczytany:
Po drugie, gdy skrypt będzie gotowy, wywoływane jest wywołanie zwrotne onLoad
. Następnie wczytuje się
klient interfejsu API Google, Logowanie przez Google i biblioteki widżetów Cloud Search.
Pozostałą inicjalizacja aplikacji jest obsługiwana przez initializeApp
po załadowaniu wszystkich wymaganych bibliotek.
Autoryzacja obsługi
Użytkownicy muszą autoryzować aplikację do wysyłania zapytań w ich imieniu. Gdy widżet możesz prosić użytkowników o autoryzację, możesz zapewnić użytkownikom lepsze wrażenia samodzielnie przeprowadzając autoryzację.
W interfejsie wyszukiwania aplikacja wyświetla 2 różne widoki w zależności od na temat stanu logowania użytkownika.
Podczas inicjowania włączony jest właściwy widok, a odpowiednie moduły obsługi są skonfigurowane zdarzenia zalogowania i wylogowania:
Tworzę interfejs wyszukiwania
Widżet wyszukiwania wymaga użycia niewielkiej ilości znaczników HTML na potrzeby wyszukiwania wprowadzania i przytrzymywania wyników wyszukiwania:
Widżet zostanie zainicjowany i powiązany z elementami wejściowymi i kontenerami podczas inicjowania:
Gratulujemy! Udało Ci się ukończyć samouczek. Jedź dalej przez jak je wyczyścić.