Настройте доступ к API Google Cloud Search.

Перед использованием API Google Cloud Search напрямую или через SDK необходимо настроить доступ к нему. В этом документе описаны шаги, необходимые для работы с REST API Cloud Search.

1. Создайте проект API.

Для включения API сначала создайте проект Google Cloud. Этот проект является основой для использования сервисов Google Cloud, управления API и настройки разрешений.

  1. Откройте консоль Google Cloud .
  2. Щелкните раскрывающийся список проектов справа от «Консоли Google Cloud» и выберите «Новый проект» .
  3. Введите название в поле «Название проекта» .
  4. (Необязательно) Нажмите «Редактировать» , чтобы изменить идентификатор проекта. После создания проекта изменить этот идентификатор будет невозможно.
  5. Нажмите кнопку «Обзор» , чтобы выбрать местоположение, затем нажмите кнопку «Выбрать» .
  6. Нажмите «Создать» . Проект обычно готов в течение нескольких минут.

Для получения более подробной информации см. раздел «Создание и управление проектами» .

2. Включите API.

Включите API Cloud Search и создайте учетную запись службы для получения учетных данных.

  1. Выберите свой новый проект из выпадающего меню в баннере консоли Google Cloud.
  2. Нажмите «Включить API и сервисы» .
  3. Найдите и выберите API Google Cloud Search .
  4. Нажмите «Включить» .

Для получения дополнительной информации см. раздел «Управление API в консоли Google Cloud» .

3. Создайте учетные данные сервисной учетной записи.

  1. В консоли Google Cloud в левой панели навигации нажмите «Учетные данные» .
  2. Выберите учетную запись службы из выпадающего меню «Создать учетные данные» .
  3. Введите имя в поле « Имя учетной записи службы» .
  4. (Необязательно) Отредактируйте идентификатор учетной записи службы.
  5. Нажмите «Создать и продолжить» .
  6. Нажмите «Готово» , чтобы перейти к списку «Учетные записи служб».
  7. Щелкните по адресу электронной почты вашей новой учетной записи, затем выберите вкладку «Ключи» .
  8. Нажмите ДОБАВИТЬ КЛЮЧ > Создать новый ключ .
  9. Выберите JSON и нажмите «Создать» . Закрытый ключ будет загружен на ваш компьютер.

Для получения дополнительной информации см. раздел «Учетные записи служб» .

4. Определите адрес электронной почты учетной записи службы.

  1. В консоли Google Cloud выберите свой проект.
  2. Щелкните меню навигации > IAM и администрирование > Учетные записи служб .
  3. Запишите адрес электронной почты вашей учетной записи в сервисе. Он необходим для добавления источника данных в Cloud Search.

5. Инициализация поддержки сторонних организаций.

Перед вызовом любых других API Cloud Search необходимо инициализировать поддержку сторонних сервисов для Google Cloud Search.

Для инициализации поддержки сторонних сервисов:

  1. Создайте учетные данные веб-приложения в проекте платформы Cloud Search. См. раздел «Создание учетных данных» . Вам понадобятся идентификатор клиента и секретный ключ клиента.
  2. Получите токен доступа, используя OAuth 2.0 Playground :
    1. Нажмите «Конфигурация OAuth 2.0» (значок настроек) и установите флажок «Использовать собственные учетные данные OAuth» .
    2. Введите свой идентификатор клиента и секретный ключ клиента.
    3. В поле «Области действия» введите https://www.googleapis.com/auth/cloud_search.settings и нажмите «Авторизовать API» .
    4. Нажмите «Код авторизации биржи для получения токенов» .

  3. Выполните следующую команду curl, заменив [YOUR_ACCESS_TOKEN] на ваш токен:

    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

    В случае успеха тело ответа будет содержать описание operation . В случае неудачи обратитесь в службу поддержки Cloud Search.

  4. Используйте 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

    Инициализация считается завершенной, когда done равно true .

Следующие шаги

  1. Для использования Cloud Search с хранилищем данных, отличным от Google, например, Microsoft® SharePoint®, необходимо создать источник данных. См. раздел «Добавление источника данных для поиска» .
  2. После настройки источника данных создайте и зарегистрируйте схему , чтобы определить, как Cloud Search представляет ваши данные. Как Cloud Search должен представлять данные.