עוצמת הקול

אוסף Volume משמש לביצוע חיפוש או לרישום התוכן של מדף ספרים. האוסף הזה הוא אוסף לקריאה בלבד.

שיטות

השיטות הבאות רלוונטיות לנתונים הציבוריים לגבי נפחי אחסון ולא מחייבות אימות.
books.volumes.list
books.volumes.get

השיטה הבאה חלה על התצוגה הפרטית 'הספרייה שלי' של האוספים, והיא דורשת אימות.
books.mylibrary.bookshelves.volumes.list

get
אחזור משאב נפח לפי מזהה.
list
מבצע חיפוש ספרים.

ייצוגים של משאבים

כרך מייצג מידע שמערכת Google Books מארחת על ספר או על כתב עת. הוא מכיל מטא-נתונים, כמו שם ומחבר, וגם נתונים מותאמים אישית, כמו העובדה שהוא נרכש או לא. (שדות נפח שזמינים בתצוגה המפורטת LITE מפורטים בהמשך).

{
  "kind": "books#volume",
  "id": string,
  "etag": string,
  "selfLink": string,
  "volumeInfo": {
    "title": string,
    "subtitle": string,
    "authors": [
      string
    ],
    "publisher": string,
    "publishedDate": string,
    "description": string,
    "industryIdentifiers": [
      {
        "type": string,
        "identifier": string
      }
    ],
    "pageCount": integer,
    "dimensions": {
      "height": string,
      "width": string,
      "thickness": string
    },
    "printType": string,
    "mainCategory": string,
    "categories": [
      string
    ],
    "averageRating": double,
    "ratingsCount": integer,
    "contentVersion": string,
    "imageLinks": {
      "smallThumbnail": string,
      "thumbnail": string,
      "small": string,
      "medium": string,
      "large": string,
      "extraLarge": string
    },
    "language": string,
    "previewLink": string,
    "infoLink": string,
    "canonicalVolumeLink": string
  },
  "userInfo": {
    "review": mylibrary.reviews Resource,
    "readingPosition": mylibrary.readingpositions Resource,
    "isPurchased": boolean,
    "isPreordered": boolean,
    "updated": datetime
  },
  "saleInfo": {
    "country": string,
    "saleability": string,
    "onSaleDate": datetime,
    "isEbook": boolean,
    "listPrice": {
      "amount": double,
      "currencyCode": string
    },
    "retailPrice": {
      "amount": double,
      "currencyCode": string
    },
    "buyLink": string
  },
  "accessInfo": {
    "country": string,
    "viewability": string,
    "embeddable": boolean,
    "publicDomain": boolean,
    "textToSpeechPermission": string,
    "epub": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "pdf": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "webReaderLink": string,
    "accessViewStatus": string,
    "downloadAccess": {
      "kind": "books#downloadAccessRestriction",
      "volumeId": string,
      "restricted": boolean,
      "deviceAllowed": boolean,
      "justAcquired": boolean,
      "maxDownloadDevices": integer,
      "downloadsAcquired": integer,
      "nonce": string,
      "source": string,
      "reasonCode": string,
      "message": string,
      "signature": string
    }
  },
  "searchInfo": {
    "textSnippet": string
  }
}
שם הנכס ערך תיאור הערות
kind string סוג המשאב של נפח האחסון. (בהקרנה ב-Lite).
id string מזהה ייחודי של נפח אחסון. (בהיטל LITE).
etag string מזהה אטום של גרסה ספציפית של משאב נפח אחסון. (בהקרנה בגרסת Lite)
volumeInfo object מידע כללי על נפח.
volumeInfo.title string כותרת הכרך. (בהקרנה ב-Lite).
volumeInfo.subtitle string כותרת המשנה של עוצמת הקול. (בהקרנה ב-Lite).
volumeInfo.authors[] list השמות של המחברים ו/או העורכים של הכרך הזה. (בהיטל LITE)
volumeInfo.publisher string המוציא לאור של הכרך הזה. (בהיטל LITE).
volumeInfo.publishedDate string תאריך הפרסום. (בהקרנה ב-Lite).
volumeInfo.description string סיכום של הכרך. הטקסט של התיאור מעוצב ב-HTML וכולל רכיבי עיצוב פשוטים, כמו תגי b,‏ i ו-br. (בתחזית LITE)
volumeInfo.industryIdentifiers[] list מזהים סטנדרטיים בתחום של האוסף הזה.
volumeInfo.industryIdentifiers[].type string סוג המזהה. הערכים האפשריים הם ISBN_10, ISBN_13, ISSN ו-OTHER.
volumeInfo.industryIdentifiers[].identifier string מזהה נפח אחסון ספציפי לתעשייה.
volumeInfo.pageCount integer מספר הדפים הכולל.
volumeInfo.dimensions object המימדים הפיזיים של הכרך.
volumeInfo.dimensions.height string הגובה או האורך של הכרך (בס"מ).
volumeInfo.dimensions.width string רוחב הכרך הזה (בס"מ).
volumeInfo.dimensions.thickness string העובי של נפח האחסון הזה (בס"מ).
volumeInfo.printType string סוג הפרסום של הכרך הזה. הערכים האפשריים הם BOOK או MAGAZINE.
volumeInfo.categories[] list רשימה של קטגוריות נושאים, כגון 'סיפורת', 'מתח' וכו'
volumeInfo.averageRating double הדירוג הממוצע של הביקורות על הכרך הזה. (מינימום = 1.0, מקסימום = 5.0)
volumeInfo.ratingsCount integer מספר הדירוגים של הביקורות באותו כרך.
volumeInfo.contentVersion string מזהה של גרסת התוכן של הכרך (טקסט ותמונות). (בהיטל LITE)
volumeInfo.imageLinks.thumbnail string קישור לתמונה בגודל תמונה ממוזערת (רוחב של כ-128 פיקסלים). (בתחזית LITE)
volumeInfo.imageLinks.small string קישור לתמונה בגודל קטן (רוחב של כ-300 פיקסלים). (בתחזית LITE)
volumeInfo.imageLinks.medium string קישור לתמונה בגודל בינוני (רוחב של כ-575 פיקסלים). (בתחזית LITE)
volumeInfo.imageLinks.large string קישור לתמונה בגודל גדול (רוחב של כ-800 פיקסלים). (בתחזית LITE)
volumeInfo.imageLinks.smallThumbnail string קישור לתמונה בגודל תמונה ממוזערת קטנה (רוחב של כ-80 פיקסלים). (בתחזית LITE)
volumeInfo.imageLinks.extraLarge string קישור לתמונה בגודל גדול במיוחד (רוחב של כ-1,280 פיקסלים). (בתחזית LITE)
volumeInfo.language string השפה הטובה ביותר לאוסף הזה (על סמך התוכן). זהו קוד בן שתי אותיות לפי תקן ISO 639-1, כמו fr, en וכו'.
volumeInfo.mainCategory string הקטגוריה הראשית שאליה שייך הכרך. הקטגוריה מתוך רשימת הקטגוריות שהוחזרה תהיה בעלת המשקל הגבוה ביותר.
userInfo object מידע ספציפי למשתמש שקשור לנפח הזה. (למשל, הדף שהמשתמש קרא לאחרונה או אם הוא רכש את הספר הזה)
userInfo.review nested object הביקורת של המשתמש הזה על הכרך הזה, אם יש כזו.
userInfo.readingPosition readingPosition Resource מיקום הקריאה הנוכחי של המשתמש במהדורה, אם יש כזה. (בהקרנה ב-Lite).
userInfo.isPurchased boolean האם נפח האחסון הזה נרכש על ידי המשתמש המאומת ששלח את הבקשה. (בהקרנה ב-Lite).
saleInfo object כל מידע על כרך שקשור לחנות האלקטרונית ו/או לאפשרות הרכישה. מידע זה עשוי להיות תלוי במדינה שממנה מגיעה הבקשה (כלומר, ייתכן שספרים לא יהיו זמינים למכירה במדינות מסוימות).
saleInfo.country string קוד מדינה בן שתי אותיות לפי תקן ISO_3166-1 שעבורו פרטי המכירה תקפים. (בהקרנה ב-Lite).
saleInfo.saleability string האם הספר זמין למכירה או זמין בחינם בחנות Google eBookstore במדינה שצוינה למעלה. ערכים אפשריים: FOR_SALE, FREE, NOT_FOR_SALE או FOR_PREORDER.
saleInfo.isEbook boolean אם כרך זה הוא ספר דיגיטלי או לא (ניתן להוסיף למדף 'הספרים שלי').
saleInfo.listPrice object המחיר המומלץ לצרכן. (בתחזית LITE)
saleInfo.listPrice.amount double הסכום במטבע שמופיע בהמשך. (בהקרנה ב-Lite).
saleInfo.listPrice.currencyCode string קוד מטבע בן שלוש אותיות לפי תקן ISO 4217. (בהקרנה ב-Lite).
saleInfo.retailPrice object מחיר המכירה בפועל של הספר. המחיר הזה זהה למחיר הקמעונאי או המחירון המוצע, אלא אם יש מבצעים או הנחות בנפח הזה. (בתחזית LITE)
saleInfo.retailPrice.amount double הסכום במטבע שמופיע בהמשך. (בהקרנה ב-Lite).
saleInfo.retailPrice.currencyCode string קוד מטבע בן שלוש אותיות לפי תקן ISO 4217. (בהיטל LITE).
accessInfo object כל מידע על כרך שקשור לקריאה או להשגת הטקסט של הכרך. המידע הזה עשוי להשתנות בהתאם למדינה (לדוגמה, ספרים עשויים להיות בתחום הציבורי במדינה אחת אבל לא במדינה אחרת).
accessInfo.country string קוד מדינה בן שתי אותיות לפי תקן ISO_3166-1 שעבורו פרטי הגישה תקפים. (בהקרנה ב-Lite).
accessInfo.viewability string הרשאת הקריאה של נפח אחסון. הערכים האפשריים הם PARTIAL, ‏ ALL_PAGES, ‏ NO_PAGES או UNKNOWN. הערך הזה תלוי במדינה שצוינה למעלה. המשמעות של הערך 'חלקי' היא שהמוציא לאור אישר לצפות בחלק מהנפח באופן ציבורי, ללא רכישה. המדיניות הזו חלה גם על ספרים דיגיטליים וגם על ספרים שאינם דיגיטליים. ספרים שהם נחלת הכלל תמיד יקבלו ערך של ALL_PAGES.
accessInfo.epub object מידע על תוכן בפורמט EPUB. (בתחזית LITE)
accessInfo.pdf object מידע על תוכן קובץ ה-PDF. (בהיטל LITE)
accessInfo.accessViewStatus string שילוב של הגישה והצפייה בנפח האחסון הזה בשדה סטטוס אחד למשתמש הזה. הערכים האפשריים הם FULL_PURCHASED, ‏ FULL_PUBLIC_DOMAIN, ‏ SAMPLE או NONE. (בהקרנה ב-Lite).
accessInfo.embeddable boolean האם אפשר להטמיע את האוסף הזה בחלון תצוגה באמצעות Embedded Viewer API.
accessInfo.publicDomain boolean האם הספר הזה הוא נחלת הכלל במדינה שצוינה למעלה.
userInfo.updated datetime חותמת הזמן של מועד השינוי האחרון של הכרך הזה על ידי פעולת משתמש, כמו עדכון מיקום הקריאה, רכישת כרך או כתיבת ביקורת. (פורמט תאריך ושעה RFC 3339 UTC).
userInfo.isPreordered boolean האם המשתמש המאומת שהגיש את הבקשה הזמין מראש את הכרך הזה. (בהיטל LITE).
saleInfo.onSaleDate datetime התאריך שבו הספר זמין למכירה.
accessInfo.textToSpeechPermission string אם מותר להשתמש בהמרת טקסט לדיבור (TTS) בנפח הזה. הערכים יכולים להיות ALLOWED, ALLOWED_FOR_ACCESSIBILITY או NOT_ALLOWED.
accessInfo.epub.isAvailable boolean האם קובץ ה-epub עם טקסט זורם זמין כתוכן בתחום הציבורי או לרכישה. (בהקרנה ב-Lite).
accessInfo.pdf.isAvailable boolean האם קובץ ה-PDF של התמונה הסריקה זמין כתוכן בתחום הציבורי או לרכישה. (בהקרנה ב-Lite).
accessInfo.downloadAccess nested object מידע על הגבלות הגישה לרישיון להורדות של נפח אחסון.
accessInfo.downloadAccess.kind string סוג המשאב.
accessInfo.downloadAccess.volumeId string מזהה את נפח האחסון שאליו חלה הרשומה הזו.
accessInfo.downloadAccess.restricted boolean אם יש מגבלות גישה להורדה בנפח האחסון הזה.
accessInfo.downloadAccess.deviceAllowed boolean אם הגישה מוגבלת, אם היא ניתנת למשתמש, למכשיר או לאחסון האישי.
accessInfo.downloadAccess.justAcquired boolean אם deviceAllowed, האם הגישה התקבלה רק עכשיו באמצעות הבקשה הזו.
accessInfo.downloadAccess.maxDownloadDevices integer אם ההרשאה מוגבלת, המספר המקסימלי של רישיונות להורדת תוכן עבור הכרך הזה.
accessInfo.downloadAccess.downloadsAcquired integer אם חלה הגבלה, מספר הרישיונות להורדת תוכן שכבר נרכשו (כולל הלקוח ששלח את הבקשה, אם יש רישיון לכך).
accessInfo.downloadAccess.nonce string קוד חד-פעמי ללקוח לאימות. גישה להורדה ואימות לקוח בלבד.
accessInfo.downloadAccess.source string מזהה אפליקציית הלקוח לאימות. גישה להורדה ואימות לקוח בלבד.
accessInfo.downloadAccess.reasonCode string קוד הסיבה לשגיאה/אזהרה. יכול להיות שנוסיף קודים נוספים בעתיד. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string הודעת שגיאה/אזהרה.
accessInfo.downloadAccess.signature string חתימה על התגובה.
searchInfo object מידע על תוצאות החיפוש שקשור לנפח הזה.
searchInfo.textSnippet string קטע טקסט שמכיל את שאילתה החיפוש.