עוצמת הקול

אוסף של 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
  }
}
שם הנכס ערך תיאור הערות
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 ועוד.
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 מידע על כרך הקשור ל-eBookstore ו/או לרכישה. מידע זה עשוי להיות תלוי במדינה שממנה נשלחה הבקשה (כלומר, ייתכן שספרים לא יימכרו במדינות מסוימות).
saleInfo.country string קוד מדינה בן שתי אותיות על פי תקן ISO_3166-1 שעבורו פרטי המבצע תקפים. (בהיטל LITE).
saleInfo.saleability string אם הספר הזה זמין למכירה או מוצע בחינם ב-Google Booksstore עבור המדינה שצוינה למעלה. הערכים האפשריים הם 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. הערך הזה תלוי במדינה שצוינה למעלה. ערך חלקי של PARTIAL פירושו שבעל האתר איפשר להציג חלק מהנפח באופן ציבורי, ללא רכישה. אפשרות זו חלה על ספרים דיגיטליים וגם על ספרים שאינם דיגיטליים. ספרים שהם נחלת הכלל תמיד יקבלו את הערך 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 קביעה אם אפשר להטמיע את עוצמת הקול הזו באזור תצוגה באמצעות 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 אם המכשיר אושר, האם הגישה הזו התקבלה באמצעות הבקשה הזו.
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 קטע טקסט שמכיל את שאילתת החיפוש.