אוסף של
Volume
משמש לביצוע חיפוש או רישום של תוכן של מדף ספרים. האוסף הזה הוא לקריאה בלבד.שיטות
השיטות הבאות חלות על הנתונים הציבוריים על נפחים, ואינן דורשות אימות.
books.volumes.listbooks.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) | |
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 ועוד. | |
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 |
מידע על כרך הקשור ל-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). | |
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. הערך הזה תלוי במדינה שצוינה למעלה. ערך חלקי של PARTIAL פירושו שבעל האתר איפשר להציג חלק מהנפח באופן ציבורי, ללא רכישה. אפשרות זו חלה על ספרים דיגיטליים וגם על ספרים שאינם דיגיטליים. ספרים שהם נחלת הכלל תמיד יקבלו את הערך 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 |
קביעה אם אפשר להטמיע את עוצמת הקול הזו באזור תצוגה באמצעות 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 |
אם המכשיר אושר, האם הגישה הזו התקבלה באמצעות הבקשה הזו. | |
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 |
קטע טקסט שמכיל את שאילתת החיפוש. |