เอกสารการค้นพบ: รายการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เรียกข้อมูลรายการ API ที่ปลายทางนี้รองรับ
ลองใช้เลย
เมธอด discovery.apis.list จะแสดงรายการ API ทั้งหมดที่รองรับโดยบริการ Google APIs Discovery ข้อมูลของแต่ละรายการคือชุดย่อยของเอกสารการค้นพบสําหรับ 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 |
สตริงที่ค้นพบได้#directoryList |
|
discoveryVersion |
string |
ระบุเวอร์ชันของ Discovery API ที่ใช้สร้างเอกสารนี้ |
|
items[] |
list |
แต่ละรายการในไดเรกทอรี 1 รายการต่อคู่ API/เวอร์ชัน |
|
items[].kind |
string |
ประเภทการตอบกลับนี้ |
|
items[].id |
string |
รหัส API นี้ |
|
items[].name |
string |
ชื่อของ API |
|
items[].version |
string |
เวอร์ชันของ API |
|
items[].title |
string |
ชื่อของ API นี้ |
|
items[].description |
string |
คําอธิบายของ API นี้ |
|
items[].discoveryRestUrl |
string |
URL สําหรับเอกสาร REST ที่ค้นพบ |
|
items[].discoveryLink |
string |
ลิงก์ไปยังเอกสารการค้นพบ |
|
items[].icons |
object |
ลิงก์ไปยังไอคอนขนาด 16x16 และ 32x32 ที่แสดงแทน API |
|
items[].icons.x16 |
string |
URL ของไอคอนขนาด 16x16 |
|
items[].icons.x32 |
string |
URL ของไอคอนขนาด 32x32 |
|
items[].documentationLink |
string |
ลิงก์ไปยังเอกสารประกอบสําหรับ API ที่มนุษย์อ่านได้ |
|
items[].labels[] |
list |
ป้ายกํากับสําหรับสถานะของ API นี้ เช่น limited_availability หรือ deprecated |
|
items[].preferred |
boolean |
true หากเวอร์ชันนี้เป็นเวอร์ชันที่ต้องการใช้ |
|
ลองเลย
ใช้โปรแกรมสํารวจด้านล่างเพื่อเรียกใช้วิธีการนี้กับข้อมูลสดและดูคําตอบ
หรือลองใช้ นักสํารวจแบบสแตนด์อโลน
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2022-07-27 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]
