حجم: فهرست

جستجوی کتاب را انجام می دهد. اکنون آن را امتحان کنید .

درخواست کنید

درخواست HTTP 

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مورد نیاز
q string رشته جستجوی متن کامل
پارامترهای اختیاری
download string با در دسترس بودن دانلود به حجم محدود کنید.

مقادیر قابل قبول عبارتند از:
  • " epub " - همه جلدها با epub.
filter string فیلتر کردن نتایج جستجو

مقادیر قابل قبول عبارتند از:
  • " ebooks " - همه کتاب‌های الکترونیکی Google.
  • " free-ebooks " - کتاب الکترونیکی Google با قابلیت مشاهده متن کامل.
  • " full " - عمومی می تواند کل متن حجم را مشاهده کند.
  • " paid-ebooks " - Google eBook با قیمت.
  • " partial " - عمومی قادر به دیدن بخش هایی از متن است.
langRestrict string نتایج را به کتاب‌هایی با این کد زبان محدود کنید.
libraryRestrict string جستجو را به کتابخانه این کاربر محدود کنید.

مقادیر قابل قبول عبارتند از:
  • " my-library " - محدود به کتابخانه کاربر، هر قفسه.
  • " no-restrict " - بر اساس کتابخانه کاربر محدود نکنید.
maxResults unsigned integer حداکثر تعداد نتایج برای بازگشت. مقادیر قابل قبول شامل 0 تا 40 است.
orderBy string نتایج جستجو را مرتب کنید

مقادیر قابل قبول عبارتند از:
  • " newest " - اخیراً منتشر شده است.
  • " relevance " - ارتباط با عبارات جستجو.
partner string محدود کردن و نتایج مارک برای شناسه شریک.
printType string محدود به کتاب یا مجلات.

مقادیر قابل قبول عبارتند از:
  • " all " - همه انواع محتوای حجمی.
  • " books " - فقط کتاب.
  • " magazines " - فقط مجلات.
projection string اطلاعات بازگردانده شده را به مجموعه ای از فیلدهای انتخابی محدود کنید.

مقادیر قابل قبول عبارتند از:
  • " full " - شامل تمام داده های حجمی است.
  • " lite " - شامل زیر مجموعه ای از فیلدها در volumeInfo و accessInfo است.
showPreorders boolean برای نمایش کتاب‌های موجود برای پیش‌سفارش، روی true تنظیم کنید. پیش فرض به نادرست.
source string رشته ای برای شناسایی مبدع این درخواست.
startIndex unsigned integer فهرست اولین نتیجه برای بازگشت (از 0 شروع می شود)

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند: 

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
نام ملک ارزش توضیحات یادداشت ها
kind string نوع منبع
items[] list فهرستی از مجلدات
totalItems integer تعداد مجموع جلدهای یافت شده اگر نتایج صفحه‌بندی شده باشند، ممکن است این تعداد جلدهای بازگشتی در این پاسخ بیشتر باشد.

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

از کاوشگر زیر برای فراخوانی این روش در داده های زنده و مشاهده پاسخ استفاده کنید.