נפח: רשימה

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

בקשה

בקשת 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 המספר הכולל של הכרכים שנמצאו. אם התוצאות חולקו לדפים, המספר הזה עשוי להיות גדול ממספר האוספים שמוחזרים בתגובה הזו.

רוצה לנסות?

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