Tài liệu khám phá: danh sách

Truy xuất danh sách các API được hỗ trợ tại điểm cuối này.

Phương thức discovery.apis.list trả về danh sách tất cả các API mà Google APIs Discovery Service hỗ trợ. Dữ liệu cho mỗi mục là một tập hợp con của Tài liệu khám phá cho API đó và danh sách này cung cấp một thư mục gồm các API được hỗ trợ.  Nếu một API cụ thể có nhiều phiên bản, thì mỗi phiên bản sẽ có một mục riêng trong danh sách.

Yêu cầu

Yêu cầu HTTP

GET https://discovery.googleapis.com/discovery/v1/apis

Thông số

Tên thông số Giá trị Mô tả
Thông số không bắt buộc
name string Chỉ bao gồm các API có tên đã cho.
preferred boolean Chỉ trả về phiên bản ưu tiên của một API.  "false" theo mặc định.

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một nội dung phản hồi có cấu trúc sau:

{
  "kind": "discovery#directoryList",
  "discoveryVersion": "v1",
  "items": [
    {
      "kind": "discovery#directoryItem",
      "id": string,
      "name": string,
      "version": string,
      "title": string,
      "description": string,
      "discoveryRestUrl": string,
      "discoveryLink": string,
      "icons": {
        "x16": string,
        "x32": string
      },
      "documentationLink": string,
      "labels": [
        string
      ],
      "preferred": boolean
    }
  ]
}
Tên thuộc tính Giá trị Mô tả
kind string Chuỗi cố định discovery#directoryList
discoveryVersion string Cho biết phiên bản của Discovery API được dùng để tạo tài liệu này.
items[] list Các mục riêng lẻ trong thư mục. Mỗi cặp API/phiên bản có một mục.
items[].kind string Loại phản hồi này.
items[].id string Mã nhận dạng của API này.
items[].name string Tên của API.
items[].version string Phiên bản của API.
items[].title string Tiêu đề của API này.
items[].description string Nội dung mô tả về API này.
items[].discoveryRestUrl string URL cho tài liệu REST khám phá.
items[].icons object Đường liên kết đến các biểu tượng 16x16 và 32x32 đại diện cho API.
items[].icons.x16 string URL của biểu tượng 16x16.
items[].icons.x32 string URL của biểu tượng 32x32.
items[].labels[] list Nhãn cho trạng thái của API này, chẳng hạn như limited_availability hoặc deprecated.
items[].preferred boolean true nếu đây là phiên bản bạn muốn dùng.