Để có thể bắt đầu lập trình ứng dụng đầu tiên của mình, bạn cần làm một số việc nếu chưa thực hiện.
Tạo tài khoản Google
Bạn cần có một Tài khoản Google để tạo một dự án trong Google API Console. Nếu đã có tài khoản thì bạn đã hoàn tất.
Bạn cũng nên có một Tài khoản Google riêng cho mục đích thử nghiệm.
Tạo một dự án cho ứng dụng của bạn
Trước khi có thể gửi yêu cầu đến API Tìm kiếm sơ đồ tri thức của Google, bạn cần cho Google biết về ứng dụng của mình và kích hoạt quyền truy cập vào API đó. Bạn thực hiện việc này bằng cách sử dụng Google API Console để tạo dự án. Đây là một tập hợp gồm các chế độ cài đặt và thông tin truy cập API được đặt tên, đồng thời đăng ký ứng dụng của bạn.
Để bắt đầu sử dụng API Tìm kiếm sơ đồ tri thức của Google, trước tiên bạn cần dùng công cụ thiết lập. Công cụ này sẽ hướng dẫn bạn trong quy trình tạo dự án trong Google API Console, bật API và tạo bằng chứng xác thực.
Nếu bạn chưa thực hiện việc này, hãy tạo khóa API của ứng dụng bằng cách nhấp vào Tạo thông tin xác thực > khóa API. Tiếp theo, hãy tìm khoá API của bạn trong phần Khoá API.
Tìm hiểu kiến thức cơ bản về REST
Có hai cách để gọi API:
- Gửi yêu cầu HTTP và phân tích cú pháp các phản hồi.
- Sử dụng thư viện ứng dụng.
Nếu quyết định không sử dụng thư viện ứng dụng, bạn sẽ cần hiểu những kiến thức cơ bản về REST.
REST là một kiểu kiến trúc phần mềm cung cấp một phương pháp nhất quán thuận tiện để yêu cầu và sửa đổi dữ liệu.
Thuật ngữ REST là tên viết tắt của "Đại diện chuyển trạng thái". Trong ngữ cảnh của API Google, thuật ngữ này đề cập đến việc sử dụng động từ HTTP để truy xuất và sửa đổi bản trình bày dữ liệu được Google lưu trữ.
Trong hệ thống RESTful, tài nguyên được lưu trữ trong kho lưu trữ dữ liệu; máy khách gửi yêu cầu rằng máy chủ thực hiện một hành động cụ thể (chẳng hạn như tạo, truy xuất, cập nhật hoặc xóa tài nguyên) và máy chủ thực hiện hành động đó và gửi phản hồi, thường ở dạng đại diện cho tài nguyên đã chỉ định.
Trong API RESTful của Google, ứng dụng chỉ định một thao tác bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Hàm này chỉ định tài nguyên theo một URI độc nhất trên toàn cầu có dạng như sau:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Vì tất cả tài nguyên API đều có các URI có thể truy cập HTTP duy nhất, nên REST cho phép lưu vào bộ nhớ đệm dữ liệu và được tối ưu hoá để hoạt động với cơ sở hạ tầng phân tán của web.
Bạn có thể thấy định nghĩa về phương thức trong tài liệu về các tiêu chuẩn HTTP 1.1; các định nghĩa này bao gồm thông số kỹ thuật cho GET, POST, PUT và DELETE.
REST trong API Tìm kiếm sơ đồ tri thức của Google
Các thao tác API Tìm kiếm sơ đồ tri thức của Google ánh xạ trực tiếp đến động từ HTTP trong REST.
Các định dạng cụ thể cho URI API Tìm kiếm sơ đồ tri thức của Google là:
https://kgsearch.googleapis.com/v1/entities:search?query=your_query¶meters
Tập hợp đầy đủ các URI được sử dụng cho từng toán tử được hỗ trợ trong API được tóm tắt trong tài liệu Tài liệu tham khảo API tìm kiếm sơ đồ tri thức của Google.
Tìm hiểu kiến thức cơ bản về JSON
API Tìm kiếm sơ đồ tri thức của Google trả về dữ liệu ở định dạng JSON.
JSON (Ký hiệu đối tượng JavaScript) là một định dạng dữ liệu phổ biến, độc lập về ngôn ngữ, cung cấp bản trình bày văn bản đơn giản của các cấu trúc dữ liệu tùy ý. Để biết thêm thông tin, hãy xem json.org.