google-api-client 0.43.0 → 0.48.0

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 [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.
+      # 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]
@@ -719,16 +626,16 @@ module Google
         # 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.
+        # 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.
+        # 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
@@ -747,33 +654,30 @@ module Google
         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
@@ -803,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
@@ -884,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
       
@@ -898,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
       
@@ -912,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