Cloud Talent Solution V4 API - Class Google::Cloud::Talent::V4::JobQuery (v1.1.0)

Reference documentation and code samples for the Cloud Talent Solution V4 API class Google::Cloud::Talent::V4::JobQuery.

The query required to perform a search query.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#commute_filter

def commute_filter() -> ::Google::Cloud::Talent::V4::CommuteFilter
Returns

#commute_filter=

def commute_filter=(value) -> ::Google::Cloud::Talent::V4::CommuteFilter
Parameter
Returns

#companies

def companies() -> ::Array<::String>
Returns
  • (::Array<::String>) — This filter specifies the company entities to search against.

    If a value isn't specified, jobs are searched for against all companies.

    If multiple values are specified, jobs are searched against the companies specified.

    The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For example, "projects/foo/tenants/bar/companies/baz".

    At most 20 company filters are allowed.

#companies=

def companies=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — This filter specifies the company entities to search against.

    If a value isn't specified, jobs are searched for against all companies.

    If multiple values are specified, jobs are searched against the companies specified.

    The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For example, "projects/foo/tenants/bar/companies/baz".

    At most 20 company filters are allowed.

Returns
  • (::Array<::String>) — This filter specifies the company entities to search against.

    If a value isn't specified, jobs are searched for against all companies.

    If multiple values are specified, jobs are searched against the companies specified.

    The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For example, "projects/foo/tenants/bar/companies/baz".

    At most 20 company filters are allowed.

#company_display_names

def company_display_names() -> ::Array<::String>
Returns
  • (::Array<::String>) — This filter specifies the company Company.display_name of the jobs to search against. The company name must match the value exactly.

    Alternatively, the value being searched for can be wrapped in different match operators. SUBSTRING_MATCH([value]) The company name must contain a case insensitive substring match of the value. Using this function may increase latency.

    Sample Value: SUBSTRING_MATCH(google)

    MULTI_WORD_TOKEN_MATCH([value]) The value will be treated as a multi word token and the company name must contain a case insensitive match of the value. Using this function may increase latency.

    Sample Value: MULTI_WORD_TOKEN_MATCH(google)

    If a value isn't specified, jobs within the search results are associated with any company.

    If multiple values are specified, jobs within the search results may be associated with any of the specified companies.

    At most 20 company display name filters are allowed.

#company_display_names=

def company_display_names=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — This filter specifies the company Company.display_name of the jobs to search against. The company name must match the value exactly.

    Alternatively, the value being searched for can be wrapped in different match operators. SUBSTRING_MATCH([value]) The company name must contain a case insensitive substring match of the value. Using this function may increase latency.

    Sample Value: SUBSTRING_MATCH(google)

    MULTI_WORD_TOKEN_MATCH([value]) The value will be treated as a multi word token and the company name must contain a case insensitive match of the value. Using this function may increase latency.

    Sample Value: MULTI_WORD_TOKEN_MATCH(google)

    If a value isn't specified, jobs within the search results are associated with any company.

    If multiple values are specified, jobs within the search results may be associated with any of the specified companies.

    At most 20 company display name filters are allowed.

Returns
  • (::Array<::String>) — This filter specifies the company Company.display_name of the jobs to search against. The company name must match the value exactly.

    Alternatively, the value being searched for can be wrapped in different match operators. SUBSTRING_MATCH([value]) The company name must contain a case insensitive substring match of the value. Using this function may increase latency.

    Sample Value: SUBSTRING_MATCH(google)

    MULTI_WORD_TOKEN_MATCH([value]) The value will be treated as a multi word token and the company name must contain a case insensitive match of the value. Using this function may increase latency.

    Sample Value: MULTI_WORD_TOKEN_MATCH(google)

    If a value isn't specified, jobs within the search results are associated with any company.

    If multiple values are specified, jobs within the search results may be associated with any of the specified companies.

    At most 20 company display name filters are allowed.

#compensation_filter

def compensation_filter() -> ::Google::Cloud::Talent::V4::CompensationFilter
Returns

#compensation_filter=

def compensation_filter=(value) -> ::Google::Cloud::Talent::V4::CompensationFilter
Parameter
Returns

#custom_attribute_filter

def custom_attribute_filter() -> ::String
Returns
  • (::String) — This filter specifies a structured syntax to match against the Job.custom_attributes marked as filterable.

    The syntax for this expression is a subset of SQL syntax.

    Supported operators are: =, !=, <, <=, >, and >= where the left of the operator is a custom field key and the right of the operator is a number or a quoted string. You must escape backslash (\) and quote (\") characters.

    Supported functions are LOWER([field_name]) to perform a case insensitive match and EMPTY([field_name]) to filter on the existence of a key.

    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 < 10000 bytes in length.

    Sample Query: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

#custom_attribute_filter=

def custom_attribute_filter=(value) -> ::String
Parameter
  • value (::String) — This filter specifies a structured syntax to match against the Job.custom_attributes marked as filterable.

    The syntax for this expression is a subset of SQL syntax.

    Supported operators are: =, !=, <, <=, >, and >= where the left of the operator is a custom field key and the right of the operator is a number or a quoted string. You must escape backslash (\) and quote (\") characters.

    Supported functions are LOWER([field_name]) to perform a case insensitive match and EMPTY([field_name]) to filter on the existence of a key.

    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 < 10000 bytes in length.

    Sample Query: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

Returns
  • (::String) — This filter specifies a structured syntax to match against the Job.custom_attributes marked as filterable.

    The syntax for this expression is a subset of SQL syntax.

    Supported operators are: =, !=, <, <=, >, and >= where the left of the operator is a custom field key and the right of the operator is a number or a quoted string. You must escape backslash (\) and quote (\") characters.

    Supported functions are LOWER([field_name]) to perform a case insensitive match and EMPTY([field_name]) to filter on the existence of a key.

    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 < 10000 bytes in length.

    Sample Query: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

#disable_spell_check

def disable_spell_check() -> ::Boolean
Returns
  • (::Boolean) — This flag controls the spell-check feature. If false, the service attempts to correct a misspelled query, for example, "enginee" is corrected to "engineer".

    Defaults to false: a spell check is performed.

#disable_spell_check=

def disable_spell_check=(value) -> ::Boolean
Parameter
  • value (::Boolean) — This flag controls the spell-check feature. If false, the service attempts to correct a misspelled query, for example, "enginee" is corrected to "engineer".

    Defaults to false: a spell check is performed.

Returns
  • (::Boolean) — This flag controls the spell-check feature. If false, the service attempts to correct a misspelled query, for example, "enginee" is corrected to "engineer".

    Defaults to false: a spell check is performed.

#employment_types

def employment_types() -> ::Array<::Google::Cloud::Talent::V4::EmploymentType>
Returns
  • (::Array<::Google::Cloud::Talent::V4::EmploymentType>) — The employment type filter specifies the employment type of jobs to search against, such as EmploymentType.FULL_TIME.

    If a value isn't specified, jobs in the search results includes any employment type.

    If multiple values are specified, jobs in the search results include any of the specified employment types.

#employment_types=

def employment_types=(value) -> ::Array<::Google::Cloud::Talent::V4::EmploymentType>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4::EmploymentType>) — The employment type filter specifies the employment type of jobs to search against, such as EmploymentType.FULL_TIME.

    If a value isn't specified, jobs in the search results includes any employment type.

    If multiple values are specified, jobs in the search results include any of the specified employment types.

Returns
  • (::Array<::Google::Cloud::Talent::V4::EmploymentType>) — The employment type filter specifies the employment type of jobs to search against, such as EmploymentType.FULL_TIME.

    If a value isn't specified, jobs in the search results includes any employment type.

    If multiple values are specified, jobs in the search results include any of the specified employment types.

#excluded_jobs

def excluded_jobs() -> ::Array<::String>
Returns
  • (::Array<::String>) — This filter specifies a list of job names to be excluded during search.

    At most 400 excluded job names are allowed.

#excluded_jobs=

def excluded_jobs=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — This filter specifies a list of job names to be excluded during search.

    At most 400 excluded job names are allowed.

Returns
  • (::Array<::String>) — This filter specifies a list of job names to be excluded during search.

    At most 400 excluded job names are allowed.

#job_categories

def job_categories() -> ::Array<::Google::Cloud::Talent::V4::JobCategory>
Returns
  • (::Array<::Google::Cloud::Talent::V4::JobCategory>) — The category filter specifies the categories of jobs to search against. See JobCategory for more information.

    If a value isn't specified, jobs from any category are searched against.

    If multiple values are specified, jobs from any of the specified categories are searched against.

#job_categories=

def job_categories=(value) -> ::Array<::Google::Cloud::Talent::V4::JobCategory>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4::JobCategory>) — The category filter specifies the categories of jobs to search against. See JobCategory for more information.

    If a value isn't specified, jobs from any category are searched against.

    If multiple values are specified, jobs from any of the specified categories are searched against.

Returns
  • (::Array<::Google::Cloud::Talent::V4::JobCategory>) — The category filter specifies the categories of jobs to search against. See JobCategory for more information.

    If a value isn't specified, jobs from any category are searched against.

    If multiple values are specified, jobs from any of the specified categories are searched against.

#language_codes

def language_codes() -> ::Array<::String>
Returns
  • (::Array<::String>) — This filter specifies the locale of jobs to search against, for example, "en-US".

    If a value isn't specified, the search results can contain jobs in any locale.

    Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.

    At most 10 language code filters are allowed.

#language_codes=

def language_codes=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — This filter specifies the locale of jobs to search against, for example, "en-US".

    If a value isn't specified, the search results can contain jobs in any locale.

    Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.

    At most 10 language code filters are allowed.

Returns
  • (::Array<::String>) — This filter specifies the locale of jobs to search against, for example, "en-US".

    If a value isn't specified, the search results can contain jobs in any locale.

    Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.

    At most 10 language code filters are allowed.

#location_filters

def location_filters() -> ::Array<::Google::Cloud::Talent::V4::LocationFilter>
Returns
  • (::Array<::Google::Cloud::Talent::V4::LocationFilter>) — The location filter specifies geo-regions containing the jobs to search against. See LocationFilter for more information.

    If a location value isn't specified, jobs fitting the other search criteria are retrieved regardless of where they're located.

    If multiple values are specified, jobs are retrieved from any of the specified locations. If different values are specified for the LocationFilter.distance_in_miles parameter, the maximum provided distance is used for all locations.

    At most 5 location filters are allowed.

#location_filters=

def location_filters=(value) -> ::Array<::Google::Cloud::Talent::V4::LocationFilter>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4::LocationFilter>) — The location filter specifies geo-regions containing the jobs to search against. See LocationFilter for more information.

    If a location value isn't specified, jobs fitting the other search criteria are retrieved regardless of where they're located.

    If multiple values are specified, jobs are retrieved from any of the specified locations. If different values are specified for the LocationFilter.distance_in_miles parameter, the maximum provided distance is used for all locations.

    At most 5 location filters are allowed.

Returns
  • (::Array<::Google::Cloud::Talent::V4::LocationFilter>) — The location filter specifies geo-regions containing the jobs to search against. See LocationFilter for more information.

    If a location value isn't specified, jobs fitting the other search criteria are retrieved regardless of where they're located.

    If multiple values are specified, jobs are retrieved from any of the specified locations. If different values are specified for the LocationFilter.distance_in_miles parameter, the maximum provided distance is used for all locations.

    At most 5 location filters are allowed.

#publish_time_range

def publish_time_range() -> ::Google::Cloud::Talent::V4::TimestampRange
Returns

#publish_time_range=

def publish_time_range=(value) -> ::Google::Cloud::Talent::V4::TimestampRange
Parameter
Returns

#query

def query() -> ::String
Returns
  • (::String) — The query string that matches against the job title, description, and location fields.

    The maximum number of allowed characters is 255.

#query=

def query=(value) -> ::String
Parameter
  • value (::String) — The query string that matches against the job title, description, and location fields.

    The maximum number of allowed characters is 255.

Returns
  • (::String) — The query string that matches against the job title, description, and location fields.

    The maximum number of allowed characters is 255.

#query_language_code

def query_language_code() -> ::String
Returns
  • (::String) — The language code of query. For example, "en-US". This field helps to better interpret the query.

    If a value isn't specified, the query language code is automatically detected, which may not be accurate.

    Language code should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.

#query_language_code=

def query_language_code=(value) -> ::String
Parameter
  • value (::String) — The language code of query. For example, "en-US". This field helps to better interpret the query.

    If a value isn't specified, the query language code is automatically detected, which may not be accurate.

    Language code should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.

Returns
  • (::String) — The language code of query. For example, "en-US". This field helps to better interpret the query.

    If a value isn't specified, the query language code is automatically detected, which may not be accurate.

    Language code should be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages.