Đị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 một 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 Google Cloud. 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ở Google Cloud Console.
  2. Nhấp vào trình đơn thả xuống dự án ở bên phải "Google Cloud Console" 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ã nhận dạng này sau khi tạo.
  5. Nhấp vào DUYỆT XEM để chọn một vị trí, rồi 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 phần 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 trong trình đơn thả xuống ở biểu ngữ Google Cloud Console.
  2. Nhấp vào BẬT API VÀ DỊCH VỤ.
  3. Tì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 bài viết Quản lý API trong Google Cloud Console.

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

  1. Trong Bảng điều khiển Google Cloud, hãy nhấp vào Thông tin đăng nhập 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, rồi 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 bài viết Tài khoản dịch vụ.

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

  1. Trong Google Cloud Console, 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. Lưu ý địa chỉ email cho tài khoản dịch vụ của bạn. Bạn cần có quyền này để thêm một 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 chế độ hỗ trợ bên thứ ba cho Google Cloud Search trước khi bạn gọi bất kỳ API Cloud Search nào khác.

Cách khởi động chế độ hỗ trợ bên thứ ba:

  1. Tạo thông tin đăng nhập của ứng dụng web trong dự án nền tảng Cloud Search. Xem phần Tạo thông tin đăng nhập. Bạn cần có mã ứng dụng khách và khoá bí mật của ứng dụng khách.
  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 đăng nhập OAuth 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.
    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 cho API.
    4. Nhấp vào Đổ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 được, hãy liên hệ với nhóm 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 sẽ 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 (chẳng hạn như Microsoft® SharePoint®), bạn phải tạo một nguồn dữ liệu. Xem phần 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 giản đồ để xác định cách Cloud Search biểu thị dữ liệu của bạn, cách Cloud Search nên biểu thị dữ liệu.