google-cloud-talent 0.3.0 → 0.4.0

data/lib/google/cloud/talent/v4beta1/job_service_client_config.json

@@ -59,6 +59,16 @@
           "timeout_millis": 30000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
+        },
+        "BatchCreateJobs": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "BatchUpdateJobs": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -5,6 +5,8 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/cloud/talent/v4beta1/batch_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/cloud/talent/v4beta1/filters_pb'
 require 'google/cloud/talent/v4beta1/histogram_pb'
@@ -106,6 +108,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :job_location, :message, 1, "google.cloud.talent.v4beta1.Location"
     optional :travel_duration, :message, 2, "google.protobuf.Duration"
   end
+  add_message "google.cloud.talent.v4beta1.BatchCreateJobsRequest" do
+    optional :parent, :string, 1
+    repeated :jobs, :message, 2, "google.cloud.talent.v4beta1.Job"
+  end
+  add_message "google.cloud.talent.v4beta1.BatchUpdateJobsRequest" do
+    optional :parent, :string, 1
+    repeated :jobs, :message, 2, "google.cloud.talent.v4beta1.Job"
+    optional :update_mask, :message, 3, "google.protobuf.FieldMask"
+  end
   add_enum "google.cloud.talent.v4beta1.JobView" do
     value :JOB_VIEW_UNSPECIFIED, 0
     value :JOB_VIEW_ID_ONLY, 1
@@ -134,6 +145,8 @@ module Google
         SearchJobsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.SearchJobsResponse").msgclass
         SearchJobsResponse::MatchingJob = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob").msgclass
         SearchJobsResponse::CommuteInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo").msgclass
+        BatchCreateJobsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.BatchCreateJobsRequest").msgclass
+        BatchUpdateJobsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.BatchUpdateJobsRequest").msgclass
         JobView = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.JobView").enummodule
       end
     end

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

@@ -57,23 +57,31 @@ module Google
             rpc :ListJobs, ListJobsRequest, ListJobsResponse
             # Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter.
             rpc :BatchDeleteJobs, BatchDeleteJobsRequest, Google::Protobuf::Empty
-            # Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+            # Searches for jobs using the provided
+            # [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
             #
-            # This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
-            # present in the database, and only returns jobs that the caller has
-            # permission to search against.
+            # This call constrains the
+            # [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
+            # the database, and only returns jobs that the caller has permission to
+            # search against.
             rpc :SearchJobs, SearchJobsRequest, SearchJobsResponse
-            # Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+            # Searches for jobs using the provided
+            # [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
             #
             # This API call is intended for the use case of targeting passive job
             # seekers (for example, job seekers who have signed up to receive email
             # alerts about potential job opportunities), and has different algorithmic
             # adjustments that are targeted to passive job seekers.
             #
-            # This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
-            # present in the database, and only returns jobs the caller has
-            # permission to search against.
+            # This call constrains the
+            # [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
+            # the database, and only returns jobs the caller has permission to search
+            # against.
             rpc :SearchJobsForAlert, SearchJobsRequest, SearchJobsResponse
+            # Begins executing a batch create jobs operation.
+            rpc :BatchCreateJobs, BatchCreateJobsRequest, Google::Longrunning::Operation
+            # Begins executing a batch update jobs operation.
+            rpc :BatchUpdateJobs, BatchUpdateJobsRequest, Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/talent/v4beta1/profile_service_client.rb

@@ -27,6 +27,7 @@ require "google/gax"
 
 require "google/cloud/talent/v4beta1/profile_service_pb"
 require "google/cloud/talent/v4beta1/credentials"
+require "google/cloud/talent/version"
 
 module Google
   module Cloud
@@ -60,7 +61,7 @@ module Google
             "search_profiles" => Google::Gax::PageDescriptor.new(
               "page_token",
               "next_page_token",
-              "histogram_query_results")
+              "summarized_profiles")
           }.freeze
 
           private_constant :PAGE_DESCRIPTORS
@@ -135,6 +136,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -144,6 +149,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -171,7 +178,7 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
-            package_version = Gem.loaded_specs['google-cloud-talent'].version.version
+            package_version = Google::Cloud::Talent::VERSION
 
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
@@ -198,8 +205,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @profile_service_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -267,9 +274,8 @@ module Google
           # Lists profiles by filter. The order is unspecified.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The resource name of the tenant under which the job is created.
+          #   Required. The resource name of the tenant under which the profile is
+          #   created.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenants/foo".
@@ -280,10 +286,8 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param read_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional.
-          #
-          #   A field mask to specify the profile fields to be listed in response.
-          #   All fields are listed if it is unset.
+          #   Optional. A field mask to specify the profile fields to be listed in
+          #   response. All fields are listed if it is unset.
           #
           #   Valid values are:
           #
@@ -339,16 +343,12 @@ module Google
           # Creates and returns a new profile.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The name of the tenant this profile belongs to.
+          #   Required. The name of the tenant this profile belongs to.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenants/foo".
           # @param profile [Google::Cloud::Talent::V4beta1::Profile | Hash]
-          #   Required.
-          #
-          #   The profile to be created.
+          #   Required. The profile to be created.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Profile`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -385,9 +385,7 @@ module Google
           # Gets the specified profile.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   Resource name of the profile to get.
+          #   Required. Resource name of the profile to get.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
@@ -421,43 +419,39 @@ module Google
           # Updates the specified profile and returns the updated result.
           #
           # @param profile [Google::Cloud::Talent::V4beta1::Profile | Hash]
-          #   Required.
-          #
-          #   Profile to be updated.
+          #   Required. Profile to be updated.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Profile`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional.
-          #
-          #   A field mask to specify the profile fields to update.
+          #   Optional. A field mask to specify the profile fields to update.
           #
           #   A full update is performed if it is unset.
           #
           #   Valid values are:
           #
-          #   * externalId
+          #   * external_id
           #   * source
           #   * uri
-          #   * isHirable
-          #   * createTime
-          #   * updateTime
-          #   * resumeHrxml
-          #   * personNames
+          #   * is_hirable
+          #   * create_time
+          #   * update_time
+          #   * resume
+          #   * person_names
           #   * addresses
-          #   * emailAddresses
-          #   * phoneNumbers
-          #   * personalUris
-          #   * additionalContactInfo
-          #   * employmentRecords
-          #   * educationRecords
+          #   * email_addresses
+          #   * phone_numbers
+          #   * personal_uris
+          #   * additional_contact_info
+          #   * employment_records
+          #   * education_records
           #   * skills
           #   * projects
           #   * publications
           #   * patents
           #   * certifications
-          #   * recruitingNotes
-          #   * customAttributes
-          #   * groupId
+          #   * recruiting_notes
+          #   * custom_attributes
+          #   * group_id
           #   A hash of the same form as `Google::Protobuf::FieldMask`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -495,9 +489,7 @@ module Google
           # associated.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   Resource name of the profile to be deleted.
+          #   Required. Resource name of the profile to be deleted.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
@@ -533,27 +525,24 @@ module Google
           # For example, search by raw queries "software engineer in Mountain View" or
           # search by structured filters (location filter, education filter, etc.).
           #
-          # See {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest} for more information.
+          # See
+          # {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}
+          # for more information.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   The resource name of the tenant to search within.
+          #   Required. The resource name of the tenant to search within.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenants/foo".
           # @param request_metadata [Google::Cloud::Talent::V4beta1::RequestMetadata | Hash]
-          #   Required.
-          #
-          #   The meta information collected about the profile search user. This is used
-          #   to improve the search quality of the service. These values are provided by
-          #   users, and must be precise and consistent.
+          #   Required. The meta information collected about the profile search user.
+          #   This is used to improve the search quality of the service. These values are
+          #   provided by users, and must be precise and consistent.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::RequestMetadata`
           #   can also be provided.
           # @param profile_query [Google::Cloud::Talent::V4beta1::ProfileQuery | Hash]
-          #   Optional.
-          #
-          #   Search query to execute. See {Google::Cloud::Talent::V4beta1::ProfileQuery ProfileQuery} for more details.
+          #   Optional. Search query to execute. See
+          #   {Google::Cloud::Talent::V4beta1::ProfileQuery ProfileQuery} for more details.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::ProfileQuery`
           #   can also be provided.
           # @param page_size [Integer]
@@ -563,10 +552,10 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param offset [Integer]
-          #   Optional.
-          #
-          #   An integer that specifies the current offset (that is, starting result) in
-          #   search results. This field is only considered if {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#page_token page_token} is unset.
+          #   Optional. An integer that specifies the current offset (that is, starting
+          #   result) in search results. This field is only considered if
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#page_token page_token}
+          #   is unset.
           #
           #   The maximum allowed value is 5000. Otherwise an error is thrown.
           #
@@ -574,45 +563,48 @@ module Google
           #   search from the 11th profile. This can be used for pagination, for example
           #   pageSize = 10 and offset = 10 means to search from the second page.
           # @param disable_spell_check [true, false]
-          #   Optional.
-          #
-          #   This flag controls the spell-check feature. If `false`, the
+          #   Optional. This flag controls the spell-check feature. If `false`, the
           #   service attempts to correct a misspelled query.
           #
           #   For example, "enginee" is corrected to "engineer".
           # @param order_by [String]
-          #   Optional.
-          #
-          #   The criteria that determines how search results are sorted.
+          #   Optional. The criteria that determines how search results are sorted.
           #   Defaults is "relevance desc" if no value is specified.
           #
           #   Supported options are:
           #
           #   * "relevance desc": By descending relevance, as determined by the API
           #     algorithms.
-          #   * "update_date desc": Sort by {Profile#update_date} in descending order
+          #   * "update_time desc": Sort by
+          #     {Google::Cloud::Talent::V4beta1::Profile#update_time Profile#update_time} in
+          #     descending order
           #     (recently updated profiles first).
-          #   * "create_date desc": Sort by {Profile#create_date} in descending order
+          #   * "create_time desc": Sort by
+          #     {Google::Cloud::Talent::V4beta1::Profile#create_time Profile#create_time} in
+          #     descending order
           #     (recently created profiles first).
-          #   * "first_name": Sort by {PersonStrcuturedName#given_name} in ascending
-          #     order.
-          #   * "first_name desc": Sort by {PersonStrcuturedName#given_name} in
-          #     descending order.
-          #   * "last_name": Sort by {PersonStrcuturedName#family_name} in ascending
-          #     order.
-          #   * "last_name desc": Sort by {PersonStrcuturedName#family_name} in
+          #   * "first_name": Sort by
+          #     {Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName#given_name PersonName::PersonStructuredName#given_name}
+          #     in
+          #     ascending order.
+          #   * "first_name desc": Sort by
+          #     {Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName#given_name PersonName::PersonStructuredName#given_name}
+          #     in descending order.
+          #   * "last_name": Sort by
+          #     {Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName#family_name PersonName::PersonStructuredName#family_name}
+          #     in
           #     ascending order.
+          #   * "last_name desc": Sort by
+          #     {Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName#family_name PersonName::PersonStructuredName#family_name}
+          #     in ascending order.
           # @param case_sensitive_sort [true, false]
-          #   Optional.
-          #
-          #   When sort by field is based on alphabetical order, sort values case
-          #   sensitively (based on ASCII) when the value is set to true. Default value
-          #   is case in-sensitive sort (false).
+          #   Optional. When sort by field is based on alphabetical order, sort values
+          #   case sensitively (based on ASCII) when the value is set to true. Default
+          #   value is case in-sensitive sort (false).
           # @param histogram_queries [Array<Google::Cloud::Talent::V4beta1::HistogramQuery | Hash>]
-          #   Optional.
-          #
-          #   A list of expressions specifies histogram requests against matching
-          #   profiles for {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
+          #   Optional. A list of expressions specifies histogram requests against
+          #   matching profiles for
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
           #
           #   The expression syntax looks like a function definition with optional
           #   parameters.
@@ -665,13 +657,19 @@ module Google
           #   * experience_in_months: experience in months. 0 means 0 month to 1 month
           #     (exclusive).
           #   * application_date: The application date specifies application start dates.
-          #     See {Google::Cloud::Talent::V4beta1::ApplicationDateFilter ApplicationDateFilter} for more details.
+          #     See
+          #     {Google::Cloud::Talent::V4beta1::ApplicationDateFilter ApplicationDateFilter}
+          #     for more details.
           #   * application_outcome_notes: The application outcome reason specifies the
           #     reasons behind the outcome of the job application.
-          #     See {Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter ApplicationOutcomeNotesFilter} for more details.
+          #     See
+          #     {Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter ApplicationOutcomeNotesFilter}
+          #     for more details.
           #   * application_job_title: The application job title specifies the job
           #     applied for in the application.
-          #     See {Google::Cloud::Talent::V4beta1::ApplicationJobFilter ApplicationJobFilter} for more details.
+          #     See
+          #     {Google::Cloud::Talent::V4beta1::ApplicationJobFilter ApplicationJobFilter}
+          #     for more details.
           #   * hirable_status: Hirable status specifies the profile's hirable status.
           #   * string_custom_attribute: String custom attributes. Values can be accessed
           #     via square bracket notation like string_custom_attribute["key1"].
@@ -688,14 +686,41 @@ module Google
           #     [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::HistogramQuery`
           #   can also be provided.
+          # @param result_set_id [String]
+          #   Optional. An id that uniquely identifies the result set of a
+          #   {SearchProfiles} call.  The id should be retrieved from the
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}
+          #   message returned from a previous invocation of {SearchProfiles}.
+          #
+          #   A result set is an ordered list of search results.
+          #
+          #   If this field is not set, a new result set is computed based on the
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#profile_query profile_query}.
+          #   A new
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#result_set_id result_set_id}
+          #   is returned as a handle to access this result set.
+          #
+          #   If this field is set, the service will ignore the resource and
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#profile_query profile_query}
+          #   values, and simply retrieve a page of results from the corresponding result
+          #   set.  In this case, one and only one of [page_token] or [offset] must be
+          #   set.
+          #
+          #   A typical use case is to invoke
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}
+          #   without this field, then use the resulting
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#result_set_id result_set_id}
+          #   in
+          #   {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}
+          #   to page through the results.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::Talent::V4beta1::HistogramQueryResult>]
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::Talent::V4beta1::SummarizedProfile>]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<Google::Cloud::Talent::V4beta1::HistogramQueryResult>]
-          #   An enumerable of Google::Cloud::Talent::V4beta1::HistogramQueryResult instances.
+          # @return [Google::Gax::PagedEnumerable<Google::Cloud::Talent::V4beta1::SummarizedProfile>]
+          #   An enumerable of Google::Cloud::Talent::V4beta1::SummarizedProfile instances.
           #   See Google::Gax::PagedEnumerable documentation for other
           #   operations such as per-page iteration or access to the response
           #   object.
@@ -732,6 +757,7 @@ module Google
               order_by: nil,
               case_sensitive_sort: nil,
               histogram_queries: nil,
+              result_set_id: nil,
               options: nil,
               &block
             req = {
@@ -743,7 +769,8 @@ module Google
               disable_spell_check: disable_spell_check,
               order_by: order_by,
               case_sensitive_sort: case_sensitive_sort,
-              histogram_queries: histogram_queries
+              histogram_queries: histogram_queries,
+              result_set_id: result_set_id
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Talent::V4beta1::SearchProfilesRequest)
             @search_profiles.call(req, options, &block)