google-api-client 0.42.1 → 0.42.2

data/generated/google/apis/bigtableadmin_v2/service.rb

@@ -879,6 +879,121 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts creating a new Cloud Bigtable Backup.  The returned backup
+        # long-running operation can be used to
+        # track creation of the backup. The
+        # metadata field type is
+        # CreateBackupMetadata. The
+        # response field type is
+        # Backup, if successful. Cancelling the returned operation will stop the
+        # creation and delete the backup.
+        # @param [String] parent
+        #   Required. This must be one of the clusters in the instance in which this
+        #   table is located. The backup will be stored in this cluster. Values are
+        #   of the form `projects/`project`/instances/`instance`/clusters/`cluster``.
+        # @param [Google::Apis::BigtableadminV2::Backup] backup_object
+        # @param [String] backup_id
+        #   Required. The id of the backup to be created. The `backup_id` along with
+        #   the parent `parent` are combined as `parent`/backups/`backup_id` to create
+        #   the full backup name, of the form:
+        #   `projects/`project`/instances/`instance`/clusters/`cluster`/backups/`backup_id`
+        #   `.
+        #   This string must be between 1 and 50 characters in length and match the
+        #   regex _a-zA-Z0-9*.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_project_instance_cluster_backup(parent, backup_object = nil, backup_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/backups', options)
+          command.request_representation = Google::Apis::BigtableadminV2::Backup::Representation
+          command.request_object = backup_object
+          command.response_representation = Google::Apis::BigtableadminV2::Operation::Representation
+          command.response_class = Google::Apis::BigtableadminV2::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['backupId'] = backup_id unless backup_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a pending or completed Cloud Bigtable backup.
+        # @param [String] name
+        #   Required. Name of the backup to delete.
+        #   Values are of the form
+        #   `projects/`project`/instances/`instance`/clusters/`cluster`/backups/`backup``.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project_instance_cluster_backup(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::BigtableadminV2::Empty::Representation
+          command.response_class = Google::Apis::BigtableadminV2::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets metadata on a pending or completed Cloud Bigtable Backup.
+        # @param [String] name
+        #   Required. Name of the backup.
+        #   Values are of the form
+        #   `projects/`project`/instances/`instance`/clusters/`cluster`/backups/`backup``.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::Backup] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::Backup]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_instance_cluster_backup(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::BigtableadminV2::Backup::Representation
+          command.response_class = Google::Apis::BigtableadminV2::Backup
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the access control policy for a Table resource.
         # Returns an empty policy if the resource exists but does not have a policy
         # set.
@@ -915,6 +1030,147 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists Cloud Bigtable backups. Returns both completed and pending
+        # backups.
+        # @param [String] parent
+        #   Required. The cluster to list backups from.  Values are of the
+        #   form `projects/`project`/instances/`instance`/clusters/`cluster``.
+        #   Use ``cluster` = '-'` to list backups for all clusters in an instance,
+        #   e.g., `projects/`project`/instances/`instance`/clusters/-`.
+        # @param [String] filter
+        #   A filter expression that filters backups listed in the response.
+        #   The expression must specify the field name, a comparison operator,
+        #   and the value that you want to use for filtering. The value must be a
+        #   string, a number, or a boolean. The comparison operator must be
+        #   <, >, <=, >=, !=, =, or :. Colon ‘:’ represents a HAS operator which is
+        #   roughly synonymous with equality. Filter rules are case insensitive.
+        #   The fields eligible for filtering are:
+        #   * `name`
+        #   * `source_table`
+        #   * `state`
+        #   * `start_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+        #   * `end_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+        #   * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+        #   * `size_bytes`
+        #   To filter on multiple expressions, provide each separate expression within
+        #   parentheses. By default, each expression is an AND expression. However,
+        #   you can include AND, OR, and NOT expressions explicitly.
+        #   Some examples of using filters are:
+        #   * `name:"exact"` --> The backup's name is the string "exact".
+        #   * `name:howl` --> The backup's name contains the string "howl".
+        #   * `source_table:prod`
+        #   --> The source_table's name contains the string "prod".
+        #   * `state:CREATING` --> The backup is pending creation.
+        #   * `state:READY` --> The backup is fully created and ready for use.
+        #   * `(name:howl) AND (start_time < \"2018-03-28T14:50:00Z\")`
+        #   --> The backup name contains the string "howl" and start_time
+        #   of the backup is before 2018-03-28T14:50:00Z.
+        #   * `size_bytes > 10000000000` --> The backup's size is greater than 10GB
+        # @param [String] order_by
+        #   An expression for specifying the sort order of the results of the request.
+        #   The string value should specify one or more fields in Backup. The full
+        #   syntax is described at https://aip.dev/132#ordering.
+        #   Fields supported are:
+        #   * name
+        #   * source_table
+        #   * expire_time
+        #   * start_time
+        #   * end_time
+        #   * size_bytes
+        #   * state
+        #   For example, "start_time". The default sorting order is ascending.
+        #   To specify descending order for the field, a suffix " desc" should
+        #   be appended to the field name. For example, "start_time desc".
+        #   Redundant space characters in the syntax are insigificant.
+        #   If order_by is empty, results will be sorted by `start_time` in descending
+        #   order starting from the most recently created backup.
+        # @param [Fixnum] page_size
+        #   Number of backups to be returned in the response. If 0 or
+        #   less, defaults to the server's maximum allowed page size.
+        # @param [String] page_token
+        #   If non-empty, `page_token` should contain a
+        #   next_page_token from a
+        #   previous ListBackupsResponse to the same `parent` and with the same
+        #   `filter`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::ListBackupsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::ListBackupsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_instance_cluster_backups(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/backups', options)
+          command.response_representation = Google::Apis::BigtableadminV2::ListBackupsResponse::Representation
+          command.response_class = Google::Apis::BigtableadminV2::ListBackupsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a pending or completed Cloud Bigtable Backup.
+        # @param [String] name
+        #   A globally unique identifier for the backup which cannot be
+        #   changed. Values are of the form
+        #   `projects/`project`/instances/`instance`/clusters/`cluster`/
+        #   backups/_a-zA-Z0-9*`
+        #   The final segment of the name must be between 1 and 50 characters
+        #   in length.
+        #   The backup is stored in the cluster identified by the prefix of the backup
+        #   name of the form
+        #   `projects/`project`/instances/`instance`/clusters/`cluster``.
+        # @param [Google::Apis::BigtableadminV2::Backup] backup_object
+        # @param [String] update_mask
+        #   Required. A mask specifying which fields (e.g. `expire_time`) in the
+        #   Backup resource should be updated. This mask is relative to the Backup
+        #   resource, not to the request message. The field mask must always be
+        #   specified; this prevents any future fields from being erased accidentally
+        #   by clients that do not know about them.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::Backup] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::Backup]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_project_instance_cluster_backup(name, backup_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2/{+name}', options)
+          command.request_representation = Google::Apis::BigtableadminV2::Backup::Representation
+          command.request_object = backup_object
+          command.response_representation = Google::Apis::BigtableadminV2::Backup::Representation
+          command.response_class = Google::Apis::BigtableadminV2::Backup
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the access control policy on a Table resource.
         # Replaces any existing policy.
         # @param [String] resource
@@ -1322,6 +1578,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Create a new table by restoring from a completed backup. The new table
+        # must be in the same instance as the instance containing the backup.  The
+        # returned table long-running operation can
+        # be used to track the progress of the operation, and to cancel it.  The
+        # metadata field type is
+        # RestoreTableMetadata.  The
+        # response type is
+        # Table, if successful.
+        # @param [String] parent
+        #   Required. The name of the instance in which to create the restored
+        #   table. This instance must be the parent of the source backup. Values are
+        #   of the form `projects/<project>/instances/<instance>`.
+        # @param [Google::Apis::BigtableadminV2::RestoreTableRequest] restore_table_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigtableadminV2::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigtableadminV2::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def restore_table(parent, restore_table_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/tables:restore', options)
+          command.request_representation = Google::Apis::BigtableadminV2::RestoreTableRequest::Representation
+          command.request_object = restore_table_request_object
+          command.response_representation = Google::Apis::BigtableadminV2::Operation::Representation
+          command.response_class = Google::Apis::BigtableadminV2::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the access control policy on a Table resource.
         # Replaces any existing policy.
         # @param [String] resource

data/generated/google/apis/books_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://code.google.com/apis/books/docs/v1/getting_started.html
     module BooksV1
       VERSION = 'V1'
-      REVISION = '20200617'
+      REVISION = '20200717'
 
       # Manage your books
       AUTH_BOOKS = 'https://www.googleapis.com/auth/books'

data/generated/google/apis/books_v1/classes.rb

@@ -26,14 +26,14 @@ module Google
       class Annotation
         include Google::Apis::Core::Hashable
       
-        # Anchor text after excerpt. For requests, if the user bookmarked a screen
-        # that has no flowing text on it, then this field should be empty.
+        # Anchor text after excerpt. For requests, if the user bookmarked a screen that
+        # has no flowing text on it, then this field should be empty.
         # Corresponds to the JSON property `afterSelectedText`
         # @return [String]
         attr_accessor :after_selected_text
       
-        # Anchor text before excerpt. For requests, if the user bookmarked a screen
-        # that has no flowing text on it, then this field should be empty.
+        # Anchor text before excerpt. For requests, if the user bookmarked a screen that
+        # has no flowing text on it, then this field should be empty.
         # Corresponds to the JSON property `beforeSelectedText`
         # @return [String]
         attr_accessor :before_selected_text
@@ -229,8 +229,7 @@ module Google
         class LayerSummary
           include Google::Apis::Core::Hashable
         
-          # Maximum allowed characters on this layer, especially for the "copy"
-          # layer.
+          # Maximum allowed characters on this layer, especially for the "copy" layer.
           # Corresponds to the JSON property `allowedCharacterCount`
           # @return [Fixnum]
           attr_accessor :allowed_character_count
@@ -241,8 +240,7 @@ module Google
           # @return [String]
           attr_accessor :limit_type
         
-          # Remaining allowed characters on this layer, especially for the "copy"
-          # layer.
+          # Remaining allowed characters on this layer, especially for the "copy" layer.
           # Corresponds to the JSON property `remainingCharacterCount`
           # @return [Fixnum]
           attr_accessor :remaining_character_count
@@ -274,8 +272,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Token to pass in for pagination for the next page. This will not be present
-        # if this request does not have more results.
+        # Token to pass in for pagination for the next page. This will not be present if
+        # this request does not have more results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -381,8 +379,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Token to pass in for pagination for the next page. This will not be present
-        # if this request does not have more results.
+        # Token to pass in for pagination for the next page. This will not be present if
+        # this request does not have more results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -538,8 +536,8 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # Last modified time of this bookshelf (formatted UTC timestamp with
-        # millisecond resolution).
+        # Last modified time of this bookshelf (formatted UTC timestamp with millisecond
+        # resolution).
         # Corresponds to the JSON property `updated`
         # @return [String]
         attr_accessor :updated
@@ -701,8 +699,8 @@ module Google
         # @return [String]
         attr_accessor :signature
       
-        # Client app identifier for verification. Download access and
-        # client-validation only.
+        # Client app identifier for verification. Download access and client-validation
+        # only.
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
@@ -746,9 +744,8 @@ module Google
         # @return [String]
         attr_accessor :annotation_type
       
-        # JSON encoded data for this dictionary annotation data.
-        # Emitted with name 'data' in JSON output. Either this or geo_data will
-        # be populated.
+        # JSON encoded data for this dictionary annotation data. Emitted with name 'data'
+        # in JSON output. Either this or geo_data will be populated.
         # Corresponds to the JSON property `data`
         # @return [Google::Apis::BooksV1::DictLayerData]
         attr_accessor :data
@@ -842,8 +839,8 @@ module Google
         class Common
           include Google::Apis::Core::Hashable
         
-          # The display title and localized canonical name to use when searching for
-          # this entity on Google search.
+          # The display title and localized canonical name to use when searching for this
+          # entity on Google search.
           # Corresponds to the JSON property `title`
           # @return [String]
           attr_accessor :title
@@ -926,8 +923,8 @@ module Google
             # @return [Array<Google::Apis::BooksV1::DictLayerData::Dict::Word::Sense>]
             attr_accessor :senses
           
-            # The words with different meanings but not related words, e.g. "go"
-            # (game) and "go" (verb).
+            # The words with different meanings but not related words, e.g. "go" (game) and "
+            # go" (verb).
             # Corresponds to the JSON property `source`
             # @return [Google::Apis::BooksV1::DictLayerData::Dict::Word::Source]
             attr_accessor :source
@@ -1280,8 +1277,8 @@ module Google
               end
             end
             
-            # The words with different meanings but not related words, e.g. "go"
-            # (game) and "go" (verb).
+            # The words with different meanings but not related words, e.g. "go" (game) and "
+            # go" (verb).
             class Source
               include Google::Apis::Core::Hashable
             
@@ -1448,8 +1445,8 @@ module Google
         attr_accessor :device_allowed
         alias_method :device_allowed?, :device_allowed
       
-        # If restricted, the number of content download licenses already acquired
-        # (including the requesting client, if licensed).
+        # If restricted, the number of content download licenses already acquired (
+        # including the requesting client, if licensed).
         # Corresponds to the JSON property `downloadsAcquired`
         # @return [Fixnum]
         attr_accessor :downloads_acquired
@@ -1465,8 +1462,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # If restricted, the maximum number of content download licenses for this
-        # volume.
+        # If restricted, the maximum number of content download licenses for this volume.
         # Corresponds to the JSON property `maxDownloadDevices`
         # @return [Fixnum]
         attr_accessor :max_download_devices
@@ -1481,8 +1477,8 @@ module Google
         # @return [String]
         attr_accessor :nonce
       
-        # Error/warning reason code.  Additional codes may be added in the future. 0
-        # OK 100   ACCESS_DENIED_PUBLISHER_LIMIT 101   ACCESS_DENIED_LIMIT 200
+        # 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
         # Corresponds to the JSON property `reasonCode`
         # @return [String]
@@ -1499,8 +1495,8 @@ module Google
         # @return [String]
         attr_accessor :signature
       
-        # Client app identifier for verification. Download access and
-        # client-validation only.
+        # Client app identifier for verification. Download access and client-validation
+        # only.
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
@@ -1556,13 +1552,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -1653,9 +1647,8 @@ module Google
         # @return [String]
         attr_accessor :annotation_type
       
-        # JSON encoded data for this geo annotation data.
-        # Emitted with name 'data' in JSON output. Either this or dict_data will
-        # be populated.
+        # JSON encoded data for this geo annotation data. Emitted with name 'data' in
+        # JSON output. Either this or dict_data will be populated.
         # Corresponds to the JSON property `data`
         # @return [Google::Apis::BooksV1::GeoLayerData]
         attr_accessor :data
@@ -1769,8 +1762,8 @@ module Google
           # @return [String]
           attr_accessor :snippet_url
         
-          # The display title and localized canonical name to use when searching for
-          # this entity on Google search.
+          # The display title and localized canonical name to use when searching for this
+          # entity on Google search.
           # Corresponds to the JSON property `title`
           # @return [String]
           attr_accessor :title
@@ -1793,14 +1786,13 @@ module Google
         class Geo
           include Google::Apis::Core::Hashable
         
-          # The boundary of the location as a set of loops containing pairs of
-          # latitude, longitude coordinates.
+          # The boundary of the location as a set of loops containing pairs of latitude,
+          # longitude coordinates.
           # Corresponds to the JSON property `boundary`
           # @return [Array<String>]
           attr_accessor :boundary
         
-          # The cache policy active for this data. EX: UNRESTRICTED, RESTRICTED,
-          # NEVER
+          # The cache policy active for this data. EX: UNRESTRICTED, RESTRICTED, NEVER
           # Corresponds to the JSON property `cachePolicy`
           # @return [String]
           attr_accessor :cache_policy
@@ -1820,8 +1812,8 @@ module Google
           # @return [Float]
           attr_accessor :longitude
         
-          # The type of map that should be used for this location. EX: HYBRID,
-          # ROADMAP, SATELLITE, TERRAIN
+          # The type of map that should be used for this location. EX: HYBRID, ROADMAP,
+          # SATELLITE, TERRAIN
           # Corresponds to the JSON property `mapType`
           # @return [String]
           attr_accessor :map_type
@@ -1834,8 +1826,8 @@ module Google
         
           # The Zoom level to use for the map. Zoom levels between 0 (the lowest zoom
           # level, in which the entire world can be seen on one map) to 21+ (down to
-          # individual buildings). See: https:
-          # //developers.google.com/maps/documentation/staticmaps/#Zoomlevels
+          # individual buildings). See: https: //developers.google.com/maps/documentation/
+          # staticmaps/#Zoomlevels
           # Corresponds to the JSON property `zoom`
           # @return [Fixnum]
           attr_accessor :zoom
@@ -2019,15 +2011,15 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Timestamp for the last time an item in this layer was updated. (RFC 3339
-        # UTC date-time format).
+        # Timestamp for the last time an item in this layer was updated. (RFC 3339 UTC
+        # date-time format).
         # Corresponds to the JSON property `updated`
         # @return [String]
         attr_accessor :updated
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `volumeAnnotationsVersion`
         # @return [String]
         attr_accessor :volume_annotations_version
@@ -2379,8 +2371,8 @@ module Google
         # @return [String]
         attr_accessor :pdf_position
       
-        # Timestamp when this reading position was last updated (formatted UTC
-        # timestamp with millisecond resolution).
+        # Timestamp when this reading position was last updated (formatted UTC timestamp
+        # with millisecond resolution).
         # Corresponds to the JSON property `updated`
         # @return [String]
         attr_accessor :updated
@@ -2466,14 +2458,14 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR,
-        # FIVE or NOT_RATED.
+        # Star rating for this review. Possible values are ONE, TWO, THREE, FOUR, FIVE
+        # or NOT_RATED.
         # Corresponds to the JSON property `rating`
         # @return [String]
         attr_accessor :rating
       
-        # Information regarding the source of this review, when the review is not
-        # from a Google Books user.
+        # Information regarding the source of this review, when the review is not from a
+        # Google Books user.
         # Corresponds to the JSON property `source`
         # @return [Google::Apis::BooksV1::Review::Source]
         attr_accessor :source
@@ -2531,8 +2523,8 @@ module Google
           end
         end
         
-        # Information regarding the source of this review, when the review is not
-        # from a Google Books user.
+        # Information regarding the source of this review, when the review is not from a
+        # Google Books user.
         class Source
           include Google::Apis::Core::Hashable
         
@@ -3039,9 +3031,8 @@ module Google
         attr_accessor :recommended_info
       
         # 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).
+        # purchaseability. This information can depend on the country where the request
+        # originates from (i.e. books may not be for sale in certain countries).
         # Corresponds to the JSON property `saleInfo`
         # @return [Google::Apis::BooksV1::Volume::SaleInfo]
         attr_accessor :sale_info
@@ -3092,15 +3083,15 @@ module Google
         class AccessInfo
           include Google::Apis::Core::Hashable
         
-          # 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.)
+          # 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.)
           # Corresponds to the JSON property `accessViewStatus`
           # @return [String]
           attr_accessor :access_view_status
         
-          # The two-letter ISO_3166-1 country code for which this access information
-          # is valid. (In LITE projection.)
+          # The two-letter ISO_3166-1 country code for which this access information is
+          # valid. (In LITE projection.)
           # Corresponds to the JSON property `country`
           # @return [String]
           attr_accessor :country
@@ -3116,8 +3107,8 @@ module Google
           # @return [String]
           attr_accessor :drive_imported_content_link
         
-          # Whether this volume can be embedded in a viewport using the Embedded
-          # Viewer API.
+          # Whether this volume can be embedded in a viewport using the Embedded Viewer
+          # API.
           # Corresponds to the JSON property `embeddable`
           # @return [Boolean]
           attr_accessor :embeddable
@@ -3153,30 +3144,29 @@ module Google
           attr_accessor :quote_sharing_allowed
           alias_method :quote_sharing_allowed?, :quote_sharing_allowed
         
-          # Whether text-to-speech is permitted for this volume. Values can be
-          # ALLOWED, ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
+          # Whether text-to-speech is permitted for this volume. Values can be ALLOWED,
+          # ALLOWED_FOR_ACCESSIBILITY, or NOT_ALLOWED.
           # Corresponds to the JSON property `textToSpeechPermission`
           # @return [String]
           attr_accessor :text_to_speech_permission
         
-          # For ordered but not yet processed orders, we give a URL that can be used
-          # to go to the appropriate Google Wallet page.
+          # For ordered but not yet processed orders, we give a URL that can be used to go
+          # to the appropriate Google Wallet page.
           # Corresponds to the JSON property `viewOrderUrl`
           # @return [String]
           attr_accessor :view_order_url
         
-          # 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.
+          # 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.
           # Corresponds to the JSON property `viewability`
           # @return [String]
           attr_accessor :viewability
         
-          # URL to read this volume on the Google Books site. Link will not allow
-          # users to read non-viewable volumes.
+          # URL to read this volume on the Google Books site. Link will not allow users to
+          # read non-viewable volumes.
           # Corresponds to the JSON property `webReaderLink`
           # @return [String]
           attr_accessor :web_reader_link
@@ -3217,8 +3207,8 @@ module Google
             # @return [String]
             attr_accessor :download_link
           
-            # Is a flowing text epub available either as public domain or for
-            # purchase. (In LITE projection.)
+            # Is a flowing text epub available either as public domain or for purchase. (In
+            # LITE projection.)
             # Corresponds to the JSON property `isAvailable`
             # @return [Boolean]
             attr_accessor :is_available
@@ -3250,8 +3240,8 @@ module Google
             # @return [String]
             attr_accessor :download_link
           
-            # Is a scanned image pdf available either as public domain or for
-            # purchase. (In LITE projection.)
+            # Is a scanned image pdf available either as public domain or for purchase. (In
+            # LITE projection.)
             # Corresponds to the JSON property `isAvailable`
             # @return [Boolean]
             attr_accessor :is_available
@@ -3297,10 +3287,9 @@ module Google
             # @return [String]
             attr_accessor :layer_id
           
-            # 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.
+            # 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.
             # Corresponds to the JSON property `volumeAnnotationsVersion`
             # @return [String]
             attr_accessor :volume_annotations_version
@@ -3337,14 +3326,12 @@ module Google
         end
         
         # 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).
+        # purchaseability. This information can depend on the country where the request
+        # originates from (i.e. books may not be for sale in certain countries).
         class SaleInfo
           include Google::Apis::Core::Hashable
         
-          # URL to purchase this volume on the Google Books site. (In LITE
-          # projection)
+          # URL to purchase this volume on the Google Books site. (In LITE projection)
           # Corresponds to the JSON property `buyLink`
           # @return [String]
           attr_accessor :buy_link
@@ -3355,8 +3342,7 @@ module Google
           # @return [String]
           attr_accessor :country
         
-          # Whether or not this volume is an eBook (can be added to the My eBooks
-          # shelf).
+          # Whether or not this volume is an eBook (can be added to the My eBooks shelf).
           # Corresponds to the JSON property `isEbook`
           # @return [Boolean]
           attr_accessor :is_ebook
@@ -3377,17 +3363,16 @@ module Google
           # @return [String]
           attr_accessor :on_sale_date
         
-          # 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.)
+          # 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.)
           # Corresponds to the JSON property `retailPrice`
           # @return [Google::Apis::BooksV1::Volume::SaleInfo::RetailPrice]
           attr_accessor :retail_price
         
           # 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.
+          # 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.
           # Corresponds to the JSON property `saleability`
           # @return [String]
           attr_accessor :saleability
@@ -3552,9 +3537,9 @@ module Google
             end
           end
           
-          # 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.)
+          # 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.)
           class RetailPrice
             include Google::Apis::Core::Hashable
           
@@ -3604,9 +3589,9 @@ module Google
         class UserInfo
           include Google::Apis::Core::Hashable
         
-          # Timestamp when this volume was acquired by the user. (RFC 3339 UTC
-          # date-time format) Acquiring includes purchase, user upload, receiving
-          # family sharing, etc.
+          # Timestamp when this volume was acquired by the user. (RFC 3339 UTC date-time
+          # format) Acquiring includes purchase, user upload, receiving family sharing,
+          # etc.
           # Corresponds to the JSON property `acquiredTime`
           # @return [String]
           attr_accessor :acquired_time
@@ -3661,15 +3646,15 @@ module Google
           attr_accessor :is_in_my_books
           alias_method :is_in_my_books?, :is_in_my_books
         
-          # Whether or not this volume was pre-ordered by the authenticated user
-          # making the request. (In LITE projection.)
+          # Whether or not this volume was pre-ordered by the authenticated user making
+          # the request. (In LITE projection.)
           # Corresponds to the JSON property `isPreordered`
           # @return [Boolean]
           attr_accessor :is_preordered
           alias_method :is_preordered?, :is_preordered
         
-          # Whether or not this volume was purchased by the authenticated user making
-          # the request. (In LITE projection.)
+          # Whether or not this volume was purchased by the authenticated user making the
+          # request. (In LITE projection.)
           # Corresponds to the JSON property `isPurchased`
           # @return [Boolean]
           attr_accessor :is_purchased
@@ -3681,8 +3666,8 @@ module Google
           attr_accessor :is_uploaded
           alias_method :is_uploaded?, :is_uploaded
         
-          # The user's current reading position in the volume, if one is available.
-          # (In LITE projection.)
+          # The user's current reading position in the volume, if one is available. (In
+          # LITE projection.)
           # Corresponds to the JSON property `readingPosition`
           # @return [Google::Apis::BooksV1::ReadingPosition]
           attr_accessor :reading_position
@@ -3703,8 +3688,8 @@ module Google
           attr_accessor :review
         
           # 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).
+          # reading position update, volume purchase or writing a review. (RFC 3339 UTC
+          # date-time format).
           # Corresponds to the JSON property `updated`
           # @return [String]
           attr_accessor :updated
@@ -3787,16 +3772,16 @@ module Google
             # @return [String]
             attr_accessor :family_role
           
-            # 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.
+            # 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.
             # Corresponds to the JSON property `isSharingAllowed`
             # @return [Boolean]
             attr_accessor :is_sharing_allowed
             alias_method :is_sharing_allowed?, :is_sharing_allowed
           
-            # Whether or not sharing this volume is temporarily disabled due to
-            # issues with the Family Wallet.
+            # Whether or not sharing this volume is temporarily disabled due to issues with
+            # the Family Wallet.
             # Corresponds to the JSON property `isSharingDisabledByFop`
             # @return [Boolean]
             attr_accessor :is_sharing_disabled_by_fop
@@ -3869,8 +3854,7 @@ module Google
           attr_accessor :allow_anon_logging
           alias_method :allow_anon_logging?, :allow_anon_logging
         
-          # The names of the authors and/or editors for this volume. (In LITE
-          # projection)
+          # The names of the authors and/or editors for this volume. (In LITE projection)
           # Corresponds to the JSON property `authors`
           # @return [Array<String>]
           attr_accessor :authors
@@ -3896,15 +3880,15 @@ module Google
           attr_accessor :comics_content
           alias_method :comics_content?, :comics_content
         
-          # An identifier for the version of the volume content (text & images). (In
-          # LITE projection)
+          # An identifier for the version of the volume content (text & images). (In LITE
+          # projection)
           # Corresponds to the JSON property `contentVersion`
           # @return [String]
           attr_accessor :content_version
         
-          # 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.)
+          # 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.)
           # Corresponds to the JSON property `description`
           # @return [String]
           attr_accessor :description
@@ -3925,20 +3909,20 @@ module Google
           # @return [Array<Google::Apis::BooksV1::Volume::VolumeInfo::IndustryIdentifier>]
           attr_accessor :industry_identifiers
         
-          # URL to view information about this volume on the Google Books site. (In
-          # LITE projection)
+          # URL to view information about this volume on the Google Books site. (In LITE
+          # projection)
           # Corresponds to the JSON property `infoLink`
           # @return [String]
           attr_accessor :info_link
         
-          # Best language for this volume (based on content). It is the two-letter
-          # ISO 639-1 code such as 'fr', 'en', etc.
+          # Best language for this volume (based on content). It is the two-letter ISO 639-
+          # 1 code such as 'fr', 'en', etc.
           # Corresponds to the JSON property `language`
           # @return [String]
           attr_accessor :language
         
-          # The main category to which this volume belongs. It will be the category
-          # from the categories list returned below that has the highest weight.
+          # The main category to which this volume belongs. It will be the category from
+          # the categories list returned below that has the highest weight.
           # Corresponds to the JSON property `mainCategory`
           # @return [String]
           attr_accessor :main_category
@@ -4085,8 +4069,7 @@ module Google
           class ImageLinks
             include Google::Apis::Core::Hashable
           
-            # Image link for extra large size (width of ~1280 pixels). (In LITE
-            # projection)
+            # Image link for extra large size (width of ~1280 pixels). (In LITE projection)
             # Corresponds to the JSON property `extraLarge`
             # @return [String]
             attr_accessor :extra_large
@@ -4106,14 +4089,12 @@ module Google
             # @return [String]
             attr_accessor :small
           
-            # Image link for small thumbnail size (width of ~80 pixels). (In LITE
-            # projection)
+            # Image link for small thumbnail size (width of ~80 pixels). (In LITE projection)
             # Corresponds to the JSON property `smallThumbnail`
             # @return [String]
             attr_accessor :small_thumbnail
           
-            # Image link for thumbnail size (width of ~128 pixels). (In LITE
-            # projection)
+            # Image link for thumbnail size (width of ~128 pixels). (In LITE projection)
             # Corresponds to the JSON property `thumbnail`
             # @return [String]
             attr_accessor :thumbnail
@@ -4322,8 +4303,8 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Timestamp for the last time this anntoation was updated. (RFC 3339 UTC
-        # date-time format).
+        # Timestamp for the last time this anntoation was updated. (RFC 3339 UTC date-
+        # time format).
         # Corresponds to the JSON property `updated`
         # @return [String]
         attr_accessor :updated
@@ -4407,8 +4388,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Token to pass in for pagination for the next page. This will not be present
-        # if this request does not have more results.
+        # Token to pass in for pagination for the next page. This will not be present if
+        # this request does not have more results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -4418,10 +4399,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :total_items
       
-        # The version string for all of the volume annotations in this layer (not
-        # just the ones in this response). Note: the version string
-        # doesn't apply to the annotation data, just the information in this response
-        # (e.g. the location of annotations in the book).
+        # The version string for all of the volume annotations in this layer (not just
+        # the ones in this response). Note: the version string doesn't apply to the
+        # annotation data, just the information in this response (e.g. the location of
+        # annotations in the book).
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -4476,8 +4457,8 @@ module Google
       class Volumeseriesinfo
         include Google::Apis::Core::Hashable
       
-        # The display number string. This should be used only for display purposes
-        # and the actual sequence should be inferred from the below orderNumber.
+        # The display number string. This should be used only for display purposes and
+        # the actual sequence should be inferred from the below orderNumber.
         # Corresponds to the JSON property `bookDisplayNumber`
         # @return [String]
         attr_accessor :book_display_number
@@ -4523,8 +4504,8 @@ module Google
           # @return [Fixnum]
           attr_accessor :order_number
         
-          # The book type in the context of series. Examples - Single Issue,
-          # Collection Edition, etc.
+          # The book type in the context of series. Examples - Single Issue, Collection
+          # Edition, etc.
           # Corresponds to the JSON property `seriesBookType`
           # @return [String]
           attr_accessor :series_book_type