Blame - docs/dyn/books_v1.volumes.html - platform/external/python/google-api-python-client

2014-04-24 15:46:26 -0400

[diff] [blame]

102

<p class="firstline">Gets volume information for a single volume.</p>

103

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

104

<code><a href="#list">list(q, maxResults=None, maxAllowedMaturityRating=None, partner=None, langRestrict=None, filter=None, source=None, download=None, orderBy=None, libraryRestrict=None, printType=None, projection=None, startIndex=None, showPreorders=None, x__xgafv=None)</a></code></p>

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

105

<p class="firstline">Performs a book search.</p>

106

<h3>Method Details</h3>

107

Dmitry Frenkel

3e17f89

2020-10-06 16:46:05 -0700

[diff] [blame]

108

<code class="details" id="close">close()</code>

109

<pre>Close httplib2 connections.</pre>

</div>

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

113

<code class="details" id="get">get(volumeId, includeNonComicsSeries=None, country=None, user_library_consistent_read=None, projection=None, partner=None, source=None, x__xgafv=None)</code>

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

114

<pre>Gets volume information for a single volume.

115

116

Args:

117

volumeId: string, ID of volume to retrieve. (required)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

118

includeNonComicsSeries: boolean, Set to true to include non-comics series. Defaults to false.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

119

country: string, ISO-3166-1 code to override the IP-based location.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

120

user_library_consistent_read: boolean, A parameter

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

121

projection: string, Restrict information returned to a set of selected fields.

122

Allowed values

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

123

PROJECTION_UNDEFINED -

124

FULL - Includes all volume data.

125

LITE - Includes a subset of fields in volumeInfo and accessInfo.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

126

partner: string, Brand results for partner ID.

127

source: string, string to identify the originator of this request.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

128

x__xgafv: string, V1 error format.

129

Allowed values

130

1 - v1 error format

131

2 - v2 error format

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

132

133

Returns:

134

An object of the form:

135

136

{

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

137

"searchInfo": { # Search result information related to this volume.

138

"textSnippet": "A String", # A text snippet containing the search query.

139

},

140

"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.).

141

"driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.

142

"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.)

143

"epub": { # Information about epub content. (In LITE projection.)

144

"acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)

145

"downloadLink": "A String", # URL to download epub. (In LITE projection.)

146

"isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)

147

},

148

"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.

149

"pdf": { # Information about pdf content. (In LITE projection.)

150

"isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)

151

"downloadLink": "A String", # URL to download pdf. (In LITE projection.)

152

"acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)

153

},

154

"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.

155

"quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.

156

"country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)

157

"textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.

158

"webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.

159

"publicDomain": True or False, # Whether or not this book is public domain in the country listed above.

160

"embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.

161

"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.

162

"downloadAccess": { # Information about a volume's download license access restrictions.

163

"restricted": True or False, # Whether this volume has any download access restrictions.

164

"justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.

165

"volumeId": "A String", # Identifies the volume for which this entry applies.

166

"deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).

167

"downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).

168

"maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.

169

"kind": "A String", # Resource type.

170

"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

171

"message": "A String", # Error/warning message.

172

"source": "A String", # Client app identifier for verification. Download access and client-validation only.

173

"nonce": "A String", # Client nonce for verification. Download access and client-validation only.

174

"signature": "A String", # Response signature.

175

},

176

},

177

"kind": "A String", # Resource type for a volume. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

178

"layerInfo": { # What layers exist in this volume and high level information about them.

179

"layers": [ # A layer should appear here if and only if the layer exists for this book.

180

{

181

"layerId": "A String", # The layer id of this layer (e.g. "geo").

182

"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.

183

},

184

],

185

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

186

"recommendedInfo": { # Recommendation related information for this volume.

187

"explanation": "A String", # A text explaining why this volume is recommended.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

188

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

189

"selfLink": "A String", # URL to this resource. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

190

"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).

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

191

"country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

192

"isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

193

"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.)

194

"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)

195

"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)

196

},

197

"listPrice": { # Suggested retail price. (In LITE projection.)

198

"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)

199

"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)

200

},

201

"onSaleDate": "A String", # The date on which this book is available for sale.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

202

"offers": [ # Offers available for this volume (sales and rentals).

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

203

{

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

204

"rentalDuration": { # The rental duration (for rental offers only).

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

205

"unit": "A String",

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

206

"count": 3.14,

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

207

},

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

208

"retailPrice": { # Offer retail (=discounted) price in Micros

209

"amountInMicros": 3.14,

210

"currencyCode": "A String",

211

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

212

"finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)

213

"giftable": True or False, # Indicates whether the offer is giftable.

214

"listPrice": { # Offer list (=undiscounted) price in Micros.

215

"currencyCode": "A String",

216

"amountInMicros": 3.14,

217

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

218

},

219

],

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

220

"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.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

221

"buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

222

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

223

"id": "A String", # Unique identifier for a volume. (In LITE projection.)

224

"userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)

225

"review": { # This user's review of this volume, if one exists.

226

"volumeId": "A String", # Volume that this review is for.

227

"date": "A String", # Date of this review.

228

"author": { # Author of this review.

229

"displayName": "A String", # Name of this person.

230

},

231

"type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.

232

"kind": "A String", # Resource type for a review.

233

"source": { # Information regarding the source of this review, when the review is not from a Google Books user.

234

"description": "A String", # Name of the source.

235

"extraDescription": "A String", # Extra text about the source of the review.

236

"url": "A String", # URL of the source of the review.

237

},

238

"content": "A String", # Review text.

239

"fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.

240

"title": "A String", # Title for this review.

241

"rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.

242

},

243

"rentalPeriod": { # Period during this book is/was a valid rental.

244

"endUtcSec": "A String",

245

"startUtcSec": "A String",

246

},

247

"isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)

248

"acquisitionType": 42, # How this volume was acquired.

249

"acquiredTime": "A String", # Timestamp when this volume was acquired by the user. (RFC 3339 UTC date-time format) Acquiring includes purchase, user upload, receiving family sharing, etc.

250

"familySharing": { # Information on the ability to share with the family.

251

"isSharingAllowed": True or False, # Whether or not this volume can be shared with the family by the user. This includes sharing eligibility of both the volume and the user. If the value is true, the user can initiate a family sharing action.

252

"familyRole": "A String", # The role of the user in the family.

253

"isSharingDisabledByFop": True or False, # Whether or not sharing this volume is temporarily disabled due to issues with the Family Wallet.

254

},

255

"copy": { # Copy/Paste accounting information.

256

"allowedCharacterCount": 42,

257

"updated": "A String",

258

"remainingCharacterCount": 42,

259

"limitType": "A String",

260

},

261

"isFamilySharingDisabledByFop": True or False, # Deprecated: Replaced by familySharing.

262

"isInMyBooks": True or False, # Whether or not this volume is currently in "my books."

263

"entitlementType": 42, # Whether this volume is purchased, sample, pd download etc.

264

"isFamilySharedFromUser": True or False, # Whether or not the user shared this volume with the family.

265

"userUploadedVolumeInfo": {

266

"processingState": "A String",

267

},

268

"isUploaded": True or False, # Whether or not this volume was user uploaded.

269

"isFamilySharingAllowed": True or False, # Deprecated: Replaced by familySharing.

270

"isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)

271

"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).

272

"readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)

273

"updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).

274

"epubCfiPosition": "A String", # Position in an EPUB as a CFI.

275

"gbTextPosition": "A String", # Position in a volume for text-based content.

276

"kind": "A String", # Resource type for a reading position.

277

"volumeId": "A String", # Volume id associated with this reading position.

278

"pdfPosition": "A String", # Position in a PDF file.

279

"gbImagePosition": "A String", # Position in a volume for image-based content.

280

},

281

"rentalState": "A String", # Whether this book is an active or an expired rental.

282

"isFamilySharedToUser": True or False, # Whether or not the user received this volume through family sharing.

283

},

284

"etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

285

"volumeInfo": { # General volume information.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

286

"dimensions": { # Physical dimensions of this volume.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

287

"width": "A String", # Width of this volume (in cm).

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

288

"height": "A String", # Height or length of this volume (in cm).

289

"thickness": "A String", # Thickness of this volume (in cm).

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

290

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

291

"publisher": "A String", # Publisher of this volume. (In LITE projection.)

292

"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.

293

"title": "A String", # Volume title. (In LITE projection.)

294

"printedPageCount": 42, # Total number of printed pages in generated pdf representation.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

295

"readingModes": { # The reading modes available for this volume.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

296

"text": True or False,

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

297

"image": True or False,

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

298

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

299

"contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)

300

"printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

301

"previewLink": "A String", # URL to preview this volume on the Google Books site.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

302

"ratingsCount": 42, # The number of review ratings for this volume.

303

"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.)

304

"maturityRating": "A String",

305

"infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)

306

"categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.

307

"A String",

308

],

309

"pageCount": 42, # Total number of pages as per publisher metadata.

310

"samplePageCount": 42, # Total number of sample pages as per publisher metadata.

311

"allowAnonLogging": True or False, # Whether anonymous logging should be allowed.

312

"subtitle": "A String", # Volume subtitle. (In LITE projection.)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

313

"industryIdentifiers": [ # Industry standard identifiers for this volume.

314

{

315

"type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.

316

"identifier": "A String", # Industry specific volume identifier.

317

},

318

],

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

319

"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.

320

"averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)

321

"panelizationSummary": { # A top-level summary of the panelization info in this volume.

322

"containsEpubBubbles": True or False,

323

"epubBubbleVersion": "A String",

324

"containsImageBubbles": True or False,

325

"imageBubbleVersion": "A String",

326

},

327

"comicsContent": True or False, # Whether the volume has comics content.

328

"seriesInfo": {

329

"bookDisplayNumber": "A String", # The display number string. This should be used only for display purposes and the actual sequence should be inferred from the below orderNumber.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

330

"kind": "A String", # Resource type.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

331

"volumeSeries": [

332

{

333

"issue": [ # List of issues. Applicable only for Collection Edition and Omnibus.

334

{

335

"issueOrderNumber": 42,

336

"issueDisplayNumber": "A String",

337

},

338

],

339

"seriesBookType": "A String", # The book type in the context of series. Examples - Single Issue, Collection Edition, etc.

340

"seriesId": "A String", # The series id.

341

"orderNumber": 42, # The book order number in the series.

342

},

343

],

344

"shortSeriesBookTitle": "A String", # Short book title in the context of the series.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

345

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

346

"imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)

347

"large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)

348

"medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)

349

"small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)

350

"smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)

351

"extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)

352

"thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

353

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

354

"authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)

355

"A String",

356

],

357

"canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)

358

"publishedDate": "A String", # Date of publication. (In LITE projection.)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

359

},

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

}</pre>

</div>

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

364

<code class="details" id="list">list(q, maxResults=None, maxAllowedMaturityRating=None, partner=None, langRestrict=None, filter=None, source=None, download=None, orderBy=None, libraryRestrict=None, printType=None, projection=None, startIndex=None, showPreorders=None, x__xgafv=None)</code>

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

365

<pre>Performs a book search.

366

367

Args:

Bu Sun Kim

673ec5c

2020-11-16 11:05:03 -0700

[diff] [blame]

368

q: string, Full-text search query string. (required)

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

369

maxResults: integer, Maximum number of results to return.

370

maxAllowedMaturityRating: string, The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.

Dmitry Frenkel

3e17f89

2020-10-06 16:46:05 -0700

[diff] [blame]

371

Allowed values

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

372

MAX_ALLOWED_MATURITY_RATING_UNDEFINED -

373

MATURE - Show books which are rated mature or lower.

374

not-mature - Show books which are rated not mature.

375

partner: string, Restrict and brand results for partner ID.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

376

langRestrict: string, Restrict results to books with this language code.

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

377

filter: string, Filter search results.

378

Allowed values

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

379

FILTER_UNDEFINED -

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

380

ebooks - All Google eBooks.

381

free-ebooks - Google eBook with full volume text viewability.

382

full - Public can view entire volume text.

383

paid-ebooks - Google eBook with a price.

384

partial - Public able to see parts of text.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

385

source: string, String to identify the originator of this request.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

386

download: string, Restrict to volumes by download availability.

387

Allowed values

388

DOWNLOAD_UNDEFINED -

389

EPUB - All volumes with epub.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

390

orderBy: string, Sort search results.

Bu Sun Kim

673ec5c

2020-11-16 11:05:03 -0700

[diff] [blame]

391

Allowed values

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

392

ORDER_BY_UNDEFINED -

393

newest - Most recently published.

394

relevance - Relevance to search terms.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

395

libraryRestrict: string, Restrict search to this user's library.

396

Allowed values

397

LIBRARY_RESTRICT_UNDEFINED -

398

my-library - Restrict to the user's library, any shelf.

399

no-restrict - Do not restrict based on user's library.

400

printType: string, Restrict to books or magazines.

401

Allowed values

402

PRINT_TYPE_UNDEFINED -

403

ALL - All volume content types.

404

BOOKS - Just books.

405

MAGAZINES - Just magazines.

406

projection: string, Restrict information returned to a set of selected fields.

407

Allowed values

408

PROJECTION_UNDEFINED -

409

FULL - Includes all volume data.

410

LITE - Includes a subset of fields in volumeInfo and accessInfo.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

411

startIndex: integer, Index of the first result to return (starts at 0)

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

412

showPreorders: boolean, Set to true to show books available for preorder. Defaults to false.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

413

x__xgafv: string, V1 error format.

414

Allowed values

415

1 - v1 error format

416

2 - v2 error format

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

417

418

Returns:

419

An object of the form:

420

421

{

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

422

"kind": "A String", # Resource type.

423

"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.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

424

"items": [ # A list of volumes.

John Asmuth

2014-04-24 15:46:26 -0400

[diff] [blame]

425

{

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

426

"searchInfo": { # Search result information related to this volume.

427

"textSnippet": "A String", # A text snippet containing the search query.

428

},

429

"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.).

430

"driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.

431

"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.)

432

"epub": { # Information about epub content. (In LITE projection.)

433

"acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)

434

"downloadLink": "A String", # URL to download epub. (In LITE projection.)

435

"isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)

436

},

437

"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.

438

"pdf": { # Information about pdf content. (In LITE projection.)

439

"isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)

440

"downloadLink": "A String", # URL to download pdf. (In LITE projection.)

441

"acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)

442

},

443

"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.

444

"quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.

445

"country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)

446

"textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.

447

"webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.

448

"publicDomain": True or False, # Whether or not this book is public domain in the country listed above.

449

"embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.

450

"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.

451

"downloadAccess": { # Information about a volume's download license access restrictions.

452

"restricted": True or False, # Whether this volume has any download access restrictions.

453

"justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.

454

"volumeId": "A String", # Identifies the volume for which this entry applies.

455

"deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).

456

"downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).

457

"maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.

458

"kind": "A String", # Resource type.

459

"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

460

"message": "A String", # Error/warning message.

461

"source": "A String", # Client app identifier for verification. Download access and client-validation only.

462

"nonce": "A String", # Client nonce for verification. Download access and client-validation only.

463

"signature": "A String", # Response signature.

464

},

465

},

466

"kind": "A String", # Resource type for a volume. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

467

"layerInfo": { # What layers exist in this volume and high level information about them.

468

"layers": [ # A layer should appear here if and only if the layer exists for this book.

469

{

470

"layerId": "A String", # The layer id of this layer (e.g. "geo").

471

"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.

472

},

473

],

474

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

475

"recommendedInfo": { # Recommendation related information for this volume.

476

"explanation": "A String", # A text explaining why this volume is recommended.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

477

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

478

"selfLink": "A String", # URL to this resource. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

479

"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).

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

480

"country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

481

"isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

482

"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.)

483

"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)

484

"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)

485

},

486

"listPrice": { # Suggested retail price. (In LITE projection.)

487

"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)

488

"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)

489

},

490

"onSaleDate": "A String", # The date on which this book is available for sale.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

491

"offers": [ # Offers available for this volume (sales and rentals).

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

492

{

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

493

"rentalDuration": { # The rental duration (for rental offers only).

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

494

"unit": "A String",

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

495

"count": 3.14,

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

496

},

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

497

"retailPrice": { # Offer retail (=discounted) price in Micros

498

"amountInMicros": 3.14,

499

"currencyCode": "A String",

500

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

501

"finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)

502

"giftable": True or False, # Indicates whether the offer is giftable.

503

"listPrice": { # Offer list (=undiscounted) price in Micros.

504

"currencyCode": "A String",

505

"amountInMicros": 3.14,

506

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

507

},

508

],

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

509

"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.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

510

"buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

511

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

512

"id": "A String", # Unique identifier for a volume. (In LITE projection.)

513

"userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)

514

"review": { # This user's review of this volume, if one exists.

515

"volumeId": "A String", # Volume that this review is for.

516

"date": "A String", # Date of this review.

517

"author": { # Author of this review.

518

"displayName": "A String", # Name of this person.

519

},

520

"type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.

521

"kind": "A String", # Resource type for a review.

522

"source": { # Information regarding the source of this review, when the review is not from a Google Books user.

523

"description": "A String", # Name of the source.

524

"extraDescription": "A String", # Extra text about the source of the review.

525

"url": "A String", # URL of the source of the review.

526

},

527

"content": "A String", # Review text.

528

"fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.

529

"title": "A String", # Title for this review.

530

"rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.

531

},

532

"rentalPeriod": { # Period during this book is/was a valid rental.

533

"endUtcSec": "A String",

534

"startUtcSec": "A String",

535

},

536

"isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)

537

"acquisitionType": 42, # How this volume was acquired.

538

"acquiredTime": "A String", # Timestamp when this volume was acquired by the user. (RFC 3339 UTC date-time format) Acquiring includes purchase, user upload, receiving family sharing, etc.

539

"familySharing": { # Information on the ability to share with the family.

540

"isSharingAllowed": True or False, # Whether or not this volume can be shared with the family by the user. This includes sharing eligibility of both the volume and the user. If the value is true, the user can initiate a family sharing action.

541

"familyRole": "A String", # The role of the user in the family.

542

"isSharingDisabledByFop": True or False, # Whether or not sharing this volume is temporarily disabled due to issues with the Family Wallet.

543

},

544

"copy": { # Copy/Paste accounting information.

545

"allowedCharacterCount": 42,

546

"updated": "A String",

547

"remainingCharacterCount": 42,

548

"limitType": "A String",

549

},

550

"isFamilySharingDisabledByFop": True or False, # Deprecated: Replaced by familySharing.

551

"isInMyBooks": True or False, # Whether or not this volume is currently in "my books."

552

"entitlementType": 42, # Whether this volume is purchased, sample, pd download etc.

553

"isFamilySharedFromUser": True or False, # Whether or not the user shared this volume with the family.

554

"userUploadedVolumeInfo": {

555

"processingState": "A String",

556

},

557

"isUploaded": True or False, # Whether or not this volume was user uploaded.

558

"isFamilySharingAllowed": True or False, # Deprecated: Replaced by familySharing.

559

"isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)

560

"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).

561

"readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)

562

"updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).

563

"epubCfiPosition": "A String", # Position in an EPUB as a CFI.

564

"gbTextPosition": "A String", # Position in a volume for text-based content.

565

"kind": "A String", # Resource type for a reading position.

566

"volumeId": "A String", # Volume id associated with this reading position.

567

"pdfPosition": "A String", # Position in a PDF file.

568

"gbImagePosition": "A String", # Position in a volume for image-based content.

569

},

570

"rentalState": "A String", # Whether this book is an active or an expired rental.

571

"isFamilySharedToUser": True or False, # Whether or not the user received this volume through family sharing.

572

},

573

"etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

574

"volumeInfo": { # General volume information.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

575

"dimensions": { # Physical dimensions of this volume.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

576

"width": "A String", # Width of this volume (in cm).

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

577

"height": "A String", # Height or length of this volume (in cm).

578

"thickness": "A String", # Thickness of this volume (in cm).

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

579

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

580

"publisher": "A String", # Publisher of this volume. (In LITE projection.)

581

"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.

582

"title": "A String", # Volume title. (In LITE projection.)

583

"printedPageCount": 42, # Total number of printed pages in generated pdf representation.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

584

"readingModes": { # The reading modes available for this volume.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

585

"text": True or False,

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

586

"image": True or False,

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame]

587

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

588

"contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)

589

"printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

590

"previewLink": "A String", # URL to preview this volume on the Google Books site.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

591

"ratingsCount": 42, # The number of review ratings for this volume.

592

"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.)

593

"maturityRating": "A String",

594

"infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)

595

"categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.

596

"A String",

597

],

598

"pageCount": 42, # Total number of pages as per publisher metadata.

599

"samplePageCount": 42, # Total number of sample pages as per publisher metadata.

600

"allowAnonLogging": True or False, # Whether anonymous logging should be allowed.

601

"subtitle": "A String", # Volume subtitle. (In LITE projection.)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame]

602

"industryIdentifiers": [ # Industry standard identifiers for this volume.

603

{

604

"type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.

605

"identifier": "A String", # Industry specific volume identifier.

606

},

607

],

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

608

"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.

609

"averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)

610

"panelizationSummary": { # A top-level summary of the panelization info in this volume.

611

"containsEpubBubbles": True or False,

612

"epubBubbleVersion": "A String",

613

"containsImageBubbles": True or False,

614

"imageBubbleVersion": "A String",

615

},

616

"comicsContent": True or False, # Whether the volume has comics content.

617

"seriesInfo": {

618

"bookDisplayNumber": "A String", # The display number string. This should be used only for display purposes and the actual sequence should be inferred from the below orderNumber.

Yoshi Automation Bot

2020-11-26 17:16:03 -0800

[diff] [blame]

619

"kind": "A String", # Resource type.

Yoshi Automation Bot