Documento di rilevamento: elenco
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera l'elenco delle API supportate per questo endpoint.
Prova subito.
Il metodo discovery.apis.list restituisce l'elenco di tutte le API supportate dal servizio Discovery delle API di Google. I dati di ciascuna voce sono un sottoinsieme del documento di rilevamento per tale API e l'elenco fornisce una directory delle API supportate. Se un'API specifica ha più versioni, ognuna di esse avrà la propria voce nell'elenco.
Risorse richieste:
Richiesta HTTP
GET https://discovery.googleapis.com/discovery/v1/apis
Parametri
Nome parametro |
Valore |
Descrizione |
Parametri facoltativi |
name |
string |
Includi solo le API con il nome specificato.
|
preferred |
boolean |
Restituisce solo la versione preferita di un'API. "false " per impostazione predefinita.
|
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo di risposta con la seguente struttura:
{
"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
}
]
}
Nome proprietà |
Valore |
Descrizione |
Note |
kind |
string |
La stringa fissa discovery#directoryList |
|
discoveryVersion |
string |
Indica la versione dell'API Discovery utilizzata per generare questo documento. |
|
items[] |
list |
Le singole voci della directory. Una voce per coppia di API/versione. |
|
items[].kind |
string |
Il tipo di risposta. |
|
items[].id |
string |
L'ID di questa API. |
|
items[].name |
string |
Il nome dell'API. |
|
items[].version |
string |
Versione dell'API. |
|
items[].title |
string |
Il titolo di questa API. |
|
items[].description |
string |
La descrizione di questa API. |
|
items[].discoveryRestUrl |
string |
L'URL per il documento REST di rilevamento. |
|
items[].discoveryLink |
string |
Un link al documento di rilevamento. |
|
items[].icons |
object |
Link a icone 16 x 16 e 32 x 32 che rappresentano l'API. |
|
items[].icons.x16 |
string |
L'URL dell'icona 16 x 16. |
|
items[].icons.x32 |
string |
L'URL dell'icona 32 x 32. |
|
items[].documentationLink |
string |
Un link alla documentazione leggibile dall'API. |
|
items[].labels[] |
list |
Etichette per lo stato di questa API, ad esempio limited_availability o deprecated . |
|
items[].preferred |
boolean |
true se questa è la versione preferita da utilizzare. |
|
Prova!
Utilizza lo spazio di esplorazione di seguito per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
In alternativa, prova lo strumento di esplorazione autonomo.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2022-07-27 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]