google-api-client 0.41.2 → 0.44.0

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

@@ -48,33 +48,27 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a Folder in the resource hierarchy.
-        # Returns an Operation which can be used to track the progress of the
-        # folder creation workflow.
-        # Upon success the Operation.response field will be populated with the
-        # created Folder.
-        # In order to succeed, the addition of this new Folder must not violate
-        # the Folder naming, height or fanout constraints.
-        # + The Folder's display_name must be distinct from all other Folder's that
-        # share its parent.
-        # + The addition of the Folder must not cause the active Folder hierarchy
-        # to exceed a height of 4. Note, the full active + deleted Folder hierarchy
-        # is allowed to reach a height of 8; this provides additional headroom when
-        # moving folders that contain deleted folders.
-        # + The addition of the Folder must not cause the total number of Folders
-        # under its parent to exceed 100.
-        # If the operation fails due to a folder constraint violation, some errors
-        # may be returned by the CreateFolder request, with status code
-        # FAILED_PRECONDITION and an error description. Other folder constraint
-        # violations will be communicated in the Operation, with the specific
-        # PreconditionFailure returned via the details list in the Operation.error
-        # field.
+        # Creates a Folder in the resource hierarchy. Returns an Operation which can be
+        # used to track the progress of the folder creation workflow. Upon success the
+        # Operation.response field will be populated with the created Folder. In order
+        # to succeed, the addition of this new Folder must not violate the Folder naming,
+        # height or fanout constraints. + The Folder's display_name must be distinct
+        # from all other Folder's that share its parent. + The addition of the Folder
+        # must not cause the active Folder hierarchy to exceed a height of 4. Note, the
+        # full active + deleted Folder hierarchy is allowed to reach a height of 8; this
+        # provides additional headroom when moving folders that contain deleted folders.
+        # + The addition of the Folder must not cause the total number of Folders under
+        # its parent to exceed 100. If the operation fails due to a folder constraint
+        # violation, some errors may be returned by the CreateFolder request, with
+        # status code FAILED_PRECONDITION and an error description. Other folder
+        # constraint violations will be communicated in the Operation, with the specific
+        # PreconditionFailure returned via the details list in the Operation.error field.
         # The caller must have `resourcemanager.folders.create` permission on the
         # identified parent.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::Folder] folder_object
         # @param [String] parent
-        #   Required. The resource name of the new Folder's parent.
-        #   Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
+        #   Required. The resource name of the new Folder's parent. Must be of the form `
+        #   folders/`folder_id`` or `organizations/`org_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -104,18 +98,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests deletion of a Folder. The Folder is moved into the
-        # DELETE_REQUESTED state
-        # immediately, and is deleted approximately 30 days later. This method may
-        # only be called on an empty Folder in the
-        # ACTIVE state, where a Folder is empty if
-        # it doesn't contain any Folders or Projects in the
-        # ACTIVE state.
-        # The caller must have `resourcemanager.folders.delete` permission on the
-        # identified folder.
+        # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED
+        # state immediately, and is deleted approximately 30 days later. This method may
+        # only be called on an empty Folder in the ACTIVE state, where a Folder is empty
+        # if it doesn't contain any Folders or Projects in the ACTIVE state. The caller
+        # must have `resourcemanager.folders.delete` permission on the identified folder.
         # @param [String] name
-        #   Required. the resource name of the Folder to be deleted.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. the resource name of the Folder to be deleted. Must be of the form `
+        #   folders/`folder_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -143,14 +133,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a Folder identified by the supplied resource name.
-        # Valid Folder resource names have the format `folders/`folder_id``
-        # (for example, `folders/1234`).
-        # The caller must have `resourcemanager.folders.get` permission on the
+        # Retrieves a Folder identified by the supplied resource name. Valid Folder
+        # resource names have the format `folders/`folder_id`` (for example, `folders/
+        # 1234`). The caller must have `resourcemanager.folders.get` permission on the
         # identified folder.
         # @param [String] name
-        #   Required. The resource name of the Folder to retrieve.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. The resource name of the Folder to retrieve. Must be of the form `
+        #   folders/`folder_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -178,14 +167,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Folder. The returned policy may be
-        # empty if no such policy or resource exists. The `resource` field should
-        # be the Folder's resource name, e.g. "folders/1234".
-        # The caller must have `resourcemanager.folders.getIamPolicy` permission
-        # on the identified folder.
+        # Gets the access control policy for a Folder. The returned policy may be empty
+        # if no such policy or resource exists. The `resource` field should be the
+        # Folder's resource name, e.g. "folders/1234". The caller must have `
+        # resourcemanager.folders.getIamPolicy` permission on the identified folder.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -217,12 +205,10 @@ module Google
         end
         
         # Lists the Folders that are direct descendants of supplied parent resource.
-        # List provides a strongly consistent view of the Folders underneath
-        # the specified parent resource.
-        # List returns Folders sorted based upon the (ascending) lexical ordering
-        # of their display_name.
-        # The caller must have `resourcemanager.folders.list` permission on the
-        # identified parent.
+        # List provides a strongly consistent view of the Folders underneath the
+        # specified parent resource. List returns Folders sorted based upon the (
+        # ascending) lexical ordering of their display_name. The caller must have `
+        # resourcemanager.folders.list` permission on the identified parent.
         # @param [Fixnum] page_size
         #   Optional. The maximum number of Folders to return in the response.
         # @param [String] page_token
@@ -230,14 +216,12 @@ module Google
         #   that indicates where this listing should continue from.
         # @param [String] parent
         #   Required. The resource name of the Organization or Folder whose Folders are
-        #   being listed.
-        #   Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
-        #   Access to this method is controlled by checking the
-        #   `resourcemanager.folders.list` permission on the `parent`.
+        #   being listed. Must be of the form `folders/`folder_id`` or `organizations/`
+        #   org_id``. Access to this method is controlled by checking the `resourcemanager.
+        #   folders.list` permission on the `parent`.
         # @param [Boolean] show_deleted
-        #   Optional. Controls whether Folders in the
-        #   DELETE_REQUESTED
-        #   state should be returned. Defaults to false.
+        #   Optional. Controls whether Folders in the DELETE_REQUESTED state should be
+        #   returned. Defaults to false.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -268,26 +252,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves a Folder under a new resource parent.
-        # Returns an Operation which can be used to track the progress of the
-        # folder move workflow.
-        # Upon success the Operation.response field will be populated with the
-        # moved Folder.
-        # Upon failure, a FolderOperationError categorizing the failure cause will
-        # be returned - if the failure occurs synchronously then the
-        # FolderOperationError will be returned via the Status.details field
-        # and if it occurs asynchronously then the FolderOperation will be returned
-        # via the Operation.error field.
-        # In addition, the Operation.metadata field will be populated with a
-        # FolderOperation message as an aid to stateless clients.
-        # Folder moves will be rejected if they violate either the naming, height
-        # or fanout constraints described in the
-        # CreateFolder documentation.
-        # The caller must have `resourcemanager.folders.move` permission on the
-        # folder's current and proposed new parent.
+        # Moves a Folder under a new resource parent. Returns an Operation which can be
+        # used to track the progress of the folder move workflow. Upon success the
+        # Operation.response field will be populated with the moved Folder. Upon failure,
+        # a FolderOperationError categorizing the failure cause will be returned - if
+        # the failure occurs synchronously then the FolderOperationError will be
+        # returned via the Status.details field and if it occurs asynchronously then the
+        # FolderOperation will be returned via the Operation.error field. In addition,
+        # the Operation.metadata field will be populated with a FolderOperation message
+        # as an aid to stateless clients. Folder moves will be rejected if they violate
+        # either the naming, height or fanout constraints described in the CreateFolder
+        # documentation. The caller must have `resourcemanager.folders.move` permission
+        # on the folder's current and proposed new parent.
         # @param [String] name
-        #   Required. The resource name of the Folder to move.
-        #   Must be of the form folders/`folder_id`
+        #   Required. The resource name of the Folder to move. Must be of the form folders/
+        #   `folder_id`
         # @param [Google::Apis::CloudresourcemanagerV2beta1::MoveFolderRequest] move_folder_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -318,26 +297,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a Folder, changing its display_name.
-        # Changes to the folder display_name will be rejected if they violate either
-        # the display_name formatting rules or naming constraints described in
-        # the CreateFolder documentation.
-        # The Folder's display name must start and end with a letter or digit,
-        # may contain letters, digits, spaces, hyphens and underscores and can be
-        # no longer than 30 characters. This is captured by the regular expression:
-        # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?.
-        # The caller must have `resourcemanager.folders.update` permission on the
-        # identified folder.
-        # If the update fails due to the unique name constraint then a
-        # PreconditionFailure explaining this violation will be returned
-        # in the Status.details field.
+        # Updates a Folder, changing its display_name. Changes to the folder
+        # display_name will be rejected if they violate either the display_name
+        # formatting rules or naming constraints described in the CreateFolder
+        # documentation. The Folder's display name must start and end with a letter or
+        # digit, may contain letters, digits, spaces, hyphens and underscores and can be
+        # no longer than 30 characters. This is captured by the regular expression: [\p`
+        # L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. The caller must have `
+        # resourcemanager.folders.update` permission on the identified folder. If the
+        # update fails due to the unique name constraint then a PreconditionFailure
+        # explaining this violation will be returned in the Status.details field.
         # @param [String] name
-        #   Output only. The resource name of the Folder.
-        #   Its format is `folders/`folder_id``, for example: "folders/1234".
+        #   Output only. The resource name of the Folder. Its format is `folders/`
+        #   folder_id``, for example: "folders/1234".
         # @param [Google::Apis::CloudresourcemanagerV2beta1::Folder] folder_object
         # @param [String] update_mask
-        #   Required. Fields to be updated.
-        #   Only the `display_name` can be updated.
+        #   Required. Fields to be updated. Only the `display_name` can be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -368,11 +343,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search for folders that match specific filter criteria.
-        # Search provides an eventually consistent view of the folders a user has
-        # access to which meet the specified filter criteria.
-        # This will only return folders on which the caller has the
-        # permission `resourcemanager.folders.get`.
+        # Search for folders that match specific filter criteria. Search provides an
+        # eventually consistent view of the folders a user has access to which meet the
+        # specified filter criteria. This will only return folders on which the caller
+        # has the permission `resourcemanager.folders.get`.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::SearchFoldersRequest] search_folders_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -402,14 +376,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a Folder, replacing any existing policy.
-        # The `resource` field should be the Folder's resource name, e.g.
-        # "folders/1234".
-        # The caller must have `resourcemanager.folders.setIamPolicy` permission
-        # on the identified folder.
+        # Sets the access control policy on a Folder, replacing any existing policy. The
+        # `resource` field should be the Folder's resource name, e.g. "folders/1234".
+        # The caller must have `resourcemanager.folders.setIamPolicy` permission on the
+        # identified folder.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -440,13 +413,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified Folder.
-        # The `resource` field should be the Folder's resource name,
-        # e.g. "folders/1234".
-        # There are no permissions required for making this API call.
+        # Returns permissions that a caller has on the specified Folder. The `resource`
+        # field should be the Folder's resource name, e.g. "folders/1234". There are no
+        # permissions required for making this API call.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -477,19 +449,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Cancels the deletion request for a Folder. This method may only be
-        # called on a Folder in the
-        # DELETE_REQUESTED state.
-        # In order to succeed, the Folder's parent must be in the
-        # ACTIVE state.
-        # In addition, reintroducing the folder into the tree must not violate
-        # folder naming, height and fanout constraints described in the
-        # CreateFolder documentation.
-        # The caller must have `resourcemanager.folders.undelete` permission on the
-        # identified folder.
+        # Cancels the deletion request for a Folder. This method may only be called on a
+        # Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent
+        # must be in the ACTIVE state. In addition, reintroducing the folder into the
+        # tree must not violate folder naming, height and fanout constraints described
+        # in the CreateFolder documentation. The caller must have `resourcemanager.
+        # folders.undelete` permission on the identified folder.
         # @param [String] name
-        #   Required. The resource name of the Folder to undelete.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. The resource name of the Folder to undelete. Must be of the form `
+        #   folders/`folder_id``.
         # @param [Google::Apis::CloudresourcemanagerV2beta1::UndeleteFolderRequest] undelete_folder_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -520,9 +488,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields

data/generated/google/apis/cloudscheduler_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/scheduler/
     module CloudschedulerV1
       VERSION = 'V1'
-      REVISION = '20200618'
+      REVISION = '20200814'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,83 +22,65 @@ module Google
   module Apis
     module CloudschedulerV1
       
-      # App Engine target. The job will be pushed to a job handler by means
-      # of an HTTP request via an http_method such
-      # as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
-      # HTTP response code in the range [200 - 299]. Error 503 is
-      # considered an App Engine system error instead of an application
-      # error. Requests returning error 503 will be retried regardless of
-      # retry configuration and not counted against retry counts. Any other
-      # response code, or a failure to receive a response before the
-      # deadline, constitutes a failed attempt.
+      # App Engine target. The job will be pushed to a job handler by means of an HTTP
+      # request via an http_method such as HTTP POST, HTTP GET, etc. The job is
+      # acknowledged by means of an HTTP response code in the range [200 - 299]. Error
+      # 503 is considered an App Engine system error instead of an application error.
+      # Requests returning error 503 will be retried regardless of retry configuration
+      # and not counted against retry counts. Any other response code, or a failure to
+      # receive a response before the deadline, constitutes a failed attempt.
       class AppEngineHttpTarget
         include Google::Apis::Core::Hashable
       
-        # App Engine Routing.
-        # For more information about services, versions, and instances see
-        # [An Overview of App
-        # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-
-        # engine),
-        # [Microservices Architecture on Google App
-        # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-
-        # engine),
-        # [App Engine Standard request
-        # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-
-        # are-routed),
-        # and [App Engine Flex request
-        # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-
-        # are-routed).
+        # App Engine Routing. For more information about services, versions, and
+        # instances see [An Overview of App Engine](https://cloud.google.com/appengine/
+        # docs/python/an-overview-of-app-engine), [Microservices Architecture on Google
+        # App Engine](https://cloud.google.com/appengine/docs/python/microservices-on-
+        # app-engine), [App Engine Standard request routing](https://cloud.google.com/
+        # appengine/docs/standard/python/how-requests-are-routed), and [App Engine Flex
+        # request routing](https://cloud.google.com/appengine/docs/flexible/python/how-
+        # requests-are-routed).
         # Corresponds to the JSON property `appEngineRouting`
         # @return [Google::Apis::CloudschedulerV1::AppEngineRouting]
         attr_accessor :app_engine_routing
       
-        # Body.
-        # HTTP request body. A request body is allowed only if the HTTP method is
-        # POST or PUT. It will result in invalid argument error to set a body on a
-        # job with an incompatible HttpMethod.
+        # Body. HTTP request body. A request body is allowed only if the HTTP method is
+        # POST or PUT. It will result in invalid argument error to set a body on a job
+        # with an incompatible HttpMethod.
         # Corresponds to the JSON property `body`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :body
       
-        # HTTP request headers.
-        # This map contains the header field names and values. Headers can be set
-        # when the job is created.
-        # Cloud Scheduler sets some headers to default values:
-        # * `User-Agent`: By default, this header is
-        # `"AppEngine-Google; (+http://code.google.com/appengine)"`.
-        # This header can be modified, but Cloud Scheduler will append
-        # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
-        # modified `User-Agent`.
-        # * `X-CloudScheduler`: This header will be set to true.
-        # If the job has an body, Cloud Scheduler sets
-        # the following headers:
-        # * `Content-Type`: By default, the `Content-Type` header is set to
-        # `"application/octet-stream"`. The default can be overridden by explictly
-        # setting `Content-Type` to a particular media type when the job is
-        # created.
-        # For example, `Content-Type` can be set to `"application/json"`.
-        # * `Content-Length`: This is computed by Cloud Scheduler. This value is
-        # output only. It cannot be changed.
-        # The headers below are output only. They cannot be set or overridden:
-        # * `X-Google-*`: For Google internal use only.
-        # * `X-AppEngine-*`: For Google internal use only.
-        # In addition, some App Engine headers, which contain
-        # job-specific information, are also be sent to the job handler.
+        # HTTP request headers. This map contains the header field names and values.
+        # Headers can be set when the job is created. Cloud Scheduler sets some headers
+        # to default values: * `User-Agent`: By default, this header is `"AppEngine-
+        # Google; (+http://code.google.com/appengine)"`. This header can be modified,
+        # but Cloud Scheduler will append `"AppEngine-Google; (+http://code.google.com/
+        # appengine)"` to the modified `User-Agent`. * `X-CloudScheduler`: This header
+        # will be set to true. If the job has an body, Cloud Scheduler sets the
+        # following headers: * `Content-Type`: By default, the `Content-Type` header is
+        # set to `"application/octet-stream"`. The default can be overridden by
+        # explictly setting `Content-Type` to a particular media type when the job is
+        # created. For example, `Content-Type` can be set to `"application/json"`. * `
+        # Content-Length`: This is computed by Cloud Scheduler. This value is output
+        # only. It cannot be changed. The headers below are output only. They cannot be
+        # set or overridden: * `X-Google-*`: For Google internal use only. * `X-
+        # AppEngine-*`: For Google internal use only. In addition, some App Engine
+        # headers, which contain job-specific information, are also be sent to the job
+        # handler.
         # Corresponds to the JSON property `headers`
         # @return [Hash<String,String>]
         attr_accessor :headers
       
-        # The HTTP method to use for the request. PATCH and OPTIONS are not
-        # permitted.
+        # The HTTP method to use for the request. PATCH and OPTIONS are not permitted.
         # Corresponds to the JSON property `httpMethod`
         # @return [String]
         attr_accessor :http_method
       
-        # The relative URI.
-        # The relative URL must begin with "/" and must be a valid HTTP relative URL.
-        # It can contain a path, query string arguments, and `#` fragments.
-        # If the relative URL is empty, then the root path "/" will be used.
+        # The relative URI. The relative URL must begin with "/" and must be a valid
+        # HTTP relative URL. It can contain a path, query string arguments, and `#`
+        # fragments. If the relative URL is empty, then the root path "/" will be used.
         # No spaces are allowed, and the maximum length allowed is 2083 characters.
         # Corresponds to the JSON property `relativeUri`
         # @return [String]
@@ -118,96 +100,63 @@ module Google
         end
       end
       
-      # App Engine Routing.
-      # For more information about services, versions, and instances see
-      # [An Overview of App
-      # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-
-      # engine),
-      # [Microservices Architecture on Google App
-      # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-
-      # engine),
-      # [App Engine Standard request
-      # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-
-      # are-routed),
-      # and [App Engine Flex request
-      # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-
-      # are-routed).
+      # App Engine Routing. For more information about services, versions, and
+      # instances see [An Overview of App Engine](https://cloud.google.com/appengine/
+      # docs/python/an-overview-of-app-engine), [Microservices Architecture on Google
+      # App Engine](https://cloud.google.com/appengine/docs/python/microservices-on-
+      # app-engine), [App Engine Standard request routing](https://cloud.google.com/
+      # appengine/docs/standard/python/how-requests-are-routed), and [App Engine Flex
+      # request routing](https://cloud.google.com/appengine/docs/flexible/python/how-
+      # requests-are-routed).
       class AppEngineRouting
         include Google::Apis::Core::Hashable
       
-        # Output only. The host that the job is sent to.
-        # For more information about how App Engine requests are routed, see
-        # [here](https://cloud.google.com/appengine/docs/standard/python/how-requests-
-        # are-routed).
-        # The host is constructed as:
-        # * `host = [application_domain_name]`</br>
-        # `| [service] + '.' + [application_domain_name]`</br>
-        # `| [version] + '.' + [application_domain_name]`</br>
-        # `| [version_dot_service]+ '.' + [application_domain_name]`</br>
-        # `| [instance] + '.' + [application_domain_name]`</br>
-        # `| [instance_dot_service] + '.' + [application_domain_name]`</br>
-        # `| [instance_dot_version] + '.' + [application_domain_name]`</br>
-        # `| [instance_dot_version_dot_service] + '.' + [application_domain_name]`
-        # * `application_domain_name` = The domain name of the app, for
-        # example <app-id>.appspot.com, which is associated with the
-        # job's project ID.
-        # * `service =` service
-        # * `version =` version
-        # * `version_dot_service =`
-        # version `+ '.' +`
-        # service
-        # * `instance =` instance
-        # * `instance_dot_service =`
-        # instance `+ '.' +`
-        # service
-        # * `instance_dot_version =`
-        # instance `+ '.' +`
-        # version
-        # * `instance_dot_version_dot_service =`
-        # instance `+ '.' +`
-        # version `+ '.' +`
-        # service
-        # If service is empty, then the job will be sent
-        # to the service which is the default service when the job is attempted.
-        # If version is empty, then the job will be sent
-        # to the version which is the default version when the job is attempted.
-        # If instance is empty, then the job will be
-        # sent to an instance which is available when the job is attempted.
-        # If service,
-        # version, or
-        # instance is invalid, then the job will be sent
-        # to the default version of the default service when the job is attempted.
+        # Output only. The host that the job is sent to. For more information about how
+        # App Engine requests are routed, see [here](https://cloud.google.com/appengine/
+        # docs/standard/python/how-requests-are-routed). The host is constructed as: * `
+        # host = [application_domain_name]` `| [service] + '.' + [
+        # application_domain_name]` `| [version] + '.' + [application_domain_name]` `| [
+        # version_dot_service]+ '.' + [application_domain_name]` `| [instance] + '.' + [
+        # application_domain_name]` `| [instance_dot_service] + '.' + [
+        # application_domain_name]` `| [instance_dot_version] + '.' + [
+        # application_domain_name]` `| [instance_dot_version_dot_service] + '.' + [
+        # application_domain_name]` * `application_domain_name` = The domain name of the
+        # app, for example .appspot.com, which is associated with the job's project ID. *
+        # `service =` service * `version =` version * `version_dot_service =` version `+
+        # '.' +` service * `instance =` instance * `instance_dot_service =` instance `+
+        # '.' +` service * `instance_dot_version =` instance `+ '.' +` version * `
+        # instance_dot_version_dot_service =` instance `+ '.' +` version `+ '.' +`
+        # service If service is empty, then the job will be sent to the service which is
+        # the default service when the job is attempted. If version is empty, then the
+        # job will be sent to the version which is the default version when the job is
+        # attempted. If instance is empty, then the job will be sent to an instance
+        # which is available when the job is attempted. If service, version, or instance
+        # is invalid, then the job will be sent to the default version of the default
+        # service when the job is attempted.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # App instance.
-        # By default, the job is sent to an instance which is available when
-        # the job is attempted.
-        # Requests can only be sent to a specific instance if
-        # [manual scaling is used in App Engine
-        # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-
-        # engine?hl=en_US#scaling_types_and_instance_classes).
-        # App Engine Flex does not support instances. For more information, see
-        # [App Engine Standard request
-        # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-
-        # are-routed)
-        # and [App Engine Flex request
-        # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-
-        # are-routed).
+        # App instance. By default, the job is sent to an instance which is available
+        # when the job is attempted. Requests can only be sent to a specific instance if
+        # [manual scaling is used in App Engine Standard](https://cloud.google.com/
+        # appengine/docs/python/an-overview-of-app-engine?hl=en_US#
+        # scaling_types_and_instance_classes). App Engine Flex does not support
+        # instances. For more information, see [App Engine Standard request routing](
+        # https://cloud.google.com/appengine/docs/standard/python/how-requests-are-
+        # routed) and [App Engine Flex request routing](https://cloud.google.com/
+        # appengine/docs/flexible/python/how-requests-are-routed).
         # Corresponds to the JSON property `instance`
         # @return [String]
         attr_accessor :instance
       
-        # App service.
-        # By default, the job is sent to the service which is the default
+        # App service. By default, the job is sent to the service which is the default
         # service when the job is attempted.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
       
-        # App version.
-        # By default, the job is sent to the version which is the default
+        # App version. By default, the job is sent to the version which is the default
         # version when the job is attempted.
         # Corresponds to the JSON property `version`
         # @return [String]
@@ -226,13 +175,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
       
@@ -245,37 +192,32 @@ module Google
         end
       end
       
-      # Http target. The job will be pushed to the job handler by means of
-      # an HTTP request via an http_method such as HTTP
-      # POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
-      # response code in the range [200 - 299]. A failure to receive a response
-      # constitutes a failed execution. For a redirected request, the response
-      # returned by the redirected request is considered.
+      # Http target. The job will be pushed to the job handler by means of an HTTP
+      # request via an http_method such as HTTP POST, HTTP GET, etc. The job is
+      # acknowledged by means of an HTTP response code in the range [200 - 299]. A
+      # failure to receive a response constitutes a failed execution. For a redirected
+      # request, the response returned by the redirected request is considered.
       class HttpTarget
         include Google::Apis::Core::Hashable
       
-        # HTTP request body. A request body is allowed only if the HTTP
-        # method is POST, PUT, or PATCH. It is an error to set body on a job with an
-        # incompatible HttpMethod.
+        # HTTP request body. A request body is allowed only if the HTTP method is POST,
+        # PUT, or PATCH. It is an error to set body on a job with an incompatible
+        # HttpMethod.
         # Corresponds to the JSON property `body`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :body
       
-        # The user can specify HTTP request headers to send with the job's
-        # HTTP request. This map contains the header field names and
-        # values. Repeated headers are not supported, but a header value can
-        # contain commas. These headers represent a subset of the headers
-        # that will accompany the job's HTTP request. Some HTTP request
-        # headers will be ignored or replaced. A partial list of headers that
-        # will be ignored or replaced is below:
-        # - Host: This will be computed by Cloud Scheduler and derived from
-        # uri.
-        # * `Content-Length`: This will be computed by Cloud Scheduler.
-        # * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`.
-        # * `X-Google-*`: Google internal use only.
-        # * `X-AppEngine-*`: Google internal use only.
-        # The total size of headers must be less than 80KB.
+        # The user can specify HTTP request headers to send with the job's HTTP request.
+        # This map contains the header field names and values. Repeated headers are not
+        # supported, but a header value can contain commas. These headers represent a
+        # subset of the headers that will accompany the job's HTTP request. Some HTTP
+        # request headers will be ignored or replaced. A partial list of headers that
+        # will be ignored or replaced is below: - Host: This will be computed by Cloud
+        # Scheduler and derived from uri. * `Content-Length`: This will be computed by
+        # Cloud Scheduler. * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`
+        # . * `X-Google-*`: Google internal use only. * `X-AppEngine-*`: Google internal
+        # use only. The total size of headers must be less than 80KB.
         # Corresponds to the JSON property `headers`
         # @return [Hash<String,String>]
         attr_accessor :headers
@@ -285,29 +227,25 @@ module Google
         # @return [String]
         attr_accessor :http_method
       
-        # Contains information needed for generating an
-        # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
-        # This type of authorization should generally only be used when calling Google
-        # APIs hosted on *.googleapis.com.
+        # Contains information needed for generating an [OAuth token](https://developers.
+        # google.com/identity/protocols/OAuth2). This type of authorization should
+        # generally only be used when calling Google APIs hosted on *.googleapis.com.
         # Corresponds to the JSON property `oauthToken`
         # @return [Google::Apis::CloudschedulerV1::OAuthToken]
         attr_accessor :oauth_token
       
-        # Contains information needed for generating an
-        # [OpenID Connect
-        # token](https://developers.google.com/identity/protocols/OpenIDConnect).
-        # This type of authorization can be used for many scenarios, including
-        # calling Cloud Run, or endpoints where you intend to validate the token
-        # yourself.
+        # Contains information needed for generating an [OpenID Connect token](https://
+        # developers.google.com/identity/protocols/OpenIDConnect). This type of
+        # authorization can be used for many scenarios, including calling Cloud Run, or
+        # endpoints where you intend to validate the token yourself.
         # Corresponds to the JSON property `oidcToken`
         # @return [Google::Apis::CloudschedulerV1::OidcToken]
         attr_accessor :oidc_token
       
-        # Required. The full URI path that the request will be sent to. This string
-        # must begin with either "http://" or "https://". Some examples of
-        # valid values for uri are:
-        # `http://acme.com` and `https://acme.com/sales:8080`. Cloud Scheduler will
-        # encode some characters for safety and compatibility. The maximum allowed
+        # Required. The full URI path that the request will be sent to. This string must
+        # begin with either "http://" or "https://". Some examples of valid values for
+        # uri are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Scheduler
+        # will encode some characters for safety and compatibility. The maximum allowed
         # URL length is 2083 characters after encoding.
         # Corresponds to the JSON property `uri`
         # @return [String]
@@ -328,51 +266,42 @@ module Google
         end
       end
       
-      # Configuration for a job.
-      # The maximum allowed size for a job is 100KB.
+      # Configuration for a job. The maximum allowed size for a job is 100KB.
       class Job
         include Google::Apis::Core::Hashable
       
-        # App Engine target. The job will be pushed to a job handler by means
-        # of an HTTP request via an http_method such
-        # as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
-        # HTTP response code in the range [200 - 299]. Error 503 is
-        # considered an App Engine system error instead of an application
-        # error. Requests returning error 503 will be retried regardless of
-        # retry configuration and not counted against retry counts. Any other
-        # response code, or a failure to receive a response before the
-        # deadline, constitutes a failed attempt.
+        # App Engine target. The job will be pushed to a job handler by means of an HTTP
+        # request via an http_method such as HTTP POST, HTTP GET, etc. The job is
+        # acknowledged by means of an HTTP response code in the range [200 - 299]. Error
+        # 503 is considered an App Engine system error instead of an application error.
+        # Requests returning error 503 will be retried regardless of retry configuration
+        # and not counted against retry counts. Any other response code, or a failure to
+        # receive a response before the deadline, constitutes a failed attempt.
         # Corresponds to the JSON property `appEngineHttpTarget`
         # @return [Google::Apis::CloudschedulerV1::AppEngineHttpTarget]
         attr_accessor :app_engine_http_target
       
-        # The deadline for job attempts. If the request handler does not respond by
-        # this deadline then the request is cancelled and the attempt is marked as a
-        # `DEADLINE_EXCEEDED` failure. The failed attempt can be viewed in
-        # execution logs. Cloud Scheduler will retry the job according
-        # to the RetryConfig.
-        # The allowed duration for this deadline is:
-        # * For HTTP targets, between 15 seconds and 30 minutes.
-        # * For App Engine HTTP targets, between 15
-        # seconds and 24 hours.
+        # The deadline for job attempts. If the request handler does not respond by this
+        # deadline then the request is cancelled and the attempt is marked as a `
+        # DEADLINE_EXCEEDED` failure. The failed attempt can be viewed in execution logs.
+        # Cloud Scheduler will retry the job according to the RetryConfig. The allowed
+        # duration for this deadline is: * For HTTP targets, between 15 seconds and 30
+        # minutes. * For App Engine HTTP targets, between 15 seconds and 24 hours.
         # Corresponds to the JSON property `attemptDeadline`
         # @return [String]
         attr_accessor :attempt_deadline
       
-        # Optionally caller-specified in CreateJob or
-        # UpdateJob.
-        # A human-readable description for the job. This string must not contain
-        # more than 500 characters.
+        # Optionally caller-specified in CreateJob or UpdateJob. A human-readable
+        # description for the job. This string must not contain more than 500 characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Http target. The job will be pushed to the job handler by means of
-        # an HTTP request via an http_method such as HTTP
-        # POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
-        # response code in the range [200 - 299]. A failure to receive a response
-        # constitutes a failed execution. For a redirected request, the response
-        # returned by the redirected request is considered.
+        # Http target. The job will be pushed to the job handler by means of an HTTP
+        # request via an http_method such as HTTP POST, HTTP GET, etc. The job is
+        # acknowledged by means of an HTTP response code in the range [200 - 299]. A
+        # failure to receive a response constitutes a failed execution. For a redirected
+        # request, the response returned by the redirected request is considered.
         # Corresponds to the JSON property `httpTarget`
         # @return [Google::Apis::CloudschedulerV1::HttpTarget]
         attr_accessor :http_target
@@ -382,66 +311,54 @@ module Google
         # @return [String]
         attr_accessor :last_attempt_time
       
-        # Optionally caller-specified in CreateJob, after
-        # which it becomes output only.
-        # The job name. For example:
-        # `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-        # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
-        # hyphens (-), colons (:), or periods (.).
-        # For more information, see
-        # [Identifying
-        # projects](https://cloud.google.com/resource-manager/docs/creating-managing-
-        # projects#identifying_projects)
-        # * `LOCATION_ID` is the canonical ID for the job's location.
-        # The list of available locations can be obtained by calling
-        # ListLocations.
-        # For more information, see https://cloud.google.com/about/locations/.
-        # * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
-        # hyphens (-), or underscores (_). The maximum length is 500 characters.
+        # Optionally caller-specified in CreateJob, after which it becomes output only.
+        # The job name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/jobs/
+        # JOB_ID`. * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        # hyphens (-), colons (:), or periods (.). For more information, see [
+        # Identifying projects](https://cloud.google.com/resource-manager/docs/creating-
+        # managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID
+        # for the job's location. The list of available locations can be obtained by
+        # calling ListLocations. For more information, see https://cloud.google.com/
+        # about/locations/. * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-
+        # 9]), hyphens (-), or underscores (_). The maximum length is 500 characters.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Pub/Sub target. The job will be delivered by publishing a message to
-        # the given Pub/Sub topic.
+        # Pub/Sub target. The job will be delivered by publishing a message to the given
+        # Pub/Sub topic.
         # Corresponds to the JSON property `pubsubTarget`
         # @return [Google::Apis::CloudschedulerV1::PubsubTarget]
         attr_accessor :pubsub_target
       
-        # Settings that determine the retry behavior.
-        # By default, if a job does not complete successfully (meaning that
-        # an acknowledgement is not received from the handler, then it will be retried
-        # with exponential backoff according to the settings in RetryConfig.
+        # Settings that determine the retry behavior. By default, if a job does not
+        # complete successfully (meaning that an acknowledgement is not received from
+        # the handler, then it will be retried with exponential backoff according to the
+        # settings in RetryConfig.
         # Corresponds to the JSON property `retryConfig`
         # @return [Google::Apis::CloudschedulerV1::RetryConfig]
         attr_accessor :retry_config
       
-        # Required, except when used with UpdateJob.
-        # Describes the schedule on which the job will be executed.
-        # The schedule can be either of the following types:
-        # * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
-        # * English-like
-        # [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-
-        # schedules)
-        # As a general rule, execution `n + 1` of a job will not begin
-        # until execution `n` has finished. Cloud Scheduler will never
-        # allow two simultaneously outstanding executions. For example,
-        # this implies that if the `n+1`th execution is scheduled to run at
-        # 16:00 but the `n`th execution takes until 16:15, the `n+1`th
-        # execution will not start until `16:15`.
-        # A scheduled start time will be delayed if the previous
-        # execution has not ended when its scheduled time occurs.
-        # If retry_count > 0 and a job attempt fails,
-        # the job will be tried a total of retry_count
-        # times, with exponential backoff, until the next scheduled start
+        # Required, except when used with UpdateJob. Describes the schedule on which the
+        # job will be executed. The schedule can be either of the following types: * [
+        # Crontab](http://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule](
+        # https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) As a
+        # general rule, execution `n + 1` of a job will not begin until execution `n`
+        # has finished. Cloud Scheduler will never allow two simultaneously outstanding
+        # executions. For example, this implies that if the `n+1`th execution is
+        # scheduled to run at 16:00 but the `n`th execution takes until 16:15, the `n+1`
+        # th execution will not start until `16:15`. A scheduled start time will be
+        # delayed if the previous execution has not ended when its scheduled time occurs.
+        # If retry_count > 0 and a job attempt fails, the job will be tried a total of
+        # retry_count times, with exponential backoff, until the next scheduled start
         # time.
         # Corresponds to the JSON property `schedule`
         # @return [String]
         attr_accessor :schedule
       
-        # Output only. The next time the job is scheduled. Note that this may be a
-        # retry of a previously failed attempt or the next execution time
-        # according to the schedule.
+        # Output only. The next time the job is scheduled. Note that this may be a retry
+        # of a previously failed attempt or the next execution time according to the
+        # schedule.
         # Corresponds to the JSON property `scheduleTime`
         # @return [String]
         attr_accessor :schedule_time
@@ -451,24 +368,22 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::CloudschedulerV1::Status]
         attr_accessor :status
       
-        # Specifies the time zone to be used in interpreting
-        # schedule. The value of this field must be a time
-        # zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database).
-        # Note that some time zones include a provision for
-        # daylight savings time. The rules for daylight saving time are
-        # determined by the chosen tz. For UTC use the string "utc". If a
-        # time zone is not specified, the default will be in UTC (also known
-        # as GMT).
+        # Specifies the time zone to be used in interpreting schedule. The value of this
+        # field must be a time zone name from the [tz database](http://en.wikipedia.org/
+        # wiki/Tz_database). Note that some time zones include a provision for daylight
+        # savings time. The rules for daylight saving time are determined by the chosen
+        # tz. For UTC use the string "utc". If a time zone is not specified, the default
+        # will be in UTC (also known as GMT).
         # Corresponds to the JSON property `timeZone`
         # @return [String]
         attr_accessor :time_zone
@@ -510,12 +425,10 @@ module Google
         # @return [Array<Google::Apis::CloudschedulerV1::Job>]
         attr_accessor :jobs
       
-        # A token to retrieve next page of results. Pass this value in the
-        # page_token field in the subsequent call to
-        # ListJobs to retrieve the next page of results.
-        # If this is empty it indicates that there are no more results
-        # through which to paginate.
-        # The page token is valid for only 2 hours.
+        # A token to retrieve next page of results. Pass this value in the page_token
+        # field in the subsequent call to ListJobs to retrieve the next page of results.
+        # If this is empty it indicates that there are no more results through which to
+        # paginate. The page token is valid for only 2 hours.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -560,14 +473,14 @@ module Google
       class Location
         include Google::Apis::Core::Hashable
       
-        # The friendly name for this location, typically a nearby city name.
-        # For example, "Tokyo".
+        # The friendly name for this location, typically a nearby city name. For example,
+        # "Tokyo".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Cross-service attributes for the location. For example
-        # `"cloud.googleapis.com/region": "us-east1"`
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
+        # region": "us-east1"`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -583,8 +496,8 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
-        # Resource name for the location, which may vary between implementations.
-        # For example: `"projects/example-project/locations/us-east1"`
+        # Resource name for the location, which may vary between implementations. For
+        # example: `"projects/example-project/locations/us-east1"`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -603,24 +516,22 @@ module Google
         end
       end
       
-      # Contains information needed for generating an
-      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
-      # This type of authorization should generally only be used when calling Google
-      # APIs hosted on *.googleapis.com.
+      # Contains information needed for generating an [OAuth token](https://developers.
+      # google.com/identity/protocols/OAuth2). This type of authorization should
+      # generally only be used when calling Google APIs hosted on *.googleapis.com.
       class OAuthToken
         include Google::Apis::Core::Hashable
       
-        # OAuth scope to be used for generating OAuth access token.
-        # If not specified, "https://www.googleapis.com/auth/cloud-platform"
-        # will be used.
+        # OAuth scope to be used for generating OAuth access token. If not specified, "
+        # https://www.googleapis.com/auth/cloud-platform" will be used.
         # Corresponds to the JSON property `scope`
         # @return [String]
         attr_accessor :scope
       
-        # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
-        # to be used for generating OAuth token.
-        # The service account must be within the same project as the job. The caller
-        # must have iam.serviceAccounts.actAs permission for the service account.
+        # [Service account email](https://cloud.google.com/iam/docs/service-accounts) to
+        # be used for generating OAuth token. The service account must be within the
+        # same project as the job. The caller must have iam.serviceAccounts.actAs
+        # permission for the service account.
         # Corresponds to the JSON property `serviceAccountEmail`
         # @return [String]
         attr_accessor :service_account_email
@@ -636,12 +547,10 @@ module Google
         end
       end
       
-      # Contains information needed for generating an
-      # [OpenID Connect
-      # token](https://developers.google.com/identity/protocols/OpenIDConnect).
-      # This type of authorization can be used for many scenarios, including
-      # calling Cloud Run, or endpoints where you intend to validate the token
-      # yourself.
+      # Contains information needed for generating an [OpenID Connect token](https://
+      # developers.google.com/identity/protocols/OpenIDConnect). This type of
+      # authorization can be used for many scenarios, including calling Cloud Run, or
+      # endpoints where you intend to validate the token yourself.
       class OidcToken
         include Google::Apis::Core::Hashable
       
@@ -651,10 +560,10 @@ module Google
         # @return [String]
         attr_accessor :audience
       
-        # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
-        # to be used for generating OIDC token.
-        # The service account must be within the same project as the job. The caller
-        # must have iam.serviceAccounts.actAs permission for the service account.
+        # [Service account email](https://cloud.google.com/iam/docs/service-accounts) to
+        # be used for generating OIDC token. The service account must be within the same
+        # project as the job. The caller must have iam.serviceAccounts.actAs permission
+        # for the service account.
         # Corresponds to the JSON property `serviceAccountEmail`
         # @return [String]
         attr_accessor :service_account_email
@@ -685,24 +594,22 @@ module Google
       
       # A message that is published by publishers and consumed by subscribers. The
       # message must contain either a non-empty data field or at least one attribute.
-      # Note that client libraries represent this object differently
-      # depending on the language. See the corresponding
-      # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
-      # library documentation</a> for more information. See
-      # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
-      # for more information about message limits.
+      # Note that client libraries represent this object differently depending on the
+      # language. See the corresponding [client library documentation](https://cloud.
+      # google.com/pubsub/docs/reference/libraries) for more information. See [quotas
+      # and limits] (https://cloud.google.com/pubsub/quotas) for more information
+      # about message limits.
       class PubsubMessage
         include Google::Apis::Core::Hashable
       
-        # Attributes for this message. If this field is empty, the message must
-        # contain non-empty data. This can be used to filter messages on the
-        # subscription.
+        # Attributes for this message. If this field is empty, the message must contain
+        # non-empty data. This can be used to filter messages on the subscription.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes
       
-        # The message data field. If this field is empty, the message must contain
-        # at least one attribute.
+        # The message data field. If this field is empty, the message must contain at
+        # least one attribute.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -716,9 +623,19 @@ module Google
         # @return [String]
         attr_accessor :message_id
       
-        # The time at which the message was published, populated by the server when
-        # it receives the `Publish` call. It must not be populated by the
-        # publisher in a `Publish` call.
+        # If non-empty, identifies related messages for which publish order should be
+        # respected. If a `Subscription` has `enable_message_ordering` set to `true`,
+        # messages published with the same non-empty `ordering_key` value will be
+        # delivered to subscribers in the order in which they are received by the Pub/
+        # Sub system. All `PubsubMessage`s published in a given `PublishRequest` must
+        # specify the same `ordering_key` value.
+        # Corresponds to the JSON property `orderingKey`
+        # @return [String]
+        attr_accessor :ordering_key
+      
+        # The time at which the message was published, populated by the server when it
+        # receives the `Publish` call. It must not be populated by the publisher in a `
+        # Publish` call.
         # Corresponds to the JSON property `publishTime`
         # @return [String]
         attr_accessor :publish_time
@@ -732,37 +649,35 @@ module Google
           @attributes = args[:attributes] if args.key?(:attributes)
           @data = args[:data] if args.key?(:data)
           @message_id = args[:message_id] if args.key?(:message_id)
+          @ordering_key = args[:ordering_key] if args.key?(:ordering_key)
           @publish_time = args[:publish_time] if args.key?(:publish_time)
         end
       end
       
-      # Pub/Sub target. The job will be delivered by publishing a message to
-      # the given Pub/Sub topic.
+      # Pub/Sub target. The job will be delivered by publishing a message to the given
+      # Pub/Sub topic.
       class PubsubTarget
         include Google::Apis::Core::Hashable
       
-        # Attributes for PubsubMessage.
-        # Pubsub message must contain either non-empty data, or at least one
-        # attribute.
+        # Attributes for PubsubMessage. Pubsub message must contain either non-empty
+        # data, or at least one attribute.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes
       
-        # The message payload for PubsubMessage.
-        # Pubsub message must contain either non-empty data, or at least one
-        # attribute.
+        # The message payload for PubsubMessage. Pubsub message must contain either non-
+        # empty data, or at least one attribute.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :data
       
-        # Required. The name of the Cloud Pub/Sub topic to which messages will
-        # be published when a job is delivered. The topic name must be in the
-        # same format as required by PubSub's
-        # [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/
-        # google.pubsub.v1#publishrequest),
-        # for example `projects/PROJECT_ID/topics/TOPIC_ID`.
-        # The topic must be in the same project as the Cloud Scheduler job.
+        # Required. The name of the Cloud Pub/Sub topic to which messages will be
+        # published when a job is delivered. The topic name must be in the same format
+        # as required by PubSub's [PublishRequest.name](https://cloud.google.com/pubsub/
+        # docs/reference/rpc/google.pubsub.v1#publishrequest), for example `projects/
+        # PROJECT_ID/topics/TOPIC_ID`. The topic must be in the same project as the
+        # Cloud Scheduler job.
         # Corresponds to the JSON property `topicName`
         # @return [String]
         attr_accessor :topic_name
@@ -792,69 +707,55 @@ module Google
         end
       end
       
-      # Settings that determine the retry behavior.
-      # By default, if a job does not complete successfully (meaning that
-      # an acknowledgement is not received from the handler, then it will be retried
-      # with exponential backoff according to the settings in RetryConfig.
+      # Settings that determine the retry behavior. By default, if a job does not
+      # complete successfully (meaning that an acknowledgement is not received from
+      # the handler, then it will be retried with exponential backoff according to the
+      # settings in RetryConfig.
       class RetryConfig
         include Google::Apis::Core::Hashable
       
-        # The maximum amount of time to wait before retrying a job after
-        # it fails.
-        # The default value of this field is 1 hour.
+        # The maximum amount of time to wait before retrying a job after it fails. The
+        # default value of this field is 1 hour.
         # Corresponds to the JSON property `maxBackoffDuration`
         # @return [String]
         attr_accessor :max_backoff_duration
       
-        # The time between retries will double `max_doublings` times.
-        # A job's retry interval starts at
-        # min_backoff_duration, then doubles
-        # `max_doublings` times, then increases linearly, and finally
-        # retries at intervals of
-        # max_backoff_duration up to
-        # retry_count times.
-        # For example, if min_backoff_duration is
-        # 10s, max_backoff_duration is 300s, and
-        # `max_doublings` is 3, then the a job will first be retried in 10s. The
-        # retry interval will double three times, and then increase linearly by
-        # 2^3 * 10s.  Finally, the job will retry at intervals of
-        # max_backoff_duration until the job has
-        # been attempted retry_count times. Thus, the
-        # requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....
-        # The default value of this field is 5.
+        # The time between retries will double `max_doublings` times. A job's retry
+        # interval starts at min_backoff_duration, then doubles `max_doublings` times,
+        # then increases linearly, and finally retries at intervals of
+        # max_backoff_duration up to retry_count times. For example, if
+        # min_backoff_duration is 10s, max_backoff_duration is 300s, and `max_doublings`
+        # is 3, then the a job will first be retried in 10s. The retry interval will
+        # double three times, and then increase linearly by 2^3 * 10s. Finally, the job
+        # will retry at intervals of max_backoff_duration until the job has been
+        # attempted retry_count times. Thus, the requests will retry at 10s, 20s, 40s,
+        # 80s, 160s, 240s, 300s, 300s, .... The default value of this field is 5.
         # Corresponds to the JSON property `maxDoublings`
         # @return [Fixnum]
         attr_accessor :max_doublings
       
-        # The time limit for retrying a failed job, measured from time when an
-        # execution was first attempted. If specified with
-        # retry_count, the job will be retried until both
-        # limits are reached.
-        # The default value for max_retry_duration is zero, which means retry
-        # duration is unlimited.
+        # The time limit for retrying a failed job, measured from time when an execution
+        # was first attempted. If specified with retry_count, the job will be retried
+        # until both limits are reached. The default value for max_retry_duration is
+        # zero, which means retry duration is unlimited.
         # Corresponds to the JSON property `maxRetryDuration`
         # @return [String]
         attr_accessor :max_retry_duration
       
-        # The minimum amount of time to wait before retrying a job after
-        # it fails.
-        # The default value of this field is 5 seconds.
+        # The minimum amount of time to wait before retrying a job after it fails. The
+        # default value of this field is 5 seconds.
         # Corresponds to the JSON property `minBackoffDuration`
         # @return [String]
         attr_accessor :min_backoff_duration
       
         # The number of attempts that the system will make to run a job using the
-        # exponential backoff procedure described by
-        # max_doublings.
-        # The default value of retry_count is zero.
-        # If retry_count is zero, a job attempt will *not* be retried if
-        # it fails. Instead the Cloud Scheduler system will wait for the
-        # next scheduled execution time.
-        # If retry_count is set to a non-zero number then Cloud Scheduler
-        # will retry failed attempts, using exponential backoff,
-        # retry_count times, or until the next scheduled execution time,
-        # whichever comes first.
-        # Values greater than 5 and negative values are not allowed.
+        # exponential backoff procedure described by max_doublings. The default value of
+        # retry_count is zero. If retry_count is zero, a job attempt will *not* be
+        # retried if it fails. Instead the Cloud Scheduler system will wait for the next
+        # scheduled execution time. If retry_count is set to a non-zero number then
+        # Cloud Scheduler will retry failed attempts, using exponential backoff,
+        # retry_count times, or until the next scheduled execution time, whichever comes
+        # first. Values greater than 5 and negative values are not allowed.
         # Corresponds to the JSON property `retryCount`
         # @return [Fixnum]
         attr_accessor :retry_count
@@ -873,8 +774,7 @@ module Google
         end
       end
       
-      # Request message for forcing a job to run now using
-      # RunJob.
+      # Request message for forcing a job to run now using RunJob.
       class RunJobRequest
         include Google::Apis::Core::Hashable
       
@@ -887,12 +787,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -901,15 +801,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message