سند کشف: فهرست

لیست API های پشتیبانی شده در این نقطه پایانی را بازیابی کنید. اکنون آن را امتحان کنید .

متد discovery.apis.list فهرستی از همه APIهای پشتیبانی شده توسط Google APIs Discovery Service را برمی گرداند. داده‌های هر ورودی زیرمجموعه‌ای از سند کشف برای آن 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 ورودی های دایرکتوری فردی یک ورودی برای هر جفت 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 نشانی اینترنتی سند REST کشف.
items[]. icons object پیوندهایی به نمادهای 16x16 و 32x32 نشان دهنده API.
items[].icons. x16 string نشانی اینترنتی نماد ۱۶×۱۶.
items[].icons. x32 string آدرس اینترنتی نماد 32x32.
items[]. labels[] list برچسب‌هایی برای وضعیت این API، مانند limited_availability یا deprecated .
items[]. preferred boolean true اگر این نسخه نسخه ترجیحی برای استفاده باشد.

آن را امتحان کنید!

از کاوشگر زیر برای فراخوانی این روش در داده های زنده و مشاهده پاسخ استفاده کنید. از طرف دیگر، کاوشگر مستقل را امتحان کنید.