Konfigurowanie dostępu do interfejsu Google Cloud Search API

Aby móc korzystać z Google Cloud Search API, musisz najpierw skonfigurować dostęp do interfejsu Google Cloud Search API. korzystać z tego interfejsu API bezpośrednio lub przez pakiet SDK. Ten dokument obejmuje kroki wymagane do korzystania z interfejsu Google Cloud Search API REST API.

1. Tworzenie projektu API

Aby włączyć interfejs API, musisz najpierw utworzyć projekt Google Cloud. Ten projekt stanowi podstawę do tworzenia, włączania i używania wszystkich rozwiązań Google Cloud między innymi do zarządzania interfejsami API, włączania płatności, dodawania usuwanie współpracowników i zarządzanie uprawnieniami.

  1. Otwórz konsolę Google Cloud.

  2. U góry strony kliknij po prawej stronie „Konsoli Google Cloud”. Okno z listą bieżących projektów

  3. Kliknij NOWY PROJEKT. „Nowy projekt” ekranu.

  4. Wpisz nazwę projektu w polu Nazwa projektu.

  5. (Opcjonalnie) Kliknij Edytuj, aby zmodyfikować identyfikator projektu. Identyfikatorem projektu nie może być zmienia się po utworzeniu projektu, wybierz więc Identyfikator, który spełnia Twoje potrzeby przez cały okres trwania projektu.

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

  7. Kliknij lokalizację projektu, a następnie Wybierz.

  8. Kliknij Utwórz. Konsola wyświetli stronę panelu. Projekt zostanie utworzona w ciągu kilku minut.

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

2. Włącz API

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

  1. Aby upewnić się, że korzystasz z nowo utworzonego projektu, kliknij po prawej stronie baner konsoli Google Cloud i wybierz nowo utworzony projekt.
  2. Kliknij WŁĄCZ INTERFEJSY API I USŁUGI. Interfejs „Welcome to API Library” strona
  3. Otwórz interfejs Google Cloud Search API.
  4. Kliknij Włącz. „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. Utwórz dane logowania do konta usługi

  1. W konsoli Google Cloud: W menu po lewej stronie kliknij Dane logowania. Pojawi się strona Dane logowania.
  2. Na liście Utwórz dane logowania wybierz Konto usługi. „Utwórz konto usługi”
  3. Wpisz nazwę w polu Nazwa konta usługi.
  4. (Opcjonalnie) Edytuj identyfikator konta usługi.
  5. Kliknij Utwórz. „Uprawnienia konta usługi” ekranu.
  6. Kliknij Dalej. komunikat „Przyznaj użytkownikom dostęp do tego konta usługi” Ekran
  7. Kliknij UTWÓRZ KLUCZ i wybierz Gotowe. „Klucz prywatny został zapisany na Twoim komputer” zostanie wyświetlone okno dialogowe, a kopia klucza prywatnego zostanie pobrana na komputera.
  8. Kliknij Zamknij.

Więcej informacji o kontach usługi znajdziesz tutaj: Konta usługi, aplikacje internetowe i zainstalowane aplikacje

4. Podaj adres e-mail

  1. W konsoli Google Cloud: wybierz utworzony 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” zanotuj wygenerowanego e-maila identyfikujący skonfigurowane konto usługi. Ten adres e-mail jest używane przy dodawaniu źródła danych do Cloud Search.

5. Inicjowanie pomocy zewnętrznej

Zanim będzie można wywołać inne interfejsy API Cloud Search, musisz zainicjować obsługę Google Cloud Search.

Aby zainicjować obsługę Cloud Search przez inną firmę:

  1. Twój projekt platformy Cloud Search zawiera dane logowania do konta usługi. Aby jednak zainicjować pomoc zewnętrzną, musisz utworzyć dane logowania do aplikacji. Instrukcje tworzenia aplikacji internetowej dane logowania, zapoznaj się z artykułem Utwórz dane logowania. Po wykonaniu tej czynności powinien być już identyfikator klienta i plik z tajnym kluczem klienta.

  2. Używaj Protokół Google OAuth 2 aby uzyskać token dostępu:

    1. Kliknij ustawienia i zaznacz Użyj własnych danych uwierzytelniających.
    2. Wpisz identyfikator klienta i tajny klucz klienta z kroku 1.
    3. Kliknij Zamknij.
    4. W polu zakresów wpisz https://www.googleapis.com/auth/cloud_search.settings i kliknij Autoryzuj. Narzędzie do testowania OAuth 2 zwraca kod autoryzacji.
    5. Kliknij Exchange authorization code for token (Kod autoryzacji giełdy dla tokenów). Zwracany jest token.

  3. Aby zainicjować obsługę Cloud Search przez inną firmę, użyj tego curl . Pamiętaj, aby zastąpić [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"
}

    W przypadku niepowodzenia skontaktuj się z zespołem pomocy Cloud Search.

  4. Użyj pliku operations.get, aby to sprawdzić. zostanie zainicjowana pomoc innych firm:

    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 usługi zewnętrznej zawiera pole done zostało ustawione na true. Na przykład:

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

Dalsze kroki

Oto kilka kolejnych kroków, które możesz podjąć:

  1. Jeśli zamierzasz używać Google Cloud Search z repozytorium danych spoza Google, takich jak Microsoft® SharePoint®, musi utworzyć źródło danych. Instrukcje dotyczące dodając źródło danych, zapoznaj się z artykułem Dodaj źródło danych do wyszukiwania.

  2. Po skonfigurowaniu źródła danych możesz utwórz i zarejestruj schemat, aby zidentyfikować jak Google Cloud Search ma przedstawiać dane w repozytorium.