google-api-client 0.28.4 → 0.29.2

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

@@ -40,14 +40,18 @@ module Google
         # Defines routing characteristics specific to App Engine - service, version,
         # and instance.
         # 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).
+        # [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 `appEngineRoutingOverride`
         # @return [Google::Apis::CloudtasksV2beta3::AppEngineRouting]
         attr_accessor :app_engine_routing_override
@@ -65,8 +69,6 @@ module Google
       # App Engine HTTP request.
       # The message defines the HTTP request that is sent to an App Engine app when
       # the task is dispatched.
-      # This proto can only be used for tasks in a queue which has
-      # app_engine_http_queue set.
       # Using AppEngineHttpRequest requires
       # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-
       # api/access-control)
@@ -75,11 +77,12 @@ module Google
       # `https://www.googleapis.com/auth/cloud-platform`
       # The task will be delivered to the App Engine app which belongs to the same
       # project as the queue. For more information, see
-      # [How Requests are Routed](https://cloud.google.com/appengine/docs/standard/
-      # python/how-requests-are-routed)
+      # [How Requests are
+      # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-
+      # are-routed)
       # and how routing is affected by
-      # [dispatch files](https://cloud.google.com/appengine/docs/python/config/
-      # dispatchref).
+      # [dispatch
+      # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
       # Traffic is encrypted during transport and never leaves Google datacenters.
       # Because this traffic is carried over a communication mechanism internal to
       # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
@@ -97,20 +100,25 @@ module Google
       # relative_uri
       # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
       # URIs restricted with
-      # [`login: admin`](https://cloud.google.com/appengine/docs/standard/python/
-      # config/appref).
+      # [`login:
+      # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
       # Because tasks are not run as any user, they cannot be dispatched to URIs
       # restricted with
-      # [`login: required`](https://cloud.google.com/appengine/docs/standard/python/
-      # config/appref)
+      # [`login:
+      # required`](https://cloud.google.com/appengine/docs/standard/python/config/
+      # appref)
       # Task dispatches also do not follow redirects.
-      # The task attempt has succeeded if the app's request handler returns
-      # an HTTP response code in the range [`200` - `299`]. `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 is a failed attempt.
+      # The task attempt has succeeded if the app's request handler returns an HTTP
+      # response code in the range [`200` - `299`]. The task attempt has failed if
+      # the app's handler returns a non-2xx response code or Cloud Tasks does
+      # not receive response before the deadline. Failed
+      # tasks will be retried according to the
+      # retry configuration. `503` (Service Unavailable) is
+      # considered an App Engine system error instead of an application error and
+      # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+      # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+      # Requests) response from an app handler does not cause traffic congestion
+      # control to throttle the queue.
       class AppEngineHttpRequest
         include Google::Apis::Core::Hashable
       
@@ -118,14 +126,18 @@ module Google
         # Defines routing characteristics specific to App Engine - service, version,
         # and instance.
         # 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).
+        # [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::CloudtasksV2beta3::AppEngineRouting]
         attr_accessor :app_engine_routing
@@ -164,8 +176,9 @@ module Google
         # * `X-AppEngine-*`
         # In addition, Cloud Tasks sets some headers when the task is dispatched,
         # such as headers containing information about the task; see
-        # [request headers](https://cloud.google.com/appengine/docs/python/taskqueue/
-        # push/creating-handlers#reading_request_headers).
+        # [request
+        # headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/
+        # creating-handlers#reading_request_headers).
         # These headers are set only when the task is dispatched, so they are not
         # visible when the task is returned in a Cloud Tasks response.
         # Although there is no specific limit for the maximum number of headers or
@@ -179,12 +192,14 @@ module Google
         # The app's request handler for the task's target URL must be able to handle
         # HTTP requests with this http_method, otherwise the task attempt will fail
         # with error code 405 (Method Not Allowed). See
-        # [Writing a push task request handler](https://cloud.google.com/appengine/docs/
-        # java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+        # [Writing a push task request
+        # handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-
+        # handlers#writing_a_push_task_request_handler)
         # and the documentation for the request handlers in the language your app is
         # written in e.g.
-        # [Python Request Handler](https://cloud.google.com/appengine/docs/python/tools/
-        # webapp/requesthandlerclass).
+        # [Python Request
+        # Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/
+        # requesthandlerclass).
         # Corresponds to the JSON property `httpMethod`
         # @return [String]
         attr_accessor :http_method
@@ -216,14 +231,18 @@ module Google
       # Defines routing characteristics specific to App Engine - service, version,
       # and instance.
       # 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).
+      # [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
       
@@ -234,8 +253,9 @@ module Google
         # and instance. Tasks which were created using
         # the App Engine SDK might have a custom domain name.
         # For more information, see
-        # [How Requests are Routed](https://cloud.google.com/appengine/docs/standard/
-        # python/how-requests-are-routed).
+        # [How Requests are
+        # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-
+        # are-routed).
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
@@ -244,14 +264,16 @@ module Google
         # By default, the task is sent to an instance which is available when
         # the task 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).
+        # [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 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
@@ -315,14 +337,14 @@ module Google
         # @return [String]
         attr_accessor :dispatch_time
       
-        # 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). The error model is designed to be:
+        # 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). The error model is designed to be:
         # - Simple to use and understand for most users
         # - Flexible enough to meet unexpected needs
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -407,7 +429,7 @@ module Google
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
         # For example, `admins@example.com`.
-        # * `domain:`domain``: A Google Apps domain name that represents all the
+        # * `domain:`domain``: The G Suite domain (primary) that represents all the
         # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
@@ -544,6 +566,118 @@ module Google
         end
       end
       
+      # HTTP request.
+      # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
+      # feature. If you haven't already joined, you can [use this form to sign
+      # up](https://docs.google.com/forms/d/e/
+      # 1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
+      # The task will be pushed to the worker as an HTTP request. If the worker
+      # or the redirected worker acknowledges the task by returning a successful HTTP
+      # response code ([`200` - `299`]), the task will removed from the queue. If
+      # any other HTTP response code is returned or no response is received, the
+      # task will be retried according to the following:
+      # * User-specified throttling: retry configuration,
+      # rate limits, and the queue's state.
+      # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+      # temporarily reduce the queue's effective rate. User-specified settings
+      # will not be changed.
+      # System throttling happens because:
+      # * Cloud Tasks backoffs on all errors. Normally the backoff specified in
+      # rate limits will be used. But if the worker returns
+      # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+      # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+      # specified in the `Retry-After` HTTP response header is considered.
+      # * To prevent traffic spikes and to smooth sudden large traffic spikes,
+      # dispatches ramp up slowly when the queue is newly created or idle and
+      # if large numbers of tasks suddenly become available to dispatch (due to
+      # spikes in create task rates, the queue being unpaused, or many tasks
+      # that are scheduled at the same time).
+      class HttpRequest
+        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 task 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
+        # task is created.
+        # These headers represent a subset of the headers that will accompany the
+        # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+        # A partial list of headers that will be ignored or replaced is:
+        # * Host: This will be computed by Cloud Tasks and derived from
+        # HttpRequest.url.
+        # * Content-Length: This will be computed by Cloud Tasks.
+        # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+        # * X-Google-*: Google use only.
+        # * X-AppEngine-*: Google use only.
+        # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+        # `Content-Type` to a media type when the
+        # task is created.
+        # For example, `Content-Type` can be set to `"application/octet-stream"` or
+        # `"application/json"`.
+        # Headers which can have multiple values (according to RFC2616) can be
+        # specified using comma-separated values.
+        # The size of the headers must be less than 80KB.
+        # Corresponds to the JSON property `headers`
+        # @return [Hash<String,String>]
+        attr_accessor :headers
+      
+        # The HTTP method to use for the request. The default is POST.
+        # Corresponds to the JSON property `httpMethod`
+        # @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.
+        # Corresponds to the JSON property `oauthToken`
+        # @return [Google::Apis::CloudtasksV2beta3::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.
+        # Corresponds to the JSON property `oidcToken`
+        # @return [Google::Apis::CloudtasksV2beta3::OidcToken]
+        attr_accessor :oidc_token
+      
+        # Required. The full url path that the request will be sent to.
+        # This string must begin with either "http://" or "https://". Some examples
+        # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+        # encode some characters for safety and compatibility. The maximum allowed
+        # URL length is 2083 characters after encoding.
+        # The `Location` header response from a redirect response [`300` - `399`]
+        # may be followed. The redirect is not counted as a separate attempt.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @body = args[:body] if args.key?(:body)
+          @headers = args[:headers] if args.key?(:headers)
+          @http_method = args[:http_method] if args.key?(:http_method)
+          @oauth_token = args[:oauth_token] if args.key?(:oauth_token)
+          @oidc_token = args[:oidc_token] if args.key?(:oidc_token)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
       # The response message for Locations.ListLocations.
       class ListLocationsResponse
         include Google::Apis::Core::Hashable
@@ -675,6 +809,75 @@ 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.
+      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.
+        # 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 queue. 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @scope = args[:scope] if args.key?(:scope)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
+        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.
+      class OidcToken
+        include Google::Apis::Core::Hashable
+      
+        # Audience to be used when generating OIDC token. If not specified, the URI
+        # specified in target will be used.
+        # Corresponds to the JSON property `audience`
+        # @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 queue. 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience = args[:audience] if args.key?(:audience)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
+        end
+      end
+      
       # Request message for PauseQueue.
       class PauseQueueRequest
         include Google::Apis::Core::Hashable
@@ -807,8 +1010,9 @@ module Google
         # * `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)
+        # [Identifying
+        # projects](https://cloud.google.com/resource-manager/docs/creating-managing-
+        # projects#identifying_projects)
         # * `LOCATION_ID` is the canonical ID for the queue's location.
         # The list of available locations can be obtained by calling
         # ListLocations.
@@ -823,9 +1027,9 @@ module Google
         # All tasks that were created before this time
         # were purged.
         # A queue can be purged using PurgeQueue, the
-        # [App Engine Task Queue SDK, or the Cloud Console](https://cloud.google.com/
-        # appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#
-        # purging_all_tasks_from_a_queue).
+        # [App Engine Task Queue SDK, or the Cloud
+        # Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/
+        # push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
         # Purge time will be truncated to the nearest microsecond. Purge
         # time will be unset if the queue has never been purged.
         # Corresponds to the JSON property `purgeTime`
@@ -847,6 +1051,12 @@ module Google
         # @return [Google::Apis::CloudtasksV2beta3::RetryConfig]
         attr_accessor :retry_config
       
+        # Configuration options for writing logs to
+        # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+        # Corresponds to the JSON property `stackdriverLoggingConfig`
+        # @return [Google::Apis::CloudtasksV2beta3::StackdriverLoggingConfig]
+        attr_accessor :stackdriver_logging_config
+      
         # Output only. The state of the queue.
         # `state` can only be changed by called
         # PauseQueue,
@@ -869,6 +1079,7 @@ module Google
           @purge_time = args[:purge_time] if args.key?(:purge_time)
           @rate_limits = args[:rate_limits] if args.key?(:rate_limits)
           @retry_config = args[:retry_config] if args.key?(:retry_config)
+          @stackdriver_logging_config = args[:stackdriver_logging_config] if args.key?(:stackdriver_logging_config)
           @state = args[:state] if args.key?(:state)
         end
       end
@@ -922,8 +1133,9 @@ module Google
         # default.
         # The maximum allowed value is 5,000.
         # This field has the same meaning as
-        # [max_concurrent_requests in queue.yaml/xml](https://cloud.google.com/appengine/
-        # docs/standard/python/config/queueref#max_concurrent_requests).
+        # [max_concurrent_requests in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#max_concurrent_requests).
         # Corresponds to the JSON property `maxConcurrentDispatches`
         # @return [Fixnum]
         attr_accessor :max_concurrent_dispatches
@@ -934,8 +1146,9 @@ module Google
         # * For App Engine queues, the maximum allowed value
         # is 500.
         # This field has the same meaning as
-        # [rate in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/
-        # python/config/queueref#rate).
+        # [rate in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#rate).
         # Corresponds to the JSON property `maxDispatchesPerSecond`
         # @return [Float]
         attr_accessor :max_dispatches_per_second
@@ -978,8 +1191,9 @@ module Google
         # default.
         # -1 indicates unlimited attempts.
         # This field has the same meaning as
-        # [task_retry_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/
-        # standard/python/config/queueref#retry_parameters).
+        # [task_retry_limit in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxAttempts`
         # @return [Fixnum]
         attr_accessor :max_attempts
@@ -993,8 +1207,9 @@ module Google
         # default.
         # `max_backoff` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/
-        # docs/standard/python/config/queueref#retry_parameters).
+        # [max_backoff_seconds in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxBackoff`
         # @return [String]
         attr_accessor :max_backoff
@@ -1018,8 +1233,9 @@ module Google
         # If unspecified when the queue is created, Cloud Tasks will pick the
         # default.
         # This field has the same meaning as
-        # [max_doublings in queue.yaml/xml](https://cloud.google.com/appengine/docs/
-        # standard/python/config/queueref#retry_parameters).
+        # [max_doublings in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxDoublings`
         # @return [Fixnum]
         attr_accessor :max_doublings
@@ -1035,8 +1251,9 @@ module Google
         # default.
         # `max_retry_duration` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/
-        # standard/python/config/queueref#retry_parameters).
+        # [task_age_limit in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxRetryDuration`
         # @return [String]
         attr_accessor :max_retry_duration
@@ -1050,8 +1267,9 @@ module Google
         # default.
         # `min_backoff` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/
-        # docs/standard/python/config/queueref#retry_parameters).
+        # [min_backoff_seconds in
+        # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `minBackoff`
         # @return [String]
         attr_accessor :min_backoff
@@ -1154,14 +1372,37 @@ 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). The error model is designed to be:
+      # Configuration options for writing logs to
+      # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+      class StackdriverLoggingConfig
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the fraction of operations to write to
+        # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+        # This field may contain any value between 0.0 and 1.0, inclusive.
+        # 0.0 is the default and means that no operations are logged.
+        # Corresponds to the JSON property `samplingRatio`
+        # @return [Float]
+        attr_accessor :sampling_ratio
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sampling_ratio = args[:sampling_ratio] if args.key?(:sampling_ratio)
+        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). The error model is designed to be:
       # - Simple to use and understand for most users
       # - Flexible enough to meet unexpected needs
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing
@@ -1233,8 +1474,6 @@ module Google
         # App Engine HTTP request.
         # The message defines the HTTP request that is sent to an App Engine app when
         # the task is dispatched.
-        # This proto can only be used for tasks in a queue which has
-        # app_engine_http_queue set.
         # Using AppEngineHttpRequest requires
         # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-
         # api/access-control)
@@ -1243,11 +1482,12 @@ module Google
         # `https://www.googleapis.com/auth/cloud-platform`
         # The task will be delivered to the App Engine app which belongs to the same
         # project as the queue. For more information, see
-        # [How Requests are Routed](https://cloud.google.com/appengine/docs/standard/
-        # python/how-requests-are-routed)
+        # [How Requests are
+        # Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-
+        # are-routed)
         # and how routing is affected by
-        # [dispatch files](https://cloud.google.com/appengine/docs/python/config/
-        # dispatchref).
+        # [dispatch
+        # files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
         # Traffic is encrypted during transport and never leaves Google datacenters.
         # Because this traffic is carried over a communication mechanism internal to
         # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
@@ -1265,20 +1505,25 @@ module Google
         # relative_uri
         # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
         # URIs restricted with
-        # [`login: admin`](https://cloud.google.com/appengine/docs/standard/python/
-        # config/appref).
+        # [`login:
+        # admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
         # Because tasks are not run as any user, they cannot be dispatched to URIs
         # restricted with
-        # [`login: required`](https://cloud.google.com/appengine/docs/standard/python/
-        # config/appref)
+        # [`login:
+        # required`](https://cloud.google.com/appengine/docs/standard/python/config/
+        # appref)
         # Task dispatches also do not follow redirects.
-        # The task attempt has succeeded if the app's request handler returns
-        # an HTTP response code in the range [`200` - `299`]. `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 is a failed attempt.
+        # The task attempt has succeeded if the app's request handler returns an HTTP
+        # response code in the range [`200` - `299`]. The task attempt has failed if
+        # the app's handler returns a non-2xx response code or Cloud Tasks does
+        # not receive response before the deadline. Failed
+        # tasks will be retried according to the
+        # retry configuration. `503` (Service Unavailable) is
+        # considered an App Engine system error instead of an application error and
+        # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+        # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+        # Requests) response from an app handler does not cause traffic congestion
+        # control to throttle the queue.
         # Corresponds to the JSON property `appEngineHttpRequest`
         # @return [Google::Apis::CloudtasksV2beta3::AppEngineHttpRequest]
         attr_accessor :app_engine_http_request
@@ -1290,7 +1535,7 @@ module Google
         attr_accessor :create_time
       
         # Output only. The number of attempts dispatched.
-        # This count includes tasks which have been dispatched but haven't
+        # This count includes attempts which have been dispatched but haven't
         # received a response.
         # Corresponds to the JSON property `dispatchCount`
         # @return [Fixnum]
@@ -1305,10 +1550,13 @@ module Google
         # worker. For example, if the worker is stuck, it may not react to cancelled
         # requests.
         # The default and maximum values depend on the type of request:
+        # * For HTTP tasks, the default is 10 minutes. The deadline
+        # must be in the interval [15 seconds, 30 minutes].
         # * For App Engine tasks, 0 indicates that the
         # request has the default deadline. The default deadline depends on the
-        # [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-
-        # instances-are-managed#instance_scaling)
+        # [scaling
+        # type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-
+        # managed#instance_scaling)
         # of the service: 10 minutes for standard apps with automatic scaling, 24
         # hours for standard apps with manual and basic scaling, and 60 minutes for
         # flex apps. If the request deadline is set, it must be in the interval [15
@@ -1330,6 +1578,36 @@ module Google
         # @return [Google::Apis::CloudtasksV2beta3::Attempt]
         attr_accessor :first_attempt
       
+        # HTTP request.
+        # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
+        # feature. If you haven't already joined, you can [use this form to sign
+        # up](https://docs.google.com/forms/d/e/
+        # 1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
+        # The task will be pushed to the worker as an HTTP request. If the worker
+        # or the redirected worker acknowledges the task by returning a successful HTTP
+        # response code ([`200` - `299`]), the task will removed from the queue. If
+        # any other HTTP response code is returned or no response is received, the
+        # task will be retried according to the following:
+        # * User-specified throttling: retry configuration,
+        # rate limits, and the queue's state.
+        # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+        # temporarily reduce the queue's effective rate. User-specified settings
+        # will not be changed.
+        # System throttling happens because:
+        # * Cloud Tasks backoffs on all errors. Normally the backoff specified in
+        # rate limits will be used. But if the worker returns
+        # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+        # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+        # specified in the `Retry-After` HTTP response header is considered.
+        # * To prevent traffic spikes and to smooth sudden large traffic spikes,
+        # dispatches ramp up slowly when the queue is newly created or idle and
+        # if large numbers of tasks suddenly become available to dispatch (due to
+        # spikes in create task rates, the queue being unpaused, or many tasks
+        # that are scheduled at the same time).
+        # Corresponds to the JSON property `httpRequest`
+        # @return [Google::Apis::CloudtasksV2beta3::HttpRequest]
+        attr_accessor :http_request
+      
         # The status of a task attempt.
         # Corresponds to the JSON property `lastAttempt`
         # @return [Google::Apis::CloudtasksV2beta3::Attempt]
@@ -1342,8 +1620,9 @@ module Google
         # * `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)
+        # [Identifying
+        # projects](https://cloud.google.com/resource-manager/docs/creating-managing-
+        # projects#identifying_projects)
         # * `LOCATION_ID` is the canonical ID for the task's location.
         # The list of available locations can be obtained by calling
         # ListLocations.
@@ -1385,6 +1664,7 @@ module Google
           @dispatch_count = args[:dispatch_count] if args.key?(:dispatch_count)
           @dispatch_deadline = args[:dispatch_deadline] if args.key?(:dispatch_deadline)
           @first_attempt = args[:first_attempt] if args.key?(:first_attempt)
+          @http_request = args[:http_request] if args.key?(:http_request)
           @last_attempt = args[:last_attempt] if args.key?(:last_attempt)
           @name = args[:name] if args.key?(:name)
           @response_count = args[:response_count] if args.key?(:response_count)