docs/dyn/books.v1.bookshelves.volumes.html - platform/external/python/google-api-python-client - Gitiles


 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html><head><title>Python: class Resource</title>
 </head><body bgcolor="#f0f0f8">
 <p>
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
 <tr bgcolor="#ffc8d8">
 <td colspan=3 valign=bottom>&nbsp;<br>
 <font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>

 <tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
 <td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
 <tr><td>&nbsp;</td>
 <td width="100%">Methods defined here:<br>
 <dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>

 <dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves&nbsp;volumes&nbsp;in&nbsp;a&nbsp;specific&nbsp;bookshelf&nbsp;for&nbsp;the&nbsp;specified&nbsp;user.<br>
 &nbsp;<br>
 Args:<br>
 &nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;source:&nbsp;string,&nbsp;String&nbsp;to&nbsp;identify&nbsp;the&nbsp;originator&nbsp;of&nbsp;this&nbsp;request.<br>
 &nbsp;&nbsp;shelf:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;bookshelf&nbsp;to&nbsp;retrieve&nbsp;volumes.&nbsp;(required)<br>
 &nbsp;&nbsp;showPreorders:&nbsp;boolean,&nbsp;Set&nbsp;to&nbsp;true&nbsp;to&nbsp;show&nbsp;pre-ordered&nbsp;books.&nbsp;Defaults&nbsp;to&nbsp;false.<br>
 &nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;results&nbsp;to&nbsp;return<br>
 &nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;startIndex:&nbsp;integer,&nbsp;Index&nbsp;of&nbsp;the&nbsp;first&nbsp;element&nbsp;to&nbsp;return&nbsp;(starts&nbsp;at&nbsp;0)<br>
 &nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;user&nbsp;for&nbsp;whom&nbsp;to&nbsp;retrieve&nbsp;bookshelf&nbsp;volumes.&nbsp;(required)<br>
 &nbsp;<br>
 Returns:<br>
 &nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
 &nbsp;<br>
 &nbsp;&nbsp;&nbsp;&nbsp;{<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"totalItems":&nbsp;42,&nbsp;#&nbsp;Total&nbsp;number&nbsp;of&nbsp;volumes&nbsp;found.&nbsp;This&nbsp;might&nbsp;be&nbsp;greater&nbsp;than&nbsp;the&nbsp;number&nbsp;of&nbsp;volumes&nbsp;returned&nbsp;in&nbsp;this&nbsp;response&nbsp;if&nbsp;results&nbsp;have&nbsp;been&nbsp;paginated.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;A&nbsp;list&nbsp;of&nbsp;volumes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"books#volume",&nbsp;#&nbsp;Resource&nbsp;type&nbsp;for&nbsp;a&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"accessInfo":&nbsp;{&nbsp;#&nbsp;Any&nbsp;information&nbsp;about&nbsp;a&nbsp;volume&nbsp;related&nbsp;to&nbsp;reading&nbsp;or&nbsp;obtaining&nbsp;that&nbsp;volume&nbsp;text.&nbsp;This&nbsp;information&nbsp;can&nbsp;depend&nbsp;on&nbsp;country&nbsp;(books&nbsp;may&nbsp;be&nbsp;public&nbsp;domain&nbsp;in&nbsp;one&nbsp;country&nbsp;but&nbsp;not&nbsp;in&nbsp;another,&nbsp;e.g.).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"webReaderLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;read&nbsp;this&nbsp;volume&nbsp;on&nbsp;the&nbsp;Google&nbsp;Books&nbsp;site.&nbsp;Link&nbsp;will&nbsp;not&nbsp;allow&nbsp;users&nbsp;to&nbsp;read&nbsp;non-viewable&nbsp;volumes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"publicDomain":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;book&nbsp;is&nbsp;public&nbsp;domain&nbsp;in&nbsp;the&nbsp;country&nbsp;listed&nbsp;above.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"embeddable":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;volume&nbsp;can&nbsp;be&nbsp;embedded&nbsp;in&nbsp;a&nbsp;viewport&nbsp;using&nbsp;the&nbsp;Embedded&nbsp;Viewer&nbsp;API.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadAccess":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;a&nbsp;volume's&nbsp;download&nbsp;license&nbsp;access&nbsp;restrictions.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"nonce":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Client&nbsp;nonce&nbsp;for&nbsp;verification.&nbsp;Download&nbsp;access&nbsp;and&nbsp;client-validation&nbsp;only.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"books#downloadAccessRestriction",&nbsp;#&nbsp;Resource&nbsp;type.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"justAcquired":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;If&nbsp;deviceAllowed,&nbsp;whether&nbsp;access&nbsp;was&nbsp;just&nbsp;acquired&nbsp;with&nbsp;this&nbsp;request.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"maxDownloadDevices":&nbsp;42,&nbsp;#&nbsp;If&nbsp;restricted,&nbsp;the&nbsp;maximum&nbsp;number&nbsp;of&nbsp;content&nbsp;download&nbsp;licenses&nbsp;for&nbsp;this&nbsp;volume.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadsAcquired":&nbsp;42,&nbsp;#&nbsp;If&nbsp;restricted,&nbsp;the&nbsp;number&nbsp;of&nbsp;content&nbsp;download&nbsp;licenses&nbsp;already&nbsp;acquired&nbsp;(including&nbsp;the&nbsp;requesting&nbsp;client,&nbsp;if&nbsp;licensed).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"signature":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Response&nbsp;signature.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"volumeId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifies&nbsp;the&nbsp;volume&nbsp;for&nbsp;which&nbsp;this&nbsp;entry&nbsp;applies.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"deviceAllowed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;If&nbsp;restricted,&nbsp;whether&nbsp;access&nbsp;is&nbsp;granted&nbsp;for&nbsp;this&nbsp;(user,&nbsp;device,&nbsp;volume).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"source":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Client&nbsp;app&nbsp;identifier&nbsp;for&nbsp;verification.&nbsp;Download&nbsp;access&nbsp;and&nbsp;client-validation&nbsp;only.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"restricted":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;volume&nbsp;has&nbsp;any&nbsp;download&nbsp;access&nbsp;restrictions.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"reasonCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Error/warning&nbsp;reason&nbsp;code.&nbsp;Additional&nbsp;codes&nbsp;may&nbsp;be&nbsp;added&nbsp;in&nbsp;the&nbsp;future.&nbsp;0&nbsp;OK&nbsp;100&nbsp;ACCESS_DENIED_PUBLISHER_LIMIT&nbsp;101&nbsp;ACCESS_DENIED_LIMIT&nbsp;200&nbsp;WARNING_USED_LAST_ACCESS<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"message":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Error/warning&nbsp;message.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;two-letter&nbsp;ISO_3166-1&nbsp;country&nbsp;code&nbsp;for&nbsp;which&nbsp;this&nbsp;access&nbsp;information&nbsp;is&nbsp;valid.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"viewOrderUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;For&nbsp;ordered&nbsp;but&nbsp;not&nbsp;yet&nbsp;processed&nbsp;orders,&nbsp;we&nbsp;give&nbsp;a&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;go&nbsp;to&nbsp;the&nbsp;appropriate&nbsp;Google&nbsp;Wallet&nbsp;page.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"textToSpeechPermission":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;text-to-speech&nbsp;is&nbsp;permitted&nbsp;for&nbsp;this&nbsp;volume.&nbsp;Values&nbsp;can&nbsp;be&nbsp;ALLOWED,&nbsp;ALLOWED_FOR_ACCESSIBILITY,&nbsp;or&nbsp;NOT_ALLOWED.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"pdf":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;pdf&nbsp;content.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isAvailable":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Is&nbsp;a&nbsp;scanned&nbsp;image&nbsp;pdf&nbsp;available&nbsp;either&nbsp;as&nbsp;public&nbsp;domain&nbsp;or&nbsp;for&nbsp;purchase.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;download&nbsp;pdf.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"acsTokenLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;retrieve&nbsp;ACS&nbsp;token&nbsp;for&nbsp;pdf&nbsp;download.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"viewability":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;read&nbsp;access&nbsp;of&nbsp;a&nbsp;volume.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;PARTIAL,&nbsp;ALL_PAGES,&nbsp;NO_PAGES&nbsp;or&nbsp;UNKNOWN.&nbsp;This&nbsp;value&nbsp;depends&nbsp;on&nbsp;the&nbsp;country&nbsp;listed&nbsp;above.&nbsp;A&nbsp;value&nbsp;of&nbsp;PARTIAL&nbsp;means&nbsp;that&nbsp;the&nbsp;publisher&nbsp;has&nbsp;allowed&nbsp;some&nbsp;portion&nbsp;of&nbsp;the&nbsp;volume&nbsp;to&nbsp;be&nbsp;viewed&nbsp;publicly,&nbsp;without&nbsp;purchase.&nbsp;This&nbsp;can&nbsp;apply&nbsp;to&nbsp;eBooks&nbsp;as&nbsp;well&nbsp;as&nbsp;non-eBooks.&nbsp;Public&nbsp;domain&nbsp;books&nbsp;will&nbsp;always&nbsp;have&nbsp;a&nbsp;value&nbsp;of&nbsp;ALL_PAGES.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"epub":&nbsp;{&nbsp;#&nbsp;Information&nbsp;about&nbsp;epub&nbsp;content.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isAvailable":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Is&nbsp;a&nbsp;flowing&nbsp;text&nbsp;epub&nbsp;available&nbsp;either&nbsp;as&nbsp;public&nbsp;domain&nbsp;or&nbsp;for&nbsp;purchase.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;download&nbsp;epub.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"acsTokenLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;retrieve&nbsp;ACS&nbsp;token&nbsp;for&nbsp;epub&nbsp;download.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"accessViewStatus":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Combines&nbsp;the&nbsp;access&nbsp;and&nbsp;viewability&nbsp;of&nbsp;this&nbsp;volume&nbsp;into&nbsp;a&nbsp;single&nbsp;status&nbsp;field&nbsp;for&nbsp;this&nbsp;user.&nbsp;Values&nbsp;can&nbsp;be&nbsp;FULL_PURCHASED,&nbsp;FULL_PUBLIC_DOMAIN,&nbsp;SAMPLE&nbsp;or&nbsp;NONE.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"searchInfo":&nbsp;{&nbsp;#&nbsp;Search&nbsp;result&nbsp;information&nbsp;related&nbsp;to&nbsp;this&nbsp;volume.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"textSnippet":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;text&nbsp;snippet&nbsp;containing&nbsp;the&nbsp;search&nbsp;query.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"saleInfo":&nbsp;{&nbsp;#&nbsp;Any&nbsp;information&nbsp;about&nbsp;a&nbsp;volume&nbsp;related&nbsp;to&nbsp;the&nbsp;eBookstore&nbsp;and/or&nbsp;purchaseability.&nbsp;This&nbsp;information&nbsp;can&nbsp;depend&nbsp;on&nbsp;the&nbsp;country&nbsp;where&nbsp;the&nbsp;request&nbsp;originates&nbsp;from&nbsp;(i.e.&nbsp;books&nbsp;may&nbsp;not&nbsp;be&nbsp;for&nbsp;sale&nbsp;in&nbsp;certain&nbsp;countries).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;two-letter&nbsp;ISO_3166-1&nbsp;country&nbsp;code&nbsp;for&nbsp;which&nbsp;this&nbsp;sale&nbsp;information&nbsp;is&nbsp;valid.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"retailPrice":&nbsp;{&nbsp;#&nbsp;The&nbsp;actual&nbsp;selling&nbsp;price&nbsp;of&nbsp;the&nbsp;book.&nbsp;This&nbsp;is&nbsp;the&nbsp;same&nbsp;as&nbsp;the&nbsp;suggested&nbsp;retail&nbsp;or&nbsp;list&nbsp;price&nbsp;unless&nbsp;there&nbsp;are&nbsp;offers&nbsp;or&nbsp;discounts&nbsp;on&nbsp;this&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;Amount&nbsp;in&nbsp;the&nbsp;currency&nbsp;listed&nbsp;below.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;ISO&nbsp;4217,&nbsp;three-letter&nbsp;currency&nbsp;code.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isEbook":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;volume&nbsp;is&nbsp;an&nbsp;eBook&nbsp;(can&nbsp;be&nbsp;added&nbsp;to&nbsp;the&nbsp;My&nbsp;eBooks&nbsp;shelf).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"saleability":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;book&nbsp;is&nbsp;available&nbsp;for&nbsp;sale&nbsp;or&nbsp;offered&nbsp;for&nbsp;free&nbsp;in&nbsp;the&nbsp;Google&nbsp;eBookstore&nbsp;for&nbsp;the&nbsp;country&nbsp;listed&nbsp;above.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;FOR_SALE,&nbsp;FREE,&nbsp;NOT_FOR_SALE,&nbsp;or&nbsp;FOR_PREORDER.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"buyLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;purchase&nbsp;this&nbsp;volume&nbsp;on&nbsp;the&nbsp;Google&nbsp;Books&nbsp;site.&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"onSaleDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;date&nbsp;on&nbsp;which&nbsp;this&nbsp;book&nbsp;is&nbsp;available&nbsp;for&nbsp;sale.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"listPrice":&nbsp;{&nbsp;#&nbsp;Suggested&nbsp;retail&nbsp;price.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;Amount&nbsp;in&nbsp;the&nbsp;currency&nbsp;listed&nbsp;below.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;ISO&nbsp;4217,&nbsp;three-letter&nbsp;currency&nbsp;code.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Opaque&nbsp;identifier&nbsp;for&nbsp;a&nbsp;specific&nbsp;version&nbsp;of&nbsp;a&nbsp;volume&nbsp;resource.&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userInfo":&nbsp;{&nbsp;#&nbsp;User&nbsp;specific&nbsp;information&nbsp;related&nbsp;to&nbsp;this&nbsp;volume.&nbsp;(e.g.&nbsp;page&nbsp;this&nbsp;user&nbsp;last&nbsp;read&nbsp;or&nbsp;whether&nbsp;they&nbsp;purchased&nbsp;this&nbsp;book)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isInMyBooks":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;volume&nbsp;is&nbsp;currently&nbsp;in&nbsp;"my&nbsp;books."<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Timestamp&nbsp;when&nbsp;this&nbsp;volume&nbsp;was&nbsp;last&nbsp;modified&nbsp;by&nbsp;a&nbsp;user&nbsp;action,&nbsp;such&nbsp;as&nbsp;a&nbsp;reading&nbsp;position&nbsp;update,&nbsp;volume&nbsp;purchase&nbsp;or&nbsp;writing&nbsp;a&nbsp;review.&nbsp;(<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;UTC&nbsp;date-time&nbsp;format).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"review":&nbsp;{&nbsp;#&nbsp;This&nbsp;user's&nbsp;review&nbsp;of&nbsp;this&nbsp;volume,&nbsp;if&nbsp;one&nbsp;exists.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"rating":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Star&nbsp;rating&nbsp;for&nbsp;this&nbsp;review.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;ONE,&nbsp;TWO,&nbsp;THREE,&nbsp;FOUR,&nbsp;FIVE&nbsp;or&nbsp;NOT_RATED.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"books#review",&nbsp;#&nbsp;Resource&nbsp;type&nbsp;for&nbsp;a&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"author":&nbsp;{&nbsp;#&nbsp;Author&nbsp;of&nbsp;this&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Name&nbsp;of&nbsp;this&nbsp;person.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Title&nbsp;for&nbsp;this&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"volumeId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Volume&nbsp;that&nbsp;this&nbsp;review&nbsp;is&nbsp;for.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"content":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Review&nbsp;text.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"source":&nbsp;{&nbsp;#&nbsp;Information&nbsp;regarding&nbsp;the&nbsp;source&nbsp;of&nbsp;this&nbsp;review,&nbsp;when&nbsp;the&nbsp;review&nbsp;is&nbsp;not&nbsp;from&nbsp;a&nbsp;Google&nbsp;Books&nbsp;user.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extraDescription":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Extra&nbsp;text&nbsp;about&nbsp;the&nbsp;source&nbsp;of&nbsp;the&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;of&nbsp;the&nbsp;source&nbsp;of&nbsp;the&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Name&nbsp;of&nbsp;the&nbsp;source.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"date":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Date&nbsp;of&nbsp;this&nbsp;review.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Source&nbsp;type&nbsp;for&nbsp;this&nbsp;review.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;EDITORIAL,&nbsp;WEB_USER&nbsp;or&nbsp;GOOGLE_USER.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fullTextUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;for&nbsp;the&nbsp;full&nbsp;review&nbsp;text,&nbsp;for&nbsp;reviews&nbsp;gathered&nbsp;from&nbsp;the&nbsp;web.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isPurchased":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;volume&nbsp;was&nbsp;purchased&nbsp;by&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;making&nbsp;the&nbsp;request.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"readingPosition":&nbsp;{&nbsp;#&nbsp;The&nbsp;user's&nbsp;current&nbsp;reading&nbsp;position&nbsp;in&nbsp;the&nbsp;volume,&nbsp;if&nbsp;one&nbsp;is&nbsp;available.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"books#readingPosition",&nbsp;#&nbsp;Resource&nbsp;type&nbsp;for&nbsp;a&nbsp;reading&nbsp;position.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gbImagePosition":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Position&nbsp;in&nbsp;a&nbsp;volume&nbsp;for&nbsp;image-based&nbsp;content.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"epubCfiPosition":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Position&nbsp;in&nbsp;an&nbsp;EPUB&nbsp;as&nbsp;a&nbsp;CFI.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Timestamp&nbsp;when&nbsp;this&nbsp;reading&nbsp;position&nbsp;was&nbsp;last&nbsp;updated&nbsp;(formatted&nbsp;UTC&nbsp;timestamp&nbsp;with&nbsp;millisecond&nbsp;resolution).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"volumeId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Volume&nbsp;id&nbsp;associated&nbsp;with&nbsp;this&nbsp;reading&nbsp;position.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"pdfPosition":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Position&nbsp;in&nbsp;a&nbsp;PDF&nbsp;file.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"gbTextPosition":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Position&nbsp;in&nbsp;a&nbsp;volume&nbsp;for&nbsp;text-based&nbsp;content.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"isPreordered":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;or&nbsp;not&nbsp;this&nbsp;volume&nbsp;was&nbsp;pre-ordered&nbsp;by&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;making&nbsp;the&nbsp;request.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"volumeInfo":&nbsp;{&nbsp;#&nbsp;General&nbsp;volume&nbsp;information.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"publisher":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Publisher&nbsp;of&nbsp;this&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"subtitle":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Volume&nbsp;subtitle.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;synopsis&nbsp;of&nbsp;the&nbsp;volume.&nbsp;The&nbsp;text&nbsp;of&nbsp;the&nbsp;description&nbsp;is&nbsp;formatted&nbsp;in&nbsp;HTML&nbsp;and&nbsp;includes&nbsp;simple&nbsp;formatting&nbsp;elements,&nbsp;such&nbsp;as&nbsp;b,&nbsp;i,&nbsp;and&nbsp;br&nbsp;tags.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"language":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Best&nbsp;language&nbsp;for&nbsp;this&nbsp;volume&nbsp;(based&nbsp;on&nbsp;content).&nbsp;It&nbsp;is&nbsp;the&nbsp;two-letter&nbsp;ISO&nbsp;639-1&nbsp;code&nbsp;such&nbsp;as&nbsp;'fr',&nbsp;'en',&nbsp;etc.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"pageCount":&nbsp;42,&nbsp;#&nbsp;Total&nbsp;number&nbsp;of&nbsp;pages.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"imageLinks":&nbsp;{&nbsp;#&nbsp;A&nbsp;list&nbsp;of&nbsp;image&nbsp;links&nbsp;for&nbsp;all&nbsp;the&nbsp;sizes&nbsp;that&nbsp;are&nbsp;available.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"medium":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;medium&nbsp;size&nbsp;(width&nbsp;of&nbsp;~575&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"smallThumbnail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;small&nbsp;thumbnail&nbsp;size&nbsp;(width&nbsp;of&nbsp;~80&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"large":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;large&nbsp;size&nbsp;(width&nbsp;of&nbsp;~800&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"extraLarge":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;extra&nbsp;large&nbsp;size&nbsp;(width&nbsp;of&nbsp;~1280&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"small":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;small&nbsp;size&nbsp;(width&nbsp;of&nbsp;~300&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"thumbnail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Image&nbsp;link&nbsp;for&nbsp;thumbnail&nbsp;size&nbsp;(width&nbsp;of&nbsp;~128&nbsp;pixels).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"publishedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Date&nbsp;of&nbsp;publication.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"previewLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;preview&nbsp;this&nbsp;volume&nbsp;on&nbsp;the&nbsp;Google&nbsp;Books&nbsp;site.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"printType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Type&nbsp;of&nbsp;publication&nbsp;of&nbsp;this&nbsp;volume.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;BOOK&nbsp;or&nbsp;MAGAZINE.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"ratingsCount":&nbsp;42,&nbsp;#&nbsp;The&nbsp;number&nbsp;of&nbsp;review&nbsp;ratings&nbsp;for&nbsp;this&nbsp;volume.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mainCategory":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;main&nbsp;category&nbsp;to&nbsp;which&nbsp;this&nbsp;volume&nbsp;belongs.&nbsp;It&nbsp;will&nbsp;be&nbsp;the&nbsp;category&nbsp;from&nbsp;the&nbsp;categories&nbsp;list&nbsp;returned&nbsp;below&nbsp;that&nbsp;has&nbsp;the&nbsp;highest&nbsp;weight.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"dimensions":&nbsp;{&nbsp;#&nbsp;Physical&nbsp;dimensions&nbsp;of&nbsp;this&nbsp;volume.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"width":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Width&nbsp;of&nbsp;this&nbsp;volume&nbsp;(in&nbsp;cm).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"thickness":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Thickness&nbsp;of&nbsp;this&nbsp;volume&nbsp;(in&nbsp;cm).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"height":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Height&nbsp;or&nbsp;length&nbsp;of&nbsp;this&nbsp;volume&nbsp;(in&nbsp;cm).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"contentVersion":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;identifier&nbsp;for&nbsp;the&nbsp;version&nbsp;of&nbsp;the&nbsp;volume&nbsp;content&nbsp;(text&nbsp;&amp;&nbsp;images).&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"industryIdentifiers":&nbsp;[&nbsp;#&nbsp;Industry&nbsp;standard&nbsp;identifiers&nbsp;for&nbsp;this&nbsp;volume.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"identifier":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Industry&nbsp;specific&nbsp;volume&nbsp;identifier.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Identifier&nbsp;type.&nbsp;Possible&nbsp;values&nbsp;are&nbsp;ISBN_10,&nbsp;ISBN_13,&nbsp;ISSN&nbsp;and&nbsp;OTHER.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"authors":&nbsp;[&nbsp;#&nbsp;The&nbsp;names&nbsp;of&nbsp;the&nbsp;authors&nbsp;and/or&nbsp;editors&nbsp;for&nbsp;this&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Volume&nbsp;title.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"canonicalVolumeLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Canonical&nbsp;URL&nbsp;for&nbsp;a&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"infoLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;view&nbsp;information&nbsp;about&nbsp;this&nbsp;volume&nbsp;on&nbsp;the&nbsp;Google&nbsp;Books&nbsp;site.&nbsp;(In&nbsp;LITE&nbsp;projection)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"categories":&nbsp;[&nbsp;#&nbsp;A&nbsp;list&nbsp;of&nbsp;subject&nbsp;categories,&nbsp;such&nbsp;as&nbsp;"Fiction",&nbsp;"Suspense",&nbsp;etc.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"averageRating":&nbsp;3.14,&nbsp;#&nbsp;The&nbsp;mean&nbsp;review&nbsp;rating&nbsp;for&nbsp;this&nbsp;volume.&nbsp;(min&nbsp;=&nbsp;1.0,&nbsp;max&nbsp;=&nbsp;5.0)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Unique&nbsp;identifier&nbsp;for&nbsp;a&nbsp;volume.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;this&nbsp;resource.&nbsp;(In&nbsp;LITE&nbsp;projection.)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;],<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"books#volumes",&nbsp;#&nbsp;Resource&nbsp;type.<br>
 &nbsp;&nbsp;}</tt></dd></dl>

 <hr>
 Data descriptors defined here:<br>
 <dl><dt><strong>__dict__</strong></dt>
 <dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
 </dl>
 <dl><dt><strong>__weakref__</strong></dt>
 <dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
 </dl>
 </td></tr></table>
 </body></html>

	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	<html><head><title>Python: class Resource</title>
	</head><body bgcolor="#f0f0f8">
	<p>
	<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
	<tr bgcolor="#ffc8d8">
	<td colspan=3 valign=bottom> <br>
	<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>

	<tr bgcolor="#ffc8d8"><td rowspan=2><tt>   </tt></td>
	<td colspan=2><tt>A class for interacting with a resource.<br> </tt></td></tr>
	<tr><td> </td>
	<td width="100%">Methods defined here:<br>
	<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>

	<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves volumes in a specific bookshelf for the specified user.<br>
	<br>
	Args:<br>
	pp: string, A parameter<br>
	trace: string, A parameter<br>
	source: string, String to identify the originator of this request.<br>
	shelf: string, ID of bookshelf to retrieve volumes. (required)<br>
	showPreorders: boolean, Set to true to show pre-ordered books. Defaults to false.<br>
	maxResults: integer, Maximum number of results to return<br>
	strict: string, A parameter<br>
	startIndex: integer, Index of the first element to return (starts at 0)<br>
	userip: string, A parameter<br>
	userId: string, ID of user for whom to retrieve bookshelf volumes. (required)<br>
	<br>
	Returns:<br>
	An object of the form<br>
	<br>
	{<br>
	"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.<br>
	"items": [ # A list of volumes.<br>
	{<br>
	"kind": "books#volume", # Resource type for a volume. (In LITE projection.)<br>
	"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.).<br>
	"webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.<br>
	"publicDomain": True or False, # Whether or not this book is public domain in the country listed above.<br>
	"embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.<br>
	"downloadAccess": { # Information about a volume's download license access restrictions.<br>
	"nonce": "A String", # Client nonce for verification. Download access and client-validation only.<br>
	"kind": "books#downloadAccessRestriction", # Resource type.<br>
	"justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.<br>
	"maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.<br>
	"downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).<br>
	"signature": "A String", # Response signature.<br>
	"volumeId": "A String", # Identifies the volume for which this entry applies.<br>
	"deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).<br>
	"source": "A String", # Client app identifier for verification. Download access and client-validation only.<br>
	"restricted": True or False, # Whether this volume has any download access restrictions.<br>
	"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<br>
	"message": "A String", # Error/warning message.<br>
	},<br>
	"country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)<br>
	"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.<br>
	"textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.<br>
	"pdf": { # Information about pdf content. (In LITE projection.)<br>
	"isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)<br>
	"downloadLink": "A String", # URL to download pdf. (In LITE projection.)<br>
	"acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)<br>
	},<br>
	"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.<br>
	"epub": { # Information about epub content. (In LITE projection.)<br>
	"isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)<br>
	"downloadLink": "A String", # URL to download epub. (In LITE projection.)<br>
	"acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)<br>
	},<br>
	"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.)<br>
	},<br>
	"searchInfo": { # Search result information related to this volume.<br>
	"textSnippet": "A String", # A text snippet containing the search query.<br>
	},<br>
	"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).<br>
	"country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)<br>
	"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.)<br>
	"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)<br>
	"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)<br>
	},<br>
	"isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).<br>
	"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, FREE, NOT_FOR_SALE, or FOR_PREORDER.<br>
	"buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)<br>
	"onSaleDate": "A String", # The date on which this book is available for sale.<br>
	"listPrice": { # Suggested retail price. (In LITE projection.)<br>
	"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)<br>
	"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)<br>
	},<br>
	},<br>
	"etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)<br>
	"userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)<br>
	"isInMyBooks": True or False, # Whether or not this volume is currently in "my books."<br>
	"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. (<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC 3339</a> UTC date-time format).<br>
	"review": { # This user's review of this volume, if one exists.<br>
	"rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.<br>
	"kind": "books#review", # Resource type for a review.<br>
	"author": { # Author of this review.<br>
	"displayName": "A String", # Name of this person.<br>
	},<br>
	"title": "A String", # Title for this review.<br>
	"volumeId": "A String", # Volume that this review is for.<br>
	"content": "A String", # Review text.<br>
	"source": { # Information regarding the source of this review, when the review is not from a Google Books user.<br>
	"extraDescription": "A String", # Extra text about the source of the review.<br>
	"url": "A String", # URL of the source of the review.<br>
	"description": "A String", # Name of the source.<br>
	},<br>
	"date": "A String", # Date of this review.<br>
	"type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.<br>
	"fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.<br>
	},<br>
	"isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)<br>
	"readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)<br>
	"kind": "books#readingPosition", # Resource type for a reading position.<br>
	"gbImagePosition": "A String", # Position in a volume for image-based content.<br>
	"epubCfiPosition": "A String", # Position in an EPUB as a CFI.<br>
	"updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).<br>
	"volumeId": "A String", # Volume id associated with this reading position.<br>
	"pdfPosition": "A String", # Position in a PDF file.<br>
	"gbTextPosition": "A String", # Position in a volume for text-based content.<br>
	},<br>
	"isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)<br>
	},<br>
	"volumeInfo": { # General volume information.<br>
	"publisher": "A String", # Publisher of this volume. (In LITE projection.)<br>
	"subtitle": "A String", # Volume subtitle. (In LITE projection.)<br>
	"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.)<br>
	"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.<br>
	"pageCount": 42, # Total number of pages.<br>
	"imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)<br>
	"medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)<br>
	"smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)<br>
	"large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)<br>
	"extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)<br>
	"small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)<br>
	"thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)<br>
	},<br>
	"publishedDate": "A String", # Date of publication. (In LITE projection.)<br>
	"previewLink": "A String", # URL to preview this volume on the Google Books site.<br>
	"printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.<br>
	"ratingsCount": 42, # The number of review ratings for this volume.<br>
	"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.<br>
	"dimensions": { # Physical dimensions of this volume.<br>
	"width": "A String", # Width of this volume (in cm).<br>
	"thickness": "A String", # Thickness of this volume (in cm).<br>
	"height": "A String", # Height or length of this volume (in cm).<br>
	},<br>
	"contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)<br>
	"industryIdentifiers": [ # Industry standard identifiers for this volume.<br>
	{<br>
	"identifier": "A String", # Industry specific volume identifier.<br>
	"type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.<br>
	},<br>
	],<br>
	"authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)<br>
	"A String",<br>
	],<br>
	"title": "A String", # Volume title. (In LITE projection.)<br>
	"canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)<br>
	"infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)<br>
	"categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.<br>
	"A String",<br>
	],<br>
	"averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)<br>
	},<br>
	"id": "A String", # Unique identifier for a volume. (In LITE projection.)<br>
	"selfLink": "A String", # URL to this resource. (In LITE projection.)<br>
	},<br>
	],<br>
	"kind": "books#volumes", # Resource type.<br>
	}</tt></dd></dl>

	<hr>
	Data descriptors defined here:<br>
	<dl><dt><strong>__dict__</strong></dt>
	<dd><tt>dictionary for instance variables (if defined)</tt></dd>
	</dl>
	<dl><dt><strong>__weakref__</strong></dt>
	<dd><tt>list of weak references to the object (if defined)</tt></dd>
	</dl>
	</td></tr></table>
	</body></html>