Trên hầu hết các trang tài liệu, trình khám phá API thu gọn sẽ hiển thị ở bên phải màn hình. Nếu APIs Explorer không hiển thị, hãy nhấp vào Try it! để hiển thị phiên bản rút gọn của APIs Explorer.
Nếu Dùng thử không xuất hiện ở phía bên phải của trang tài liệu tham chiếu, thì phương thức này không được APIs Explorer hỗ trợ. Ví dụ: APIs Explorer không tương thích với API yêu cầu tài khoản dịch vụ, vì vậy, APIs Explorer không xuất hiện trên trang tài liệu cho các API đó.
Hiển thị phiên bản mở rộng của APIs Explorer
Phiên bản mở rộng của APIs Explorer chứa cURL, HTTP và có thể là các mã mẫu khác. Để hiển thị phiên bản mở rộng của APIs Explorer, hãy nhấp vào biểu tượng Toàn màn hình .
Thực thi một phương thức
Trình khám phá API cho phép bạn nhập các thông số bắt buộc, thông số không bắt buộc
và nội dung yêu cầu (nếu có) cho các phương thức API. Đối với nhiều phương thức REST,
chẳng hạn như phương thức danh sách, bạn chỉ cần điền vào một hoặc hai trường trước khi có thể
thực thi phương thức đó. Ví dụ: phương thức API của sách&books.volumes.list
chỉ yêu cầu một tham số truy vấn (q) để liệt kê sách. Để thử phương thức
books.volumes.list, hãy làm như sau:
- Chuyển đến
books.volumes.list. - Nếu APIs Explorer không hiển thị, hãy nhấp vào Dùng thử!
- Trong trường
q, hãy nhập Hunger Games (không có dấu ngoặc kép hoặc ký tự đặc biệt). - Di chuyển xuống rồi nhấp vào Thực thi.
- (không bắt buộc) Màn hình đăng nhập của Google yêu cầu bạn chọn một Tài khoản Google.
- (không bắt buộc) Hộp thoại ủy quyền của Google sẽ hỏi xem bạn có đồng ý "Quản lý sách của bạn không." Hãy nhấp vào Cho phép. Kết quả sẽ xuất hiện bên dưới nút Thực thi.
Nếu APIs Explorer hiển thị kết quả là 200, thì phương thức này đã thành công.
Khắc phục sự cố API Explorer
Bạn nhận được lỗi 401 hoặc 403
Nếu bạn gặp lỗi 401 hoặc 403 khi thực thi một phương thức bằng cách sử dụng APIs Explorer, thì có thể là do một trong những vấn đề sau:
- Bạn đang sử dụng sai loại ủy quyền (khóa API thay vì OAuth 2.0). Hãy thử chuyển đổi loại ủy quyền.
- Bạn đang sử dụng OAuth 2.0 nhưng phạm vi quá hẹp. Hãy thử sử dụng phạm vi rộng hơn.
Hộp thoại ủy quyền không xuất hiện
APIs Explorer sử dụng cửa sổ bật lên để cấp quyền truy cập vào dữ liệu riêng tư của bạn. Nếu trình duyệt của bạn chặn cửa sổ bật lên, cửa sổ bật lên này sẽ không xuất hiện và bạn sẽ không thể cấp quyền truy cập.
Nếu bạn nhấp vào Cho phép trong hộp thoại ủy quyền và không có gì xảy ra, hãy thử thay đổi chế độ cài đặt cửa sổ bật lên của trình duyệt để bật cửa sổ bật lên.