google-cloud-talent-v4beta1 0.4.6 → 0.5.0

data/proto_docs/google/cloud/talent/v4beta1/job_service.rb

@@ -129,11 +129,14 @@ module Google
         #
         #     The fields eligible for filtering are:
         #
-        #     * `companyName` (Required)
+        #     * `companyName`
         #     * `requisitionId`
         #     * `status` Available values: OPEN, EXPIRED, ALL. Defaults to
         #     OPEN if no value is specified.
         #
+        #     At least one of `companyName` and `requisitionId` must present or an
+        #     INVALID_ARGUMENT error is thrown.
+        #
         #     Sample Query:
         #
         #     * companyName = "projects/foo/tenants/bar/companies/baz"
@@ -141,6 +144,8 @@ module Google
         #     requisitionId = "req-1"
         #     * companyName = "projects/foo/tenants/bar/companies/baz" AND
         #     status = "EXPIRED"
+        #     * requisitionId = "req-1"
+        #     * requisitionId = "req-1" AND status = "EXPIRED"
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The starting point of a query result.
@@ -211,15 +216,7 @@ module Google
         #     Defaults to false.
         # @!attribute [rw] require_precise_result_size
         #   @return [::Boolean]
-        #     Controls if the search job request requires the return of a precise
-        #     count of the first 300 results. Setting this to `true` ensures
-        #     consistency in the number of results per page. Best practice is to set this
-        #     value to true if a client allows users to jump directly to a
-        #     non-sequential search results page.
-        #
-        #     Enabling this flag may adversely impact performance.
-        #
-        #     Defaults to false.
+        #     This field is deprecated.
         # @!attribute [rw] histogram_queries
         #   @return [::Array<::Google::Cloud::Talent::V4beta1::HistogramQuery>]
         #     An expression specifies a histogram request against matching jobs.
@@ -233,6 +230,8 @@ module Google
         #     * `count(numeric_histogram_facet, list of buckets)`: Count the number of
         #     matching entities within each bucket.
         #
+        #     A maximum of 200 histogram buckets are supported.
+        #
         #     Data types:
         #
         #     * Histogram facet: facet names with format `[a-zA-Z][a-zA-Z0-9_]+`.
@@ -259,6 +258,9 @@ module Google
         #       "FULL_TIME", "PART_TIME".
         #     * company_size: histogram by {::Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
         #     "MEDIUM", "BIG".
+        #     * publish_time_in_day: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
+        #       in days.
+        #       Must specify list of numeric buckets in spec.
         #     * publish_time_in_month: histogram by the {::Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job.posting_publish_time}
         #       in months.
         #       Must specify list of numeric buckets in spec.
@@ -312,7 +314,7 @@ module Google
         #     bucket(100000, MAX)])`
         #     * `count(string_custom_attribute["some-string-custom-attribute"])`
         #     * `count(numeric_custom_attribute["some-numeric-custom-attribute"],
-        #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`
+        #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])`
         # @!attribute [rw] job_view
         #   @return [::Google::Cloud::Talent::V4beta1::JobView]
         #     The desired job attributes returned for jobs in the search response.
@@ -408,6 +410,14 @@ module Google
         #     score (determined by API algorithm).
         # @!attribute [rw] disable_keyword_match
         #   @return [::Boolean]
+        #     This field is deprecated. Please use
+        #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} going forward.
+        #
+        #     To migrate, disable_keyword_match set to false maps to
+        #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL}, and disable_keyword_match set to
+        #     true maps to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_DISABLED KeywordMatchMode.KEYWORD_MATCH_DISABLED}. If
+        #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#keyword_match_mode SearchJobsRequest.keyword_match_mode} is set, this field is ignored.
+        #
         #     Controls whether to disable exact keyword match on {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
         #     {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
         #     {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}. When disable keyword match is turned off, a
@@ -427,6 +437,12 @@ module Google
         #     requests.
         #
         #     Defaults to false.
+        # @!attribute [rw] keyword_match_mode
+        #   @return [::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode]
+        #     Controls what keyword match options to use.
+        #
+        #     Defaults to {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} if no value
+        #     is specified.
         class SearchJobsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -453,7 +469,7 @@ module Google
           #     integer/double value or an expression that can be evaluated to a number.
           #
           #     Parenthesis are supported to adjust calculation precedence. The
-          #     expression must be < 100 characters in length.
+          #     expression must be < 200 characters in length.
           #
           #     The expression is considered invalid for a job if the expression
           #     references custom attributes that are not populated on the job or if the
@@ -545,6 +561,40 @@ module Google
             # results are returned.
             SIMPLE = 2
           end
+
+          # Controls what keyword matching behavior the search has. When keyword
+          # matching is enabled, a keyword match returns jobs that may not match given
+          # category filters when there are matching keywords. For example, for the
+          # query "program manager" with KeywordMatchMode set to KEYWORD_MATCH_ALL, a
+          # job posting with the title "software developer," which doesn't fall into
+          # "program manager" ontology, and "program manager" appearing in its
+          # description will be surfaced.
+          #
+          # For queries like "cloud" that don't contain title or
+          # location specific ontology, jobs with "cloud" keyword matches are returned
+          # regardless of this enum's value.
+          #
+          # Use {::Google::Cloud::Talent::V4beta1::Company#keyword_searchable_job_custom_attributes Company.keyword_searchable_job_custom_attributes} if
+          # company-specific globally matched custom field/attribute string values are
+          # needed. Enabling keyword match improves recall of subsequent search
+          # requests.
+          module KeywordMatchMode
+            # The keyword match option isn't specified. Defaults to
+            # {::Google::Cloud::Talent::V4beta1::SearchJobsRequest::KeywordMatchMode::KEYWORD_MATCH_ALL KeywordMatchMode.KEYWORD_MATCH_ALL} behavior.
+            KEYWORD_MATCH_MODE_UNSPECIFIED = 0
+
+            # Disables keyword matching.
+            KEYWORD_MATCH_DISABLED = 1
+
+            # Enable keyword matching over {::Google::Cloud::Talent::V4beta1::Job#title Job.title},
+            # {::Google::Cloud::Talent::V4beta1::Job#description Job.description}, {::Google::Cloud::Talent::V4beta1::Job#company_display_name Job.company_display_name}, {::Google::Cloud::Talent::V4beta1::Job#addresses Job.addresses},
+            # {::Google::Cloud::Talent::V4beta1::Job#qualifications Job.qualifications}, and keyword searchable {::Google::Cloud::Talent::V4beta1::Job#custom_attributes Job.custom_attributes}
+            # fields.
+            KEYWORD_MATCH_ALL = 2
+
+            # Only enable keyword matching over {::Google::Cloud::Talent::V4beta1::Job#title Job.title}.
+            KEYWORD_MATCH_TITLE_ONLY = 3
+          end
         end
 
         # Response for SearchJob method.
@@ -569,12 +619,10 @@ module Google
         #     An estimation of the number of jobs that match the specified query.
         #
         #     This number isn't guaranteed to be accurate. For accurate results,
-        #     see {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#require_precise_result_size SearchJobsRequest.require_precise_result_size}.
+        #     see {::Google::Cloud::Talent::V4beta1::SearchJobsResponse#total_size SearchJobsResponse.total_size}.
         # @!attribute [rw] total_size
         #   @return [::Integer]
-        #     The precise result count, which is available only if the client set
-        #     {::Google::Cloud::Talent::V4beta1::SearchJobsRequest#require_precise_result_size SearchJobsRequest.require_precise_result_size} to `true`, or if the
-        #     response is the last page of results. Otherwise, the value is `-1`.
+        #     The precise result count with limit 100,000.
         # @!attribute [rw] metadata
         #   @return [::Google::Cloud::Talent::V4beta1::ResponseMetadata]
         #     Additional information for the API invocation, such as the request

data/proto_docs/google/cloud/talent/v4beta1/tenant.rb

@@ -47,7 +47,7 @@ module Google
         #     Defaults behavior is {::Google::Cloud::Talent::V4beta1::Tenant::DataUsageType::ISOLATED DataUsageType.ISOLATED} if it's unset.
         # @!attribute [rw] keyword_searchable_profile_custom_attributes
         #   @return [::Array<::String>]
-        #     A list of keys of filterable {::Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile.custom_attributes}, whose
+        #     A list of keys of filterable [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes], whose
         #     corresponding `string_values` are used in keyword searches. Profiles with
         #     `string_values` under these specified field keys are returned if any
         #     of the values match the search keyword. Custom field values with

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/type/timeofday.rb

@@ -21,7 +21,7 @@ module Google
   module Type
     # Represents a time of day. The date and time zone are either not significant
     # or are specified elsewhere. An API may choose to allow leap seconds. Related
-    # types are {::Google::Type::Date google.type.Date} and
+    # types are [google.type.Date][google.type.Date] and
     # `google.protobuf.Timestamp`.
     # @!attribute [rw] hours
     #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-talent-v4beta1
 version: !ruby/object:Gem::Version
-  version: 0.4.6
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -174,13 +174,6 @@ files:
 - README.md
 - lib/google-cloud-talent-v4beta1.rb
 - lib/google/cloud/talent/v4beta1.rb
-- lib/google/cloud/talent/v4beta1/application_pb.rb
-- lib/google/cloud/talent/v4beta1/application_service.rb
-- lib/google/cloud/talent/v4beta1/application_service/client.rb
-- lib/google/cloud/talent/v4beta1/application_service/credentials.rb
-- lib/google/cloud/talent/v4beta1/application_service/paths.rb
-- lib/google/cloud/talent/v4beta1/application_service_pb.rb
-- lib/google/cloud/talent/v4beta1/application_service_services_pb.rb
 - lib/google/cloud/talent/v4beta1/batch_pb.rb
 - lib/google/cloud/talent/v4beta1/common_pb.rb
 - lib/google/cloud/talent/v4beta1/company_pb.rb
@@ -213,13 +206,6 @@ files:
 - lib/google/cloud/talent/v4beta1/job_service/paths.rb
 - lib/google/cloud/talent/v4beta1/job_service_pb.rb
 - lib/google/cloud/talent/v4beta1/job_service_services_pb.rb
-- lib/google/cloud/talent/v4beta1/profile_pb.rb
-- lib/google/cloud/talent/v4beta1/profile_service.rb
-- lib/google/cloud/talent/v4beta1/profile_service/client.rb
-- lib/google/cloud/talent/v4beta1/profile_service/credentials.rb
-- lib/google/cloud/talent/v4beta1/profile_service/paths.rb
-- lib/google/cloud/talent/v4beta1/profile_service_pb.rb
-- lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb
 - lib/google/cloud/talent/v4beta1/tenant_pb.rb
 - lib/google/cloud/talent/v4beta1/tenant_service.rb
 - lib/google/cloud/talent/v4beta1/tenant_service/client.rb
@@ -231,8 +217,6 @@ files:
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
-- proto_docs/google/cloud/talent/v4beta1/application.rb
-- proto_docs/google/cloud/talent/v4beta1/application_service.rb
 - proto_docs/google/cloud/talent/v4beta1/common.rb
 - proto_docs/google/cloud/talent/v4beta1/company.rb
 - proto_docs/google/cloud/talent/v4beta1/company_service.rb
@@ -243,8 +227,6 @@ files:
 - proto_docs/google/cloud/talent/v4beta1/histogram.rb
 - proto_docs/google/cloud/talent/v4beta1/job.rb
 - proto_docs/google/cloud/talent/v4beta1/job_service.rb
-- proto_docs/google/cloud/talent/v4beta1/profile.rb
-- proto_docs/google/cloud/talent/v4beta1/profile_service.rb
 - proto_docs/google/cloud/talent/v4beta1/tenant.rb
 - proto_docs/google/cloud/talent/v4beta1/tenant_service.rb
 - proto_docs/google/longrunning/operations.rb
@@ -255,7 +237,6 @@ files:
 - proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/protobuf/wrappers.rb
 - proto_docs/google/rpc/status.rb
-- proto_docs/google/type/date.rb
 - proto_docs/google/type/latlng.rb
 - proto_docs/google/type/money.rb
 - proto_docs/google/type/postal_address.rb
@@ -279,7 +260,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Talent Solution V4beta1 API

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

@@ -1,64 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/cloud/talent/v4beta1/application.proto
-
-require 'google/api/annotations_pb'
-require 'google/api/field_behavior_pb'
-require 'google/api/resource_pb'
-require 'google/cloud/talent/v4beta1/common_pb'
-require 'google/protobuf/timestamp_pb'
-require 'google/protobuf/wrappers_pb'
-require 'google/type/date_pb'
-require 'google/protobuf'
-
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/cloud/talent/v4beta1/application.proto", :syntax => :proto3) do
-    add_message "google.cloud.talent.v4beta1.Application" do
-      optional :name, :string, 1
-      optional :external_id, :string, 31
-      optional :profile, :string, 2
-      optional :job, :string, 4
-      optional :company, :string, 5
-      optional :application_date, :message, 7, "google.type.Date"
-      optional :stage, :enum, 11, "google.cloud.talent.v4beta1.Application.ApplicationStage"
-      optional :state, :enum, 13, "google.cloud.talent.v4beta1.Application.ApplicationState"
-      repeated :interviews, :message, 16, "google.cloud.talent.v4beta1.Interview"
-      optional :referral, :message, 18, "google.protobuf.BoolValue"
-      optional :create_time, :message, 19, "google.protobuf.Timestamp"
-      optional :update_time, :message, 20, "google.protobuf.Timestamp"
-      optional :outcome_notes, :string, 21
-      optional :outcome, :enum, 22, "google.cloud.talent.v4beta1.Outcome"
-      optional :is_match, :message, 28, "google.protobuf.BoolValue"
-      optional :job_title_snippet, :string, 29
-    end
-    add_enum "google.cloud.talent.v4beta1.Application.ApplicationState" do
-      value :APPLICATION_STATE_UNSPECIFIED, 0
-      value :IN_PROGRESS, 1
-      value :CANDIDATE_WITHDREW, 2
-      value :EMPLOYER_WITHDREW, 3
-      value :COMPLETED, 4
-      value :CLOSED, 5
-    end
-    add_enum "google.cloud.talent.v4beta1.Application.ApplicationStage" do
-      value :APPLICATION_STAGE_UNSPECIFIED, 0
-      value :NEW, 1
-      value :SCREEN, 2
-      value :HIRING_MANAGER_REVIEW, 3
-      value :INTERVIEW, 4
-      value :OFFER_EXTENDED, 5
-      value :OFFER_ACCEPTED, 6
-      value :STARTED, 7
-    end
-  end
-end
-
-module Google
-  module Cloud
-    module Talent
-      module V4beta1
-        Application = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Application").msgclass
-        Application::ApplicationState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Application.ApplicationState").enummodule
-        Application::ApplicationStage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Application.ApplicationStage").enummodule
-      end
-    end
-  end
-end