탐색 문서: 목록

이 엔드포인트에서 지원되는 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	고정 문자열 discovery#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 문서의 URL입니다.
items[].discoveryLink	string	검색 문서 링크입니다.
items[].icons	object	API를 나타내는 16x16 및 32x32 아이콘에 대한 링크입니다.
items[].icons.x16	string	16x16 아이콘의 URL입니다.
items[].icons.x32	string	32x32 아이콘의 URL입니다.
items[].documentationLink	string	인간이 읽을 수 있는 API 문서 링크입니다.
items[].labels[]	list	이 API의 상태에 대한 라벨입니다(예: limited_availability 또는deprecated).
items[].preferred	boolean	이 버전이 선호하는 버전이면 true입니다.