Đị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 có thể trực tiếp sử dụng API này 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.

1. Tạo dự án API

Để bật API, trước tiên, bạn phải tạo một dự án Google Cloud. Dự án này là nền tảng để tạo, bật và sử dụng tất cả các dịch vụ của Google Cloud, bao gồm cả việc quản lý API, bật tính năng thanh toán, thêm và xoá cộng tác viên cũng như quản lý quyền.

1. Mở Google Cloud Console.

2. Ở đầu trang, hãy nhấp vào biểu tượng ở bên phải "Google Cloud Console". Một hộp thoại liệt kê các dự án hiện tại sẽ xuất hiện.

3. Nhấp vào NEW PROJECT (DỰ ÁN MỚI). Màn hình "New Project" (Dự án mới) sẽ xuất hiện.

4. Nhập tên dự án trong trường Project Name (Tên dự án).

5. (không bắt buộc) Nhấp vào Chỉnh sửa để chỉnh sửa Mã dự án. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.

6. Để duyệt qua các vị trí cho dự án, hãy nhấp vào DUYỆT TRA.

7. Nhấp vào một vị trí cho dự án của bạn rồi nhấp vào Chọn.

8. 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 bài viết 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ụ để nhận thông tin xác thực.

1. Để đả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 của biểu ngữ trên bảng điều khiển Google Cloud rồi chọn dự án mới tạo của bạn.
2. Nhấp vào BẬT API VÀ DỊCH VỤ. Trang "Chào mừng bạn đến với Thư viện API" sẽ xuất hiện.
3. Chuyển đến Google Cloud Search API.
4. Nhấp vào Bật. Trang "Tổng quan" sẽ 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 bài viết Quản lý API trong bảng điều khiển Google Cloud

Lưu ý: Các API Cloud Search khác nhau yêu cầu các tài khoản khác nhau để thực thi (quản trị viên, dịch vụ và người dùng). Để biết thêm thông tin, hãy tham khảo tài liệu tham khảo về phương thức bạn muốn gọi.

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

1. Trong Google Cloud Console, hãy nhấp vào Thông tin xác thực trong bảng điều hướng bên trái. Trang Thông tin xác thực sẽ xuất hiện.
2. 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ụ. Trang "Tạo tài khoản dịch vụ" sẽ xuất hiện.
3. Nhập tên vào trường Tên tài khoản dịch vụ.
4. Chỉnh sửa mã tài khoản dịch vụ (không bắt buộc).
5. Nhấp vào Tạo. Màn hình "Quyền cho tài khoản dịch vụ" sẽ xuất hiện.
6. Nhấp vào Tiếp tục. Màn hình "Cấp cho người dùng quyền truy cập vào tài khoản dịch vụ này" sẽ xuất hiện.
7. Nhấp vào TẠO KHOÁ rồi nhấp vào Xong. Hộp thoại "Khoá riêng tư đã lưu vào máy tính của bạn" sẽ xuất hiện và một bản sao của khoá riêng tư sẽ được tải xuống máy tính của bạn.
8. Nhấp vào Close (Đóng).

Để biết thêm thông tin về tài khoản dịch vụ, hãy tham khảo bài viết 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

1. Trong bảng điều khiển Google Cloud, hãy chọn dự án bạn đã tạo ở đầu trang.
2. Nhấp vào trình đơn Điều hướng ở bên trái biểu ngữ Google Cloud Console.
3. Nhấp vào IAM and Admin (Quản trị viên và quản lý danh tính và quyền truy cập) > Tài khoản dịch vụ.
4. Trong danh sách, trong phần "Mã tài khoản dịch vụ", hãy ghi lại địa chỉ email đã tạo để xác định tài khoản dịch vụ mà 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 chạy tính năng hỗ trợ 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 dịch vụ hỗ trợ của bên thứ ba cho Google Cloud Search.

Lưu ý: Nếu thực thi thành công hướng dẫn về Cloud Search thì bạn đã khởi động dịch vụ hỗ trợ bên thứ ba dành cho Cloud Search và có thể bỏ qua bước này.

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

1. Dự án trên Cloud Search Platform chứa thông tin xác thực của tài khoản dịch vụ. Tuy nhiên, để khởi chạy tính năng hỗ trợ bên thứ ba, bạn phải tạo thông tin xác thực ứng dụng web. Để biết hướng dẫn về cách tạo thông tin xác thực ứng dụng web, hãy tham khảo phần 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.

2. Sử dụng OAuth 2 playground của Google để lấy mã truy cập:

   1. Nhấp vào phần cài đặt rồi đánh dấu vào Sử dụng thông tin xác thực của riêng bạn.
   2. Nhập mã ứng dụng khách và mật khẩu ứng dụng khách từ bước 1.
   3. Nhấp vào Close (Đóng).
   4. 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. OAuth 2 playground sẽ trả về một mã uỷ quyền.
   5. Nhấp vào Mã uỷ quyền Exchange cho mã thông báo. Hệ thống sẽ trả về một mã thông báo.

3. Để khởi chạy tính năng hỗ trợ bên thứ ba cho Cloud Search, hãy sử dụng lệnh curl sau. Hãy nhớ thay thế [YOUR_ACCESS_TOKEN] bằng mã thông báo thu được ở 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 thực thể 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 nhóm hỗ trợ Cloud Search.

4. 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, nó sẽ chứa trường done được đặt thành true. 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:

1. Nếu 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® SharePoint®, bạn phải tạo một nguồn dữ liệu. Để biết hướng dẫn về cách thêm nguồn dữ liệu, hãy tham khảo 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, bạn có thể tạo và đăng ký giản đồ để xác định cách Google Cloud Search thể hiện dữ liệu trong kho lưu trữ.