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

Konfigurowanie interfejsu użytkownika

Na tej stronie samouczka wyszukiwarki Google Cloud znajdziesz informacje o tym, jak skonfigurować niestandardową aplikację wyszukiwania za pomocą widżetu wyszukiwarki. Aby rozpocząć pracę od początku tego samouczka, zapoznaj się z samouczkiem wprowadzającym do Cloud Search.

Instalowanie zależności

Jeśli łącznik nadal indeksuje repozytorium, otwórz nową powłokę i kontynuuj.
Z poziomu wiersza poleceń zmień katalog na cloud-search-samples/end-to-end/search-interface.
Aby pobrać wymagane zależności do obsługi serwera WWW, uruchom to polecenie:

npm install

Tworzenie danych logowania do wyszukiwarki

Aby wywoływać interfejsy API Cloud Search, sprzęg wymaga danych logowania do konta usługi. Aby utworzyć dane logowania:

Wróć do konsoli Google Cloud.
W panelu nawigacyjnym po lewej stronie kliknij Dane logowania.
Na liście Utwórz dane logowania kliknij Identyfikator klienta OAuth. Pojawi się strona „Tworzenie identyfikatora klienta OAuth”.
Opcjonalnie: Jeśli nie skonfigurowano ekranu zgody, kliknij SKONFIGURUJ EKRAN ZGODY. Pojawi się ekran „Zgoda OAuth”.
1. Kliknij kolejno Wewnętrzny i UTWÓRZ. Pojawi się kolejny ekran „Zgoda OAuth”.
2. Wypełnij wymagane pola. Więcej instrukcji znajdziesz w sekcji dotyczącej zgody użytkownika w artykule Konfigurowanie OAuth 2.0.
Kliknij listę Application type (Typ aplikacji) i wybierz Web application (Aplikacja internetowa).
W polu Nazwa wpisz „tutorial”.
W polu Autoryzowane źródła JavaScriptu kliknij DODAJ URI. Pojawi się puste pole „URI”.
W polu URI wpisz http://localhost:8080.
Kliknij UTWÓRZ. Pojawi się ekran „Utworzono klienta OAuth”.
Zapisz identyfikator klienta. Ta wartość służy do identyfikowania aplikacji podczas żądania autoryzacji użytkownika za pomocą OAuth 2. W przypadku tej implementacji nie jest wymagany tajny klucz klienta.
Kliknij OK.

Tworzenie wyszukiwarki

Następnie utwórz w konsoli administracyjnej aplikację wyszukiwania. Aplikacja wyszukiwania to wirtualna reprezentacja interfejsu wyszukiwania i jego domyślnej konfiguracji.

Wróć do konsoli administracyjnej Google.
Kliknij ikonę aplikacji. Pojawi się strona „Administrowanie aplikacjami”.
Kliknij Google Workspace. Pojawi się strona „Administracja Google Workspace”.
Przewiń w dół i kliknij Cloud Search. Pojawi się strona „Ustawienia Google Workspace”.
Kliknij Wyszukiwarki. Pojawi się strona „Aplikacje wyszukiwania”.
Kliknij żółte kółko +. Pojawi się okno „Tworzenie nowej wyszukiwarki”.
W polu Wyświetlana nazwa wpisz „tutorial”.
Kliknij UTWÓRZ.
Kliknij ikonę ołówka obok utworzonej wyszukiwarki („Edytuj wyszukiwarkę”). Pojawi się strona „Szczegóły aplikacji wyszukiwania”.
Zapisz identyfikator aplikacji.
Po prawej stronie sekcji Ź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 z samouczka dla nowo utworzonej wyszukiwarki.
Po prawej stronie źródła danych „samouczka” kliknij Opcje wyświetlania.
Sprawdź wszystkie kolumny.
Kliknij ZAPISZ.
Kliknij GOTOWE.

Konfigurowanie aplikacji internetowej

Po utworzeniu danych logowania i aplikacji wyszukiwania zaktualizuj konfigurację aplikacji, aby uwzględnić te wartości w ten 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 podanym w poprzedniej sekcji.
Zapisz plik.

Uruchamianie aplikacji

Uruchom aplikację, wykonując to polecenie:

npm run start

Wysyłanie zapytań do indeksu

Aby zapytać indeks za pomocą widżetu wyszukiwania:

Otwórz przeglądarkę i wejdź na stronę http://localhost:8080.
Kliknij Zaloguj się, aby autoryzować aplikację do wysyłania zapytań do Cloud Search w Twoim imieniu.
W polu wyszukiwania wpisz zapytanie, np. słowo „test”, a następnie naciśnij Enter. Na stronie powinny wyświetlać się wyniki zapytania wraz z aspektami i elementami sterowania stronowaniem, które umożliwiają poruszanie się po wynikach.

Sprawdzanie kodu

Pozostałe sekcje opisują sposób tworzenia interfejsu użytkownika.

Ładowanie widżetu

Widżet i powiązane z nim biblioteki są wczytywane w 2 etapach. Najpierw wczytuje się skrypt bootstrap:

index.html

Wyświetl w GitHubie

<script src="https://apis.google.com/js/api.js?mods=enable_cloud_search_widget&onload=onLoad" async defer></script>

Po drugie, gdy skrypt będzie gotowy, wywoływane jest wywołanie zwrotne onLoad. Następnie wczytuje biblioteki klienta interfejsu Google API, logowania Google i widżetów wyszukiwarki Cloud.

app.js

Wyświetl w GitHubie

/**
 * Load the cloud search widget & auth libraries. Runs after
 * the initial gapi bootstrap library is ready.
 */
function onLoad() {
  gapi.load('client:auth2:cloudsearch-widget', initializeApp)
}

Po załadowaniu wszystkich wymaganych bibliotek pozostałą część inicjalizacji aplikacji przejmuje initializeApp.

Obsługa autoryzacji

Użytkownicy muszą autoryzować aplikację do wysyłania zapytań w ich imieniu. Widget może wyświetlać użytkownikom prośbę o autoryzację, ale możesz też samodzielnie zadbać o autoryzację, aby zapewnić użytkownikom lepsze wrażenia.

W interfejsie wyszukiwania aplikacja wyświetla 2 różne widoki w zależności od stanu logowania użytkownika.

index.html

Wyświetl w GitHubie

<div class="content">
  <div id="app" hidden>
    <div id="header">
      <button id="sign-out">Sign-out</button>
    </div>
    <!-- Markup for widget...-->
  </div>
  <div id="welcome" hidden>
    <h1>Cloud Search Tutorial</h1>
    <p>Sign in with your Google account to search.</p>
    <button id="sign-in">Sign-in</button>
  </div>
</div>

Podczas inicjalizacji włączana jest odpowiednia widok i konfigurowane są moduły obsługi zdarzeń logowania i wylogowywania:

app.js

Wyświetl w GitHubie

/**
 * Initialize the app after loading the Google API client &
 * Cloud Search widget.
 */
async function initializeApp() {
  await gapi.auth2.init({
      'clientId': searchConfig.clientId,
      'scope': 'https://www.googleapis.com/auth/cloud_search.query'
  });

  let auth = gapi.auth2.getAuthInstance();

  // Watch for sign in status changes to update the UI appropriately
  let onSignInChanged = (isSignedIn) => {
    document.getElementById("app").hidden = !isSignedIn;
    document.getElementById("welcome").hidden = isSignedIn;
    if (resultsContainer) {
      resultsContainer.clear();
    }
  }
  auth.isSignedIn.listen(onSignInChanged);
  onSignInChanged(auth.isSignedIn.get()); // Trigger with current status

  // Connect sign-in/sign-out buttons
  document.getElementById("sign-in").onclick = (e) =>  auth.signIn();
  document.getElementById("sign-out").onclick = (e) => auth.signOut();

  // ...

}

Tworzenie interfejsu wyszukiwania

Widżet wyszukiwania wymaga niewielkiej ilości znaczników HTML na potrzeby wprowadzania zapytań i przechowywania wyników wyszukiwania:

index.html

Wyświetl w GitHubie

<div id="search_bar">
  <div>
    <div id="suggestions_anchor">
      <input type="text" id="search_input" placeholder="Search for...">
    </div>
  </div>
</div>
<div id="facet_results" ></div>
<div id="search_results" ></div>

Widżet jest inicjowany i wiązany z elementami wejścia i kontenera podczas inicjowania:

app.js

Wyświetl w GitHubie

gapi.config.update('cloudsearch.config/apiVersion', 'v1');
resultsContainer = new gapi.cloudsearch.widget.resultscontainer.Builder()
  .setSearchApplicationId(searchConfig.searchAppId)
  .setSearchResultsContainerElement(document.getElementById('search_results'))
  .setFacetResultsContainerElement(document.getElementById('facet_results'))
  .build();

const searchBox = new gapi.cloudsearch.widget.searchbox.Builder()
  .setSearchApplicationId(searchConfig.searchAppId)
  .setInput(document.getElementById('search_input'))
  .setAnchor(document.getElementById('suggestions_anchor'))
  .setResultsContainer(resultsContainer)
  .build();

Gratulacje! Samouczek został ukończony. Przejdź dalej, aby uzyskać instrukcje czyszczenia.

Wstecz Dalej