Trang này cho biết cách bắt đầu sử dụng Thư viện ứng dụng đám mây cho Developer Knowledge API. Thay vì tạo các yêu cầu HTTP thô, thư viện ứng dụng cung cấp các loại thành ngữ, tính năng xác thực tích hợp, tính năng phân trang tự động và tính năng xử lý việc thử lại giúp giảm lượng mã bạn cần viết.
Để tìm hiểu thêm về các thư viện ứng dụng cho Google API, hãy tham khảo phần Giải thích về thư viện ứng dụng.
Cài đặt thư viện ứng dụng
Chọn ngôn ngữ lập trình để cài đặt thư viện ứng dụng Developer Knowledge API chính thức:
Go
Thêm mô-đun vào dự án Go:
go get cloud.google.com/go/developerknowledge/apiv1
Để tìm hiểu thêm, hãy tham khảo bài viết Thiết lập môi trường phát triển Go.
Java
Nếu bạn sử dụng Maven, hãy thêm phần phụ thuộc sau vào tệp pom.xml:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-developer-knowledge</artifactId>
<version>0.6.0</version>
</dependency>
Nếu bạn sử dụng Gradle, hãy thêm phần phụ thuộc sau vào tệp build.gradle:
implementation 'com.google.cloud:google-cloud-developer-knowledge:0.6.0'
Để tìm hiểu thêm, hãy tham khảo bài viết Thiết lập môi trường phát triển Java.
Node.js và TypeScript
Cài đặt gói bằng npm:
npm install @google/developer-knowledge
Để tìm hiểu thêm, hãy tham khảo bài viết Thiết lập môi trường phát triển Node.js.
PHP
Cài đặt gói bằng Composer:
composer require google/developer-knowledge
Để tìm hiểu thêm, hãy tham khảo bài viết Sử dụng PHP trên Google Cloud.
Python
Cài đặt gói bằng pip:
pip install --upgrade google-developer-knowledge
Để tìm hiểu thêm, hãy tham khảo bài viết Thiết lập môi trường phát triển Python.
Ruby
Cài đặt gem:
gem install google-developers-developer_knowledge
Để tìm hiểu thêm, hãy tham khảo bài viết Thiết lập môi trường phát triển Ruby.
Thiết lập phương thức xác thực
Trước khi đưa ra yêu cầu API, hãy đảm bảo rằng bạn đã bật Developer Knowledge API trong dự án trên đám mây của Google.
Để xác thực các lệnh gọi đến Developer Knowledge API, thư viện ứng dụng hỗ trợ Thông tin xác thực mặc định của ứng dụng (ADC). Các thư viện này tìm thông tin xác thực ở một số vị trí được xác định và sử dụng thông tin xác thực đó để xác thực các yêu cầu đến API. Với ADC, bạn có thể cung cấp thông tin đăng nhập cho ứng dụng của mình trong nhiều môi trường, chẳng hạn như môi trường phát triển cục bộ hoặc môi trường sản xuất, mà không cần sửa đổi mã xử lý ứng dụng.
Đối với môi trường sản xuất, cách bạn thiết lập ADC phụ thuộc vào dịch vụ và bối cảnh:
- Môi trường Google Cloud: khi ứng dụng của bạn chạy trên Cloud Run, Google Kubernetes Engine, Compute Engine hoặc các hàm Cloud Run, ADC sẽ tự động sử dụng tài khoản dịch vụ được đính kèm vào tài nguyên điện toán.
- Môi trường bên ngoài hoặc tại chỗ: sử dụng Workload Identity Federation hoặc đặt biến môi trường
GOOGLE_APPLICATION_CREDENTIALSthành đường dẫn của một tệp cấu hình thông tin đăng nhập.
Để tìm hiểu thêm về các lựa chọn thông tin xác thực phát hành công khai, hãy tham khảo bài viết Thiết lập thông tin xác thực mặc định của ứng dụng.
Đối với môi trường phát triển cục bộ, bạn có thể thiết lập ADC bằng thông tin đăng nhập được liên kết với Tài khoản Google của mình:
- Cài đặt và khởi chạy CLI gcloud.
Tạo thông tin đăng nhập xác thực cục bộ cho Tài khoản Google:
gcloud auth application-default loginMàn hình đăng nhập sẽ xuất hiện. Sau khi bạn đăng nhập, thông tin đăng nhập của bạn sẽ được lưu trữ trong tệp thông tin đăng nhập cục bộ mà ADC sử dụng.
Tài nguyên khác
Chọn một thẻ ngôn ngữ để tìm các đường liên kết đến tài liệu tham khảo API, mã mẫu, các phương pháp hay nhất, công cụ theo dõi vấn đề và kho lưu trữ mã nguồn cho từng thư viện ứng dụng:
Go
Danh sách sau đây chứa đường liên kết đến các tài nguyên khác liên quan đến thư viện ứng dụng cho Go:
Java
Danh sách sau đây chứa đường liên kết đến các tài nguyên khác liên quan đến thư viện ứng dụng cho Java:
Node.js và TypeScript
Danh sách sau đây chứa đường liên kết đến các tài nguyên khác liên quan đến thư viện ứng dụng cho Node.js và TypeScript:
PHP
Danh sách sau đây chứa đường liên kết đến các tài nguyên khác liên quan đến thư viện ứng dụng cho PHP:
Python
Danh sách sau đây chứa đường liên kết đến các tài nguyên khác liên quan đến thư viện ứng dụng cho Python:
Ruby
Danh sách sau đây chứa các đường liên kết đến nhiều tài nguyên khác liên quan đến thư viện ứng dụng cho Ruby:
Bước tiếp theo
- Hãy làm theo hướng dẫn bắt đầu nhanh về thư viện ứng dụng để xem và chạy các mẫu mã cho
AnswerQuery,SearchDocumentChunks,GetDocumentvàBatchGetDocuments. - Tìm hiểu thêm về bộ lọc truy vấn, phân trang và mặt nạ trường trong phần Tìm kiếm và truy xuất tài liệu.
- Sử dụng tính năng tạo dựa trên thông tin thực tế với Tạo câu trả lời từ tài liệu.
- Xem lại các chiến lược thử lại và mã trạng thái trong phần Xử lý lỗi, giới hạn tốc độ và quản lý hạn mức.
- Duyệt xem tài liệu tham khảo về ngữ liệu để xem tất cả các miền tài liệu được hỗ trợ.