google-cloud-talent-v4 0.4.3 → 0.6.2

data/lib/google/cloud/talent/v4/job_service/operations.rb

@@ -143,6 +143,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::ListOperationsRequest.new
+            #
+            #   # Call the list_operations method.
+            #   result = client.list_operations 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::Longrunning::Operation.
+            #     p response
+            #   end
+            #
             def list_operations request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -160,9 +181,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -215,6 +238,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::GetOperationRequest.new
+            #
+            #   # Call the get_operation method.
+            #   result = client.get_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def get_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -232,9 +277,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -287,6 +334,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::DeleteOperationRequest.new
+            #
+            #   # Call the delete_operation method.
+            #   result = client.delete_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -304,9 +366,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -364,6 +428,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::CancelOperationRequest.new
+            #
+            #   # Call the cancel_operation method.
+            #   result = client.cancel_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def cancel_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -381,9 +460,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -444,6 +525,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::WaitOperationRequest.new
+            #
+            #   # Call the wait_operation method.
+            #   result = client.wait_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def wait_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/talent/v4/job_service_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4/job_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -17,6 +15,8 @@ require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/rpc/status_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/talent/v4/job_service.proto", :syntax => :proto3) do
     add_message "google.cloud.talent.v4.CreateJobRequest" do
@@ -60,6 +60,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :diversification_level, :enum, 13, "google.cloud.talent.v4.SearchJobsRequest.DiversificationLevel"
       optional :custom_ranking_info, :message, 14, "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo"
       optional :disable_keyword_match, :bool, 16
+      optional :keyword_match_mode, :enum, 18, "google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode"
     end
     add_message "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo" do
       optional :importance_level, :enum, 1, "google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo.ImportanceLevel"
@@ -83,6 +84,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :DIVERSIFICATION_LEVEL_UNSPECIFIED, 0
       value :DISABLED, 1
       value :SIMPLE, 2
+      value :ONE_PER_COMPANY, 3
+      value :TWO_PER_COMPANY, 4
+      value :DIVERSIFY_BY_LOOSER_SIMILARITY, 5
+    end
+    add_enum "google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode" do
+      value :KEYWORD_MATCH_MODE_UNSPECIFIED, 0
+      value :KEYWORD_MATCH_DISABLED, 1
+      value :KEYWORD_MATCH_ALL, 2
+      value :KEYWORD_MATCH_TITLE_ONLY, 3
     end
     add_message "google.cloud.talent.v4.SearchJobsResponse" do
       repeated :matching_jobs, :message, 1, "google.cloud.talent.v4.SearchJobsResponse.MatchingJob"
@@ -156,6 +166,7 @@ module Google
         SearchJobsRequest::CustomRankingInfo::ImportanceLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.CustomRankingInfo.ImportanceLevel").enummodule
         SearchJobsRequest::SearchMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.SearchMode").enummodule
         SearchJobsRequest::DiversificationLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.DiversificationLevel").enummodule
+        SearchJobsRequest::KeywordMatchMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsRequest.KeywordMatchMode").enummodule
         SearchJobsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse").msgclass
         SearchJobsResponse::MatchingJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse.MatchingJob").msgclass
         SearchJobsResponse::CommuteInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4.SearchJobsResponse.CommuteInfo").msgclass

data/lib/google/cloud/talent/v4/job_service_services_pb.rb

@@ -27,7 +27,7 @@ module Google
           # A service handles job management, including job CRUD, enumeration and search.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

data/lib/google/cloud/talent/v4/tenant_pb.rb

@@ -1,11 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4/tenant.proto
 
-require 'google/protobuf'
-
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/api/annotations_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/talent/v4/tenant.proto", :syntax => :proto3) do
     add_message "google.cloud.talent.v4.Tenant" do

data/lib/google/cloud/talent/v4/tenant_service/client.rb

@@ -197,6 +197,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4::TenantService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4::CreateTenantRequest.new
+            #
+            #   # Call the create_tenant method.
+            #   result = client.create_tenant request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4::Tenant.
+            #   p result
+            #
             def create_tenant request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -214,9 +229,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -268,6 +285,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4::TenantService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4::GetTenantRequest.new
+            #
+            #   # Call the get_tenant method.
+            #   result = client.get_tenant request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4::Tenant.
+            #   p result
+            #
             def get_tenant request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -285,9 +317,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -344,6 +378,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4::TenantService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4::UpdateTenantRequest.new
+            #
+            #   # Call the update_tenant method.
+            #   result = client.update_tenant request
+            #
+            #   # The returned object is of type Google::Cloud::Talent::V4::Tenant.
+            #   p result
+            #
             def update_tenant request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -361,9 +410,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "tenant.name" => request.tenant.name
-              }
+              header_params = {}
+              if request.tenant&.name
+                header_params["tenant.name"] = request.tenant.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -415,6 +466,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4::TenantService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4::DeleteTenantRequest.new
+            #
+            #   # Call the delete_tenant method.
+            #   result = client.delete_tenant request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_tenant request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -432,9 +498,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 
@@ -491,6 +559,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/talent/v4"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Talent::V4::TenantService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Talent::V4::ListTenantsRequest.new
+            #
+            #   # Call the list_tenants method.
+            #   result = client.list_tenants 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::Talent::V4::Tenant.
+            #     p response
+            #   end
+            #
             def list_tenants request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -508,9 +597,11 @@ module Google
                 gapic_version: ::Google::Cloud::Talent::V4::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
 

data/lib/google/cloud/talent/v4/tenant_service_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/talent/v4/tenant_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -11,6 +9,8 @@ require 'google/cloud/talent/v4/common_pb'
 require 'google/cloud/talent/v4/tenant_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/talent/v4/tenant_service.proto", :syntax => :proto3) do
     add_message "google.cloud.talent.v4.CreateTenantRequest" do

data/lib/google/cloud/talent/v4/tenant_service_services_pb.rb

@@ -27,7 +27,7 @@ module Google
           # A service that handles tenant management, including CRUD and enumeration.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

data/lib/google/cloud/talent/v4/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Talent
       module V4
-        VERSION = "0.4.3"
+        VERSION = "0.6.2"
       end
     end
   end

data/proto_docs/google/cloud/talent/v4/common.rb

@@ -865,7 +865,8 @@ module Google
           SIMPLE_FORMATTING_ONLY = 2
         end
 
-        # Method for commute.
+        # Method for commute. Walking, biking and wheelchair accessible transit is
+        # still in the Preview stage.
         module CommuteMethod
           # Commute method isn't specified.
           COMMUTE_METHOD_UNSPECIFIED = 0
@@ -876,6 +877,16 @@ module Google
           # Commute time is calculated based on public transit including bus, metro,
           # subway, and so on.
           TRANSIT = 2
+
+          # Commute time is calculated based on walking time.
+          WALKING = 3
+
+          # Commute time is calculated based on biking time.
+          CYCLING = 4
+
+          # Commute time is calculated based on public transit that is wheelchair
+          # accessible.
+          TRANSIT_ACCESSIBLE = 5
         end
       end
     end

data/proto_docs/google/cloud/talent/v4/filters.rb

@@ -124,7 +124,7 @@ module Google
         #     Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
         #     nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 100
         #     comparisons or functions are allowed in the expression. The expression
-        #     must be < 6000 bytes in length.
+        #     must be < 10000 bytes in length.
         #
         #     Sample Query:
         #     `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
@@ -180,16 +180,20 @@ module Google
         #     The address name, such as "Mountain View" or "Bay Area".
         # @!attribute [rw] region_code
         #   @return [::String]
-        #     CLDR region code of the country/region of the address. This is used
-        #     to address ambiguity of the user-input location, for example, "Liverpool"
-        #     against "Liverpool, NY, US" or "Liverpool, UK".
+        #     CLDR region code of the country/region. This field may be used in two ways:
         #
-        #     Set this field to bias location resolution toward a specific country
-        #     or territory. If this field is not set, application behavior is biased
-        #     toward the United States by default.
+        #     1) If telecommute preference is not set, this field is used address
+        #     ambiguity of the user-input address. For example, "Liverpool" may refer to
+        #     "Liverpool, NY, US" or "Liverpool, UK". This region code biases the
+        #     address resolution toward a specific country or territory. If this field is
+        #     not set, address resolution is biased toward the United States by default.
+        #
+        #     2) If telecommute preference is set to TELECOMMUTE_ALLOWED, the
+        #     telecommute location filter will be limited to the region specified in this
+        #     field. If this field is not set, the telecommute job locations will not be
         #
         #     See
-        #     https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
+        #     https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/territory_information.html
         #     for details. Example: "CH" for Switzerland.
         # @!attribute [rw] lat_lng
         #   @return [::Google::Type::LatLng]

data/proto_docs/google/cloud/talent/v4/job.rb

@@ -88,6 +88,15 @@ module Google
         #     suggested to group the locations that close to each other in the same job
         #     for better search experience.
         #
+        #     Jobs with multiple addresses must have their addresses with the same
+        #     [LocationType][] to allow location filtering to work properly. (For
+        #     example, a Job with addresses "1600 Amphitheatre Parkway, Mountain View,
+        #     CA, USA" and "London, UK" may not have location filters applied correctly
+        #     at search time since the first is a [LocationType.STREET_ADDRESS][] and the
+        #     second is a [LocationType.LOCALITY][].) If a job needs to have multiple
+        #     addresses, it is suggested to split it into multiple jobs with same
+        #     LocationTypes.
+        #
         #     The maximum number of allowed characters is 500.
         # @!attribute [rw] application_info
         #   @return [::Google::Cloud::Talent::V4::Job::ApplicationInfo]
@@ -105,7 +114,7 @@ module Google
         #     attributes that are not covered by the provided structured fields.
         #
         #     The keys of the map are strings up to 64 bytes and must match the
-        #     pattern: [a-zA-Z][a-zA-Z0-9_]*. For example, key0LikeThis or
+        #     pattern: `[a-zA-Z][a-zA-Z0-9_]*`. For example, key0LikeThis or
         #     KEY_1_LIKE_THIS.
         #
         #     At most 100 filterable and at most 100 unfilterable keys are supported.