Прежде чем использовать этот API напрямую или через SDK, необходимо настроить доступ к API Google Cloud Search. В этом документе описаны шаги, необходимые для использования REST API Google Cloud Search API.
1. Создайте проект API
Чтобы включить API, сначала необходимо создать проект Google Cloud. Этот проект формирует основу для создания, включения и использования всех сервисов Google Cloud, включая управление API, включение выставления счетов, добавление и удаление соавторов, а также управление разрешениями.
Откройте консоль Google Cloud .
В верхней части страницы нажмите
справа от «Google Cloud Console». Появится диалоговое окно со списком текущих проектов.Нажмите НОВЫЙ ПРОЕКТ . Появится экран «Новый проект».
Введите имя проекта в поле «Имя проекта» .
(необязательно) Нажмите «Изменить» , чтобы изменить идентификатор проекта. Идентификатор проекта нельзя изменить после его создания, поэтому выберите идентификатор, который соответствует вашим потребностям на протяжении всего срока действия проекта.
Чтобы просмотреть местоположения проекта, нажмите ОБЗОР .
Нажмите на местоположение вашего проекта и нажмите «Выбрать» .
Нажмите Создать . Консоль перейдет на страницу панели мониторинга. Проект создается в течение нескольких минут.
Дополнительную информацию о создании проектов и управлении ими см. в разделе Создание проектов и управление ими .
2. Включите API
Вам необходимо включить API Google Cloud Search и создать учетную запись службы для получения учетных данных.
- Чтобы убедиться, что вы находитесь в только что созданном проекте, щелкните справа от баннера консоли Google Cloud и выберите только что созданный проект.
- Нажмите ВКЛЮЧИТЬ APIS И СЕРВИСЫ . Появится страница «Добро пожаловать в библиотеку API».
- Перейдите к API Google Cloud Search .
- Нажмите Включить . Появится страница «Обзор».
Дополнительную информацию о включении и отключении API см. в разделе «Управление API в консоли Google Cloud».
3. Создайте учетные данные сервисной учетной записи.
- В консоли Google Cloud нажмите «Учетные данные» на левой панели навигации. Появится страница учетных данных.
- В раскрывающемся списке Создать учетные данные выберите Учетная запись службы . Появится страница «Создать учетную запись службы».
- Введите имя в поле Имя учетной записи службы .
- (необязательно) Измените идентификатор учетной записи службы.
- Нажмите Создать . Появится экран «Разрешения сервисной учетной записи».
- Нажмите Продолжить . Появится экран «Предоставить пользователям доступ к этой учетной записи службы».
- Нажмите СОЗДАТЬ КЛЮЧ и нажмите Готово . Появится диалоговое окно «Закрытый ключ сохранен на вашем компьютере», и копия закрытого ключа загрузится на ваш компьютер.
- Нажмите Закрыть .
Дополнительную информацию об учетных записях служб см. в разделе Учетные записи служб, веб-приложения и установленные приложения.
4. Определите адрес электронной почты
- В консоли Google Cloud выберите созданный вами проект вверху страницы.
- Нажмите меню навигации слева от баннера консоли Google Cloud.
- Нажмите IAM и Администрирование > Учетные записи служб .
- В списке в разделе «Идентификатор учетной записи службы» запишите сгенерированный адрес электронной почты, который идентифицирует настроенную вами учетную запись службы. Этот адрес электронной почты используется при добавлении источника данных в Cloud Search.
5. Инициализировать стороннюю поддержку
Прежде чем вы сможете вызывать любые другие API Cloud Search, вам необходимо инициализировать стороннюю поддержку Google Cloud Search.
Чтобы инициализировать стороннюю поддержку Cloud Search:
Ваш проект платформы Cloud Search содержит учетные данные сервисной учетной записи. Однако для инициализации сторонней поддержки необходимо создать учетные данные веб-приложения. Инструкции по созданию учетных данных веб-приложения см. в разделе Создание учетных данных . По завершении этого шага у вас должен быть идентификатор клиента и секретный файл клиента.
Используйте площадку Google OAuth 2 для получения токена доступа:
- Нажмите «Настройки» и установите флажок «Пользователь имеет свои учетные данные» .
- Введите идентификатор клиента и секрет клиента из шага 1.
- Нажмите Закрыть .
- В поле «Области» введите
https://www.googleapis.com/auth/cloud_search.settings
и нажмите «Авторизовать» . Игровая площадка OAuth 2 возвращает код авторизации. - Нажмите «Код авторизации Exchange для токенов» . Токен возвращается.
Чтобы инициализировать стороннюю поддержку Cloud Search, используйте следующую команду Curl. Обязательно замените
[YOUR_ACCESS_TOKEN]
токеном, полученным на шаге 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
В случае успеха тело ответа содержит экземпляр
operation
. Например:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" }
В случае неудачи обратитесь в службу поддержки Cloud Search.
Используйте Operations.get , чтобы убедиться, что инициализирована сторонняя поддержка:
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
Когда сторонняя инициализация завершена, она содержит поле
done
со значениемtrue
. Например:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" done: true }
Следующие шаги
Вот несколько следующих шагов, которые вы можете предпринять:
Если вы планируете использовать Google Cloud Search с хранилищем данных, не принадлежащим Google, например Microsoft® SharePoint®, вам необходимо создать источник данных. Инструкции по добавлению источника данных см. в разделе Добавление источника данных для поиска .
Настроив источник данных, вы можете создать и зарегистрировать схему, чтобы определить, как Google Cloud Search должен представлять данные в репозитории.