1. Trước khi bắt đầu
Lớp học lập trình này hướng dẫn bạn cách tạo một dự án trên Google Cloud, sau đó gọi các API của Google Cloud từ dự án đó.
Điều kiện tiên quyết
- Có thể điều hướng trong Google Cloud Console.
Kiến thức bạn sẽ học được
- Cách tạo dự án trên Google Cloud.
- Cách thiết lập tài khoản thanh toán.
- Cách thiết lập Cloud Shell.
- Cách bật một API.
- Cách uỷ quyền cho một API bằng khoá API.
- Cách uỷ quyền cho một API bằng tài khoản dịch vụ.
Bạn cần có
- Tài khoản Google, chẳng hạn như tài khoản Gmail hoặc tài khoản Google Workspace.
- Có quyền truy cập vào một tài khoản thanh toán trên Cloud hoặc thẻ tín dụng để đăng ký Chương trình dùng thử miễn phí.
2. Bắt đầu thiết lập
Phần này hướng dẫn bạn cách tạo một dự án trên Google Cloud, thiết lập tài khoản thanh toán và thiết lập Cloud Shell.
Tạo một dự án trên Google Cloud và thiết lập tài khoản thanh toán
- Đăng nhập vào Cloud Console rồi chọn hoặc tạo một dự án.
Ghi nhớ mã dự án xuất hiện trong trường Tên dự án. Mã này là một tên riêng biệt cho tất cả các dự án trên Google Cloud (tên ở trên đã được sử dụng) và sẽ được gọi là PROJECT_ID trong lớp học lập trình này.
- Tiếp theo, hãy bật tính năng thanh toán trong Cloud Console để sử dụng các tài nguyên của Google Cloud.
Mặc dù lớp học lập trình này không tốn nhiều chi phí (nếu có), nhưng bạn nên làm theo hướng dẫn trong phần Dọn dẹp để tắt các tài nguyên và tránh phát sinh chi phí ngoài lớp học lập trình này. Xin lưu ý rằng người dùng mới của Google Cloud đủ điều kiện dùng thử miễn phí trị giá 300 USD.
Thiết lập Cloud Shell
Trong lớp học lập trình này, bạn sẽ sử dụng Cloud Shell, một môi trường dòng lệnh chạy trong Google Cloud. Cloud Shell là một máy ảo dựa trên Debian được trang bị tất cả các công cụ phát triển mà bạn cần. Thư mục này cung cấp một thư mục chính có dung lượng 5 GB và tồn tại vĩnh viễn, giúp tăng cường đáng kể hiệu suất mạng và hoạt động xác thực. Điều này có nghĩa là bạn chỉ cần một trình duyệt để tham gia lớp học lập trình này.
Cách kích hoạt Cloud Shell từ Cloud Console:
- Nhấp vào biểu tượng
Kích hoạt Cloud Shell.
Có thể mất vài phút để cung cấp và kết nối với môi trường.
Sau khi kết nối với Cloud Shell, bạn sẽ thấy rằng mình đã được xác thực và dự án đã được đặt thành PROJECT_ID.
- Tạo danh sách các tài khoản có thông tin xác thực:
gcloud auth list
Bạn sẽ thấy kết quả sau:
Credentialed accounts:
- <MY_ACCOUNT>@<MY_DOMAIN>.com (active)
- Để xem danh sách các dự án của bạn, hãy nhập lệnh này.
gcloud config list project
Bạn sẽ thấy kết quả sau:
[core]
project = <PROJECT_ID>
Nếu vì lý do nào đó mà dự án chưa được thiết lập, hãy chạy lệnh này để thiết lập dự án.
gcloud config set project <PROJECT_ID>
PROJECT_ID là mã nhận dạng mà bạn đã dùng trong các bước thiết lập. Bạn cũng có thể tra cứu trong trang tổng quan của Cloud Console:
Cloud Shell cũng đặt một số biến môi trường theo mặc định, có thể hữu ích khi bạn chạy các lệnh sau này.
- Để xem mã dự án, hãy nhập lệnh sau.
echo $GOOGLE_CLOUD_PROJECT
Bạn sẽ thấy kết quả sau đây:
<PROJECT_ID>
- Cuối cùng, hãy đặt cấu hình dự án và vùng mặc định.
gcloud config set compute/zone us-central1-f
Bạn có thể chọn nhiều múi giờ khác nhau. Để biết thêm thông tin, hãy xem phần Khu vực và múi giờ.
3. Gọi một API từ dự án
Lớp học lập trình này hướng dẫn bạn cách sử dụng một API mẫu (Natural Language API) để tìm các thực thể (chẳng hạn như người, địa điểm và sự kiện) trong văn bản, cũng như cách ước chừng tình cảm (mức độ yêu thích) của văn bản đó. Bạn sẽ tìm hiểu cách:
- Bật các API của Google Cloud.
- Uỷ quyền cho API bằng khoá API và tài khoản dịch vụ.
- Gọi API bằng
curlvà thư viện ứng dụng.
Bật một API
- Chọn API và dịch vụ trong trình đơn chính của Cloud Console.
- Chọn + BẬT API VÀ DỊCH VỤ ở đầu màn hình.
- Tại thời điểm này, bạn có thể lọc và duyệt xem các API hoặc chuyển trực tiếp đến một API bằng hộp Tìm kiếm. Tìm
Natural Languagerồi chọn Cloud Natural Language API.
- Nhấp vào DÙNG THỬ API NÀY.
Nếu không thấy nút DÙNG THỬ API NÀY, hãy nhấp vào một trong các Phương thức được liệt kê để dùng thử phương thức đó.
Tạo khoá API
Vì bạn dùng curl để gửi yêu cầu đến Natural Language API, nên bạn phải tạo một khoá API để truyền vào URL yêu cầu.
- Trong Cloud Console, hãy chọn Trình đơn điều hướng > API và dịch vụ > Thông tin xác thực.
- Nhấp vào TẠO THÔNG TIN XÁC THỰC rồi chọn Khoá API:
- Sao chép khoá API đã tạo rồi nhấp vào Đóng.
Sử dụng khoá API để gọi API
- Trong dòng lệnh Cloud Shell, hãy xuất khoá API của bạn.
export API_KEY=<YOUR_API_KEY>
Thay thế <YOUR_API_KEY> bằng khoá mà bạn đã tạo trước đó.
- Tạo yêu cầu cho API trong Cloud Shell Editor hoặc bằng một trình chỉnh sửa Linux, chẳng hạn như Vim hoặc Emacs. Bạn có thể xem thông tin chi tiết về các tham số tại Phương thức: documents.analyzeEntities. Lưu đầu ra vào một tệp có tên là
request.json:
{
"document":{
"type":"PLAIN_TEXT",
"content":"Google, headquartered in Mountain View (1600 Amphitheatre Pkwy, Mountain View, CA 940430), unveiled the new Android phone for $799 at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones."
},
"encodingType":"UTF8"
}
- Gọi API bằng thông tin yêu cầu.
curl "https://language.googleapis.com/v1/documents:analyzeEntities?key=${API_KEY}" \
-s -X POST -H "Content-Type: application/json" --data-binary @request.json
- Chạy lại lệnh này, chuyển hướng đầu ra đến một tệp rồi kiểm tra kết quả. Thông tin chi tiết về đầu ra của tệp JSON cũng có trong Phương thức: documents.analyzeEntities.
- Để thay đổi văn bản cần phân tích trong tệp
request.json, hãy thay thế giá trịcontentbằng văn bản bạn chọn.
4. Uỷ quyền bằng tài khoản dịch vụ
Tài khoản dịch vụ thường được ưu tiên hơn khoá API vì chúng cung cấp cả hoạt động xác thực và uỷ quyền. Bạn có thể coi tài khoản dịch vụ là địa chỉ email cho ứng dụng của mình.
- Quay lại phần Thông tin xác thực trong trình đơn API và dịch vụ.
- Chọn Tạo thông tin xác thực, nhưng lần này, hãy chọn Tài khoản dịch vụ.
- Cung cấp Tên tài khoản dịch vụ mô tả mục đích của tài khoản, chẳng hạn như "
Natural Language Service Account". Hệ thống sẽ đề xuất một mã nhận dạng. Bạn cũng có thể thêm nội dung mô tả. Khi tìm hiểu thêm về tài khoản dịch vụ, bạn sẽ cấp cho tài khoản dịch vụ quyền truy cập vào các dự án và cấp cho người dùng quyền truy cập vào tài khoản dịch vụ. Tuy nhiên, hiện tại, bạn chỉ cần nhấp vào Xong để tạo tài khoản dịch vụ. - Để tạo một cặp khoá cho tài khoản dịch vụ sử dụng, hãy nhấp vào
để chỉnh sửa tài khoản dịch vụ.
Thông tin chi tiết về tài khoản dịch vụ của bạn sẽ xuất hiện.
- Sao chép địa chỉ email của tài khoản dịch vụ rồi quay lại Cloud Shell.
- Trong Cloud Shell, hãy tạo một cặp khoá cho tài khoản dịch vụ của bạn và đặt một biến môi trường để trỏ đến cặp khoá đó:
gcloud iam service-accounts keys create ~/key.json \
--iam-account <your service account email>
export GOOGLE_APPLICATION_CREDENTIALS="/home/$USER/key.json"
Google Cloud sử dụng biến môi trường này để tìm thông tin xác thực, nên bạn không cần phải đưa thông tin xác thực vào lệnh gọi API.
- Giờ đây, bạn có thể gọi API bằng lệnh:
gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
Kết quả sẽ giống như trước.
Nhiều API có các thư viện ứng dụng mở rộng để trích xuất những thông tin chi tiết này. Để tìm hiểu thêm về thư viện ứng dụng, hãy xem phần Thư viện ứng dụng đám mây. Bạn cũng có thể đọc tài liệu về các API mà bạn sử dụng để xem những thư viện ứng dụng nào có sẵn cho các API đó.
5. Dọn dẹp
Không nên dùng khoá API không bị hạn chế cho các dự án. Nếu có quyền truy cập vào khoá truy cập, người đó có thể sử dụng khoá truy cập mà không cần xác thực thêm.
Cách xoá khoá API này:
- Nhấp vào
Trình đơn điều hướng > API và Dịch vụ > Thông tin xác thực. - Trong mục API Keys (Khoá API), hãy chọn khoá cần xoá rồi nhấp vào
Delete (Xoá). - Tương tự, thay vì lo lắng về việc Khoá riêng tư của Tài khoản dịch vụ không được bảo vệ, trong mục Tài khoản dịch vụ, hãy chọn tài khoản dịch vụ cần xoá rồi nhấp vào Xoá.
6. Xin chúc mừng
Xin chúc mừng! Bạn đã tìm hiểu cách tạo một dự án Google Cloud và cách gọi một API trong dự án đó.