docs: update docs/dyn (#1096)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/6f0f288a-a1e8-4b2d-a85f-00b1c6150185/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/39b7149da4026765385403632db3c6f63db96b2c
Source-Link: https://github.com/googleapis/synthtool/commit/9a7d9fbb7045c34c9d3d22c1ff766eeae51f04c9
Source-Link: https://github.com/googleapis/synthtool/commit/dc9903a8c30c3662b6098f0e4a97f221d67268b2
Source-Link: https://github.com/googleapis/synthtool/commit/7fcc405a579d5d53a726ff3da1b7c8c08f0f2d58
Source-Link: https://github.com/googleapis/synthtool/commit/d5fc0bcf9ea9789c5b0e3154a9e3b29e5cea6116
Source-Link: https://github.com/googleapis/synthtool/commit/e89175cf074dccc4babb4eca66ae913696e47a71
Source-Link: https://github.com/googleapis/synthtool/commit/7d652819519dfa24da9e14548232e4aaba71a11c
Source-Link: https://github.com/googleapis/synthtool/commit/7db8a6c5ffb12a6e4c2f799c18f00f7f3d60e279
Source-Link: https://github.com/googleapis/synthtool/commit/1f1148d3c7a7a52f0c98077f976bd9b3c948ee2b
Source-Link: https://github.com/googleapis/synthtool/commit/2c8aecedd55b0480fb4e123b6e07fa5b12953862
Source-Link: https://github.com/googleapis/synthtool/commit/3d3e94c4e02370f307a9a200b0c743c3d8d19f29
Source-Link: https://github.com/googleapis/synthtool/commit/c7824ea48ff6d4d42dfae0849aec8a85acd90bd9
Source-Link: https://github.com/googleapis/synthtool/commit/ba9918cd22874245b55734f57470c719b577e591
Source-Link: https://github.com/googleapis/synthtool/commit/b19b401571e77192f8dd38eab5fb2300a0de9324
Source-Link: https://github.com/googleapis/synthtool/commit/6542bd723403513626f61642fc02ddca528409aa
diff --git a/docs/dyn/books_v1.onboarding.html b/docs/dyn/books_v1.onboarding.html
index b1861b1..e8f2f0f 100644
--- a/docs/dyn/books_v1.onboarding.html
+++ b/docs/dyn/books_v1.onboarding.html
@@ -81,7 +81,7 @@
<code><a href="#listCategories">listCategories(locale=None, x__xgafv=None)</a></code></p>
<p class="firstline">List categories for onboarding experience.</p>
<p class="toc_element">
- <code><a href="#listCategoryVolumes">listCategoryVolumes(categoryId=None, pageSize=None, maxAllowedMaturityRating=None, pageToken=None, locale=None, x__xgafv=None)</a></code></p>
+ <code><a href="#listCategoryVolumes">listCategoryVolumes(pageSize=None, maxAllowedMaturityRating=None, categoryId=None, locale=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">List available volumes under categories for onboarding experience.</p>
<p class="toc_element">
<code><a href="#listCategoryVolumes_next">listCategoryVolumes_next(previous_request, previous_response)</a></code></p>
@@ -110,28 +110,28 @@
"kind": "A String", # Resource type.
"items": [ # A list of onboarding categories.
{
- "badgeUrl": "A String",
- "name": "A String",
"categoryId": "A String",
+ "name": "A String",
+ "badgeUrl": "A String",
},
],
}</pre>
</div>
<div class="method">
- <code class="details" id="listCategoryVolumes">listCategoryVolumes(categoryId=None, pageSize=None, maxAllowedMaturityRating=None, pageToken=None, locale=None, x__xgafv=None)</code>
+ <code class="details" id="listCategoryVolumes">listCategoryVolumes(pageSize=None, maxAllowedMaturityRating=None, categoryId=None, locale=None, pageToken=None, x__xgafv=None)</code>
<pre>List available volumes under categories for onboarding experience.
Args:
- categoryId: string, List of category ids requested. (repeated)
pageSize: integer, Number of maximum results per page to be included in the response.
maxAllowedMaturityRating: string, The maximum allowed maturity rating of returned volumes. Books with a higher maturity rating are filtered out.
Allowed values
MAX_ALLOWED_MATURITY_RATING_UNDEFINED -
MATURE - Show books which are rated mature or lower.
not-mature - Show books which are rated not mature.
- pageToken: string, The value of the nextToken from the previous page.
+ categoryId: string, List of category ids requested. (repeated)
locale: string, ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset.
+ pageToken: string, The value of the nextToken from the previous page.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -141,123 +141,164 @@
An object of the form:
{
- "kind": "A String", # Resource type.
"items": [ # A list of volumes.
{
- "layerInfo": { # What layers exist in this volume and high level information about them.
- "layers": [ # A layer should appear here if and only if the layer exists for this book.
- {
- "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.
- "layerId": "A String", # The layer id of this layer (e.g. "geo").
- },
- ],
+ "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.).
+ "publicDomain": True or False, # Whether or not this book is public domain in the country listed above.
+ "downloadAccess": { # Information about a volume's download license access restrictions.
+ "downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).
+ "kind": "A String", # Resource type.
+ "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
+ "message": "A String", # Error/warning message.
+ "source": "A String", # Client app identifier for verification. Download access and client-validation only.
+ "maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.
+ "nonce": "A String", # Client nonce for verification. Download access and client-validation only.
+ "deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).
+ "volumeId": "A String", # Identifies the volume for which this entry applies.
+ "justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.
+ "signature": "A String", # Response signature.
+ "restricted": True or False, # Whether this volume has any download access restrictions.
+ },
+ "pdf": { # Information about pdf content. (In LITE projection.)
+ "isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)
+ "downloadLink": "A String", # URL to download pdf. (In LITE projection.)
+ "acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)
+ },
+ "driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.
+ "epub": { # Information about epub content. (In LITE projection.)
+ "downloadLink": "A String", # URL to download epub. (In LITE projection.)
+ "acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)
+ "isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)
+ },
+ "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.
+ "country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)
+ "embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.
+ "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.
+ "quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.
+ "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.
+ "webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.
+ "textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
+ "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.)
},
"recommendedInfo": { # Recommendation related information for this volume.
"explanation": "A String", # A text explaining why this volume is recommended.
},
"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).
+ "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.
"offers": [ # Offers available for this volume (sales and rentals).
{
"listPrice": { # Offer list (=undiscounted) price in Micros.
"currencyCode": "A String",
"amountInMicros": 3.14,
},
+ "finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)
+ "giftable": True or False, # Indicates whether the offer is giftable.
+ "retailPrice": { # Offer retail (=discounted) price in Micros
+ "currencyCode": "A String",
+ "amountInMicros": 3.14,
+ },
"rentalDuration": { # The rental duration (for rental offers only).
"unit": "A String",
"count": 3.14,
},
- "retailPrice": { # Offer retail (=discounted) price in Micros
- "currencyCode": "A String",
- "amountInMicros": 3.14,
- },
- "finskyOfferType": 42, # The finsky offer type (e.g., PURCHASE=0 RENTAL=3)
- "giftable": True or False, # Indicates whether the offer is giftable.
},
],
+ "isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).
"listPrice": { # Suggested retail price. (In LITE projection.)
- "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
+ "amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
},
+ "country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)
+ "buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)
"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.)
"amount": 3.14, # Amount in the currency listed below. (In LITE projection.)
"currencyCode": "A String", # An ISO 4217, three-letter currency code. (In LITE projection.)
},
- "buyLink": "A String", # URL to purchase this volume on the Google Books site. (In LITE projection)
- "country": "A String", # The two-letter ISO_3166-1 country code for which this sale information is valid. (In LITE projection.)
"onSaleDate": "A String", # The date on which this book is available for sale.
- "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.
- "isEbook": True or False, # Whether or not this volume is an eBook (can be added to the My eBooks shelf).
},
"etag": "A String", # Opaque identifier for a specific version of a volume resource. (In LITE projection)
"userInfo": { # User specific information related to this volume. (e.g. page this user last read or whether they purchased this book)
- "readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)
- "updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).
- "gbTextPosition": "A String", # Position in a volume for text-based content.
- "volumeId": "A String", # Volume id associated with this reading position.
- "gbImagePosition": "A String", # Position in a volume for image-based content.
- "pdfPosition": "A String", # Position in a PDF file.
- "epubCfiPosition": "A String", # Position in an EPUB as a CFI.
- "kind": "A String", # Resource type for a reading position.
- },
- "isFamilySharingAllowed": True or False, # Deprecated: Replaced by familySharing.
- "isFamilySharedToUser": True or False, # Whether or not the user received this volume through family sharing.
- "isUploaded": True or False, # Whether or not this volume was user uploaded.
+ "rentalState": "A String", # Whether this book is an active or an expired rental.
"isPreordered": True or False, # Whether or not this volume was pre-ordered by the authenticated user making the request. (In LITE projection.)
- "isFamilySharedFromUser": True or False, # Whether or not the user shared this volume with the family.
- "entitlementType": 42, # Whether this volume is purchased, sample, pd download etc.
- "acquisitionType": 42, # How this volume was acquired.
+ "isUploaded": True or False, # Whether or not this volume was user uploaded.
+ "copy": { # Copy/Paste accounting information.
+ "remainingCharacterCount": 42,
+ "updated": "A String",
+ "limitType": "A String",
+ "allowedCharacterCount": 42,
+ },
+ "isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)
"review": { # This user's review of this volume, if one exists.
"volumeId": "A String", # Volume that this review is for.
+ "fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.
"date": "A String", # Date of this review.
"title": "A String", # Title for this review.
"type": "A String", # Source type for this review. Possible values are EDITORIAL, WEB_USER or GOOGLE_USER.
- "fullTextUrl": "A String", # URL for the full review text, for reviews gathered from the web.
+ "source": { # Information regarding the source of this review, when the review is not from a Google Books user.
+ "description": "A String", # Name of the source.
+ "extraDescription": "A String", # Extra text about the source of the review.
+ "url": "A String", # URL of the source of the review.
+ },
+ "kind": "A String", # Resource type for a review.
+ "content": "A String", # Review text.
+ "rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.
"author": { # Author of this review.
"displayName": "A String", # Name of this person.
},
- "source": { # Information regarding the source of this review, when the review is not from a Google Books user.
- "url": "A String", # URL of the source of the review.
- "extraDescription": "A String", # Extra text about the source of the review.
- "description": "A String", # Name of the source.
- },
- "kind": "A String", # Resource type for a review.
- "rating": "A String", # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE or NOT_RATED.
- "content": "A String", # Review text.
},
- "copy": { # Copy/Paste accounting information.
- "updated": "A String",
- "allowedCharacterCount": 42,
- "limitType": "A String",
- "remainingCharacterCount": 42,
+ "isFamilySharingDisabledByFop": True or False, # Deprecated: Replaced by familySharing.
+ "familySharing": { # Information on the ability to share with the family.
+ "familyRole": "A String", # The role of the user in the family.
+ "isSharingDisabledByFop": True or False, # Whether or not sharing this volume is temporarily disabled due to issues with the Family Wallet.
+ "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.
},
+ "userUploadedVolumeInfo": {
+ "processingState": "A String",
+ },
+ "isFamilySharingAllowed": True or False, # Deprecated: Replaced by familySharing.
"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).
+ "isFamilySharedToUser": True or False, # Whether or not the user received this volume through family sharing.
+ "isFamilySharedFromUser": True or False, # Whether or not the user shared this volume with the family.
+ "entitlementType": 42, # Whether this volume is purchased, sample, pd download etc.
"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.
"rentalPeriod": { # Period during this book is/was a valid rental.
"startUtcSec": "A String",
"endUtcSec": "A String",
},
- "userUploadedVolumeInfo": {
- "processingState": "A String",
- },
- "rentalState": "A String", # Whether this book is an active or an expired rental.
+ "acquisitionType": 42, # How this volume was acquired.
"isInMyBooks": True or False, # Whether or not this volume is currently in "my books."
- "isFamilySharingDisabledByFop": True or False, # Deprecated: Replaced by familySharing.
- "familySharing": { # Information on the ability to share with the family.
- "familyRole": "A String", # The role of the user in the family.
- "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.
- "isSharingDisabledByFop": True or False, # Whether or not sharing this volume is temporarily disabled due to issues with the Family Wallet.
+ "readingPosition": { # The user's current reading position in the volume, if one is available. (In LITE projection.)
+ "kind": "A String", # Resource type for a reading position.
+ "pdfPosition": "A String", # Position in a PDF file.
+ "gbTextPosition": "A String", # Position in a volume for text-based content.
+ "volumeId": "A String", # Volume id associated with this reading position.
+ "updated": "A String", # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).
+ "gbImagePosition": "A String", # Position in a volume for image-based content.
+ "epubCfiPosition": "A String", # Position in an EPUB as a CFI.
},
- "isPurchased": True or False, # Whether or not this volume was purchased by the authenticated user making the request. (In LITE projection.)
},
+ "selfLink": "A String", # URL to this resource. (In LITE projection.)
"id": "A String", # Unique identifier for a volume. (In LITE projection.)
"volumeInfo": { # General volume information.
- "maturityRating": "A String",
"samplePageCount": 42, # Total number of sample pages as per publisher metadata.
- "previewLink": "A String", # URL to preview this volume on the Google Books site.
+ "publisher": "A String", # Publisher of this volume. (In LITE projection.)
+ "printedPageCount": 42, # Total number of printed pages in generated pdf representation.
+ "pageCount": 42, # Total number of pages as per publisher metadata.
+ "panelizationSummary": { # A top-level summary of the panelization info in this volume.
+ "containsEpubBubbles": True or False,
+ "epubBubbleVersion": "A String",
+ "imageBubbleVersion": "A String",
+ "containsImageBubbles": True or False,
+ },
+ "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.)
+ "authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)
+ "A String",
+ ],
+ "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.
"dimensions": { # Physical dimensions of this volume.
- "height": "A String", # Height or length of this volume (in cm).
"width": "A String", # Width of this volume (in cm).
"thickness": "A String", # Thickness of this volume (in cm).
+ "height": "A String", # Height or length of this volume (in cm).
},
"industryIdentifiers": [ # Industry standard identifiers for this volume.
{
@@ -265,25 +306,27 @@
"type": "A String", # Identifier type. Possible values are ISBN_10, ISBN_13, ISSN and OTHER.
},
],
- "title": "A String", # Volume title. (In LITE projection.)
- "comicsContent": True or False, # Whether the volume has comics content.
- "canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)
- "contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)
- "authors": [ # The names of the authors and/or editors for this volume. (In LITE projection)
+ "infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)
+ "categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.
"A String",
],
- "publishedDate": "A String", # Date of publication. (In LITE projection.)
- "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.
+ "allowAnonLogging": True or False, # Whether anonymous logging should be allowed.
+ "imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)
+ "large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)
+ "medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)
+ "smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)
+ "thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)
+ "extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)
+ "small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)
+ },
"seriesInfo": {
- "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.
"kind": "A String", # Resource type.
- "shortSeriesBookTitle": "A String", # Short book title in the context of the series.
"volumeSeries": [
{
"issue": [ # List of issues. Applicable only for Collection Edition and Omnibus.
{
- "issueDisplayNumber": "A String",
"issueOrderNumber": 42,
+ "issueDisplayNumber": "A String",
},
],
"seriesBookType": "A String", # The book type in the context of series. Examples - Single Issue, Collection Edition, etc.
@@ -291,84 +334,41 @@
"orderNumber": 42, # The book order number in the series.
},
],
+ "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.
+ "shortSeriesBookTitle": "A String", # Short book title in the context of the series.
},
- "ratingsCount": 42, # The number of review ratings for this volume.
- "subtitle": "A String", # Volume subtitle. (In LITE projection.)
- "pageCount": 42, # Total number of pages as per publisher metadata.
- "imageLinks": { # A list of image links for all the sizes that are available. (In LITE projection.)
- "medium": "A String", # Image link for medium size (width of ~575 pixels). (In LITE projection)
- "extraLarge": "A String", # Image link for extra large size (width of ~1280 pixels). (In LITE projection)
- "small": "A String", # Image link for small size (width of ~300 pixels). (In LITE projection)
- "large": "A String", # Image link for large size (width of ~800 pixels). (In LITE projection)
- "thumbnail": "A String", # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)
- "smallThumbnail": "A String", # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)
- },
- "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.)
+ "title": "A String", # Volume title. (In LITE projection.)
"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.
- "categories": [ # A list of subject categories, such as "Fiction", "Suspense", etc.
- "A String",
- ],
- "publisher": "A String", # Publisher of this volume. (In LITE projection.)
- "panelizationSummary": { # A top-level summary of the panelization info in this volume.
- "epubBubbleVersion": "A String",
- "imageBubbleVersion": "A String",
- "containsEpubBubbles": True or False,
- "containsImageBubbles": True or False,
- },
- "allowAnonLogging": True or False, # Whether anonymous logging should be allowed.
- "printedPageCount": 42, # Total number of printed pages in generated pdf representation.
- "infoLink": "A String", # URL to view information about this volume on the Google Books site. (In LITE projection)
+ "subtitle": "A String", # Volume subtitle. (In LITE projection.)
"printType": "A String", # Type of publication of this volume. Possible values are BOOK or MAGAZINE.
+ "maturityRating": "A String",
+ "canonicalVolumeLink": "A String", # Canonical URL for a volume. (In LITE projection.)
+ "comicsContent": True or False, # Whether the volume has comics content.
"readingModes": { # The reading modes available for this volume.
- "image": True or False,
"text": True or False,
+ "image": True or False,
},
+ "contentVersion": "A String", # An identifier for the version of the volume content (text & images). (In LITE projection)
"averageRating": 3.14, # The mean review rating for this volume. (min = 1.0, max = 5.0)
+ "publishedDate": "A String", # Date of publication. (In LITE projection.)
+ "ratingsCount": 42, # The number of review ratings for this volume.
+ "previewLink": "A String", # URL to preview this volume on the Google Books site.
},
- "selfLink": "A String", # URL to this resource. (In LITE projection.)
"searchInfo": { # Search result information related to this volume.
"textSnippet": "A String", # A text snippet containing the search query.
},
"kind": "A String", # Resource type for a volume. (In LITE projection.)
- "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.).
- "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.
- "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.)
- "embeddable": True or False, # Whether this volume can be embedded in a viewport using the Embedded Viewer API.
- "quoteSharingAllowed": True or False, # Whether quote sharing is allowed for this volume.
- "downloadAccess": { # Information about a volume's download license access restrictions.
- "nonce": "A String", # Client nonce for verification. Download access and client-validation only.
- "maxDownloadDevices": 42, # If restricted, the maximum number of content download licenses for this volume.
- "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
- "source": "A String", # Client app identifier for verification. Download access and client-validation only.
- "message": "A String", # Error/warning message.
- "restricted": True or False, # Whether this volume has any download access restrictions.
- "signature": "A String", # Response signature.
- "downloadsAcquired": 42, # If restricted, the number of content download licenses already acquired (including the requesting client, if licensed).
- "kind": "A String", # Resource type.
- "deviceAllowed": True or False, # If restricted, whether access is granted for this (user, device, volume).
- "justAcquired": True or False, # If deviceAllowed, whether access was just acquired with this request.
- "volumeId": "A String", # Identifies the volume for which this entry applies.
- },
- "epub": { # Information about epub content. (In LITE projection.)
- "downloadLink": "A String", # URL to download epub. (In LITE projection.)
- "acsTokenLink": "A String", # URL to retrieve ACS token for epub download. (In LITE projection.)
- "isAvailable": True or False, # Is a flowing text epub available either as public domain or for purchase. (In LITE projection.)
- },
- "textToSpeechPermission": "A String", # Whether text-to-speech is permitted for this volume. Values can be ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
- "country": "A String", # The two-letter ISO_3166-1 country code for which this access information is valid. (In LITE projection.)
- "publicDomain": True or False, # Whether or not this book is public domain in the country listed above.
- "pdf": { # Information about pdf content. (In LITE projection.)
- "acsTokenLink": "A String", # URL to retrieve ACS token for pdf download. (In LITE projection.)
- "downloadLink": "A String", # URL to download pdf. (In LITE projection.)
- "isAvailable": True or False, # Is a scanned image pdf available either as public domain or for purchase. (In LITE projection.)
- },
- "driveImportedContentLink": "A String", # URL to the Google Drive viewer if this volume is uploaded by the user by selecting the file from Google Drive.
- "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.
- "webReaderLink": "A String", # URL to read this volume on the Google Books site. Link will not allow users to read non-viewable volumes.
- "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.
+ "layerInfo": { # What layers exist in this volume and high level information about them.
+ "layers": [ # A layer should appear here if and only if the layer exists for this book.
+ {
+ "layerId": "A String", # The layer id of this layer (e.g. "geo").
+ "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.
+ },
+ ],
},
},
],
+ "kind": "A String", # Resource type.
"nextPageToken": "A String",
}</pre>
</div>