Konfigurowanie dostępu do interfejsu Google Cloud Search API

Zanim zaczniesz korzystać z interfejsu Google Cloud Search API bezpośrednio lub za pomocą pakietu SDK, musisz skonfigurować do niego dostęp. Ten dokument zawiera opis czynności wymaganych w przypadku interfejsu Cloud Search API REST.

1. Tworzenie projektu interfejsu API

Aby włączyć interfejs API, najpierw utwórz projekt Google Cloud. Ten projekt jest podstawą do korzystania z usług Google Cloud, zarządzania interfejsami API i ustawiania uprawnień.

  1. Otwórz konsolę Google Cloud.
  2. Kliknij menu projektu po prawej stronie „Konsola Google Cloud” i wybierz NOWY PROJEKT.
  3. Wpisz nazwę w polu Nazwa projektu.
  4. (Opcjonalnie) Kliknij Edytuj, aby zmienić identyfikator projektu. Po utworzeniu nie możesz zmienić tego identyfikatora.
  5. Kliknij PRZEGLĄDAJ, aby wybrać lokalizację, a potem kliknij Wybierz.
  6. Kliknij Utwórz. Projekt jest zwykle gotowy w ciągu kilku minut.

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

2. Włącz API

Włącz interfejs Cloud Search API i utwórz konto usługi, aby uzyskać dane logowania.

  1. Wybierz nowy projekt z menu w banerze konsoli Google Cloud.
  2. Kliknij WŁĄCZ INTERFEJSY API I USŁUGI.
  3. Wyszukaj i wybierz Google Cloud Search API.
  4. Kliknij Włącz.

Więcej informacji znajdziesz w artykule Zarządzanie interfejsami API w Google Cloud Console.

3. Tworzenie danych logowania do konta usługi

  1. W konsoli Google Cloud w menu po lewej stronie kliknij Dane logowania.
  2. W menu Utwórz dane logowania kliknij Konto usługi.
  3. W polu Nazwa konta usługi wpisz odpowiednią nazwę.
  4. (Opcjonalnie) Edytuj identyfikator konta usługi.
  5. Kliknij Utwórz i kontynuuj.
  6. Aby przejść do listy „Konta usługi”, kliknij Gotowe.
  7. Kliknij adres e-mail nowego konta usługi, a następnie wybierz kartę Klucze.
  8. Kliknij DODAJ KLUCZ > Utwórz nowy klucz.
  9. Wybierz JSON i kliknij Utwórz. Klucz prywatny zostanie pobrany na komputer.

Więcej informacji znajdziesz w artykule Konta usługi.

4. Określanie adresu e-mail konta usługi

  1. W konsoli Google Cloud wybierz projekt.
  2. Kliknij Menu nawigacyjne > Administracja > Konta usługi.
  3. Zanotuj adres e-mail konta usługi. Jest to potrzebne do dodania źródła danych do Cloud Search.

5. Inicjowanie obsługi innych firm

Zanim wywołasz inne interfejsy Cloud Search API, zainicjuj obsługę usług innych firm w Google Cloud Search.

Aby zainicjować obsługę innych firm:

  1. Utwórz dane logowania aplikacji internetowej w projekcie platformy Cloud Search. Więcej informacji znajdziesz w artykule Tworzenie danych logowania. Potrzebujesz identyfikatora klienta i tajnego klucza klienta.
  2. Uzyskaj token dostępu za pomocą OAuth 2.0 Playground:
    1. Kliknij Konfiguracja OAuth 2.0 (ikona ustawień) i zaznacz Użyj własnych danych logowania OAuth.
    2. Wpisz identyfikator i tajny klucz klienta.
    3. W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Autoryzuj interfejsy API.
    4. Kliknij Wymień kod autoryzacji na tokeny.

  3. Uruchom to polecenie curl, zastępując [YOUR_ACCESS_TOKEN] swoim tokenem:

    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 obiekt operation. Jeśli się nie uda, skontaktuj się z zespołem pomocy Cloud Search.

  4. Aby zweryfikować inicjowanie, użyj operations.get:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    Inicjowanie zostanie zakończone, gdy done będzie true.

Następne kroki

  1. Aby korzystać z Cloud Search w repozytorium innym niż Google, np. Microsoft® SharePoint®, musisz utworzyć źródło danych. Patrz Dodawanie źródła danych do wyszukiwania.
  2. Po skonfigurowaniu źródła danych utwórz i zarejestruj schemat, aby określić, jak Cloud Search ma reprezentować dane.