حجم: فهرست
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
جستجوی کتاب را انجام می دهد. اکنون آن را امتحان کنید .
درخواست کنید
درخواست 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 | تعداد مجموع جلدهای یافت شده اگر نتایج صفحه‌بندی شده باشند، ممکن است این تعداد جلدهای بازگشتی در این پاسخ بیشتر باشد. | |
آن را امتحان کنید!
از کاوشگر زیر برای فراخوانی این روش در داده های زنده و مشاهده پاسخ استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-15 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-15 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eSearches for books based on a provided query string.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by criteria such as availability, format, language, and publication type.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over the number of results, sorting order, and specific data fields returned.\u003c/p\u003e\n"],["\u003cp\u003eCan be used to retrieve information about books, including volume details and access options.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to handle large result sets.\u003c/p\u003e\n"]]],[],null,["# Volume: list\n\nPerforms a book search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n GET https://www.googleapis.com/books/v1/volumes?q={search terms}\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-------------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `q` | `string` | Full-text search query string. |\n| **Optional Parameters** |||\n| `download` | `string` | Restrict to volumes by download availability. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`epub`\" - All volumes with epub. |\n| `filter` | `string` | Filter search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`ebooks`\" - All Google eBooks. - \"`free-ebooks`\" - Google eBook with full volume text viewability. - \"`full`\" - Public can view entire volume text. - \"`paid-ebooks`\" - Google eBook with a price. - \"`partial`\" - Public able to see parts of text. |\n| `langRestrict` | `string` | Restrict results to books with this language code. |\n| `libraryRestrict` | `string` | Restrict search to this user's library. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`my-library`\" - Restrict to the user's library, any shelf. - \"`no-restrict`\" - Do not restrict based on user's library. |\n| `maxResults` | `unsigned integer` | Maximum number of results to return. Acceptable values are `0` to `40`, inclusive. |\n| `orderBy` | `string` | Sort search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`newest`\" - Most recently published. - \"`relevance`\" - Relevance to search terms. |\n| `partner` | `string` | Restrict and brand results for partner ID. |\n| `printType` | `string` | Restrict to books or magazines. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\" - All volume content types. - \"`books`\" - Just books. - \"`magazines`\" - Just magazines. |\n| `projection` | `string` | Restrict information returned to a set of selected fields. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`full`\" - Includes all volume data. - \"`lite`\" - Includes a subset of fields in volumeInfo and accessInfo. |\n| `showPreorders` | `boolean` | Set to true to show books available for preorder. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first result to return (starts at 0) |\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 {\n \"kind\": \"books#volumes\",\n \"items\": [\n volume Resource\n ],\n \"totalItems\": (value)\n }\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of volumes. | |\n| `totalItems` | `integer` | Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
