אוסף
Volume
משמש לביצוע חיפוש או לרישום התוכן של מדף ספרים. האוסף הזה הוא אוסף לקריאה בלבד.שיטות
השיטות הבאות רלוונטיות לנתונים הציבוריים לגבי נפחי אחסון ולא מחייבות אימות.
books.volumes.listbooks.volumes.get
השיטה הבאה חלה על התצוגה הפרטית 'הספרייה שלי' של האוספים, והיא דורשת אימות.
books.mylibrary.bookshelves.volumes.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) | |
selfLink |
string |
כתובת ה-URL של המשאב הזה. (בהקרנה ב-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 |
object |
רשימה של קישורים לתמונות בכל הגדלים הזמינים. (בהיטל 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 |
הקטגוריה הראשית שאליה שייך הכרך. הקטגוריה מתוך רשימת הקטגוריות שהוחזרה תהיה בעלת המשקל הגבוה ביותר. | |
volumeInfo.previewLink |
string |
כתובת URL לתצוגה מקדימה של הכרך הזה באתר Google Books. | |
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). | |
saleInfo.buyLink |
string |
כתובת ה-URL לרכישת הכרך הזה באתר Google Books. (בתחזית 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.epub.downloadLink |
string |
כתובת ה-URL להורדת קובץ ה-EPUB. (בהקרנה ב-Lite). | |
accessInfo.epub.acsTokenLink |
string |
כתובת ה-URL לאחזור אסימון ACS להורדת קובץ epub. (בהקרנה ב-Lite). | |
accessInfo.pdf |
object |
מידע על תוכן קובץ ה-PDF. (בהיטל LITE) | |
accessInfo.pdf.downloadLink |
string |
כתובת ה-URL להורדת קובץ ה-PDF. (בהיטל LITE). | |
accessInfo.pdf.acsTokenLink |
string |
כתובת URL לאחזור טוקן ACS להורדת קובץ PDF. (בהקרנה ב-Lite). | |
accessInfo.accessViewStatus |
string |
שילוב של הגישה והצפייה בנפח האחסון הזה בשדה סטטוס אחד למשתמש הזה. הערכים האפשריים הם FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE או NONE. (בהקרנה ב-Lite). | |
accessInfo.embeddable |
boolean |
האם אפשר להטמיע את האוסף הזה בחלון תצוגה באמצעות Embedded Viewer API. | |
accessInfo.publicDomain |
boolean |
האם הספר הזה הוא נחלת הכלל במדינה שצוינה למעלה. | |
|
string |
כתובת ה-URL שבה אפשר לראות מידע על הכרך הזה באתר של Google Books. (בהקרנה בגרסת Lite) | |
userInfo.updated |
datetime |
חותמת הזמן של מועד השינוי האחרון של הכרך הזה על ידי פעולת משתמש, כמו עדכון מיקום הקריאה, רכישת כרך או כתיבת ביקורת. (פורמט תאריך ושעה RFC 3339 UTC). | |
volumeInfo.canonicalVolumeLink |
string |
כתובת ה-URL הקנונית של נפח אחסון. (בהקרנה ב-Lite). | |
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.webReaderLink |
string |
כתובת URL לקריאת הכרך הזה באתר Google Books. הקישור לא יאפשר למשתמשים לקרוא כרכים שלא ניתן לצפות בהם. | |
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 |
קטע טקסט שמכיל את שאילתה החיפוש. |