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