Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / c9b6cec70b2162b98d836f8100bc039f19fe23cb / . / docs / dyn / books_v1.volumes.html
blob: b84632d8cecb6d8e918e0feaf9782b7797b709df [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="books_v1.html">Books API</a> . <a href="books_v1.volumes.html">volumes</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="books_v1.volumes.associated.html">associated()</a></code>
79</p>
80<p class="firstline">Returns the associated Resource.</p>
81
82<p class="toc_element">
83 <code><a href="books_v1.volumes.mybooks.html">mybooks()</a></code>
84</p>
85<p class="firstline">Returns the mybooks Resource.</p>
86
87<p class="toc_element">
88 <code><a href="books_v1.volumes.recommended.html">recommended()</a></code>
89</p>
90<p class="firstline">Returns the recommended Resource.</p>
91
92<p class="toc_element">
93 <code><a href="books_v1.volumes.useruploaded.html">useruploaded()</a></code>
94</p>
95<p class="firstline">Returns the useruploaded Resource.</p>
96
97<p class="toc_element">
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]98 <code><a href="#get">get(volumeId, user_library_consistent_read=None, projection=None, source=None, country=None, partner=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]99<p class="firstline">Gets volume information for a single volume.</p>
100<p class="toc_element">
101 <code><a href="#list">list(q, orderBy=None, projection=None, showPreorders=None, download=None, startIndex=None, partner=None, source=None, maxResults=None, libraryRestrict=None, langRestrict=None, printType=None, filter=None)</a></code></p>
102<p class="firstline">Performs a book search.</p>
103<h3>Method Details</h3>
104<div class="method">
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]105 <code class="details" id="get">get(volumeId, user_library_consistent_read=None, projection=None, source=None, country=None, partner=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]106 <pre>Gets volume information for a single volume.
107
108Args:
109 volumeId: string, ID of volume to retrieve. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]110 user_library_consistent_read: boolean, A parameter
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]111 projection: string, Restrict information returned to a set of selected fields.
112 Allowed values
113 full - Includes all volume data.
114 lite - Includes a subset of fields in volumeInfo and accessInfo.
115 source: string, String to identify the originator of this request.
116 country: string, ISO-3166-1 code to override the IP-based location.
117 partner: string, Brand results for partner ID.
118
119Returns:
120 An object of the form:
121
122 {
123 "kind": "books#volume", # Resource type for a volume. (In LITE projection.)
124 "accessInfo": { # Any information about a volume related to reading or obtaining that volume text. This information can depend on country (books may be public domain in one country but not in another, e.g.).
125 "webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.
126 "publicDomain": True or False, # Whether or not this book is public domain in the country listed above.
127 "embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.
128 "downloadAccess": { # Information about a volume's download license access restrictions.
129 "nonce": "A String", # Client nonce for verification. Download access and client-validation only.
130 "kind": "books#downloadAccessRestriction", # Resource type.
131 "justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.
132 "maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.
133 "downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).
134 "signature": "A String", # Response signature.
135 "volumeId": "A String", # Identifies the volume for which this entry applies.
136 "deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).
137 "source": "A String", # Client app identifier for verification. Download access and client-validation only.
138 "restricted": True or False, # Whether this volume has any download access restrictions.
139 "reasonCode": "A String", # Error/warning reason code. Additional codes may be added in the future. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
140 "message": "A String", # Error/warning message.
141 },
142 "country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)
143 "quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.
144 "viewOrderUrl": "A String", # For ordered but not yet processed orders, we give a URL that can be used to go to the appropriate Google Wallet page.
145 "textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
146 "driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.
147 "pdf": { # Information about pdf content. (In LITE projection.)
148 "isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)
149 "downloadLink": "A String", # URL to download pdf. (In LITE projection.)
150 "acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)
151 },
152 "explicitOfflineLicenseManagement": True or False, # Whether this volume requires that the client explicitly request offline download license rather than have it done automatically when loading the content, if the client supports it.
153 "viewability": "A String", # The read access of a volume. Possible values are PARTIAL, ALL_PAGES, NO_PAGES or UNKNOWN. This value depends on the country listed above. A value of PARTIAL means that the publisher has allowed some portion of the volume to be viewed publicly, without purchase. This can apply to eBooks as well as non-eBooks. Public domain books will always have a value of ALL_PAGES.
154 "epub": { # Information about epub content. (In LITE projection.)
155 "isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)
156 "downloadLink": "A String", # URL to download epub. (In LITE projection.)
157 "acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)
158 },
159 "accessViewStatus": "A String", # Combines the access and viewability of this volume into a single status field for this user. Values can be FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE or NONE. (In LITE projection.)
160 },
161 "searchInfo": { # Search result information related to this volume.
162 "textSnippet": "A String", # A text snippet containing the search query.
163 },
164 "saleInfo": { # Any information about a volume related to the eBookstore and/or purchaseability. This information can depend on the country where the request originates from (i.e. books may not be for sale in certain countries).
165 "country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)
166 "retailPrice": { # The actual selling price of the book. This is the same as the suggested retail or list price unless there are offers or discounts on this volume. (In LITE projection.)
167 "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
168 "currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
169 },
170 "isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).
171 "offers": [ # Offers available for this volume (sales and rentals).
172 {
173 "rentalDuration": { # The rental duration (for rental offers only).
174 "count": 3.14,
175 "unit": "A String",
176 },
177 "retailPrice": { # Offer retail (=discounted) price in Micros
178 "currencyCode": "A String",
179 "amountInMicros": 3.14,
180 },
181 "listPrice": { # Offer list (=undiscounted) price in Micros.
182 "currencyCode": "A String",
183 "amountInMicros": 3.14,
184 },
185 "finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)
186 },
187 ],
188 "saleability": "A String", # Whether or not this book is available for sale or offered for free in the Google eBookstore for the country listed above. Possible values are FOR_SALE, FOR_RENTAL_ONLY, FOR_SALE_AND_RENTAL, FREE, NOT_FOR_SALE, or FOR_PREORDER.
189 "buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)
190 "onSaleDate": "A String", # The date on which this book is available for sale.
191 "listPrice": { # Suggested retail price. (In LITE projection.)
192 "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
193 "currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
194 },
195 },
196 "etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)
197 "selfLink": "A String", # URL to this resource. (In LITE projection.)
198 "volumeInfo": { # General volume information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]199 "subtitle": "A String", # Volume subtitle. (In LITE projection.)
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]200 "pageCount": 42, # Total number of pages as per publisher metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]201 "mainCategory": "A String", # The main category to which this volume belongs. It will be the category from the categories list returned below that has the highest weight.
202 "dimensions": { # Physical dimensions of this volume.
203 "width": "A String", # Width of this volume (in cm).
204 "thickness": "A String", # Thickness of this volume (in cm).
205 "height": "A String", # Height or length of this volume (in cm).
206 },
207 "previewLink": "A String", # URL to preview this volume on the Google Books site.
208 "contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)
209 "industryIdentifiers": [ # Industry standard identifiers for this volume.
210 {
211 "identifier": "A String", # Industry specific volume identifier.
212 "type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.
213 },
214 ],
215 "canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)
216 "description": "A String", # A synopsis of the volume. The text of the description is formatted in HTML and includes simple formatting elements, such as b, i, and br tags. (In LITE projection.)
217 "publishedDate": "A String", # Date of publication. (In LITE projection.)
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]218 "imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)
219 "medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)
220 "smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)
221 "large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)
222 "extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)
223 "small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)
224 "thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)
225 },
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]226 "authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)
227 "A String",
228 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]229 "categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.
230 "A String",
231 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]232 "publisher": "A String", # Publisher of this volume. (In LITE projection.)
233 "language": "A String", # Best language for this volume (based on content). It is the two-letter ISO 639-1 code such as 'fr', 'en', etc.
234 "readingModes": "", # The reading modes available for this volume.
235 "title": "A String", # Volume title. (In LITE projection.)
236 "printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]237 "samplePageCount": 42, # Total number of sample pages as per publisher metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]238 "printedPageCount": 42, # Total number of printed pages in generated pdf representation.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]239 "averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]240 "infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)
241 "ratingsCount": 42, # The number of review ratings for this volume.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]242 },
243 "recommendedInfo": { # Recommendation related information for this volume.
244 "explanation": "A String", # A text explaining why this volume is recommended.
245 },
246 "id": "A String", # Unique identifier for a volume. (In LITE projection.)
247 "layerInfo": { # What layers exist in this volume and high level information about them.
248 "layers": [ # A layer should appear here if and only if the layer exists for this book.
249 {
250 "volumeAnnotationsVersion": "A String", # The current version of this layer's volume annotations. Note that this version applies only to the data in the books.layers.volumeAnnotations.* responses. The actual annotation data is versioned separately.
251 "layerId": "A String", # The layer id of this layer (e.g. "geo").
252 },
253 ],
254 },
255 "userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)
256 "isInMyBooks": True or False, # Whether or not this volume is currently in "my books."
257 "rentalPeriod": { # Period during this book is/was a valid rental.
258 "startUtcSec": "A String",
259 "endUtcSec": "A String",
260 },
261 "updated": "A String", # Timestamp when this volume was last modified by a user action, such as a reading position update, volume purchase or writing a review. (RFC 3339 UTC date-time format).
262 "userUploadedVolumeInfo": {
263 "processingState": "A String",
264 },
265 "rentalState": "A String", # Whether this book is an active or an expired rental.
266 "isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)
267 "readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)
268 "kind": "books#readingPosition", # Resource type for a reading position.
269 "gbImagePosition": "A String", # Position in a volume for image-based content.
270 "epubCfiPosition": "A String", # Position in an EPUB as a CFI.
271 "updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).
272 "volumeId": "A String", # Volume id associated with this reading position.
273 "pdfPosition": "A String", # Position in a PDF file.
274 "gbTextPosition": "A String", # Position in a volume for text-based content.
275 },
276 "review": { # This user's review of this volume, if one exists.
277 "rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.
278 "kind": "books#review", # Resource type for a review.
279 "author": { # Author of this review.
280 "displayName": "A String", # Name of this person.
281 },
282 "title": "A String", # Title for this review.
283 "volumeId": "A String", # Volume that this review is for.
284 "content": "A String", # Review text.
285 "source": { # Information regarding the source of this review, when the review is not from a Google Books user.
286 "extraDescription": "A String", # Extra text about the source of the review.
287 "url": "A String", # URL of the source of the review.
288 "description": "A String", # Name of the source.
289 },
290 "date": "A String", # Date of this review.
291 "type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.
292 "fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.
293 },
294 "isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)
295 "copy": { # Copy/Paste accounting information.
296 "limitType": "A String",
297 "remainingCharacterCount": 42,
298 "updated": "A String",
299 "allowedCharacterCount": 42,
300 },
301 "isUploaded": True or False, # Whether or not this volume was user uploaded.
302 },
303 }</pre>
304</div>
305
306<div class="method">
307 <code class="details" id="list">list(q, orderBy=None, projection=None, showPreorders=None, download=None, startIndex=None, partner=None, source=None, maxResults=None, libraryRestrict=None, langRestrict=None, printType=None, filter=None)</code>
308 <pre>Performs a book search.
309
310Args:
311 q: string, Full-text search query string. (required)
312 orderBy: string, Sort search results.
313 Allowed values
314 newest - Most recently published.
315 relevance - Relevance to search terms.
316 projection: string, Restrict information returned to a set of selected fields.
317 Allowed values
318 full - Includes all volume data.
319 lite - Includes a subset of fields in volumeInfo and accessInfo.
320 showPreorders: boolean, Set to true to show books available for preorder. Defaults to false.
321 download: string, Restrict to volumes by download availability.
322 Allowed values
323 epub - All volumes with epub.
324 startIndex: integer, Index of the first result to return (starts at 0)
325 partner: string, Restrict and brand results for partner ID.
326 source: string, String to identify the originator of this request.
327 maxResults: integer, Maximum number of results to return.
328 libraryRestrict: string, Restrict search to this user's library.
329 Allowed values
330 my-library - Restrict to the user's library, any shelf.
331 no-restrict - Do not restrict based on user's library.
332 langRestrict: string, Restrict results to books with this language code.
333 printType: string, Restrict to books or magazines.
334 Allowed values
335 all - All volume content types.
336 books - Just books.
337 magazines - Just magazines.
338 filter: string, Filter search results.
339 Allowed values
340 ebooks - All Google eBooks.
341 free-ebooks - Google eBook with full volume text viewability.
342 full - Public can view entire volume text.
343 paid-ebooks - Google eBook with a price.
344 partial - Public able to see parts of text.
345
346Returns:
347 An object of the form:
348
349 {
350 "totalItems": 42, # Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated.
351 "items": [ # A list of volumes.
352 {
353 "kind": "books#volume", # Resource type for a volume. (In LITE projection.)
354 "accessInfo": { # Any information about a volume related to reading or obtaining that volume text. This information can depend on country (books may be public domain in one country but not in another, e.g.).
355 "webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.
356 "publicDomain": True or False, # Whether or not this book is public domain in the country listed above.
357 "embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.
358 "downloadAccess": { # Information about a volume's download license access restrictions.
359 "nonce": "A String", # Client nonce for verification. Download access and client-validation only.
360 "kind": "books#downloadAccessRestriction", # Resource type.
361 "justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.
362 "maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.
363 "downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).
364 "signature": "A String", # Response signature.
365 "volumeId": "A String", # Identifies the volume for which this entry applies.
366 "deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).
367 "source": "A String", # Client app identifier for verification. Download access and client-validation only.
368 "restricted": True or False, # Whether this volume has any download access restrictions.
369 "reasonCode": "A String", # Error/warning reason code. Additional codes may be added in the future. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
370 "message": "A String", # Error/warning message.
371 },
372 "country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)
373 "quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.
374 "viewOrderUrl": "A String", # For ordered but not yet processed orders, we give a URL that can be used to go to the appropriate Google Wallet page.
375 "textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
376 "driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.
377 "pdf": { # Information about pdf content. (In LITE projection.)
378 "isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)
379 "downloadLink": "A String", # URL to download pdf. (In LITE projection.)
380 "acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)
381 },
382 "explicitOfflineLicenseManagement": True or False, # Whether this volume requires that the client explicitly request offline download license rather than have it done automatically when loading the content, if the client supports it.
383 "viewability": "A String", # The read access of a volume. Possible values are PARTIAL, ALL_PAGES, NO_PAGES or UNKNOWN. This value depends on the country listed above. A value of PARTIAL means that the publisher has allowed some portion of the volume to be viewed publicly, without purchase. This can apply to eBooks as well as non-eBooks. Public domain books will always have a value of ALL_PAGES.
384 "epub": { # Information about epub content. (In LITE projection.)
385 "isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)
386 "downloadLink": "A String", # URL to download epub. (In LITE projection.)
387 "acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)
388 },
389 "accessViewStatus": "A String", # Combines the access and viewability of this volume into a single status field for this user. Values can be FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE or NONE. (In LITE projection.)
390 },
391 "searchInfo": { # Search result information related to this volume.
392 "textSnippet": "A String", # A text snippet containing the search query.
393 },
394 "saleInfo": { # Any information about a volume related to the eBookstore and/or purchaseability. This information can depend on the country where the request originates from (i.e. books may not be for sale in certain countries).
395 "country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)
396 "retailPrice": { # The actual selling price of the book. This is the same as the suggested retail or list price unless there are offers or discounts on this volume. (In LITE projection.)
397 "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
398 "currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
399 },
400 "isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).
401 "offers": [ # Offers available for this volume (sales and rentals).
402 {
403 "rentalDuration": { # The rental duration (for rental offers only).
404 "count": 3.14,
405 "unit": "A String",
406 },
407 "retailPrice": { # Offer retail (=discounted) price in Micros
408 "currencyCode": "A String",
409 "amountInMicros": 3.14,
410 },
411 "listPrice": { # Offer list (=undiscounted) price in Micros.
412 "currencyCode": "A String",
413 "amountInMicros": 3.14,
414 },
415 "finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)
416 },
417 ],
418 "saleability": "A String", # Whether or not this book is available for sale or offered for free in the Google eBookstore for the country listed above. Possible values are FOR_SALE, FOR_RENTAL_ONLY, FOR_SALE_AND_RENTAL, FREE, NOT_FOR_SALE, or FOR_PREORDER.
419 "buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)
420 "onSaleDate": "A String", # The date on which this book is available for sale.
421 "listPrice": { # Suggested retail price. (In LITE projection.)
422 "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
423 "currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
424 },
425 },
426 "etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)
427 "selfLink": "A String", # URL to this resource. (In LITE projection.)
428 "volumeInfo": { # General volume information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]429 "subtitle": "A String", # Volume subtitle. (In LITE projection.)
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]430 "pageCount": 42, # Total number of pages as per publisher metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]431 "mainCategory": "A String", # The main category to which this volume belongs. It will be the category from the categories list returned below that has the highest weight.
432 "dimensions": { # Physical dimensions of this volume.
433 "width": "A String", # Width of this volume (in cm).
434 "thickness": "A String", # Thickness of this volume (in cm).
435 "height": "A String", # Height or length of this volume (in cm).
436 },
437 "previewLink": "A String", # URL to preview this volume on the Google Books site.
438 "contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)
439 "industryIdentifiers": [ # Industry standard identifiers for this volume.
440 {
441 "identifier": "A String", # Industry specific volume identifier.
442 "type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.
443 },
444 ],
445 "canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)
446 "description": "A String", # A synopsis of the volume. The text of the description is formatted in HTML and includes simple formatting elements, such as b, i, and br tags. (In LITE projection.)
447 "publishedDate": "A String", # Date of publication. (In LITE projection.)
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]448 "imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)
449 "medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)
450 "smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)
451 "large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)
452 "extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)
453 "small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)
454 "thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)
455 },
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]456 "authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)
457 "A String",
458 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]459 "categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.
460 "A String",
461 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]462 "publisher": "A String", # Publisher of this volume. (In LITE projection.)
463 "language": "A String", # Best language for this volume (based on content). It is the two-letter ISO 639-1 code such as 'fr', 'en', etc.
464 "readingModes": "", # The reading modes available for this volume.
465 "title": "A String", # Volume title. (In LITE projection.)
466 "printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]467 "samplePageCount": 42, # Total number of sample pages as per publisher metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]468 "printedPageCount": 42, # Total number of printed pages in generated pdf representation.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]469 "averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]470 "infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)
471 "ratingsCount": 42, # The number of review ratings for this volume.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]472 },
473 "recommendedInfo": { # Recommendation related information for this volume.
474 "explanation": "A String", # A text explaining why this volume is recommended.
475 },
476 "id": "A String", # Unique identifier for a volume. (In LITE projection.)
477 "layerInfo": { # What layers exist in this volume and high level information about them.
478 "layers": [ # A layer should appear here if and only if the layer exists for this book.
479 {
480 "volumeAnnotationsVersion": "A String", # The current version of this layer's volume annotations. Note that this version applies only to the data in the books.layers.volumeAnnotations.* responses. The actual annotation data is versioned separately.
481 "layerId": "A String", # The layer id of this layer (e.g. "geo").
482 },
483 ],
484 },
485 "userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)
486 "isInMyBooks": True or False, # Whether or not this volume is currently in "my books."
487 "rentalPeriod": { # Period during this book is/was a valid rental.
488 "startUtcSec": "A String",
489 "endUtcSec": "A String",
490 },
491 "updated": "A String", # Timestamp when this volume was last modified by a user action, such as a reading position update, volume purchase or writing a review. (RFC 3339 UTC date-time format).
492 "userUploadedVolumeInfo": {
493 "processingState": "A String",
494 },
495 "rentalState": "A String", # Whether this book is an active or an expired rental.
496 "isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)
497 "readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)
498 "kind": "books#readingPosition", # Resource type for a reading position.
499 "gbImagePosition": "A String", # Position in a volume for image-based content.
500 "epubCfiPosition": "A String", # Position in an EPUB as a CFI.
501 "updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).
502 "volumeId": "A String", # Volume id associated with this reading position.
503 "pdfPosition": "A String", # Position in a PDF file.
504 "gbTextPosition": "A String", # Position in a volume for text-based content.
505 },
506 "review": { # This user's review of this volume, if one exists.
507 "rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.
508 "kind": "books#review", # Resource type for a review.
509 "author": { # Author of this review.
510 "displayName": "A String", # Name of this person.
511 },
512 "title": "A String", # Title for this review.
513 "volumeId": "A String", # Volume that this review is for.
514 "content": "A String", # Review text.
515 "source": { # Information regarding the source of this review, when the review is not from a Google Books user.
516 "extraDescription": "A String", # Extra text about the source of the review.
517 "url": "A String", # URL of the source of the review.
518 "description": "A String", # Name of the source.
519 },
520 "date": "A String", # Date of this review.
521 "type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.
522 "fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.
523 },
524 "isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)
525 "copy": { # Copy/Paste accounting information.
526 "limitType": "A String",
527 "remainingCharacterCount": 42,
528 "updated": "A String",
529 "allowedCharacterCount": 42,
530 },
531 "isUploaded": True or False, # Whether or not this volume was user uploaded.
532 },
533 },
534 ],
535 "kind": "books#volumes", # Resource type.
536 }</pre>
537</div>
538
539</body></html>