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. Utwórz projekt 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 „Konsoli Google Cloud” i wybierz NOWY PROJEKT.
  3. W polu Nazwa projektu wpisz nazwę.
  4. (Opcjonalnie) Kliknij Edytuj , aby zmienić identyfikator projektu. Po utworzeniu nie można zmienić tego identyfikatora.
  5. Kliknij PRZEGLĄDAJ , aby wybrać lokalizację, a następnie 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 Cloud Search API i utwórz konto usługi, aby uzyskać dane logowania.

  1. W menu w banerze konsoli Google Cloud wybierz nowy projekt.
  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 konsoli Google Cloud.

3. Utwórz dane logowania do konta usługi

  1. W konsoli Google Cloud kliknij Dane logowania w menu po lewej stronie.
  2. W menu Utwórz dane logowania wybierz Konto usługi.
  3. W polu Nazwa konta usługi wpisz 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. Zidentyfikuj adres e-mail konta usługi

  1. W konsoli Google Cloud wybierz swój projekt.
  2. Kliknij Menu nawigacyjne > Uprawnienia i administrator > Konta usługi.
  3. Zapisz adres e-mail konta usługi. Będzie on potrzebny do dodania źródła danych do Cloud Search.

5. Zainicjuj obsługę innych firm

Zanim wywołasz inne interfejsy Cloud Search API, zainicjuj obsł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. Zobacz Tworzenie danych logowania. Potrzebujesz identyfikatora i tajnego klucza klienta.
  2. Uzyskaj token dostępu za pomocą OAuth 2.0 Playground:
    1. Kliknij Konfiguracja OAuth 2.0 (ikonę 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 Kod autoryzacji wymiany dla tokenów.

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

  4. Aby sprawdzić inicjację, 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

    Inicjacja jest zakończona, gdy done ma wartość true.

Następne kroki

  1. Aby używać Cloud Search z repozytorium innym niż Google, np. Microsoft® SharePoint®, musisz utworzyć źródło danych. Zobacz 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.