Định cấu hình quyền truy cập vào Google Cloud Search API

Bạn phải định cấu hình quyền truy cập vào Google Cloud Search API trước khi sử dụng 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 cho Cloud Search API REST API.

1. Tạo một dự án API

Để bật API, trước tiên hãy tạo một dự án trên đám mây của Google. Dự án này là nền tảng để sử dụng các dịch vụ của Google Cloud, quản lý API và thiết lập quyền.

1. Mở bảng điều khiển Cloud.
2. Nhấp vào trình đơn thả xuống dự án ở bên phải "bảng điều khiển Cloud" rồi chọn DỰ ÁN MỚI.
3. Nhập tên vào trường Tên dự án.
4. (Không bắt buộc) Nhấp vào Chỉnh sửa để thay đổi Mã dự án. Bạn không thể thay đổi mã này sau khi tạo.
5. Nhấp vào DUYỆT để chọn một vị trí, sau đó nhấp vào Chọn.
6. Nhấp vào Tạo. Dự án thường sẵn sàng trong vòng vài phút.

Để biết thêm thông tin, hãy xem bài viết Tạo và quản lý dự án.

2. Bật API

Bật Cloud Search API và tạo một tài khoản dịch vụ để lấy thông tin xác thực.

1. Chọn dự án mới của bạn trong trình đơn thả xuống ở biểu ngữ bảng điều khiển Cloud.
2. Nhấp vào BẬT API VÀ DỊCH VỤ.
3. Tìm kiếm và chọn Google Cloud Search API.
4. Nhấp vào Bật.

Để biết thêm thông tin, hãy xem Quản lý API trong bảng điều khiển Cloud.

3. Tạo thông tin xác thực cho tài khoản dịch vụ

1. Trong bảng điều khiển Cloud, hãy nhấp vào Thông tin xác thực trong trình đơn điều hướng bên trái.
2. Chọn Tài khoản dịch vụ trong trình đơn thả xuống Tạo thông tin xác thực.
3. Nhập tên vào trường Tên tài khoản dịch vụ.
4. (Không bắt buộc) Chỉnh sửa mã tài khoản dịch vụ.
5. Nhấp vào Tạo và tiếp tục.
6. Nhấp vào Xong để chuyển đến danh sách "Tài khoản dịch vụ".
7. Nhấp vào email của tài khoản dịch vụ mới, sau đó chọn thẻ Khoá.
8. Nhấp vào THÊM KHOÁ > Tạo khoá mới.
9. Chọn JSON rồi nhấp vào Tạo. Khoá riêng tư sẽ tải xuống máy tính của bạn.

Để biết thêm thông tin, hãy xem Tài khoản dịch vụ.

4. Xác định email của tài khoản dịch vụ

1. Trong bảng điều khiển Cloud, hãy chọn dự án của bạn.
2. Nhấp vào Trình đơn điều hướng > IAM và Quản trị > Tài khoản dịch vụ.
3. Ghi lại địa chỉ email cho tài khoản dịch vụ của bạn. Bạn cần địa chỉ email này để thêm nguồn dữ liệu vào Cloud Search.

5. Khởi chạy tính năng hỗ trợ bên thứ ba

Khởi chạy tính năng hỗ trợ bên thứ ba cho Google Cloud Search trước khi gọi bất kỳ API Cloud Search nào khác.

Cách khởi chạy tính năng hỗ trợ bên thứ ba:

1. Tạo thông tin xác thực của ứng dụng web trong dự án nền tảng Cloud Search. Xem bài viết Tạo thông tin xác thực. Bạn cần có mã ứng dụng và khoá bí mật của ứng dụng.
2. Lấy mã truy cập bằng OAuth 2.0 Playground:
   1. Nhấp vào Cấu hình OAuth 2.0 (biểu tượng cài đặt) rồi đánh dấu vào Sử dụng thông tin xác thực OAuth của riêng bạn.
   2. Nhập mã ứng dụng và khoá bí mật của ứng dụng.
   3. 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 API.
   4. Nhấp vào Trao đổi mã uỷ quyền để lấy mã thông báo.

3. Chạy lệnh curl này, thay thế [YOUR_ACCESS_TOKEN] bằng mã thông báo của bạn:

   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ẽ bao gồm một operation. Nếu không thành công, hãy liên hệ với bộ phận hỗ trợ Cloud Search.

4. Sử dụng operations.get để xác minh quá trình khởi chạy:

   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
   

   Quá trình khởi chạy hoàn tất khi done là true.

Các bước tiếp theo

1. Để sử dụng Cloud Search với một kho lưu trữ không phải của Google như Microsoft® SharePoint®, bạn phải tạo một nguồn dữ liệu. Xem bài viết Thêm nguồn dữ liệu để tìm kiếm.
2. Sau khi thiết lập nguồn dữ liệu, hãy tạo và đăng ký một lược đồ. để xác định cách Cloud Search biểu thị dữ liệu của bạn. cách Cloud Search biểu thị dữ liệu.