Keşif Belgesi: liste
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu uç noktada desteklenen API'lerin listesini alın.
Şimdi deneyin.
discovery.apis.list yöntemi, Google API'leri Keşif Hizmeti tarafından desteklenen tüm API'lerin listesini döndürür. Her girişe ait veriler, söz konusu API'nin Keşif Dokümanı'nın bir alt kümesidir ve liste, desteklenen API'lerin bulunduğu bir dizin sağlar. Belirli bir API'nin birden fazla sürümü varsa sürümlerin her birinin listede kendi girişi olur.
İstek
HTTP İsteği
GET https://discovery.googleapis.com/discovery/v1/apis
Parametreler
Parametre Adı |
Değer |
Açıklama |
İsteğe Bağlı Parametreler |
name |
string |
Yalnızca belirtilen ada sahip API'leri ekleyin.
|
preferred |
boolean |
Bir API'nin yalnızca tercih edilen sürümünü döndürür. "false " varsayılan olarak.
|
İstek Metni
Bu yöntemle bir istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{
"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
}
]
}
Özellik Adı |
Değer |
Açıklama |
Notlar |
kind |
string |
Sabit dize discovery#directoryList |
|
discoveryVersion |
string |
Bu dokümanı oluşturmak için kullanılan Discovery API'nin sürümünü belirtin. |
|
items[] |
list |
Bağımsız dizin girişleri. API/sürüm çifti başına bir giriş. |
|
items[].kind |
string |
Bu yanıtın türü. |
|
items[].id |
string |
Bu API'nin kimliği. |
|
items[].name |
string |
API'nin adı. |
|
items[].version |
string |
API sürümü. |
|
items[].title |
string |
Bu API'nin başlığı. |
|
items[].description |
string |
Bu API'nin açıklaması. |
|
items[].discoveryRestUrl |
string |
Keşif REST dokümanının URL'si. |
|
items[].discoveryLink |
string |
Keşif belgesinin bağlantısı. |
|
items[].icons |
object |
API'yi temsil eden 16x16 ve 32x32 simgelerinin bağlantıları. |
|
items[].icons.x16 |
string |
16x16 simgesinin URL'si. |
|
items[].icons.x32 |
string |
32x32 simgesinin URL'si. |
|
items[].documentationLink |
string |
API'nin okunabilir dokümanları için bir bağlantı. |
|
items[].labels[] |
list |
Bu API'nin durumunun etiketleri (ör. limited_availability veya deprecated ). |
|
items[].preferred |
boolean |
Tercih ettiğiniz sürüm bu sürümse true . |
|
Deneyin!
Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki gezgini kullanın.
Alternatif olarak, bağımsız gezgini deneyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2022-07-27 UTC.
[null,null,["Son güncelleme tarihi: 2022-07-27 UTC."],[[["\u003cp\u003eThe \u003ccode\u003ediscovery.apis.list\u003c/code\u003e endpoint retrieves a list of all APIs supported by the Google APIs Discovery Service.\u003c/p\u003e\n"],["\u003cp\u003eEach API and its versions are represented as individual entries in the response.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter results using optional parameters like \u003ccode\u003ename\u003c/code\u003e to include specific APIs or \u003ccode\u003epreferred\u003c/code\u003e to return only preferred versions.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides comprehensive information about each API, including its ID, name, version, description, documentation link, and icons.\u003c/p\u003e\n"]]],[],null,["# Discovery Document: list\n\nRetrieve the list of APIs supported at this endpoint.\n\n\nThe `discovery.apis.list` method returns the list of all APIs supported by the\nGoogle APIs Discovery Service. The data for each entry is a subset of the Discovery Document\nfor that API, and the list provides a directory of supported APIs. If a specific API\nhas multiple versions, each of the versions has its own entry in the list.\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://discovery.googleapis.com/discovery/v1/apis\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|-----------|--------------------------------------------------------------------|\n| **Optional Parameters** |||\n| `name` | `string` | Only include APIs with the given name. |\n| `preferred` | `boolean` | Return only the preferred version of an API. \"`false`\" by default. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"discovery#directoryList\",\n \"discoveryVersion\": \"v1\",\n \"items\": [\n {\n \"kind\": \"discovery#directoryItem\",\n \"id\": string,\n \"name\": string,\n \"version\": string,\n \"title\": string,\n \"description\": string,\n \"discoveryRestUrl\": string,\n \"discoveryLink\": string,\n \"icons\": {\n \"x16\": string,\n \"x32\": string\n },\n \"documentationLink\": string,\n \"labels\": [\n string\n ],\n \"preferred\": boolean\n }\n ]\n}\n```\n\n| Property Name | Value | Description |\n|-----------------------------|-----------|------------------------------------------------------------------------------------|\n| `kind` | `string` | The fixed string discovery#directoryList |\n| `discoveryVersion` | `string` | Indicate the version of the Discovery API used to generate this doc. |\n| `items[]` | `list` | The individual directory entries. One entry per API/version pair. |\n| items[].`kind` | `string` | The kind for this response. |\n| items[].`id` | `string` | The ID of this API. |\n| items[].`name` | `string` | The name of the API. |\n| items[].`version` | `string` | The version of the API. |\n| items[].`title` | `string` | The title of this API. |\n| items[].`description` | `string` | The description of this API. |\n| items[].`discoveryRestUrl` | `string` | The url for the discovery REST document. |\n| items[].`discoveryLink` | `string` | A link to the discovery document. |\n| items[].`icons` | `object` | Links to 16x16 and 32x32 icons representing the API. |\n| items[].icons.`x16` | `string` | The url of the 16x16 icon. |\n| items[].icons.`x32` | `string` | The url of the 32x32 icon. |\n| items[].`documentationLink` | `string` | A link to human readable documentation for the API. |\n| items[].`labels[]` | `list` | Labels for the status of this API, such as `limited_availability` or `deprecated`. |\n| items[].`preferred` | `boolean` | `true` if this version is the preferred version to use. |"]]