עוצמת קול: רשימה

ביצוע חיפוש בספר. כדאי לנסות עכשיו.

שליחת בקשה

בקשת 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)

גוף הבקשה

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

תשובה

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

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

רוצה לנסות?

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