Class: Google::Apis::JobsV3::SearchJobsRequest
- Inherits:
-
Object
- Object
- Google::Apis::JobsV3::SearchJobsRequest
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/jobs_v3/classes.rb,
generated/google/apis/jobs_v3/representations.rb,
generated/google/apis/jobs_v3/representations.rb
Overview
Input only.
The Request body of the SearchJobs
call.
Instance Attribute Summary collapse
-
#disable_keyword_match ⇒ Boolean
(also: #disable_keyword_match?)
Optional.
-
#diversification_level ⇒ String
Optional.
-
#enable_broadening ⇒ Boolean
(also: #enable_broadening?)
Optional.
-
#histogram_facets ⇒ Google::Apis::JobsV3::HistogramFacets
Input only.
-
#job_query ⇒ Google::Apis::JobsV3::JobQuery
Input only.
-
#job_view ⇒ String
Optional.
-
#offset ⇒ Fixnum
Optional.
-
#order_by ⇒ String
Optional.
-
#page_size ⇒ Fixnum
Optional.
-
#page_token ⇒ String
Optional.
-
#request_metadata ⇒ Google::Apis::JobsV3::RequestMetadata
Input only.
-
#require_precise_result_size ⇒ Boolean
(also: #require_precise_result_size?)
Optional.
-
#search_mode ⇒ String
Optional.
Instance Method Summary collapse
-
#initialize(**args) ⇒ SearchJobsRequest
constructor
A new instance of SearchJobsRequest.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Core::JsonObjectSupport
Methods included from Core::Hashable
Constructor Details
#initialize(**args) ⇒ SearchJobsRequest
Returns a new instance of SearchJobsRequest.
2585 2586 2587 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2585 def initialize(**args) update!(**args) end |
Instance Attribute Details
#disable_keyword_match ⇒ Boolean Also known as: disable_keyword_match?
Optional. Controls whether to disable exact keyword match on Job.job_title,
Job.description, Job.company_display_name, Job.locations,
Job.qualifications. When disable keyword match is turned off, a
keyword match returns jobs that do not match given category filters when
there are matching keywords. For example, the query "program manager," a
result is returned even if the job posting has the title "software
developer," which does not fall into "program manager" ontology, but does
have "program manager" appearing in its description.
For queries like "cloud" that does not contain title or
location specific ontology, jobs with "cloud" keyword matches are returned
regardless of this flag's value.
Please use Company.keyword_searchable_custom_fields or
Company.keyword_searchable_custom_attributes if company specific
globally matched custom field/attribute string values is needed. Enabling
keyword match improves recall of subsequent search requests.
Defaults to false.
Corresponds to the JSON property disableKeywordMatch
2456 2457 2458 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2456 def disable_keyword_match @disable_keyword_match end |
#diversification_level ⇒ String
Optional. Controls whether highly similar jobs are returned next to each other
in
the search results. Jobs are identified as highly similar based on
their titles, job categories, and locations. Highly similar results are
clustered so that only one representative job of the cluster is
displayed to the job seeker higher up in the results, with the other jobs
being displayed lower down in the results.
Defaults to DiversificationLevel.SIMPLE if no value
is specified.
Corresponds to the JSON property diversificationLevel
2470 2471 2472 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2470 def diversification_level @diversification_level end |
#enable_broadening ⇒ Boolean Also known as: enable_broadening?
Optional. Controls whether to broaden the search when it produces sparse
results.
Broadened queries append results to the end of the matching results
list.
Defaults to false.
Corresponds to the JSON property enableBroadening
2479 2480 2481 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2479 def enable_broadening @enable_broadening end |
#histogram_facets ⇒ Google::Apis::JobsV3::HistogramFacets
Input only.
Histogram facets to be specified in SearchJobsRequest.
Corresponds to the JSON property histogramFacets
2486 2487 2488 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2486 def histogram_facets @histogram_facets end |
#job_query ⇒ Google::Apis::JobsV3::JobQuery
Input only.
The query required to perform a search query.
Corresponds to the JSON property jobQuery
2492 2493 2494 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2492 def job_query @job_query end |
#job_view ⇒ String
Optional. The desired job attributes returned for jobs in the
search response. Defaults to JobView.SMALL if no value is specified.
Corresponds to the JSON property jobView
2498 2499 2500 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2498 def job_view @job_view end |
#offset ⇒ Fixnum
Optional. An integer that specifies the current offset (that is, starting
result
location, amongst the jobs deemed by the API as relevant) in search
results. This field is only considered if page_token is unset.
The maximum allowed value is 5000. Otherwise an error is thrown.
For example, 0 means to return results starting from the first matching
job, and 10 means to return from the 11th job. This can be used for
pagination, (for example, pageSize = 10 and offset = 10 means to return
from the second page).
Corresponds to the JSON property offset
2511 2512 2513 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2511 def offset @offset end |
#order_by ⇒ String
Optional. The criteria determining how search results are sorted. Default is "relevance desc". Supported options are:
"relevance desc"
: By relevance descending, as determined by the API algorithms. Relevance thresholding of query results is only available with this ordering."posting_publish_time desc"
: By Job.posting_publish_time descending."posting_update_time desc"
: By Job.posting_update_time descending."title"
: By Job.title ascending."title desc"
: By Job.title descending."annualized_base_compensation"
: By job's CompensationInfo.annualized_base_compensation_range ascending. Jobs whose annualized base compensation is unspecified are put at the end of search results."annualized_base_compensation desc"
: By job's CompensationInfo.annualized_base_compensation_range descending. Jobs whose annualized base compensation is unspecified are put at the end of search results."annualized_total_compensation"
: By job's CompensationInfo.annualized_total_compensation_range ascending. Jobs whose annualized base compensation is unspecified are put at the end of search results."annualized_total_compensation desc"
: By job's CompensationInfo.annualized_total_compensation_range descending. Jobs whose annualized base compensation is unspecified are put at the end of search results. Corresponds to the JSON propertyorderBy
2543 2544 2545 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2543 def order_by @order_by end |
#page_size ⇒ Fixnum
Optional. A limit on the number of jobs returned in the search results.
Increasing this value above the default value of 10 can increase search
response time. The value can be between 1 and 100.
Corresponds to the JSON property pageSize
2550 2551 2552 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2550 def page_size @page_size end |
#page_token ⇒ String
Optional. The token specifying the current offset within
search results. See SearchJobsResponse.next_page_token for
an explanation of how to obtain the next set of query results.
Corresponds to the JSON property pageToken
2557 2558 2559 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2557 def page_token @page_token end |
#request_metadata ⇒ Google::Apis::JobsV3::RequestMetadata
Input only.
Meta information related to the job searcher or entity
conducting the job search. This information is used to improve the
performance of the service.
Corresponds to the JSON property requestMetadata
2565 2566 2567 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2565 def @request_metadata end |
#require_precise_result_size ⇒ Boolean Also known as: require_precise_result_size?
Optional. 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.
Corresponds to the JSON property requirePreciseResultSize
2576 2577 2578 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2576 def require_precise_result_size @require_precise_result_size end |
#search_mode ⇒ String
Optional. Mode of a search.
Defaults to SearchMode.JOB_SEARCH.
Corresponds to the JSON property searchMode
2583 2584 2585 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2583 def search_mode @search_mode end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 |
# File 'generated/google/apis/jobs_v3/classes.rb', line 2590 def update!(**args) @disable_keyword_match = args[:disable_keyword_match] if args.key?(:disable_keyword_match) @diversification_level = args[:diversification_level] if args.key?(:diversification_level) @enable_broadening = args[:enable_broadening] if args.key?(:enable_broadening) @histogram_facets = args[:histogram_facets] if args.key?(:histogram_facets) @job_query = args[:job_query] if args.key?(:job_query) @job_view = args[:job_view] if args.key?(:job_view) @offset = args[:offset] if args.key?(:offset) @order_by = args[:order_by] if args.key?(:order_by) @page_size = args[:page_size] if args.key?(:page_size) @page_token = args[:page_token] if args.key?(:page_token) @request_metadata = args[:request_metadata] if args.key?(:request_metadata) @require_precise_result_size = args[:require_precise_result_size] if args.key?(:require_precise_result_size) @search_mode = args[:search_mode] if args.key?(:search_mode) end |