擷取此端點支援的 API 清單。立即試用。
discovery.apis.list 方法會傳回 Google API 探索服務支援的所有 API 清單。每個項目的資料都是該 API 的探索文件子集,而清單提供支援 API 的目錄。如果特定 API 有多個版本,則每個版本在清單中都有專屬的項目。
要求
HTTP 要求
GET https://discovery.googleapis.com/discovery/v1/apis
參數
| 參數名稱 | 值 | 說明 | 
|---|---|---|
| 選用參數 | ||
| name | string | 只納入具有指定名稱的 API。 | 
| preferred | boolean | 只傳回偏好的 API 版本。 false | 
要求內容
此方法不會提供要求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
  "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
    }
  ]
}
    | 屬性名稱 | 值 | 說明 | 附註 | 
|---|---|---|---|
| kind | string | 固定字串 found#directoryList | |
| discoveryVersion | string | 指出用來產生這份文件的 Discovery API 版本。 | |
| items[] | list | 個別目錄項目。每個 API/版本組合一個項目。 | |
| items[].kind | string | 這個回應的種類。 | |
| items[].id | string | 此 API 的 ID。 | |
| items[].name | string | API 的名稱。 | |
| items[].version | string | API 的版本。 | |
| items[].title | string | 這個 API 的標題。 | |
| items[].description | string | 這個 API 的說明。 | |
| items[].discoveryRestUrl | string | 探索 REST 文件的網址。 | |
| items[].discoveryLink | string | 探索文件的連結。 | |
| items[].icons | object | 代表 API 的 16x16 和 32x32 圖示連結。 | |
| items[].icons.x16 | string | 16x16 圖示的網址。 | |
| items[].icons.x32 | string | 32x32 圖示的網址。 | |
| items[].documentationLink | string | API 使用者可理解的說明文件連結。 | |
| items[].labels[] | list | 這個 API 狀態的標籤,例如 limited_availability或deprecated。 | |
| items[].preferred | boolean | 如果偏好版本,則 true。 | 
動手操作
請使用下方的 Explorer,針對即時資料呼叫這個方法並查看回應。 或者,您也可以嘗試使用獨立的探索工具。