אוסף
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 } }
שם הנכס | ערך של Gpa education | תיאור | הערות |
---|---|---|---|
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 |
קישור לתמונה גדולה במיוחד (רוחב של כ-1280 פיקסלים). (בהיטל 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 |
מידע כלשהו על כרך שקשור ל-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). | |
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, Example או 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 |
האם אפשר להמיר טקסט לדיבור בעוצמת הקול הזו. הערכים יכולים להיות 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 |
אם 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 |
קטע טקסט שמכיל את שאילתת החיפוש. |