Bạn phải định cấu hình quyền truy cập vào Google Cloud Search API trước khi có thể hãy sử dụng API này một cách trực tiếp hoặc thông qua SDK. Tài liệu này trình bày các bước cần thiết để sử dụng API REST của Google Cloud Search API.
1. Tạo dự án API
Để bật API này, trước tiên, bạn phải tạo một dự án trên Google Cloud. Chiến dịch này dự án này là cơ sở để tạo, kích hoạt và sử dụng toàn bộ Google Cloud các dịch vụ, bao gồm quản lý API, bật tính năng thanh toán, thêm và xoá cộng tác viên và quản lý quyền.
Ở đầu trang, hãy nhấp vào
ở bên phải "Google Cloud Console". Hộp thoại liệt kê các dự án hiện tại sẽ xuất hiện.Nhấp vào Dự án MỚI. "Dự án mới" màn hình xuất hiện.
Nhập tên dự án vào trường Project Name (Tên dự án).
(không bắt buộc) Nhấp vào Chỉnh sửa để chỉnh sửa Mã dự án. Mã dự án không được thay đổi sau khi tạo dự án, vì vậy hãy chọn một Mã nhận dạng đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.
Để duyệt xem các vị trí cho dự án, hãy nhấp vào DUYỆT XEM.
Nhấp vào vị trí cho dự án của bạn rồi nhấp vào Select (Chọn).
Nhấp vào Tạo. Bảng điều khiển sẽ chuyển đến Trang tổng quan. Dự án sẽ được tạo trong vòng vài phút.
Để biết thêm thông tin về cách tạo và quản lý dự án, hãy tham khảo Tạo và quản lý dự án.
2. Bật API
Bạn cần bật Google Cloud Search API và tạo một tài khoản dịch vụ để lấy thông tin đăng nhập.
- Để đảm bảo bạn đang sử dụng dự án mới tạo, hãy nhấp vào Biểu tượng ở bên phải Biểu ngữ của bảng điều khiển Google Cloud và chọn dự án mới tạo của bạn.
- Nhấp vào BẬT API VÀ DỊCH VỤ. Thư viện "Chào mừng bạn đến với Thư viện API" trang sẽ xuất hiện.
- Chuyển đến Google Cloud Search API.
- Nhấp vào Bật. Thẻ "Tổng quan" trang xuất hiện.
Để biết thêm thông tin về cách bật và tắt API, hãy tham khảo Quản lý API trong bảng điều khiển Google Cloud
3. Tạo thông tin xác thực cho tài khoản dịch vụ
- Trong bảng điều khiển Google Cloud, nhấp vào Thông tin đăng nhập trong bảng điều hướng bên trái. Trang Chứng chỉ xuất hiện.
- Trong danh sách thả xuống Tạo thông tin xác thực, hãy chọn Tài khoản dịch vụ. Chiến lược phát hành đĩa đơn "Tạo tài khoản dịch vụ" trang xuất hiện.
- Nhập tên vào trường Tên tài khoản dịch vụ.
- Chỉnh sửa mã tài khoản dịch vụ (không bắt buộc).
- Nhấp vào Tạo. "Quyền đối với tài khoản dịch vụ" màn hình xuất hiện.
- Nhấp vào Tiếp tục. "Cấp cho người dùng quyền truy cập vào tài khoản dịch vụ này" màn hình sẽ xuất hiện.
- Nhấp vào TẠO KHOÁ rồi nhấp vào Xong. "Đã lưu khoá riêng tư vào máy tính" xuất hiện và một bản sao của khoá riêng tư sẽ tải xuống ứng dụng của bạn.
- Nhấp vào Đóng.
Để biết thêm thông tin về tài khoản dịch vụ, hãy tham khảo Tài khoản dịch vụ, ứng dụng web và ứng dụng đã cài đặt
4. Xác định địa chỉ email
- Trên bảng điều khiển Google Cloud, chọn dự án mà bạn đã tạo ở đầu trang.
- Nhấp vào trình đơn Điều hướng ở bên trái biểu ngữ bảng điều khiển Google Cloud.
- Nhấp vào IAM and Admin (Quản trị và quản lý danh tính và quyền truy cập) > Tài khoản dịch vụ.
- Trong danh sách, ở phần "Mã tài khoản dịch vụ", ghi lại email đã tạo địa chỉ này xác định tài khoản dịch vụ bạn đã định cấu hình. Địa chỉ email này được dùng khi thêm nguồn dữ liệu vào Cloud Search.
5. Khởi động dịch vụ hỗ trợ của bên thứ ba
Trước khi có thể gọi bất kỳ API Cloud Search nào khác, bạn phải khởi chạy API của bên thứ ba hỗ trợ dành cho Google Cloud Search.
Để bắt đầu hỗ trợ bên thứ ba cho Cloud Search:
Dự án nền tảng Cloud Search của bạn có chứa thông tin đăng nhập vào tài khoản dịch vụ. Tuy nhiên, để khởi động dịch vụ hỗ trợ của bên thứ ba, bạn phải tạo trang web thông tin đăng nhập của ứng dụng. Để xem hướng dẫn về cách tạo ứng dụng web thông tin xác thực, tham khảo Tạo thông tin xác thực. Sau khi hoàn tất bước này, bạn sẽ có một ID ứng dụng khách và tệp mật khẩu ứng dụng khách.
Sử dụng Sân chơi OAuth 2 của Google để lấy mã truy cập:
- Nhấp vào phần cài đặt rồi đánh dấu chọn Người dùng sử dụng thông tin xác thực của riêng bạn.
- Nhập mã ứng dụng khách và mật khẩu ứng dụng khách ở bước 1.
- Nhấp vào Đóng.
- Trong trường phạm vi, hãy nhập
https://www.googleapis.com/auth/cloud_search.settings
rồi nhấp vào Uỷ quyền. Sân chơi OAuth 2 trả về mã uỷ quyền. - Nhấp vào Mã uỷ quyền Exchange cho mã thông báo. Một mã thông báo sẽ được trả về.
Để bắt đầu hỗ trợ bên thứ ba cho Cloud Search, hãy sử dụng curl sau . Hãy nhớ thay thế
[YOUR_ACCESS_TOKEN]
bằng mã thông báo thu được trong bước 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
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của
operation
. Ví dụ:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" }
Nếu không thành công, hãy liên hệ với bộ phận hỗ trợ của Cloud Search.
Sử dụng operations.get để xác minh rằng dịch vụ hỗ trợ của bên thứ ba đã được khởi chạy:
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
Khi quá trình khởi chạy bên thứ ba hoàn tất, quá trình này sẽ chứa trường
done
được đặt thànhtrue
. Ví dụ:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" done: true }
Các bước tiếp theo
Dưới đây là một vài bước tiếp theo bạn có thể thực hiện:
Nếu bạn dự định sử dụng Google Cloud Search với một kho lưu trữ dữ liệu không phải của Google, chẳng hạn như Microsoft® Perfetto®, bạn phải tạo một nguồn dữ liệu. Để xem hướng dẫn về thêm nguồn dữ liệu, hãy tham khảo Thêm một nguồn dữ liệu để tìm kiếm.
Sau khi thiết lập nguồn dữ liệu, bạn có thể tạo và đăng ký giản đồ để xác định cách Google Cloud Search biểu thị dữ liệu trong kho lưu trữ.