Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Google API Explorer là công cụ có sẵn trên hầu hết các trang tài liệu về phương thức API REST, cho phép bạn dùng thử các phương thức API của Google mà không cần viết mã.
API Explorer hoạt động trên dữ liệu thực tế, vì vậy, hãy thận trọng khi thử các phương thức
tạo, sửa đổi hoặc xoá dữ liệu.
Dùng thư mục
Để biết danh sách các API của Google mà bạn có thể khám phá, hãy duyệt xem
Thư mục khám phá API của Google. Danh sách này chứa đường liên kết đến
tài liệu tham khảo về API cho các API được hỗ trợ. Hãy làm theo các bước bên dưới để khám phá API:
Trong hộp tìm kiếm ở trên cùng, hãy nhập tên của API mà bạn muốn khám phá.
Nhấp vào tên API. Thao tác này sẽ mở tài liệu tham chiếu API.
Ở bên trái, hãy nhấp vào phương thức bạn muốn sử dụng trong phần điều hướng.
Ở bên phải, hãy tìm bảng điều khiển có nhãn "Thử phương thức này." Hãy xem bên dưới để biết thông tin chi tiết về cách sử dụng bảng điều khiển bên của API Explorer và cách mở rộng bảng điều khiển này thành bảng điều khiển API Explorer toàn màn hình.
Sử dụng bảng điều khiển bên
Hình 1: Bảng điều khiển bên của API Explorer cho API Google Sách.
Theo mặc định, API Explorer xuất hiện ở bên phải màn hình trong
tài liệu tham khảo về API cho các phương thức được hỗ trợ.
Bạn có thể tuỳ chỉnh và tương tác với các phần sau trong bảng điều khiển bên của API Explorer:
Yêu cầu thông số nếu phương thức yêu cầu.
Nội dung yêu cầu, nếu phương thức này yêu cầu.
Thông tin xác thực để kiểm tra phương thức này có nhiều loại thông tin xác thực và phạm vi.
Nút Thực thi để chạy phương thức này bằng các thông số và tùy chọn cài đặt
bạn đã chỉ định.
Kết quả, chỉ hiển thị sau khi thực thi phương thức.
Sử dụng bảng điều khiển toàn màn hình
Hình 2: Bảng điều khiển toàn màn hình của API Explorer cho API Google Sách.
Trong bảng điều khiển bên của API Explorer đã thu gọn, bạn có thể nhấp vào biểu tượng Toàn màn hình fullscreen để mở rộng APIs Explorer. Bảng điều khiển toàn màn hình hiển thị một ngăn bổ sung chứa các mã mẫu, phản hồi application/json và phản hồi HTTP thô.
Xác thực
API Explorer sử dụng thông tin đăng nhập của riêng mình để đưa ra yêu cầu. Bạn không thể sử dụng
thông tin xác thực tuỳ chỉnh với APIs Explorer.
Định dạng dữ liệu
API Explorer chỉ hỗ trợ JSON cho phản hồi và yêu cầu trọng tải. Ngay cả khi API của bạn hỗ trợ các định dạng dữ liệu khác, các định dạng này vẫn không hoạt động trong Trình khám phá API.
[null,null,["Cập nhật lần gần đây nhất: 2022-11-01 UTC."],[[["\u003cp\u003eGoogle APIs Explorer allows you to experiment with Google API methods directly without coding, using real data.\u003c/p\u003e\n"],["\u003cp\u003eYou can find the desired API through the Google APIs Explorer Directory and navigate to its documentation to access the Explorer.\u003c/p\u003e\n"],["\u003cp\u003eThe Explorer provides an interface to input parameters, request bodies, and credentials for executing the API method and viewing results.\u003c/p\u003e\n"],["\u003cp\u003eWhile the Explorer uses its own credentials, it offers both side-panel and full-screen views with functionalities like code samples and response formats in JSON.\u003c/p\u003e\n"],["\u003cp\u003eRemember to exercise caution when using methods that modify data, as the Explorer operates on live data.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nThe Google APIs Explorer is a tool available on most REST API method\ndocumentation pages that lets you try Google API methods without writing code.\nThe APIs Explorer acts on real data, so use caution when trying methods that\ncreate, modify, or delete data.\n\nUse the directory\n-----------------\n\nFor a list of Google APIs you can explore, browse the\n[Google APIs Explorer Directory](/apis-explorer). This list contains links to\nthe API reference documentation for supported APIs. Follow the steps below to\nexplore the API:\n\n1. Open the [Google APIs Explorer Directory](/apis-explorer).\n2. In the search box at the top, enter the name of the API you want to explore.\n3. Click the name of the API. This opens the API reference documentation.\n4. At the left, click the method you want to use in the navigation.\n5. At the right, find the panel labeled \"Try this method.\" See below for details\n about how to use the APIs Explorer side panel and how to expand it into the\n full-screen APIs Explorer panel.\n\n | **Note:** If you don't see the APIs Explorer side panel, the method might not be compatible with APIs Explorer.\n\nUse the side panel\n------------------\n\n**Figure 1**: APIs Explorer side panel for the Google Books API.\n\nBy default, the APIs Explorer appears on the right-hand side of the screen in\nAPI reference documentation for supported methods.\n\nYou can customize and interact with the following sections in the APIs Explorer\nside panel:\n\n- **Request parameters**, if required by the method.\n- **Request body**, if required by the method.\n- **Credentials**, to test the method with various credential types and scopes.\n- **Execute** button, to run the method using the parameters and settings you've specified.\n- **Result**, displayed only after executing the method.\n\nUse the full-screen panel\n-------------------------\n\n**Figure 2**: APIs Explorer full-screen panel for the Google Books API.\n\nIn the collapsed APIs Explorer side panel, you can click Full screen\nfullscreen to expand the APIs Explorer. The\nfull-screen panel displays an extra pane containing code samples,\n`application/json` responses, and Raw HTTP responses.\n\nAuthentication\n--------------\n\nThe APIs Explorer uses its own credentials to make a request. You can't use\ncustom credentials with the APIs Explorer.\n\nData formats\n------------\n\nThe APIs Explorer only supports JSON for responses and request payloads. Even if\nyour API supports other data formats, these formats don't work in the\nAPIs Explorer.\n\nNext steps\n----------\n\n- Learn how to [display the APIs Explorer and execute a method](/explorer-help/execute-method).\n- Learn how to [test a method using different credentials and scopes](/explorer-help/authorization-and-authentication).\n- Learn how to [execute APIs Explorer sample code locally](/explorer-help/code-samples)."]]