Skonfiguruj dostęp do interfejsu Google Cloud Search API

Aby móc używać interfejsu API Google Cloud Search bezpośrednio lub przez pakiet SDK, musisz skonfigurować do niego dostęp. W tym dokumencie opisano czynności wymagane do korzystania z interfejsu API REST Google Cloud Search API.

1. Tworzenie projektu API

Aby włączyć ten interfejs API, musisz najpierw utworzyć projekt Google Cloud. Ten projekt stanowi podstawę do tworzenia, włączania i używania wszystkich usług Google Cloud, w tym do zarządzania interfejsami API, włączania płatności, dodawania i usuwania współpracowników oraz zarządzania uprawnieniami.

  1. Otwórz konsolę Google Cloud.

  2. U góry strony kliknij po prawej stronie konsoli Google Cloud. Pojawi się okno z bieżącymi projektami.

  3. Kliknij NOWY PROJEKT. Pojawi się ekran „Nowy projekt”.

  4. Wpisz nazwę projektu w polu Nazwa projektu.

  5. (Opcjonalnie) Kliknij Edytuj, aby edytować identyfikator projektu. Po utworzeniu projektu nie można zmienić jego identyfikatora, dlatego wybierz identyfikator, który spełnia Twoje potrzeby w czasie jego trwania.

  6. Aby przeglądać lokalizacje projektu, kliknij PRZEGLĄDAJ.

  7. Kliknij lokalizację projektu i kliknij Wybierz.

  8. Kliknij Utwórz. Konsola przekieruje do strony Panel. Projekt zostanie utworzony w ciągu kilku minut.

Więcej informacji o tworzeniu projektów i zarządzaniu nimi znajdziesz w artykule Tworzenie projektów i zarządzanie nimi.

2. Włącz API

Aby uzyskać dane logowania, musisz włączyć interfejs Google Cloud Search API i utworzyć konto usługi.

  1. Aby upewnić się, że korzystasz z nowo utworzonego projektu, kliknij ikonę po prawej stronie banera konsoli Google Cloud i wybierz nowo utworzony projekt.
  2. Kliknij WŁĄCZ INTERFEJSY API I USŁUGI. Pojawi się strona „Witamy w bibliotece interfejsów API”.
  3. Otwórz interfejs API Google Cloud Search.
  4. Kliknij Włącz. Pojawi się strona „Przegląd”.

Więcej informacji o włączaniu i wyłączaniu interfejsów API znajdziesz w artykule Zarządzanie interfejsami API w konsoli Google Cloud.

3. Tworzenie danych logowania na konto usługi

  1. W konsoli Google Cloud kliknij Dane logowania po lewej stronie. Pojawi się strona Dane logowania.
  2. Na liście Utwórz dane logowania wybierz Konto usługi. Pojawi się strona „Utwórz konto usługi”.
  3. Wpisz nazwę w polu Nazwa konta usługi.
  4. (Opcjonalnie) Zmodyfikuj identyfikator konta usługi.
  5. Kliknij Utwórz. Pojawi się ekran „Uprawnienia do konta usługi”.
  6. Kliknij Dalej. Pojawi się ekran „Przyznaj użytkownikom dostęp do tego konta usługi”.
  7. Kliknij UTWÓRZ KLUCZ, a następnie Gotowe. Pojawi się okno „Klucz prywatny zapisany na komputerze” i kopia pobranego klucza prywatnego na komputer.
  8. Kliknij Zamknij.

Więcej informacji o kontach usługi znajdziesz w artykule Konta usługi, aplikacje internetowe i zainstalowane aplikacje.

4. Podaj adres e-mail

  1. W konsoli Google Cloud wybierz utworzony przez siebie projekt u góry strony.
  2. Kliknij menu nawigacyjne po lewej stronie banera konsoli Google Cloud.
  3. Kliknij Administracja > Konta usługi.
  4. Na liście w sekcji „Identyfikator konta usługi” sprawdź wygenerowany adres e-mail, który identyfikuje skonfigurowane konto usługi. Ten adres e-mail jest używany podczas dodawania źródła danych do Cloud Search.

5. Inicjowanie pomocy zewnętrznej

Aby móc wywoływać inne interfejsy API Cloud Search, musisz zainicjować obsługę zewnętrzną w Google Cloud Search.

Aby zainicjować obsługę zewnętrznej usługi Cloud Search:

  1. Twój projekt platformy Cloud Search zawiera dane logowania na konto usługi. Aby jednak zainicjować obsługę zewnętrznych usług pomocy technicznej, musisz utworzyć dane logowania aplikacji internetowej. Instrukcje tworzenia danych logowania do aplikacji internetowych znajdziesz w sekcji Tworzenie danych logowania. Po wykonaniu tego kroku otrzymasz identyfikator klienta i plik tajnego klucza klienta.

  2. Aby uzyskać token dostępu, użyj placu zabaw OAuth 2 firmy Google:

    1. Kliknij ustawienia i zaznacz Użyj własnych danych logowania.
    2. Wpisz identyfikator klienta i tajny klucz klienta z kroku 1.
    3. Kliknij Zamknij.
    4. W polu Zakresy wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Autoryzuj. Plac zabaw OAuth 2 zwraca kod autoryzacji.
    5. Kliknij Kod autoryzacji Exchange dla tokenów. Token jest zwracany.

  3. Aby zainicjować obsługę zewnętrznej usługi Cloud Search, użyj tego polecenia curl. Zastąp [YOUR_ACCESS_TOKEN] tokenem uzyskanym w kroku 2.

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    Jeśli operacja się uda, treść odpowiedzi będzie zawierała wystąpienie obiektu operation. Przykład:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

    Jeśli się to nie powiedzie, skontaktuj się z zespołem pomocy Cloud Search.

  4. Sprawdź przy użyciu pliku operations.get, aby włączyć obsługę zewnętrznych usług pomocy:

    curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    Po zakończeniu inicjowania przez firmę zewnętrzną zawiera ona pole done ustawione na true. Na przykład:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

Dalsze kroki

Oto co możesz teraz zrobić:

  1. Jeśli zamierzasz używać Google Cloud Search z repozytorium danych innym niż Google, np. Microsoft® SharePoint®, musisz utworzyć źródło danych. Instrukcje dotyczące dodawania źródła danych znajdziesz w artykule Dodawanie źródła danych w wyszukiwarce.

  2. Po skonfigurowaniu źródła danych możesz utworzyć i zarejestrować schemat, aby określić, w jaki sposób Google Cloud Search będzie reprezentować dane w repozytorium.