נפח: רשימה

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

בקשה

בקשת 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 עם מחיר.
  • "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)

גוף הבקשה

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

תשובה

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

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