Điều kiện tiên quyết

Nếu chưa bắt đầu thực hiện những điều sau đây, bạn hãy làm ngay trước khi có thể bắt đầu mã hoá ứng dụng đầu tiên của mình.

Tạo tài khoản Google

Bạn cần có một Tài khoản Google để tạo dự án trong Bảng điều khiển API của Google. Nếu đã có tài khoản thì bạn có thể bỏ qua bước này.

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 trong Biểu đồ kiến 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 có thể làm điều này bằng cách sử dụng Google API Console để tạo dự án (một tập hợp các chế độ cài đặt được đặt tên và thông tin truy cập API), sau đó đăng ký ứng dụng của bạn.

Để bắt đầu sử dụng API Tìm kiếm trong Biểu đồ kiến thức của Google, trước tiên bạn cần sử 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 thông tin xác thực.

Nếu bạn chưa tạo, hãy tạo khoá API của ứng dụng bằng cách nhấp vào Tạo thông tin xác thực > Khoá API. Tiếp theo, hãy tìm khoá API của bạn trong mục khoá API.

Tìm hiểu kiến thức cơ bản về REST

Có hai cách để gọi API:

Nếu quyết định không sử dụng thư viện ứng dụng, bạn cần hiểu kiến thức cơ bản về REST.

REST là một kiểu kiến trúc phần mềm mang lại cách tiếp cận thuận tiện và nhất quán trong việc yêu cầu và sửa đổi dữ liệu.

Cụm từ REST là viết tắt của "Chuyển giao Trạng thái Trình bày". Trong ngữ cảnh của API của Google, cụm từ này đề cập đến việc sử dụng các động từ HTTP để truy xuất và sửa đổi các dạng trình bày của dữ liệu do Google lưu trữ.

Trong hệ thống RESTful, tài nguyên được lưu trữ trong một kho dữ liệu; ứng dụng gửi yêu cầu 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 xoá tài nguyên), sau đó máy chủ thực hiện hành động và gửi phản hồi, thường ở dạng bản trình bày của tài nguyên đã chỉ định.

Trong API RESTful của Google, ứng dụng chỉ định một hành động bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Phương thức này chỉ định một tài nguyên theo URI duy nhất trên toàn hệ thống có dạng như sau:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Vì tất cả cá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 việc lưu trữ dữ liệu vào bộ nhớ đệm và được tối ưu hoá để hoạt động với cơ sở hạ tầng phân tán của trang web.

Bạn có thể thấy định nghĩa về phương thức trong tài liệu về các chuẩn HTTP 1.1 hữu ích; vì các định nghĩa này bao gồm nội dung đặc tả cho GET, POST, PUTDELETE.

REST trong API Tìm kiếm sơ đồ tri thức của Google

Các thao tác của API Tìm kiếm sơ đồ tri thức của Google liên kết trực tiếp đến các độ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&parameters

Bạn có thể thấy tóm tắt về toàn bộ URI được sử dụng cho từng thao tác được hỗ trợ trong API trong tài liệu Tài liệu tham khảo về API Tìm kiếm trong Biểu đồ kiến 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 phần trình bày văn bản đơn giản của các cấu trúc dữ liệu tuỳ ý. Để biết thêm thông tin, hãy xem json.org.