עוצמת הקול

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

שיטות

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

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

הורדה
אחזור משאב נפח לפי מזהה.
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
  }
}
שם הנכס ערך של Gpa education תיאור הערות
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 קישור לתמונה גדולה במיוחד (רוחב של כ-1280 פיקסלים). (בהיטל 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 מידע כלשהו על כרך שקשור ל-Digitalstore ו/או לאפשרות הרכישה. מידע זה עשוי להיות תלוי במדינה שממנה מגיעה הבקשה (כלומר, ייתכן שספרים לא יהיו זמינים למכירה במדינות מסוימות).
saleInfo.country string קוד מדינה בן שתי אותיות לפי תקן ISO_3166-1 שעבורו פרטי המכירה תקפים. (בהיטל LITE).
saleInfo.saleability string האם הספר הזה זמין למכירה או מוצע בחינם בחנות Google Books במדינה שצוינה למעלה. ערכים אפשריים: 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, Example או 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 האם אפשר להמיר טקסט לדיבור בעוצמת הקול הזו. הערכים יכולים להיות 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 אם deviceAllow, האם התקבלה גישה הרגע באמצעות הבקשה הזו.
accessInfo.downloadAccess.maxDownloadDevices integer אם חלה הגבלה, זה המספר המקסימלי של רישיונות להורדת תוכן לנפח הזה.
accessInfo.downloadAccess.downloadsAcquired integer אם חלה הגבלה, מספר הרישיונות להורדת תוכן שכבר נרכשו (כולל הלקוח ששלח את הבקשה, אם יש רישיון לכך).
accessInfo.downloadAccess.nonce string צופן חד-פעמי (nonce) של לקוח לצורך אימות. גישה להורדות ואימות לקוח בלבד.
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 קטע טקסט שמכיל את שאילתת החיפוש.