google-cloud-tasks-v2beta2 0.5.3 → 0.6.0

data/lib/google/cloud/tasks/v2beta2/cloud_tasks/client.rb

@@ -275,6 +275,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::ListQueuesRequest.new
+            #
+            #   # Call the list_queues method.
+            #   result = client.list_queues request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Tasks::V2beta2::Queue.
+            #     p response
+            #   end
+            #
             def list_queues request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -292,9 +313,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -350,6 +373,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::GetQueueRequest.new
+            #
+            #   # Call the get_queue method.
+            #   result = client.get_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def get_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -367,9 +405,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -438,6 +478,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::CreateQueueRequest.new
+            #
+            #   # Call the create_queue method.
+            #   result = client.create_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def create_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -455,9 +510,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -530,6 +587,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::UpdateQueueRequest.new
+            #
+            #   # Call the update_queue method.
+            #   result = client.update_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def update_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -547,9 +619,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "queue.name" => request.queue.name
-              }
+              header_params = {}
+              if request.queue&.name
+                header_params["queue.name"] = request.queue.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -611,6 +685,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::DeleteQueueRequest.new
+            #
+            #   # Call the delete_queue method.
+            #   result = client.delete_queue request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -628,9 +717,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -685,6 +776,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::PurgeQueueRequest.new
+            #
+            #   # Call the purge_queue method.
+            #   result = client.purge_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def purge_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -702,9 +808,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -760,6 +868,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::PauseQueueRequest.new
+            #
+            #   # Call the pause_queue method.
+            #   result = client.pause_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def pause_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -777,9 +900,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -841,6 +966,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::ResumeQueueRequest.new
+            #
+            #   # Call the resume_queue method.
+            #   result = client.resume_queue request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Queue.
+            #   p result
+            #
             def resume_queue request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -858,9 +998,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -911,7 +1053,7 @@ module Google
             #     See the operation documentation for the appropriate value for this field.
             #   @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
             #     OPTIONAL: A `GetPolicyOptions` object for specifying options to
-            #     `GetIamPolicy`. This field is only used by Cloud IAM.
+            #     `GetIamPolicy`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Iam::V1::Policy]
@@ -921,6 +1063,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::GetIamPolicyRequest.new
+            #
+            #   # Call the get_iam_policy method.
+            #   result = client.get_iam_policy request
+            #
+            #   # The returned object is of type Google::Iam::V1::Policy.
+            #   p result
+            #
             def get_iam_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -938,9 +1095,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -983,7 +1142,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload set_iam_policy(resource: nil, policy: nil)
+            # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
             #   Pass arguments to `set_iam_policy` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -996,6 +1155,12 @@ module Google
             #     the policy is limited to a few 10s of KB. An empty policy is a
             #     valid policy but certain Cloud Platform services (such as Projects)
             #     might reject them.
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+            #     the fields in the mask will be modified. If no mask is provided, the
+            #     following default mask is used:
+            #
+            #     `paths: "bindings, etag"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Iam::V1::Policy]
@@ -1005,6 +1170,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::SetIamPolicyRequest.new
+            #
+            #   # Call the set_iam_policy method.
+            #   result = client.set_iam_policy request
+            #
+            #   # The returned object is of type Google::Iam::V1::Policy.
+            #   p result
+            #
             def set_iam_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1022,9 +1202,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1085,6 +1267,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+            #
+            #   # Call the test_iam_permissions method.
+            #   result = client.test_iam_permissions request
+            #
+            #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+            #   p result
+            #
             def test_iam_permissions request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1102,9 +1299,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1194,6 +1393,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::ListTasksRequest.new
+            #
+            #   # Call the list_tasks method.
+            #   result = client.list_tasks request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Tasks::V2beta2::Task.
+            #     p response
+            #   end
+            #
             def list_tasks request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1211,9 +1431,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1277,6 +1499,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::GetTaskRequest.new
+            #
+            #   # Call the get_task method.
+            #   result = client.get_task request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Task.
+            #   p result
+            #
             def get_task request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1294,9 +1531,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1401,6 +1640,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::CreateTaskRequest.new
+            #
+            #   # Call the create_task method.
+            #   result = client.create_task request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Task.
+            #   p result
+            #
             def create_task request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1418,9 +1672,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1474,6 +1730,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::DeleteTaskRequest.new
+            #
+            #   # Call the delete_task method.
+            #   result = client.delete_task request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_task request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1491,9 +1762,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1638,6 +1911,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::LeaseTasksRequest.new
+            #
+            #   # Call the lease_tasks method.
+            #   result = client.lease_tasks request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::LeaseTasksResponse.
+            #   p result
+            #
             def lease_tasks request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1655,9 +1943,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1725,6 +2015,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::AcknowledgeTaskRequest.new
+            #
+            #   # Call the acknowledge_task method.
+            #   result = client.acknowledge_task request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def acknowledge_task request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1742,9 +2047,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1823,6 +2130,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::RenewLeaseRequest.new
+            #
+            #   # Call the renew_lease method.
+            #   result = client.renew_lease request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Task.
+            #   p result
+            #
             def renew_lease request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1840,9 +2162,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1916,6 +2240,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::CancelLeaseRequest.new
+            #
+            #   # Call the cancel_lease method.
+            #   result = client.cancel_lease request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Task.
+            #   p result
+            #
             def cancel_lease request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1933,9 +2272,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -2024,6 +2365,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/tasks/v2beta2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Tasks::V2beta2::CloudTasks::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Tasks::V2beta2::RunTaskRequest.new
+            #
+            #   # Call the run_task method.
+            #   result = client.run_task request
+            #
+            #   # The returned object is of type Google::Cloud::Tasks::V2beta2::Task.
+            #   p result
+            #
             def run_task request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2041,9 +2397,11 @@ module Google
                 gapic_version: ::Google::Cloud::Tasks::V2beta2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header