נפח: רשימה

מבצע חיפוש ספר. רוצים לנסות עכשיו?

בקשה

בקשת HTTP

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

פרמטרים

שם פרמטר ערך של Gpa education תיאור
פרמטרים נדרשים
q string מחרוזת שאילתת חיפוש בטקסט מלא.
פרמטרים אופציונליים
download string הגבלה לנפחים על ידי זמינות ההורדות.

הערכים הקבילים הם:
  • "epub" – כל הכרכים עם קובץ EPUB.
filter string סינון של תוצאות החיפוש.

הערכים הקבילים הם:
  • "ebooks" - כל Google ספרים דיגיטליים.
  • "free-ebooks" - ספר דיגיטלי של Google עם ניראות טקסט בגודל מלא.
  • "full" – גלוי לכולם יכול לראות את כל הטקסט של עוצמת הקול.
  • "paid-ebooks" - ספר דיגיטלי של Google עם מחיר.
  • "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 כדי להציג ספרים שזמינים להזמנה מראש. ברירת המחדל היא False.
source string מחרוזת לזיהוי יוזם הבקשה.
startIndex unsigned integer אינדקס של התוצאה הראשונה שצריך להחזיר (מתחיל ב-0)

גוף הבקשה

אל תספקו גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
שם הנכס ערך של Gpa education תיאור הערות
kind string סוג המשאב.
items[] list רשימה של כרכים.
totalItems integer המספר הכולל של כרכים שנמצאו. יכול להיות שהמספר הזה יהיה גדול יותר ממספר הנפחים שהוחזרו בתשובה הזו אם התוצאות מחולקות לדפים.

רוצה לנסות?

אפשר להשתמש בניתוח שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.