擷取此端點支援的 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,針對即時資料呼叫這個方法並查看回應。 或者,您也可以嘗試使用獨立的探索工具。