11893 lines
628 KiB
HTML
11893 lines
628 KiB
HTML
<html><body>
|
|
<style>
|
|
|
|
body, h1, h2, h3, div, span, p, pre, a {
|
|
margin: 0;
|
|
padding: 0;
|
|
border: 0;
|
|
font-weight: inherit;
|
|
font-style: inherit;
|
|
font-size: 100%;
|
|
font-family: inherit;
|
|
vertical-align: baseline;
|
|
}
|
|
|
|
body {
|
|
font-size: 13px;
|
|
padding: 1em;
|
|
}
|
|
|
|
h1 {
|
|
font-size: 26px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h2 {
|
|
font-size: 24px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h3 {
|
|
font-size: 20px;
|
|
margin-bottom: 1em;
|
|
margin-top: 1em;
|
|
}
|
|
|
|
pre, code {
|
|
line-height: 1.5;
|
|
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
|
|
}
|
|
|
|
pre {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
h1, h2, h3, p {
|
|
font-family: Arial, sans serif;
|
|
}
|
|
|
|
h1, h2, h3 {
|
|
border-bottom: solid #CCC 1px;
|
|
}
|
|
|
|
.toc_element {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
.firstline {
|
|
margin-left: 2 em;
|
|
}
|
|
|
|
.method {
|
|
margin-top: 1em;
|
|
border: solid 1px #CCC;
|
|
padding: 1em;
|
|
background: #EEE;
|
|
}
|
|
|
|
.details {
|
|
font-weight: bold;
|
|
font-size: 14px;
|
|
}
|
|
|
|
</style>
|
|
|
|
<h1><a href="jobs_v2.html">Cloud Talent Solution API</a> . <a href="jobs_v2.jobs.html">jobs</a></h1>
|
|
<h2>Instance Methods</h2>
|
|
<p class="toc_element">
|
|
<code><a href="#batchDelete">batchDelete(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Deletes a list of Job postings by filter.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#create">create(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Creates a new job.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#delete">delete(name, x__xgafv=None, disableFastProcess=None)</a></code></p>
|
|
<p class="firstline">Deletes the specified job.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#deleteByFilter">deleteByFilter(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Deprecated. Use BatchDeleteJobs instead.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Retrieves the specified job, whose status is OPEN or recently EXPIRED</p>
|
|
<p class="toc_element">
|
|
<code><a href="#histogram">histogram(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Deprecated. Use SearchJobsRequest.histogram_facets instead to make</p>
|
|
<p class="toc_element">
|
|
<code><a href="#list">list(pageSize=None, pageToken=None, x__xgafv=None, idsOnly=None, filter=None)</a></code></p>
|
|
<p class="firstline">Lists jobs by filter.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
|
|
<p class="firstline">Retrieves the next page of results.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#patch">patch(name, body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Updates specified job.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#search">search(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Searches for jobs using the provided SearchJobsRequest.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#searchForAlert">searchForAlert(body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Searches for jobs using the provided SearchJobsRequest.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#searchForAlert_next">searchForAlert_next(previous_request, previous_response)</a></code></p>
|
|
<p class="firstline">Retrieves the next page of results.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
|
|
<p class="firstline">Retrieves the next page of results.</p>
|
|
<h3>Method Details</h3>
|
|
<div class="method">
|
|
<code class="details" id="batchDelete">batchDelete(body, x__xgafv=None)</code>
|
|
<pre>Deletes a list of Job postings by filter.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Input only.
|
|
#
|
|
# Batch delete jobs request.
|
|
"filter": "A String", # Required.
|
|
#
|
|
# The filter string specifies the jobs to be deleted.
|
|
#
|
|
# Supported operator: =, AND
|
|
#
|
|
# The fields eligible for filtering are:
|
|
#
|
|
# * `companyName` (Required)
|
|
# * `requisitionId` (Required)
|
|
#
|
|
# Sample Query: companyName = "companies/123" AND requisitionId = "req-1"
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A generic empty message that you can re-use to avoid defining duplicated
|
|
# empty messages in your APIs. A typical example is to use it as the request
|
|
# or the response type of an API method. For instance:
|
|
#
|
|
# service Foo {
|
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
# }
|
|
#
|
|
# The JSON representation for `Empty` is empty JSON object `{}`.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="create">create(body, x__xgafv=None)</code>
|
|
<pre>Creates a new job.
|
|
|
|
Typically, the job becomes searchable within 10 seconds, but it may take
|
|
up to 5 minutes.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Input only.
|
|
#
|
|
# Create job request.
|
|
"job": { # A Job resource represents a job posting (also referred to as a "job listing" # Required.
|
|
#
|
|
# The Job to be created.
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
},
|
|
"processingOptions": { # Input only. # Optional.
|
|
#
|
|
# Options for job processing.
|
|
#
|
|
# Options for job processing.
|
|
"htmlSanitization": "A String", # Optional.
|
|
#
|
|
# Option for job HTML content sanitization. Applied fields are:
|
|
#
|
|
# * description
|
|
# * applicationInstruction
|
|
# * incentives
|
|
# * qualifications
|
|
# * responsibilities
|
|
#
|
|
# HTML tags in these fields may be stripped if sanitiazation is not disabled.
|
|
#
|
|
# Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
|
|
"disableStreetAddressResolution": True or False, # Optional.
|
|
#
|
|
# If set to `true`, the service does not attempt to resolve a
|
|
# more precise address for the job.
|
|
},
|
|
"disableStreetAddressResolution": True or False, # Deprecated. Please use processing_options. This flag is ignored if
|
|
# processing_options is set.
|
|
#
|
|
# Optional.
|
|
#
|
|
# If set to `true`, the service does not attempt to resolve a
|
|
# more precise address for the job.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A Job resource represents a job posting (also referred to as a "job listing"
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="delete">delete(name, x__xgafv=None, disableFastProcess=None)</code>
|
|
<pre>Deletes the specified job.
|
|
|
|
Typically, the job becomes unsearchable within 10 seconds, but it may take
|
|
up to 5 minutes.
|
|
|
|
Args:
|
|
name: string, Required.
|
|
|
|
The resource name of the job to be deleted, such as "jobs/11111111". (required)
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
disableFastProcess: boolean, Deprecated. This field is not working anymore.
|
|
|
|
Optional.
|
|
|
|
If set to true, this call waits for all processing steps to complete
|
|
before the job is cleaned up. Otherwise, the call returns while some
|
|
steps are still taking place asynchronously, hence faster.
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A generic empty message that you can re-use to avoid defining duplicated
|
|
# empty messages in your APIs. A typical example is to use it as the request
|
|
# or the response type of an API method. For instance:
|
|
#
|
|
# service Foo {
|
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
# }
|
|
#
|
|
# The JSON representation for `Empty` is empty JSON object `{}`.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="deleteByFilter">deleteByFilter(body, x__xgafv=None)</code>
|
|
<pre>Deprecated. Use BatchDeleteJobs instead.
|
|
|
|
Deletes the specified job by filter. You can specify whether to
|
|
synchronously wait for validation, indexing, and general processing to be
|
|
completed before the response is returned.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Deprecated. Use BatchDeleteJobsRequest instead.
|
|
#
|
|
# Input only.
|
|
#
|
|
# Delete job by filter request.
|
|
#
|
|
# The job typically becomes unsearchable within 10 seconds, but it may take
|
|
# up to 5 minutes.
|
|
"filter": { # Deprecated. Use BatchDeleteJobsRequest instead. # Required.
|
|
#
|
|
# Restrictions on the scope of the delete request.
|
|
#
|
|
# Input only.
|
|
#
|
|
# Filter for jobs to be deleted.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID (or posting ID) assigned by the client to identify a
|
|
# job. This is intended for client identification and tracking of
|
|
# listings.
|
|
# name takes precedence over this field
|
|
# The maximum number of allowed characters is 225.
|
|
},
|
|
"disableFastProcess": True or False, # Optional.
|
|
#
|
|
# If set to true, this call waits for all processing steps to complete
|
|
# before the job is cleaned up. Otherwise, the call returns while some
|
|
# steps are still taking place asynchronously, hence faster.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A generic empty message that you can re-use to avoid defining duplicated
|
|
# empty messages in your APIs. A typical example is to use it as the request
|
|
# or the response type of an API method. For instance:
|
|
#
|
|
# service Foo {
|
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
# }
|
|
#
|
|
# The JSON representation for `Empty` is empty JSON object `{}`.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="get">get(name, x__xgafv=None)</code>
|
|
<pre>Retrieves the specified job, whose status is OPEN or recently EXPIRED
|
|
within the last 90 days.
|
|
|
|
Args:
|
|
name: string, Required.
|
|
|
|
The resource name of the job to retrieve, such as "jobs/11111111". (required)
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A Job resource represents a job posting (also referred to as a "job listing"
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="histogram">histogram(body, x__xgafv=None)</code>
|
|
<pre>Deprecated. Use SearchJobsRequest.histogram_facets instead to make
|
|
a single call with both search and histogram.
|
|
|
|
Retrieves a histogram for the given
|
|
GetHistogramRequest. This call provides a structured
|
|
count of jobs that match against the search query, grouped by specified
|
|
facets.
|
|
|
|
This call constrains the visibility of jobs
|
|
present in the database, and only counts jobs the caller has
|
|
permission to search against.
|
|
|
|
For example, use this call to generate the
|
|
number of jobs in the U.S. by state.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Deprecated. Use SearchJobsRequest.histogram_facets instead to make
|
|
# a single call with both search and histogram.
|
|
#
|
|
# Input only.
|
|
#
|
|
# A request for the `GetHistogram` method.
|
|
"query": { # Input only. # Optional.
|
|
#
|
|
# Query used to search against jobs, such as keyword, location filters, etc.
|
|
#
|
|
# The query required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# 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 Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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 50
|
|
# comparisons/functions are allowed in the expression. The expression
|
|
# must be < 2000 characters in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value isn't
|
|
# specified, all open jobs are searched against regardless of their
|
|
# published date.
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (for
|
|
# example, driving or public transit). Note: This only works with COMMUTE
|
|
# MODE. When specified, [JobQuery.location_filters] is
|
|
# ignored.
|
|
#
|
|
# Currently we don't support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include
|
|
# any of the specified employment types.
|
|
"A String",
|
|
],
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query string that matches against the job title, description, and
|
|
# location fields.
|
|
#
|
|
# The maximum query size is 255 bytes.
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# 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](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# 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.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyDisplayNames": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company display
|
|
# name of the jobs to search against.
|
|
#
|
|
# 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.
|
|
"A String",
|
|
],
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs meeting
|
|
# these criteria are searched. If a filter isn't defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"requestMetadata": { # Input only. # Meta information, such as `user_id`, collected from the job searcher or
|
|
# other entity conducting a job search, is used to improve the service's
|
|
# search quality. Users determine identifier values, which must be
|
|
# unique and consist.
|
|
#
|
|
# Meta information related to the job searcher or entity
|
|
# conducting the job search. This information is used to improve the
|
|
# performance of the service.
|
|
"deviceInfo": { # Input only. # Optional.
|
|
#
|
|
# The type of device used by the job seeker at the time of the call to the
|
|
# service.
|
|
#
|
|
# Device information collected from the job seeker, candidate, or
|
|
# other entity conducting the job search. Providing this information improves
|
|
# the quality of the search results across devices.
|
|
"deviceType": "A String", # Optional.
|
|
#
|
|
# Type of the device.
|
|
"id": "A String", # Optional.
|
|
#
|
|
# A device-specific ID. The ID must be a unique identifier that distinguishes
|
|
# the device from other devices.
|
|
},
|
|
"sessionId": "A String", # Required.
|
|
#
|
|
# A unique session identification string. A session is defined as the
|
|
# duration of an end user's interaction with the service over a period.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the API.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique session_id.
|
|
"userId": "A String", # Required.
|
|
#
|
|
# A unique user identification string, as determined by the client. The
|
|
# client is responsible for ensuring client-level uniqueness of this value
|
|
# in order to have the strongest positive impact on search quality.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the service.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique user_id.
|
|
"domain": "A String", # Required.
|
|
#
|
|
# The client-defined scope or source of the service call, which typically
|
|
# is the domain on
|
|
# which the service has been implemented and is currently being run.
|
|
#
|
|
# For example, if the service is being run by client <em>Foo, Inc.</em>, on
|
|
# job board www.foo.com and career site www.bar.com, then this field is
|
|
# set to "foo.com" for use on the job board, and "bar.com" for use on the
|
|
# career site.
|
|
#
|
|
# If this field is not available for some reason, send "UNKNOWN". Note that
|
|
# any improvements to the service model for a particular tenant site rely on
|
|
# this field being set correctly to some domain.
|
|
},
|
|
"searchTypes": [ # Required.
|
|
#
|
|
# A list of facets that specify the histogram data to be calculated
|
|
# against and returned.
|
|
#
|
|
# Histogram response times can be slow, and counts
|
|
# can be approximations. This call may be temporarily or permanently removed
|
|
# prior to the production release of Cloud Talent Solution.
|
|
"A String",
|
|
],
|
|
"filters": { # Input only. # Deprecated. Use query instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Restrictions on the scope of the histogram.
|
|
#
|
|
# Deprecated. Use JobQuery instead.
|
|
#
|
|
# The filters required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# This filter specifies a structured syntax to match against the
|
|
# Job.custom_attributes that are marked as `filterable`.
|
|
#
|
|
# The syntax for this expression is a subset of Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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"), and there can
|
|
# be a maximum of 100 comparisons/functions in the expression. The expression
|
|
# must be < 3000 bytes in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"customFieldFilters": { # Deprecated. Use custom_attribute_filter instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This filter specifies searching against
|
|
# custom field values. See Job.filterable_custom_fields for information.
|
|
# The key value specifies a number between 1-20 (the service
|
|
# supports 20 custom fields) corresponding to the desired custom field map
|
|
# value. If an invalid key is provided or specified together with
|
|
# custom_attribute_filter, an error is thrown.
|
|
"a_key": { # Input only.
|
|
#
|
|
# Custom field filter of the search.
|
|
"type": "A String", # Optional.
|
|
#
|
|
# The type of filter.
|
|
# Defaults to FilterType.OR.
|
|
"queries": [ # Required.
|
|
#
|
|
# The query strings for the filter.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"tenantJobOnly": True or False, # Deprecated. Do not use this field.
|
|
#
|
|
# This flag controls whether the job search should be restricted to jobs
|
|
# owned by the current user.
|
|
#
|
|
# Defaults to false where all jobs accessible to the
|
|
# user are searched against.
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include any
|
|
# of the specified employment types.
|
|
"A String",
|
|
],
|
|
"companyTitles": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company titles
|
|
# of jobs to search against.
|
|
#
|
|
# If a value is not specified, jobs within the search results can be
|
|
# 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 title filters are allowed.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query filter contains the keywords that match against the job
|
|
# title, description, and location fields.
|
|
#
|
|
# The maximum query size is 255 bytes/characters.
|
|
"extendedCompensationFilter": { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.extended_compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# these criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Input only.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# Specify currency in 3-letter
|
|
# [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
|
|
# unspecified, jobs are returned regardless of currency.
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"compensationRange": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"compensationUnits": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# ExtendedCompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"includeJobWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (e.g.
|
|
# driving or public transit). Note: this only works with COMMUTE
|
|
# MODE. When specified, [JobFilters.location_filters] will be
|
|
# ignored.
|
|
#
|
|
# Currently we do not support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# This filter specifies the locale of jobs to search against,
|
|
# for example, "en-US".
|
|
#
|
|
# If a value is not specified, the search results may contain jobs in any
|
|
# locale.
|
|
#
|
|
#
|
|
# Language codes should be in BCP-47 format, for example, "en-US" or
|
|
# "sr-Latn". For more information, see [Tags for Identifying
|
|
# Languages](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# The company names filter specifies the company entities to search
|
|
# against.
|
|
#
|
|
# If a value is not specified, jobs are searched for against all companies.
|
|
#
|
|
# If multiple values are specified, jobs are searched against the
|
|
# specified companies.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value is not
|
|
# specified, all open jobs are searched against regardless of the
|
|
# date they were published.
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# The location filter specifies geo-regions containing the jobs to
|
|
# search against. See LocationFilter for more information.
|
|
#
|
|
# If a location value is not specified, jobs are retrieved
|
|
# from all locations.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# this criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"allowBroadening": True or False, # Optional.
|
|
#
|
|
# Controls whether to broaden the search to avoid too few results for a
|
|
# given query in instances where a search has sparse results. Results from a
|
|
# broadened query is a superset of the results from the original query.
|
|
#
|
|
# Defaults to false.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # Deprecated. Use SearchJobsRequest.histogram_facets instead to make
|
|
# a single call with both search and histogram.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The response of the GetHistogram method.
|
|
"results": [ # The Histogram results.
|
|
{ # Output only.
|
|
#
|
|
# Result of a histogram call. The response contains the histogram map for the
|
|
# search type specified by HistogramResult.field.
|
|
# The response is a map of each filter value to the corresponding count of
|
|
# jobs for that filter.
|
|
"values": { # A map from the values of field to the number of jobs with that value
|
|
# in this search result.
|
|
#
|
|
# Key: search type (filter names, such as the companyName).
|
|
#
|
|
# Values: the count of jobs that match the filter for this search.
|
|
"a_key": 42,
|
|
},
|
|
"searchType": "A String", # The Histogram search filters.
|
|
},
|
|
],
|
|
"metadata": { # Output only. # Additional information for the API invocation, such as the request
|
|
# tracking id.
|
|
#
|
|
# Additional information returned to client, such as debugging
|
|
# information.
|
|
"requestId": "A String", # A unique id associated with this call.
|
|
# This id is logged for tracking purposes.
|
|
"experimentIdList": [ # Identifiers for the versions of the search algorithm used during
|
|
# this API invocation if multiple algorithms are used.
|
|
# The default value is empty.
|
|
# For search response only.
|
|
42,
|
|
],
|
|
"mode": "A String", # For search response only. Indicates the mode of a performed search.
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="list">list(pageSize=None, pageToken=None, x__xgafv=None, idsOnly=None, filter=None)</code>
|
|
<pre>Lists jobs by filter.
|
|
|
|
Args:
|
|
pageSize: integer, Optional.
|
|
|
|
The maximum number of jobs to be returned per page of results.
|
|
|
|
If ids_only is set to true, the maximum allowed page size
|
|
is 1000. Otherwise, the maximum allowed page size is 100.
|
|
|
|
Default is 100 if empty or a number < 1 is specified.
|
|
pageToken: string, Optional.
|
|
|
|
The starting point of a query result.
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
idsOnly: boolean, Optional.
|
|
|
|
If set to `true`, only Job.name, Job.requisition_id and
|
|
Job.language_code will be returned.
|
|
|
|
A typical use case is to synchronize job repositories.
|
|
|
|
Defaults to false.
|
|
filter: string, Required.
|
|
|
|
The filter string specifies the jobs to be enumerated.
|
|
|
|
Supported operator: =, AND
|
|
|
|
The fields eligible for filtering are:
|
|
|
|
* `companyName` (Required)
|
|
* `requisitionId` (Optional)
|
|
|
|
Sample Query:
|
|
|
|
* companyName = "companies/123"
|
|
* companyName = "companies/123" AND requisitionId = "req-1"
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # Output only.
|
|
#
|
|
# List jobs response.
|
|
"nextPageToken": "A String", # A token to retrieve the next page of results.
|
|
"jobs": [ # The Jobs for a given company.
|
|
#
|
|
# The maximum number of items returned is based on the limit field
|
|
# provided in the request.
|
|
{ # A Job resource represents a job posting (also referred to as a "job listing"
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
},
|
|
],
|
|
"metadata": { # Output only. # Additional information for the API invocation, such as the request
|
|
# tracking id.
|
|
#
|
|
# Additional information returned to client, such as debugging
|
|
# information.
|
|
"requestId": "A String", # A unique id associated with this call.
|
|
# This id is logged for tracking purposes.
|
|
"experimentIdList": [ # Identifiers for the versions of the search algorithm used during
|
|
# this API invocation if multiple algorithms are used.
|
|
# The default value is empty.
|
|
# For search response only.
|
|
42,
|
|
],
|
|
"mode": "A String", # For search response only. Indicates the mode of a performed search.
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
|
|
<pre>Retrieves the next page of results.
|
|
|
|
Args:
|
|
previous_request: The request for the previous page. (required)
|
|
previous_response: The response from the request for the previous page. (required)
|
|
|
|
Returns:
|
|
A request object that you can call 'execute()' on to request the next
|
|
page. Returns None if there are no more items in the collection.
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="patch">patch(name, body, x__xgafv=None)</code>
|
|
<pre>Updates specified job.
|
|
|
|
Typically, updated contents become visible in search results within 10
|
|
seconds, but it may take up to 5 minutes.
|
|
|
|
Args:
|
|
name: string, Required during job update.
|
|
|
|
Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
of this field in job queries and API calls is preferred over the use of
|
|
requisition_id since this value is unique. (required)
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Input only.
|
|
#
|
|
# Update job request.
|
|
"updateJobFields": "A String", # Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# If update_job_fields is provided, only the specified fields in
|
|
# job are updated. Otherwise all the fields are updated.
|
|
#
|
|
# A field mask to restrict the fields that are updated. Valid values are:
|
|
#
|
|
# * jobTitle
|
|
# * employmentTypes
|
|
# * description
|
|
# * applicationUrls
|
|
# * applicationEmailList
|
|
# * applicationInstruction
|
|
# * responsibilities
|
|
# * qualifications
|
|
# * educationLevels
|
|
# * level
|
|
# * department
|
|
# * startDate
|
|
# * endDate
|
|
# * compensationInfo
|
|
# * incentives
|
|
# * languageCode
|
|
# * benefits
|
|
# * expireTime
|
|
# * customAttributes
|
|
# * visibility
|
|
# * publishDate
|
|
# * promotionValue
|
|
# * locations
|
|
# * region
|
|
# * expiryDate (deprecated)
|
|
# * filterableCustomFields (deprecated)
|
|
# * unindexedCustomFields (deprecated)
|
|
"job": { # A Job resource represents a job posting (also referred to as a "job listing" # Required.
|
|
#
|
|
# The Job to be updated.
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
},
|
|
"processingOptions": { # Input only. # Optional.
|
|
#
|
|
# Options for job processing.
|
|
#
|
|
# UpdateJobRequest.disable_street_address_resolution is ignored if this
|
|
# flag is set.
|
|
#
|
|
# Options for job processing.
|
|
"htmlSanitization": "A String", # Optional.
|
|
#
|
|
# Option for job HTML content sanitization. Applied fields are:
|
|
#
|
|
# * description
|
|
# * applicationInstruction
|
|
# * incentives
|
|
# * qualifications
|
|
# * responsibilities
|
|
#
|
|
# HTML tags in these fields may be stripped if sanitiazation is not disabled.
|
|
#
|
|
# Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
|
|
"disableStreetAddressResolution": True or False, # Optional.
|
|
#
|
|
# If set to `true`, the service does not attempt to resolve a
|
|
# more precise address for the job.
|
|
},
|
|
"disableStreetAddressResolution": True or False, # Deprecated. Please use processing_options. This flag is ignored if
|
|
# processing_options is set.
|
|
#
|
|
# Optional.
|
|
#
|
|
# If set to `true`, the service does not attempt resolve a more precise
|
|
# address for the job.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A Job resource represents a job posting (also referred to as a "job listing"
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="search">search(body, x__xgafv=None)</code>
|
|
<pre>Searches for jobs using the provided SearchJobsRequest.
|
|
|
|
This call constrains the visibility of jobs
|
|
present in the database, and only returns jobs that the caller has
|
|
permission to search against.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Input only.
|
|
#
|
|
# The Request body of the `SearchJobs` call.
|
|
"orderBy": "A String", # Deprecated. Use sort_by instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The criteria determining how search results are sorted.
|
|
# Defaults to SortBy.RELEVANCE_DESC if no value is specified.
|
|
"histogramFacets": { # Input only. # Optional.
|
|
#
|
|
# Restrictions on what fields to perform histogram on, such as
|
|
# `COMPANY_SIZE` etc.
|
|
#
|
|
# Histogram facets to be specified in SearchJobsRequest.
|
|
"simpleHistogramFacets": [ # Optional. Specifies the simple type of histogram facets, for example,
|
|
# `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc. This field is equivalent to
|
|
# GetHistogramRequest.
|
|
"A String",
|
|
],
|
|
"customAttributeHistogramFacets": [ # Optional.
|
|
#
|
|
# Specifies the custom attributes histogram requests.
|
|
# Duplicate values of CustomAttributeHistogramRequest.key are not
|
|
# allowed.
|
|
{ # Custom attributes histogram request. An error will be thrown if neither
|
|
# string_value_histogram or long_value_histogram_bucketing_option has
|
|
# been defined.
|
|
"stringValueHistogram": True or False, # Optional. If set to true, the response will include the histogram value for
|
|
# each key as a string.
|
|
"longValueHistogramBucketingOption": { # Input only. # Optional.
|
|
#
|
|
# Specifies buckets used to perform a range histogram on Job's
|
|
# filterable long custom field values, or min/max value requirements.
|
|
#
|
|
# Use this field to specify bucketing option for the histogram search response.
|
|
"bucketBounds": [ # Required.
|
|
#
|
|
# Two adjacent values form a histogram bucket. Values should be in
|
|
# ascending order. For example, if [5, 10, 15] are provided, four buckets are
|
|
# created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
|
|
# [buckets_bound is supported.
|
|
3.14,
|
|
],
|
|
"requiresMinMax": True or False, # Optional.
|
|
#
|
|
# If set to true, the histogram result includes minimum/maximum
|
|
# value of the numeric field.
|
|
},
|
|
"key": "A String", # Required.
|
|
#
|
|
# Specifies the custom field key to perform a histogram on. If specified
|
|
# without `long_value_histogram_bucketing_option`, histogram on string values
|
|
# of the given `key` is triggered, otherwise histogram is performed on long
|
|
# values.
|
|
},
|
|
],
|
|
"compensationHistogramFacets": [ # Optional.
|
|
#
|
|
# Specifies compensation field-based histogram requests.
|
|
# Duplicate values of CompensationHistogramRequest.type are not allowed.
|
|
{ # Input only.
|
|
#
|
|
# Compensation based histogram request.
|
|
"bucketingOption": { # Input only. # Required.
|
|
#
|
|
# Numeric histogram options, like buckets, whether include min or max value.
|
|
#
|
|
# Use this field to specify bucketing option for the histogram search response.
|
|
"bucketBounds": [ # Required.
|
|
#
|
|
# Two adjacent values form a histogram bucket. Values should be in
|
|
# ascending order. For example, if [5, 10, 15] are provided, four buckets are
|
|
# created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
|
|
# [buckets_bound is supported.
|
|
3.14,
|
|
],
|
|
"requiresMinMax": True or False, # Optional.
|
|
#
|
|
# If set to true, the histogram result includes minimum/maximum
|
|
# value of the numeric field.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of the request, representing which field the histogramming should be
|
|
# performed over. A single request can only specify one histogram of each
|
|
# `CompensationHistogramRequestType`.
|
|
},
|
|
],
|
|
},
|
|
"enableBroadening": True or False, # 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.
|
|
"enablePreciseResultSize": True or False, # 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.
|
|
"disableRelevanceThresholding": True or False, # Optional.
|
|
#
|
|
# Controls whether to disable relevance thresholding. Relevance
|
|
# thresholding removes jobs that have low relevance in search results,
|
|
# for example, removing "Assistant to the CEO" positions from the search
|
|
# results of a search for "CEO".
|
|
#
|
|
# Disabling relevance thresholding improves the accuracy of subsequent
|
|
# search requests.
|
|
#
|
|
# Defaults to false.
|
|
"pageSize": 42, # 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.
|
|
"pageToken": "A 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.
|
|
"jobView": "A String", # Optional.
|
|
#
|
|
# The number of job attributes returned for jobs in the
|
|
# search response. Defaults to JobView.SMALL if no value is specified.
|
|
"requestMetadata": { # Input only. # Required.
|
|
#
|
|
# The meta information collected about the job searcher, used to improve the
|
|
# search quality of the service. The identifiers, (such as `user_id`) are
|
|
# provided by users, and must be unique and consistent.
|
|
#
|
|
# Meta information related to the job searcher or entity
|
|
# conducting the job search. This information is used to improve the
|
|
# performance of the service.
|
|
"deviceInfo": { # Input only. # Optional.
|
|
#
|
|
# The type of device used by the job seeker at the time of the call to the
|
|
# service.
|
|
#
|
|
# Device information collected from the job seeker, candidate, or
|
|
# other entity conducting the job search. Providing this information improves
|
|
# the quality of the search results across devices.
|
|
"deviceType": "A String", # Optional.
|
|
#
|
|
# Type of the device.
|
|
"id": "A String", # Optional.
|
|
#
|
|
# A device-specific ID. The ID must be a unique identifier that distinguishes
|
|
# the device from other devices.
|
|
},
|
|
"sessionId": "A String", # Required.
|
|
#
|
|
# A unique session identification string. A session is defined as the
|
|
# duration of an end user's interaction with the service over a period.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the API.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique session_id.
|
|
"userId": "A String", # Required.
|
|
#
|
|
# A unique user identification string, as determined by the client. The
|
|
# client is responsible for ensuring client-level uniqueness of this value
|
|
# in order to have the strongest positive impact on search quality.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the service.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique user_id.
|
|
"domain": "A String", # Required.
|
|
#
|
|
# The client-defined scope or source of the service call, which typically
|
|
# is the domain on
|
|
# which the service has been implemented and is currently being run.
|
|
#
|
|
# For example, if the service is being run by client <em>Foo, Inc.</em>, on
|
|
# job board www.foo.com and career site www.bar.com, then this field is
|
|
# set to "foo.com" for use on the job board, and "bar.com" for use on the
|
|
# career site.
|
|
#
|
|
# If this field is not available for some reason, send "UNKNOWN". Note that
|
|
# any improvements to the service model for a particular tenant site rely on
|
|
# this field being set correctly to some domain.
|
|
},
|
|
"sortBy": "A String", # Optional.
|
|
#
|
|
# The criteria determining how search results are sorted.
|
|
# Defaults to SortBy.RELEVANCE_DESC if no value is specified.
|
|
"filters": { # Input only. # Deprecated. Use query instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Restrictions on the scope of the search request, such as filtering
|
|
# by location.
|
|
#
|
|
# Deprecated. Use JobQuery instead.
|
|
#
|
|
# The filters required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# This filter specifies a structured syntax to match against the
|
|
# Job.custom_attributes that are marked as `filterable`.
|
|
#
|
|
# The syntax for this expression is a subset of Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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"), and there can
|
|
# be a maximum of 100 comparisons/functions in the expression. The expression
|
|
# must be < 3000 bytes in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"customFieldFilters": { # Deprecated. Use custom_attribute_filter instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This filter specifies searching against
|
|
# custom field values. See Job.filterable_custom_fields for information.
|
|
# The key value specifies a number between 1-20 (the service
|
|
# supports 20 custom fields) corresponding to the desired custom field map
|
|
# value. If an invalid key is provided or specified together with
|
|
# custom_attribute_filter, an error is thrown.
|
|
"a_key": { # Input only.
|
|
#
|
|
# Custom field filter of the search.
|
|
"type": "A String", # Optional.
|
|
#
|
|
# The type of filter.
|
|
# Defaults to FilterType.OR.
|
|
"queries": [ # Required.
|
|
#
|
|
# The query strings for the filter.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"tenantJobOnly": True or False, # Deprecated. Do not use this field.
|
|
#
|
|
# This flag controls whether the job search should be restricted to jobs
|
|
# owned by the current user.
|
|
#
|
|
# Defaults to false where all jobs accessible to the
|
|
# user are searched against.
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include any
|
|
# of the specified employment types.
|
|
"A String",
|
|
],
|
|
"companyTitles": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company titles
|
|
# of jobs to search against.
|
|
#
|
|
# If a value is not specified, jobs within the search results can be
|
|
# 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 title filters are allowed.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query filter contains the keywords that match against the job
|
|
# title, description, and location fields.
|
|
#
|
|
# The maximum query size is 255 bytes/characters.
|
|
"extendedCompensationFilter": { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.extended_compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# these criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Input only.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# Specify currency in 3-letter
|
|
# [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
|
|
# unspecified, jobs are returned regardless of currency.
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"compensationRange": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"compensationUnits": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# ExtendedCompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"includeJobWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (e.g.
|
|
# driving or public transit). Note: this only works with COMMUTE
|
|
# MODE. When specified, [JobFilters.location_filters] will be
|
|
# ignored.
|
|
#
|
|
# Currently we do not support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# This filter specifies the locale of jobs to search against,
|
|
# for example, "en-US".
|
|
#
|
|
# If a value is not specified, the search results may contain jobs in any
|
|
# locale.
|
|
#
|
|
#
|
|
# Language codes should be in BCP-47 format, for example, "en-US" or
|
|
# "sr-Latn". For more information, see [Tags for Identifying
|
|
# Languages](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# The company names filter specifies the company entities to search
|
|
# against.
|
|
#
|
|
# If a value is not specified, jobs are searched for against all companies.
|
|
#
|
|
# If multiple values are specified, jobs are searched against the
|
|
# specified companies.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value is not
|
|
# specified, all open jobs are searched against regardless of the
|
|
# date they were published.
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# The location filter specifies geo-regions containing the jobs to
|
|
# search against. See LocationFilter for more information.
|
|
#
|
|
# If a location value is not specified, jobs are retrieved
|
|
# from all locations.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# this criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"offset": 42, # 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.
|
|
#
|
|
# 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).
|
|
"query": { # Input only. # Optional.
|
|
#
|
|
# Query used to search against jobs, such as keyword, location filters, etc.
|
|
#
|
|
# The query required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# 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 Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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 50
|
|
# comparisons/functions are allowed in the expression. The expression
|
|
# must be < 2000 characters in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value isn't
|
|
# specified, all open jobs are searched against regardless of their
|
|
# published date.
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (for
|
|
# example, driving or public transit). Note: This only works with COMMUTE
|
|
# MODE. When specified, [JobQuery.location_filters] is
|
|
# ignored.
|
|
#
|
|
# Currently we don't support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include
|
|
# any of the specified employment types.
|
|
"A String",
|
|
],
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query string that matches against the job title, description, and
|
|
# location fields.
|
|
#
|
|
# The maximum query size is 255 bytes.
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# 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](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# 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.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyDisplayNames": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company display
|
|
# name of the jobs to search against.
|
|
#
|
|
# 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.
|
|
"A String",
|
|
],
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs meeting
|
|
# these criteria are searched. If a filter isn't defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"mode": "A String", # Required.
|
|
#
|
|
# Mode of a search.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # Output only.
|
|
#
|
|
# Response for SearchJob method.
|
|
"nextPageToken": "A String", # The token that specifies the starting position of the next page of results.
|
|
# This field is empty if there are no more results.
|
|
"estimatedTotalSize": "A String", # An estimation of the number of jobs that match the specified query.
|
|
#
|
|
# This number is not guaranteed to be accurate. For accurate results,
|
|
# seenenable_precise_result_size.
|
|
"totalSize": "A String", # The precise result count, which is available only if the client set
|
|
# enable_precise_result_size to `true` or if the response
|
|
# is the last page of results. Otherwise, the value will be `-1`.
|
|
"matchingJobs": [ # The Job entities that match the specified SearchJobsRequest.
|
|
{ # Output only.
|
|
#
|
|
# Job entry with metadata inside SearchJobsResponse.
|
|
"searchTextSnippet": "A String", # Contains snippets of text from the Job.description and similar
|
|
# fields that most closely match a search query's keywords, if available.
|
|
# All HTML tags in the original fields are stripped when returned in this
|
|
# field, and matching query keywords are enclosed in HTML bold tags.
|
|
"job": { # A Job resource represents a job posting (also referred to as a "job listing" # Job resource that matches the specified SearchJobsRequest.
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
},
|
|
"commuteInfo": { # Output only. # Commute information which is generated based on specified
|
|
# CommutePreference.
|
|
#
|
|
# Commute details related to this job.
|
|
"travelDuration": "A String", # The number of seconds required to travel to the job location from the query
|
|
# location. A duration of 0 seconds indicates that the job is not
|
|
# reachable within the requested duration, but was returned as part of an
|
|
# expanded query.
|
|
"jobLocation": { # Output only. # Location used as the destination in the commute calculation.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
},
|
|
"jobSummary": "A String", # A summary of the job with core information that's displayed on the search
|
|
# results listing page.
|
|
"jobTitleSnippet": "A String", # Contains snippets of text from the Job.job_title field most
|
|
# closely matching a search query's keywords, if available. The matching
|
|
# query keywords are enclosed in HTML bold tags.
|
|
},
|
|
],
|
|
"numJobsFromBroadenedQuery": 42, # If query broadening is enabled, we may append additional results from the
|
|
# broadened query. This number indicates how many of the jobs returned in the
|
|
# jobs field are from the broadened query. These results are always at the
|
|
# end of the jobs list. In particular, a value of 0 means all the jobs in the
|
|
# jobs list are from the original (without broadening) query. If this
|
|
# field is non-zero, subsequent requests with offset after this result set
|
|
# should contain all broadened results.
|
|
"appliedJobLocationFilters": [ # The location filters that the service applied to the specified query. If
|
|
# any filters are lat-lng based, the JobLocation.location_type is
|
|
# JobLocation.LocationType#LOCATION_TYPE_UNSPECIFIED.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"histogramResults": { # Output only. # The histogram results that match specified
|
|
# SearchJobsRequest.HistogramFacets.
|
|
#
|
|
# Histogram results that matches HistogramFacets specified in
|
|
# SearchJobsRequest.
|
|
"customAttributeHistogramResults": [ # Specifies histogram results for custom attributes that
|
|
# matches HistogramFacets.custom_attribute_histogram_facets.
|
|
{ # Output only.
|
|
#
|
|
# Custom attribute histogram result.
|
|
"longValueHistogramResult": { # Output only. # Stores bucketed histogram counting result or min/max values for
|
|
# custom attribute long values associated with `key`.
|
|
#
|
|
# Custom numeric bucketing result.
|
|
"counts": [ # Count within each bucket. Its size is the length of
|
|
# NumericBucketingOption.bucket_bounds plus 1.
|
|
{ # Represents count of jobs within one bucket.
|
|
"count": 42, # Number of jobs whose numeric field value fall into `range`.
|
|
"range": { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
|
|
# that is, the count represents number of jobs in this range.
|
|
"to": 3.14, # Ending value of the bucket range.
|
|
"from": 3.14, # Starting value of the bucket range.
|
|
},
|
|
},
|
|
],
|
|
"maxValue": 3.14, # Stores the maximum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
"minValue": 3.14, # Stores the minimum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
},
|
|
"stringValueHistogramResult": { # Stores a map from the values of string custom field associated
|
|
# with `key` to the number of jobs with that value in this histogram result.
|
|
"a_key": 42,
|
|
},
|
|
"key": "A String", # Stores the key of custom attribute the histogram is performed on.
|
|
},
|
|
],
|
|
"simpleHistogramResults": [ # Specifies histogram results that matches
|
|
# HistogramFacets.simple_histogram_facets.
|
|
{ # Output only.
|
|
#
|
|
# Result of a histogram call. The response contains the histogram map for the
|
|
# search type specified by HistogramResult.field.
|
|
# The response is a map of each filter value to the corresponding count of
|
|
# jobs for that filter.
|
|
"values": { # A map from the values of field to the number of jobs with that value
|
|
# in this search result.
|
|
#
|
|
# Key: search type (filter names, such as the companyName).
|
|
#
|
|
# Values: the count of jobs that match the filter for this search.
|
|
"a_key": 42,
|
|
},
|
|
"searchType": "A String", # The Histogram search filters.
|
|
},
|
|
],
|
|
"compensationHistogramResults": [ # Specifies compensation field-based histogram results that matches
|
|
# HistogramFacets.compensation_histogram_requests.
|
|
{ # Output only.
|
|
#
|
|
# Compensation based histogram result.
|
|
"type": "A String", # Type of the request, corresponding to
|
|
# CompensationHistogramRequest.type.
|
|
"result": { # Output only. # Histogram result.
|
|
#
|
|
# Custom numeric bucketing result.
|
|
"counts": [ # Count within each bucket. Its size is the length of
|
|
# NumericBucketingOption.bucket_bounds plus 1.
|
|
{ # Represents count of jobs within one bucket.
|
|
"count": 42, # Number of jobs whose numeric field value fall into `range`.
|
|
"range": { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
|
|
# that is, the count represents number of jobs in this range.
|
|
"to": 3.14, # Ending value of the bucket range.
|
|
"from": 3.14, # Starting value of the bucket range.
|
|
},
|
|
},
|
|
],
|
|
"maxValue": 3.14, # Stores the maximum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
"minValue": 3.14, # Stores the minimum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
},
|
|
},
|
|
],
|
|
},
|
|
"jobView": "A String", # Corresponds to SearchJobsRequest.job_view.
|
|
"appliedCommuteFilter": { # Input only. # The commute filter the service applied to the specified query. This
|
|
# information is only available when query has a valid CommutePreference.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"spellResult": { # Output only. # The spell checking result, and correction.
|
|
#
|
|
# Spell check result.
|
|
"corrected": True or False, # Indicates if the query was corrected by the spell checker.
|
|
"correctedText": "A String", # Correction output consisting of the corrected keyword string.
|
|
},
|
|
"metadata": { # Output only. # Additional information for the API invocation, such as the request
|
|
# tracking id.
|
|
#
|
|
# Additional information returned to client, such as debugging
|
|
# information.
|
|
"requestId": "A String", # A unique id associated with this call.
|
|
# This id is logged for tracking purposes.
|
|
"experimentIdList": [ # Identifiers for the versions of the search algorithm used during
|
|
# this API invocation if multiple algorithms are used.
|
|
# The default value is empty.
|
|
# For search response only.
|
|
42,
|
|
],
|
|
"mode": "A String", # For search response only. Indicates the mode of a performed search.
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="searchForAlert">searchForAlert(body, x__xgafv=None)</code>
|
|
<pre>Searches for jobs using the provided 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 of jobs
|
|
present in the database, and only returns jobs the caller has
|
|
permission to search against.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # Input only.
|
|
#
|
|
# The Request body of the `SearchJobs` call.
|
|
"orderBy": "A String", # Deprecated. Use sort_by instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The criteria determining how search results are sorted.
|
|
# Defaults to SortBy.RELEVANCE_DESC if no value is specified.
|
|
"histogramFacets": { # Input only. # Optional.
|
|
#
|
|
# Restrictions on what fields to perform histogram on, such as
|
|
# `COMPANY_SIZE` etc.
|
|
#
|
|
# Histogram facets to be specified in SearchJobsRequest.
|
|
"simpleHistogramFacets": [ # Optional. Specifies the simple type of histogram facets, for example,
|
|
# `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc. This field is equivalent to
|
|
# GetHistogramRequest.
|
|
"A String",
|
|
],
|
|
"customAttributeHistogramFacets": [ # Optional.
|
|
#
|
|
# Specifies the custom attributes histogram requests.
|
|
# Duplicate values of CustomAttributeHistogramRequest.key are not
|
|
# allowed.
|
|
{ # Custom attributes histogram request. An error will be thrown if neither
|
|
# string_value_histogram or long_value_histogram_bucketing_option has
|
|
# been defined.
|
|
"stringValueHistogram": True or False, # Optional. If set to true, the response will include the histogram value for
|
|
# each key as a string.
|
|
"longValueHistogramBucketingOption": { # Input only. # Optional.
|
|
#
|
|
# Specifies buckets used to perform a range histogram on Job's
|
|
# filterable long custom field values, or min/max value requirements.
|
|
#
|
|
# Use this field to specify bucketing option for the histogram search response.
|
|
"bucketBounds": [ # Required.
|
|
#
|
|
# Two adjacent values form a histogram bucket. Values should be in
|
|
# ascending order. For example, if [5, 10, 15] are provided, four buckets are
|
|
# created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
|
|
# [buckets_bound is supported.
|
|
3.14,
|
|
],
|
|
"requiresMinMax": True or False, # Optional.
|
|
#
|
|
# If set to true, the histogram result includes minimum/maximum
|
|
# value of the numeric field.
|
|
},
|
|
"key": "A String", # Required.
|
|
#
|
|
# Specifies the custom field key to perform a histogram on. If specified
|
|
# without `long_value_histogram_bucketing_option`, histogram on string values
|
|
# of the given `key` is triggered, otherwise histogram is performed on long
|
|
# values.
|
|
},
|
|
],
|
|
"compensationHistogramFacets": [ # Optional.
|
|
#
|
|
# Specifies compensation field-based histogram requests.
|
|
# Duplicate values of CompensationHistogramRequest.type are not allowed.
|
|
{ # Input only.
|
|
#
|
|
# Compensation based histogram request.
|
|
"bucketingOption": { # Input only. # Required.
|
|
#
|
|
# Numeric histogram options, like buckets, whether include min or max value.
|
|
#
|
|
# Use this field to specify bucketing option for the histogram search response.
|
|
"bucketBounds": [ # Required.
|
|
#
|
|
# Two adjacent values form a histogram bucket. Values should be in
|
|
# ascending order. For example, if [5, 10, 15] are provided, four buckets are
|
|
# created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
|
|
# [buckets_bound is supported.
|
|
3.14,
|
|
],
|
|
"requiresMinMax": True or False, # Optional.
|
|
#
|
|
# If set to true, the histogram result includes minimum/maximum
|
|
# value of the numeric field.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of the request, representing which field the histogramming should be
|
|
# performed over. A single request can only specify one histogram of each
|
|
# `CompensationHistogramRequestType`.
|
|
},
|
|
],
|
|
},
|
|
"enableBroadening": True or False, # 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.
|
|
"enablePreciseResultSize": True or False, # 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.
|
|
"disableRelevanceThresholding": True or False, # Optional.
|
|
#
|
|
# Controls whether to disable relevance thresholding. Relevance
|
|
# thresholding removes jobs that have low relevance in search results,
|
|
# for example, removing "Assistant to the CEO" positions from the search
|
|
# results of a search for "CEO".
|
|
#
|
|
# Disabling relevance thresholding improves the accuracy of subsequent
|
|
# search requests.
|
|
#
|
|
# Defaults to false.
|
|
"pageSize": 42, # 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.
|
|
"pageToken": "A 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.
|
|
"jobView": "A String", # Optional.
|
|
#
|
|
# The number of job attributes returned for jobs in the
|
|
# search response. Defaults to JobView.SMALL if no value is specified.
|
|
"requestMetadata": { # Input only. # Required.
|
|
#
|
|
# The meta information collected about the job searcher, used to improve the
|
|
# search quality of the service. The identifiers, (such as `user_id`) are
|
|
# provided by users, and must be unique and consistent.
|
|
#
|
|
# Meta information related to the job searcher or entity
|
|
# conducting the job search. This information is used to improve the
|
|
# performance of the service.
|
|
"deviceInfo": { # Input only. # Optional.
|
|
#
|
|
# The type of device used by the job seeker at the time of the call to the
|
|
# service.
|
|
#
|
|
# Device information collected from the job seeker, candidate, or
|
|
# other entity conducting the job search. Providing this information improves
|
|
# the quality of the search results across devices.
|
|
"deviceType": "A String", # Optional.
|
|
#
|
|
# Type of the device.
|
|
"id": "A String", # Optional.
|
|
#
|
|
# A device-specific ID. The ID must be a unique identifier that distinguishes
|
|
# the device from other devices.
|
|
},
|
|
"sessionId": "A String", # Required.
|
|
#
|
|
# A unique session identification string. A session is defined as the
|
|
# duration of an end user's interaction with the service over a period.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the API.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique session_id.
|
|
"userId": "A String", # Required.
|
|
#
|
|
# A unique user identification string, as determined by the client. The
|
|
# client is responsible for ensuring client-level uniqueness of this value
|
|
# in order to have the strongest positive impact on search quality.
|
|
# Obfuscate this field for privacy concerns before
|
|
# providing it to the service.
|
|
#
|
|
# If this field is not available for some reason, please send "UNKNOWN". Note
|
|
# that any improvements to the service model for a particular tenant site,
|
|
# rely on this field being set correctly to some unique user_id.
|
|
"domain": "A String", # Required.
|
|
#
|
|
# The client-defined scope or source of the service call, which typically
|
|
# is the domain on
|
|
# which the service has been implemented and is currently being run.
|
|
#
|
|
# For example, if the service is being run by client <em>Foo, Inc.</em>, on
|
|
# job board www.foo.com and career site www.bar.com, then this field is
|
|
# set to "foo.com" for use on the job board, and "bar.com" for use on the
|
|
# career site.
|
|
#
|
|
# If this field is not available for some reason, send "UNKNOWN". Note that
|
|
# any improvements to the service model for a particular tenant site rely on
|
|
# this field being set correctly to some domain.
|
|
},
|
|
"sortBy": "A String", # Optional.
|
|
#
|
|
# The criteria determining how search results are sorted.
|
|
# Defaults to SortBy.RELEVANCE_DESC if no value is specified.
|
|
"filters": { # Input only. # Deprecated. Use query instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Restrictions on the scope of the search request, such as filtering
|
|
# by location.
|
|
#
|
|
# Deprecated. Use JobQuery instead.
|
|
#
|
|
# The filters required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# This filter specifies a structured syntax to match against the
|
|
# Job.custom_attributes that are marked as `filterable`.
|
|
#
|
|
# The syntax for this expression is a subset of Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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"), and there can
|
|
# be a maximum of 100 comparisons/functions in the expression. The expression
|
|
# must be < 3000 bytes in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"customFieldFilters": { # Deprecated. Use custom_attribute_filter instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This filter specifies searching against
|
|
# custom field values. See Job.filterable_custom_fields for information.
|
|
# The key value specifies a number between 1-20 (the service
|
|
# supports 20 custom fields) corresponding to the desired custom field map
|
|
# value. If an invalid key is provided or specified together with
|
|
# custom_attribute_filter, an error is thrown.
|
|
"a_key": { # Input only.
|
|
#
|
|
# Custom field filter of the search.
|
|
"type": "A String", # Optional.
|
|
#
|
|
# The type of filter.
|
|
# Defaults to FilterType.OR.
|
|
"queries": [ # Required.
|
|
#
|
|
# The query strings for the filter.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"tenantJobOnly": True or False, # Deprecated. Do not use this field.
|
|
#
|
|
# This flag controls whether the job search should be restricted to jobs
|
|
# owned by the current user.
|
|
#
|
|
# Defaults to false where all jobs accessible to the
|
|
# user are searched against.
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include any
|
|
# of the specified employment types.
|
|
"A String",
|
|
],
|
|
"companyTitles": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company titles
|
|
# of jobs to search against.
|
|
#
|
|
# If a value is not specified, jobs within the search results can be
|
|
# 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 title filters are allowed.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query filter contains the keywords that match against the job
|
|
# title, description, and location fields.
|
|
#
|
|
# The maximum query size is 255 bytes/characters.
|
|
"extendedCompensationFilter": { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
|
|
#
|
|
# Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.extended_compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# these criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Input only.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# Specify currency in 3-letter
|
|
# [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
|
|
# unspecified, jobs are returned regardless of currency.
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"compensationRange": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"compensationUnits": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# ExtendedCompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"includeJobWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (e.g.
|
|
# driving or public transit). Note: this only works with COMMUTE
|
|
# MODE. When specified, [JobFilters.location_filters] will be
|
|
# ignored.
|
|
#
|
|
# Currently we do not support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# This filter specifies the locale of jobs to search against,
|
|
# for example, "en-US".
|
|
#
|
|
# If a value is not specified, the search results may contain jobs in any
|
|
# locale.
|
|
#
|
|
#
|
|
# Language codes should be in BCP-47 format, for example, "en-US" or
|
|
# "sr-Latn". For more information, see [Tags for Identifying
|
|
# Languages](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# The company names filter specifies the company entities to search
|
|
# against.
|
|
#
|
|
# If a value is not specified, jobs are searched for against all companies.
|
|
#
|
|
# If multiple values are specified, jobs are searched against the
|
|
# specified companies.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value is not
|
|
# specified, all open jobs are searched against regardless of the
|
|
# date they were published.
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# The location filter specifies geo-regions containing the jobs to
|
|
# search against. See LocationFilter for more information.
|
|
#
|
|
# If a location value is not specified, jobs are retrieved
|
|
# from all locations.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs that meet
|
|
# this criteria are searched. If a filter is not defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"offset": 42, # 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.
|
|
#
|
|
# 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).
|
|
"query": { # Input only. # Optional.
|
|
#
|
|
# Query used to search against jobs, such as keyword, location filters, etc.
|
|
#
|
|
# The query required to perform a search query or histogram.
|
|
"disableSpellCheck": True or False, # 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".
|
|
#
|
|
# Defaults to false: a spell check is performed.
|
|
"customAttributeFilter": "A String", # Optional.
|
|
#
|
|
# 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 Google SQL syntax.
|
|
#
|
|
# Supported operators are: =, !=, <, <=, >, >= where the left of the operator
|
|
# is a custom field key and the right of the operator is a number or string
|
|
# (surrounded by quotes) value.
|
|
#
|
|
# Supported functions are LOWER(<field_name>) to
|
|
# perform 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 50
|
|
# comparisons/functions are allowed in the expression. The expression
|
|
# must be < 2000 characters in length.
|
|
#
|
|
# Sample Query:
|
|
# (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
|
|
"publishDateRange": "A String", # Optional.
|
|
#
|
|
# Jobs published within a range specified by this filter are searched
|
|
# against, for example, DateRange.PAST_MONTH. If a value isn't
|
|
# specified, all open jobs are searched against regardless of their
|
|
# published date.
|
|
"commuteFilter": { # Input only. # Optional.
|
|
#
|
|
# Allows filtering jobs by commute time with different travel methods (for
|
|
# example, driving or public transit). Note: This only works with COMMUTE
|
|
# MODE. When specified, [JobQuery.location_filters] is
|
|
# ignored.
|
|
#
|
|
# Currently we don't support sorting by commute time.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type filter specifies the employment type of jobs to
|
|
# search against, such as EmploymentType.FULL_TIME.
|
|
#
|
|
# If a value is not specified, jobs in the search results include any
|
|
# employment type.
|
|
#
|
|
# If multiple values are specified, jobs in the search results include
|
|
# any of the specified employment types.
|
|
"A String",
|
|
],
|
|
"categories": [ # Optional.
|
|
#
|
|
# The category filter specifies the categories of jobs to search against.
|
|
# See Category for more information.
|
|
#
|
|
# If a value is not specified, jobs from any category are searched against.
|
|
#
|
|
# If multiple values are specified, jobs from any of the specified
|
|
# categories are searched against.
|
|
"A String",
|
|
],
|
|
"query": "A String", # Optional.
|
|
#
|
|
# The query string that matches against the job title, description, and
|
|
# location fields.
|
|
#
|
|
# The maximum query size is 255 bytes.
|
|
"languageCodes": [ # Optional.
|
|
#
|
|
# 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](https://tools.ietf.org/html/bcp47).
|
|
#
|
|
# At most 10 language code filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyNames": [ # Optional.
|
|
#
|
|
# 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.
|
|
#
|
|
# At most 20 company filters are allowed.
|
|
"A String",
|
|
],
|
|
"companyDisplayNames": [ # Optional.
|
|
#
|
|
# This filter specifies the exact company display
|
|
# name of the jobs to search against.
|
|
#
|
|
# 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.
|
|
"A String",
|
|
],
|
|
"locationFilters": [ # Optional.
|
|
#
|
|
# 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.
|
|
{ # Input only.
|
|
#
|
|
# Geographic region of the search.
|
|
"regionCode": "A String", # Optional.
|
|
#
|
|
# CLDR region code of the country/region of the address. This will be used
|
|
# to address ambiguity of the user-input location, e.g. "Liverpool"
|
|
# against "Liverpool, NY, US" or "Liverpool, UK".
|
|
#
|
|
# Set this field if all the jobs to search against are from a same region,
|
|
# or jobs are world-wide but the job seeker is from a specific region.
|
|
#
|
|
# See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional.
|
|
#
|
|
# The latitude and longitude of the geographic center from which to
|
|
# search. This field is ignored if `location_name` is provided.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"name": "A String", # Optional.
|
|
#
|
|
# The address name, such as "Mountain View" or "Bay Area".
|
|
"isTelecommute": True or False, # Optional.
|
|
#
|
|
# Allows the client to return jobs without a
|
|
# set location, specifically, telecommuting jobs (telecomuting is considered
|
|
# by the service as a special location.
|
|
# Job.allow_telecommute indicates if a job permits telecommuting.
|
|
# If this field is true, telecommuting jobs are searched, and
|
|
# name and lat_lng are
|
|
# ignored.
|
|
# This filter can be used by itself to search exclusively for telecommuting
|
|
# jobs, or it can be combined with another location
|
|
# filter to search for a combination of job locations,
|
|
# such as "Mountain View" or "telecommuting" jobs. However, when used in
|
|
# combination with other location filters, telecommuting jobs can be
|
|
# treated as less relevant than other jobs in the search response.
|
|
"distanceInMiles": 3.14, # Optional.
|
|
#
|
|
#
|
|
# The distance_in_miles is applied when the location being searched for is
|
|
# identified as a city or smaller. When the location being searched for is a
|
|
# state or larger, this field is ignored.
|
|
},
|
|
],
|
|
"compensationFilter": { # Input only. # Optional.
|
|
#
|
|
# This search filter is applied only to
|
|
# Job.compensation_info. For example, if the filter is specified
|
|
# as "Hourly job with per-hour compensation > $15", only jobs meeting
|
|
# these criteria are searched. If a filter isn't defined, all open jobs
|
|
# are searched.
|
|
#
|
|
# Filter on job compensation type and amount.
|
|
"units": [ # Required.
|
|
#
|
|
# Specify desired `base compensation entry's`
|
|
# CompensationInfo.CompensationUnit.
|
|
"A String",
|
|
],
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Type of filter.
|
|
"includeJobsWithUnspecifiedCompensationRange": True or False, # Optional.
|
|
#
|
|
# Whether to include jobs whose compensation range is unspecified.
|
|
},
|
|
},
|
|
"mode": "A String", # Required.
|
|
#
|
|
# Mode of a search.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # Output only.
|
|
#
|
|
# Response for SearchJob method.
|
|
"nextPageToken": "A String", # The token that specifies the starting position of the next page of results.
|
|
# This field is empty if there are no more results.
|
|
"estimatedTotalSize": "A String", # An estimation of the number of jobs that match the specified query.
|
|
#
|
|
# This number is not guaranteed to be accurate. For accurate results,
|
|
# seenenable_precise_result_size.
|
|
"totalSize": "A String", # The precise result count, which is available only if the client set
|
|
# enable_precise_result_size to `true` or if the response
|
|
# is the last page of results. Otherwise, the value will be `-1`.
|
|
"matchingJobs": [ # The Job entities that match the specified SearchJobsRequest.
|
|
{ # Output only.
|
|
#
|
|
# Job entry with metadata inside SearchJobsResponse.
|
|
"searchTextSnippet": "A String", # Contains snippets of text from the Job.description and similar
|
|
# fields that most closely match a search query's keywords, if available.
|
|
# All HTML tags in the original fields are stripped when returned in this
|
|
# field, and matching query keywords are enclosed in HTML bold tags.
|
|
"job": { # A Job resource represents a job posting (also referred to as a "job listing" # Job resource that matches the specified SearchJobsRequest.
|
|
# or "job requisition"). A job belongs to a Company, which is the hiring
|
|
# entity responsible for the job.
|
|
"languageCode": "A String", # Optional.
|
|
#
|
|
# The language of the posting. This field is distinct from
|
|
# any requirements for fluency that are associated with the job.
|
|
#
|
|
# Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
|
|
# For more information, see
|
|
# [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
|
|
# class="external" target="_blank" }.
|
|
#
|
|
# If this field is unspecified and Job.description is present, detected
|
|
# language code based on Job.description is assigned, otherwise
|
|
# defaults to 'en_US'.
|
|
"updateTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was last updated.
|
|
"unindexedCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold non-filterable custom job attributes, similar to
|
|
# filterable_custom_fields. These fields are distinct in that the data
|
|
# in these fields are not indexed. Therefore, the client cannot search
|
|
# against them, nor can the client use them to list jobs.
|
|
#
|
|
# The key of the map can be any valid string.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"endDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The end date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"companyDisplayName": "A String", # Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"startDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The start date of the job in UTC time zone. Typically this field
|
|
# is used for contracting engagements.
|
|
# Dates prior to 1970/1/1 and invalid date formats are ignored.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"jobLocations": [ # Output only.
|
|
#
|
|
# Structured locations of the job, resolved from locations.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"locations": [ # Optional but strongly recommended for the best service experience.
|
|
#
|
|
# Location(s) where the emploeyer is looking to hire for this job posting.
|
|
#
|
|
# Specifying the full street address(es) of the hiring location enables
|
|
# better API results, especially job searches by commute time.
|
|
#
|
|
# At most 50 locations are allowed for best search performance. If a job has
|
|
# more locations, it is suggested to split it into multiple jobs with unique
|
|
# requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
|
|
# multiple jobs with the same requisition_id, company_name and
|
|
# language_code are not allowed. If the original requisition_id must
|
|
# be preserved, a custom field should be used for storage. It is also
|
|
# suggested to group the locations that close to each other in the same job
|
|
# for better search experience.
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"A String",
|
|
],
|
|
"employmentTypes": [ # Optional.
|
|
#
|
|
# The employment type(s) of a job, for example,
|
|
# full time or
|
|
# part time.
|
|
"A String",
|
|
],
|
|
"applicationUrls": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this URL field to direct an applicant to a website, for example to
|
|
# link to an online application form.
|
|
#
|
|
# The maximum number of allowed characters is 2,000.
|
|
"A String",
|
|
],
|
|
"educationLevels": [ # Optional.
|
|
#
|
|
# The desired education level for the job, such as
|
|
# "Bachelors", "Masters", "Doctorate".
|
|
"A String",
|
|
],
|
|
"extendedCompensationInfo": { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# This field replaces compensation_info. Only
|
|
# CompensationInfo.entries or extended_compensation_info can be set,
|
|
# otherwise an exception is thrown.
|
|
#
|
|
# Describes job compensation.
|
|
"annualizedTotalCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized total compensation range cannot be derived, due to
|
|
# the job's all CompensationEntry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"annualizedBaseCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized base compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"annualizedTotalCompensationRange": { # Deprecated. See CompensationInfo. # Output only.
|
|
#
|
|
# Annualized total compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"currency": "A String", # Optional.
|
|
#
|
|
# A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
|
|
# currency code.
|
|
"annualizedBaseCompensationUnspecified": True or False, # Output only.
|
|
#
|
|
# Indicates annualized base compensation range cannot be derived, due to
|
|
# the job's base compensation entry cannot be annualized.
|
|
# See CompensationEntry for explanation on annualization and base
|
|
# compensation entry.
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# ExtendedCompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # Deprecated. See CompensationInfo.
|
|
#
|
|
# A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description.
|
|
"range": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Compensation range.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Maximum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"min": { # Deprecated. See CompensationInfo. # Required.
|
|
#
|
|
# Minimum value.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
},
|
|
"unspecified": True or False, # Optional.
|
|
#
|
|
# Indicates compensation amount and range are unset.
|
|
"expectedUnitsPerYear": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"amount": { # Deprecated. See CompensationInfo. # Optional.
|
|
#
|
|
# Monetary amount.
|
|
#
|
|
# Decimal number.
|
|
"units": "A String", # Whole units.
|
|
"micros": 42, # Micro (10^-6) units.
|
|
# The value must be between -999,999 and +999,999 inclusive.
|
|
# If `units` is positive, `micros` must be positive or zero.
|
|
# If `units` is zero, `micros` can be positive, zero, or negative.
|
|
# If `units` is negative, `micros` must be negative or zero.
|
|
# For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
},
|
|
"filterableCustomFields": { # Deprecated. Use custom_attributes instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A map of fields to hold filterable custom job attributes not captured by
|
|
# the standard fields such as job_title, company_name, or
|
|
# level. These custom fields store arbitrary
|
|
# string values, and can be used for purposes not covered by
|
|
# the structured fields. For the best search experience, use of the
|
|
# structured rather than custom fields is recommended.
|
|
#
|
|
# Data stored in these custom fields fields are indexed and
|
|
# searched against by keyword searches (see
|
|
# SearchJobsRequest.custom_field_filters][]).
|
|
#
|
|
# The map key must be a number between 1-20. If an invalid key is
|
|
# provided on job create or update, an error is returned.
|
|
"a_key": { # Resource that represents the custom data not captured by the standard fields.
|
|
"values": [ # Optional.
|
|
#
|
|
# The values of the custom data.
|
|
"A String",
|
|
],
|
|
},
|
|
},
|
|
"expiryDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
|
|
#
|
|
# Optional but strongly recommended to be provided for the best service
|
|
# experience.
|
|
#
|
|
# The expiration date of the job in UTC time. After 12 am on this date, the
|
|
# job is marked as expired, and it no longer appears in search results.
|
|
# The expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration date. It can also remain expired.
|
|
# Updating an expired job to be open fails if there is another existing open
|
|
# job with same requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# removed first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
#
|
|
# A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
|
|
# ignored and treated as expiry date not provided.
|
|
#
|
|
# If this value is not provided on job creation or is invalid, the job
|
|
# posting expires after 30 days from the job's creation time. For example, if
|
|
# the job was created on 2017/01/01 13:00AM UTC with an unspecified
|
|
# expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_date, or the masks are empty meaning that every field is
|
|
# updated, the job expires after 30 days from the job's last update time.
|
|
# Otherwise the expiration date isn't updated.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"responsibilities": "A String", # Optional.
|
|
#
|
|
# A description of job responsibilities. The use of this field is
|
|
# recommended as an alternative to using the more general description
|
|
# field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"compensationInfo": { # Job compensation details. # Optional.
|
|
#
|
|
# Job compensation information.
|
|
"annualizedBaseCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized base compensation range. Computed as
|
|
# base compensation entry's CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# A lower bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"annualizedTotalCompensationRange": { # Compensation range. # Output only.
|
|
#
|
|
# Annualized total compensation range. Computed as
|
|
# all compensation entries' CompensationEntry.compensation times
|
|
# CompensationEntry.expected_units_per_year.
|
|
#
|
|
# See CompensationEntry for explanation on compensation annualization.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"max": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# An upper bound on a range for compensation or pay for the job.
|
|
# The currency type is specified in compensation_amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"amount": { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# The amount of compensation or pay for the job.
|
|
# As an alternative, compensation_amount_min and
|
|
# compensation_amount_max may be used to define a range of
|
|
# compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"entries": [ # Optional.
|
|
#
|
|
# Job compensation information.
|
|
#
|
|
# At most one entry can be of type
|
|
# CompensationInfo.CompensationType.BASE, which is
|
|
# referred as ** base compensation entry ** for the job.
|
|
{ # A compensation entry that represents one component of compensation, such
|
|
# as base pay, bonus, or other compensation type.
|
|
#
|
|
# Annualization: One compensation entry can be annualized if
|
|
# - it contains valid amount or range.
|
|
# - and its expected_units_per_year is set or can be derived.
|
|
# Its annualized range is determined as (amount or range) times
|
|
# expected_units_per_year.
|
|
"description": "A String", # Optional.
|
|
#
|
|
# Compensation description. For example, could
|
|
# indicate equity terms or provide additional context to an estimated
|
|
# bonus.
|
|
"range": { # Compensation range. # Optional.
|
|
#
|
|
# Compensation range.
|
|
"max": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The maximum amount of compensation. If left empty, the value is set
|
|
# to a maximal compensation value and the currency code is set to
|
|
# match the currency code of
|
|
# min_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"min": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# The minimum amount of compensation. If left empty, the value is set
|
|
# to zero and the currency code is set to match the
|
|
# currency code of max_compensation.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
},
|
|
"expectedUnitsPerYear": 3.14, # Optional.
|
|
#
|
|
# Expected number of units paid each year. If not specified, when
|
|
# Job.employment_types is FULLTIME, a default value is inferred
|
|
# based on unit. Default values:
|
|
# - HOURLY: 2080
|
|
# - DAILY: 260
|
|
# - WEEKLY: 52
|
|
# - MONTHLY: 12
|
|
# - ANNUAL: 1
|
|
"amount": { # Represents an amount of money with its currency type. # Optional.
|
|
#
|
|
# Compensation amount.
|
|
"nanos": 42, # Number of nano (10^-9) units of the amount.
|
|
# The value must be between -999,999,999 and +999,999,999 inclusive.
|
|
# If `units` is positive, `nanos` must be positive or zero.
|
|
# If `units` is zero, `nanos` can be positive, zero, or negative.
|
|
# If `units` is negative, `nanos` must be negative or zero.
|
|
# For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
|
|
"units": "A String", # The whole units of the amount.
|
|
# For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
|
|
"currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
|
|
},
|
|
"type": "A String", # Required.
|
|
#
|
|
# Compensation type.
|
|
"unit": "A String", # Optional.
|
|
#
|
|
# Frequency of the specified amount.
|
|
#
|
|
# Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
|
|
},
|
|
],
|
|
"type": "A String", # Deprecated. Use entries instead.
|
|
#
|
|
# Optional.
|
|
#
|
|
# Type of job compensation.
|
|
},
|
|
"jobTitle": "A String", # Required.
|
|
#
|
|
# The title of the job, such as "Software Engineer"
|
|
#
|
|
# The maximum number of allowed characters is 500.
|
|
"department": "A String", # Optional.
|
|
#
|
|
# The department or functional area within the company with the open
|
|
# position.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"applicationInstruction": "A String", # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to provide instructions, such as "Mail your application
|
|
# to ...", that a candidate can follow to apply for the job.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 3,000.
|
|
"description": "A String", # Required.
|
|
#
|
|
# The description of the job, which typically includes a multi-paragraph
|
|
# description of the company and related information. Separate fields are
|
|
# provided on the job object for responsibilities,
|
|
# qualifications, and other job characteristics. Use of
|
|
# these separate job fields is recommended.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 100,000.
|
|
"companyName": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# The resource name of the company listing the job, such as
|
|
# /companies/foo. This field takes precedence over the
|
|
# distributor-assigned company identifier, distributor_company_id.
|
|
"incentives": "A String", # Optional.
|
|
#
|
|
# A description of bonus, commission, and other compensation
|
|
# incentives associated with the job not including salary or pay.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"requisitionId": "A String", # Required.
|
|
#
|
|
# The requisition ID, also referred to as the posting ID, assigned by the
|
|
# client to identify a job. This field is intended to be used by clients
|
|
# for client identification and tracking of listings. A job is not allowed
|
|
# to be created if there is another job with the same requisition_id,
|
|
# company_name and language_code.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"qualifications": "A String", # Optional.
|
|
#
|
|
# A description of the qualifications required to perform the
|
|
# job. The use of this field is recommended
|
|
# as an alternative to using the more general description field.
|
|
#
|
|
# This field accepts and sanitizes HTML input, and also accepts
|
|
# bold, italic, ordered list, and unordered list markup tags.
|
|
#
|
|
# The maximum number of allowed characters is 10,000.
|
|
"visibility": "A String", # Optional.
|
|
#
|
|
# The visibility of the job.
|
|
# Defaults to JobVisibility.PRIVATE if not specified.
|
|
# Currently only JobVisibility.PRIVATE is supported.
|
|
"expireTime": "A String", # Optional but strongly recommended for the best service
|
|
# experience.
|
|
#
|
|
# The expiration timestamp of the job. After this timestamp, the
|
|
# job is marked as expired, and it no longer appears in search results. The
|
|
# expired job can't be deleted or listed by the DeleteJob and
|
|
# ListJobs APIs, but it can be retrieved with the GetJob API or
|
|
# updated with the UpdateJob API. An expired job can be updated and
|
|
# opened again by using a future expiration timestamp. Updating an expired
|
|
# job fails if there is another existing open job with same
|
|
# requisition_id, company_name and language_code.
|
|
#
|
|
# The expired jobs are retained in our system for 90 days. However, the
|
|
# overall expired job count cannot exceed 3 times the maximum of open jobs
|
|
# count over the past week, otherwise jobs with earlier expire time are
|
|
# cleaned first. Expired jobs are no longer accessible after they are cleaned
|
|
# out.
|
|
# The format of this field is RFC 3339 date strings. Example:
|
|
# 2000-01-01T00:00:00.999999999Z
|
|
# See
|
|
# [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
|
|
#
|
|
# A valid date range is between 1970-01-01T00:00:00.0Z and
|
|
# 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
|
|
# time not provided.
|
|
#
|
|
# If this value is not provided at the time of job creation or is invalid,
|
|
# the job posting expires after 30 days from the job's creation time. For
|
|
# example, if the job was created on 2017/01/01 13:00AM UTC with an
|
|
# unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
|
|
#
|
|
# If this value is not provided but expiry_date is, expiry_date is
|
|
# used.
|
|
#
|
|
# If this value is not provided on job update, it depends on the field masks
|
|
# set by UpdateJobRequest.update_job_fields. If the field masks include
|
|
# expiry_time, or the masks are empty meaning that every field is
|
|
# updated, the job posting expires after 30 days from the job's last
|
|
# update time. Otherwise the expiration date isn't updated.
|
|
"publishDate": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional.
|
|
#
|
|
# The date this job was most recently published in UTC format. The default
|
|
# value is the time the request arrives at the server.
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent:
|
|
#
|
|
# * A full date, with non-zero year, month and day values
|
|
# * A month and day value, with a zero year, e.g. an anniversary
|
|
# * A year on its own, with zero month and day values
|
|
# * A year and month value, with a zero day, e.g. a credit card expiration date
|
|
#
|
|
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
|
|
"month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
|
|
# month and day.
|
|
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
|
|
# if specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
"year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
|
|
# a year.
|
|
},
|
|
"applicationEmailList": [ # Optional but at least one of application_urls,
|
|
# application_email_list or application_instruction must be
|
|
# specified.
|
|
#
|
|
# Use this field to specify email address(es) to which resumes or
|
|
# applications can be sent.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
"A String",
|
|
],
|
|
"createTime": "A String", # Output only.
|
|
#
|
|
# The timestamp when this job was created.
|
|
"benefits": [ # Optional.
|
|
#
|
|
# The benefits included with the job.
|
|
"A String",
|
|
],
|
|
"name": "A String", # Required during job update.
|
|
#
|
|
# Resource name assigned to a job by the API, for example, "/jobs/foo". Use
|
|
# of this field in job queries and API calls is preferred over the use of
|
|
# requisition_id since this value is unique.
|
|
"level": "A String", # Optional.
|
|
#
|
|
# The experience level associated with the job, such as "Entry Level".
|
|
"companyTitle": "A String", # Deprecated. Use company_display_name instead.
|
|
#
|
|
# Output only.
|
|
#
|
|
# The name of the company listing the job.
|
|
"region": "A String", # Optional.
|
|
#
|
|
# The job Region (for example, state, country) throughout which the job
|
|
# is available. If this field is set, a
|
|
# LocationFilter in a search query within the job region
|
|
# finds this job if an exact location match is not specified.
|
|
# If this field is set, setting job locations
|
|
# to the same location level as this field is strongly recommended.
|
|
"promotionValue": 42, # Optional.
|
|
#
|
|
# A promotion value of the job, as determined by the client.
|
|
# The value determines the sort order of the jobs returned when searching for
|
|
# jobs using the featured jobs search call, with higher promotional values
|
|
# being returned first and ties being resolved by relevance sort. Only the
|
|
# jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
|
|
#
|
|
# Default value is 0, and negative values are treated as 0.
|
|
"referenceUrl": "A String", # Output only.
|
|
#
|
|
# The URL of a web page that displays job details.
|
|
"customAttributes": { # Optional.
|
|
#
|
|
# A map of fields to hold both filterable and non-filterable custom job
|
|
# attributes that are not covered by the provided structured fields.
|
|
#
|
|
# This field is a more general combination of the deprecated id-based
|
|
# filterable_custom_fields and string-based
|
|
# non_filterable_custom_fields.
|
|
#
|
|
# The keys of the map are strings up to 64 bytes and must match the
|
|
# pattern: a-zA-Z*.
|
|
#
|
|
# At most 100 filterable and at most 100 unfilterable keys are supported.
|
|
# For filterable `string_values`, across all keys at most 200 values are
|
|
# allowed, with each string no more than 255 characters. For unfilterable
|
|
# `string_values`, the maximum total size of `string_values` across all keys
|
|
# is 50KB.
|
|
"a_key": { # Custom attribute values that are either filterable or non-filterable.
|
|
"filterable": True or False, # Optional.
|
|
#
|
|
# If the `filterable` flag is true, custom field values are searchable.
|
|
# If false, values are not searchable.
|
|
#
|
|
# Default is false.
|
|
"stringValues": { # Represents array of string values. # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
|
|
# `CASE_INSENSITIVE_MATCH`) search.
|
|
# For filterable `string_values`, a maximum total number of 200 values
|
|
# is allowed, with each `string_value` has a byte size of no more than
|
|
# 255B. For unfilterable `string_values`, the maximum total byte size of
|
|
# unfilterable `string_values` is 50KB.
|
|
#
|
|
# Empty strings are not allowed.
|
|
"values": [ # Required.
|
|
#
|
|
# String values.
|
|
"A String",
|
|
],
|
|
},
|
|
"longValue": "A String", # Optional but at least one of string_values or long_value must
|
|
# be specified.
|
|
#
|
|
# This field is used to perform number range search.
|
|
# (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
|
|
# `long_value`, a value between Long.MIN and Long.MAX is allowed.
|
|
},
|
|
},
|
|
"distributorCompanyId": "A String", # Optional but one of company_name or distributor_company_id must be
|
|
# provided.
|
|
#
|
|
# A unique company identifier used by job distributors to identify an
|
|
# employer's company entity. company_name takes precedence over
|
|
# this field, and is the recommended field to use to identify companies.
|
|
#
|
|
# The maximum number of allowed characters is 255.
|
|
},
|
|
"commuteInfo": { # Output only. # Commute information which is generated based on specified
|
|
# CommutePreference.
|
|
#
|
|
# Commute details related to this job.
|
|
"travelDuration": "A String", # The number of seconds required to travel to the job location from the query
|
|
# location. A duration of 0 seconds indicates that the job is not
|
|
# reachable within the requested duration, but was returned as part of an
|
|
# expanded query.
|
|
"jobLocation": { # Output only. # Location used as the destination in the commute calculation.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
},
|
|
"jobSummary": "A String", # A summary of the job with core information that's displayed on the search
|
|
# results listing page.
|
|
"jobTitleSnippet": "A String", # Contains snippets of text from the Job.job_title field most
|
|
# closely matching a search query's keywords, if available. The matching
|
|
# query keywords are enclosed in HTML bold tags.
|
|
},
|
|
],
|
|
"numJobsFromBroadenedQuery": 42, # If query broadening is enabled, we may append additional results from the
|
|
# broadened query. This number indicates how many of the jobs returned in the
|
|
# jobs field are from the broadened query. These results are always at the
|
|
# end of the jobs list. In particular, a value of 0 means all the jobs in the
|
|
# jobs list are from the original (without broadening) query. If this
|
|
# field is non-zero, subsequent requests with offset after this result set
|
|
# should contain all broadened results.
|
|
"appliedJobLocationFilters": [ # The location filters that the service applied to the specified query. If
|
|
# any filters are lat-lng based, the JobLocation.location_type is
|
|
# JobLocation.LocationType#LOCATION_TYPE_UNSPECIFIED.
|
|
{ # Output only.
|
|
#
|
|
# A resource that represents a location with full geographic
|
|
# information.
|
|
"radiusMeters": 3.14, # Radius in meters of the job location. This value is derived from the
|
|
# location bounding box in which a circle with the specified radius
|
|
# centered from LatLng coves the area associated with the job location.
|
|
# For example, currently, "Mountain View, CA, USA" has a radius of
|
|
# 7885.79 meters.
|
|
"locationType": "A String", # The type of a location, which corresponds to the address lines field of
|
|
# PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
|
|
# LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
|
|
# LocationType#LOCALITY.
|
|
"postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
|
|
# such as postal delivery and payments addresses. Given a postal address,
|
|
# a postal service can deliver items to a premises, P.O. Box, or other
|
|
# delivery location.
|
|
# Given a postal address, a postal service can deliver items to a premise, P.O.
|
|
# Box or similar.
|
|
# It is not intended to model geographical locations (roads, towns,
|
|
# mountains).
|
|
#
|
|
# In typical usage an address would be created via user input or from importing
|
|
# existing data, depending on the type of process.
|
|
#
|
|
# Advice on address input / editing:
|
|
# - Use an i18n-ready address widget such as
|
|
# https://github.com/googlei18n/libaddressinput)
|
|
# - Users should not be presented with UI elements for input or editing of
|
|
# fields outside countries where that field is used.
|
|
#
|
|
# For more guidance on how to use this schema, please see:
|
|
# https://support.google.com/business/answer/6397478
|
|
"languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
|
|
# known). This is often the UI language of the input form or is expected
|
|
# to match one of the languages used in the address' country/region, or their
|
|
# transliterated equivalents.
|
|
# This can affect formatting in certain countries, but is not critical
|
|
# to the correctness of the data and will never affect any validation or
|
|
# other non-formatting related operations.
|
|
#
|
|
# If this value is not known, it should be omitted (rather than specifying a
|
|
# possibly incorrect default).
|
|
#
|
|
# Examples: "zh-Hant", "ja", "ja-Latn", "en".
|
|
"recipients": [ # Optional. The recipient at the address.
|
|
# This field may, under certain circumstances, contain multiline information.
|
|
# For example, it might contain "care of" information.
|
|
"A String",
|
|
],
|
|
"locality": "A String", # Optional. Generally refers to the city/town portion of the address.
|
|
# Examples: US city, IT comune, UK post town.
|
|
# In regions of the world where localities are not well defined or do not fit
|
|
# into this structure well, leave locality empty and use address_lines.
|
|
"sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
|
|
# in most regions. Where it is used, the value is either a string like
|
|
# "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
|
|
# alone, representing the "sector code" (Jamaica), "delivery area indicator"
|
|
# (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
|
|
"regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
|
|
# is never inferred and it is up to the user to ensure the value is
|
|
# correct. See http://cldr.unicode.org/ and
|
|
# http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
|
|
# for details. Example: "CH" for Switzerland.
|
|
"administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
|
|
# addresses of a country or region.
|
|
# For example, this can be a state, a province, an oblast, or a prefecture.
|
|
# Specifically, for Spain this is the province and not the autonomous
|
|
# community (e.g. "Barcelona" and not "Catalonia").
|
|
# Many countries don't use an administrative area in postal addresses. E.g.
|
|
# in Switzerland this should be left unpopulated.
|
|
"addressLines": [ # Unstructured address lines describing the lower levels of an address.
|
|
#
|
|
# Because values in address_lines do not have type information and may
|
|
# sometimes contain multiple values in a single field (e.g.
|
|
# "Austin, TX"), it is important that the line order is clear. The order of
|
|
# address lines should be "envelope order" for the country/region of the
|
|
# address. In places where this can vary (e.g. Japan), address_language is
|
|
# used to make it explicit (e.g. "ja" for large-to-small ordering and
|
|
# "ja-Latn" or "en" for small-to-large). This way, the most specific line of
|
|
# an address can be selected based on the language.
|
|
#
|
|
# The minimum permitted structural representation of an address consists
|
|
# of a region_code with all remaining information placed in the
|
|
# address_lines. It would be possible to format such an address very
|
|
# approximately without geocoding, but no semantic reasoning could be
|
|
# made about any of the address components until it was at least
|
|
# partially resolved.
|
|
#
|
|
# Creating an address only containing a region_code and address_lines, and
|
|
# then geocoding is the recommended way to handle completely unstructured
|
|
# addresses (as opposed to guessing which parts of the address should be
|
|
# localities or administrative areas).
|
|
"A String",
|
|
],
|
|
"postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
|
|
# postal codes to be present, but where they are used, they may trigger
|
|
# additional validation with other parts of the address (e.g. state/zip
|
|
# validation in the U.S.A.).
|
|
"organization": "A String", # Optional. The name of the organization at the address.
|
|
"sublocality": "A String", # Optional. Sublocality of the address.
|
|
# For example, this can be neighborhoods, boroughs, districts.
|
|
"revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
|
|
# the latest revision.
|
|
#
|
|
# All new revisions **must** be backward compatible with old revisions.
|
|
},
|
|
"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
},
|
|
],
|
|
"histogramResults": { # Output only. # The histogram results that match specified
|
|
# SearchJobsRequest.HistogramFacets.
|
|
#
|
|
# Histogram results that matches HistogramFacets specified in
|
|
# SearchJobsRequest.
|
|
"customAttributeHistogramResults": [ # Specifies histogram results for custom attributes that
|
|
# matches HistogramFacets.custom_attribute_histogram_facets.
|
|
{ # Output only.
|
|
#
|
|
# Custom attribute histogram result.
|
|
"longValueHistogramResult": { # Output only. # Stores bucketed histogram counting result or min/max values for
|
|
# custom attribute long values associated with `key`.
|
|
#
|
|
# Custom numeric bucketing result.
|
|
"counts": [ # Count within each bucket. Its size is the length of
|
|
# NumericBucketingOption.bucket_bounds plus 1.
|
|
{ # Represents count of jobs within one bucket.
|
|
"count": 42, # Number of jobs whose numeric field value fall into `range`.
|
|
"range": { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
|
|
# that is, the count represents number of jobs in this range.
|
|
"to": 3.14, # Ending value of the bucket range.
|
|
"from": 3.14, # Starting value of the bucket range.
|
|
},
|
|
},
|
|
],
|
|
"maxValue": 3.14, # Stores the maximum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
"minValue": 3.14, # Stores the minimum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
},
|
|
"stringValueHistogramResult": { # Stores a map from the values of string custom field associated
|
|
# with `key` to the number of jobs with that value in this histogram result.
|
|
"a_key": 42,
|
|
},
|
|
"key": "A String", # Stores the key of custom attribute the histogram is performed on.
|
|
},
|
|
],
|
|
"simpleHistogramResults": [ # Specifies histogram results that matches
|
|
# HistogramFacets.simple_histogram_facets.
|
|
{ # Output only.
|
|
#
|
|
# Result of a histogram call. The response contains the histogram map for the
|
|
# search type specified by HistogramResult.field.
|
|
# The response is a map of each filter value to the corresponding count of
|
|
# jobs for that filter.
|
|
"values": { # A map from the values of field to the number of jobs with that value
|
|
# in this search result.
|
|
#
|
|
# Key: search type (filter names, such as the companyName).
|
|
#
|
|
# Values: the count of jobs that match the filter for this search.
|
|
"a_key": 42,
|
|
},
|
|
"searchType": "A String", # The Histogram search filters.
|
|
},
|
|
],
|
|
"compensationHistogramResults": [ # Specifies compensation field-based histogram results that matches
|
|
# HistogramFacets.compensation_histogram_requests.
|
|
{ # Output only.
|
|
#
|
|
# Compensation based histogram result.
|
|
"type": "A String", # Type of the request, corresponding to
|
|
# CompensationHistogramRequest.type.
|
|
"result": { # Output only. # Histogram result.
|
|
#
|
|
# Custom numeric bucketing result.
|
|
"counts": [ # Count within each bucket. Its size is the length of
|
|
# NumericBucketingOption.bucket_bounds plus 1.
|
|
{ # Represents count of jobs within one bucket.
|
|
"count": 42, # Number of jobs whose numeric field value fall into `range`.
|
|
"range": { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
|
|
# that is, the count represents number of jobs in this range.
|
|
"to": 3.14, # Ending value of the bucket range.
|
|
"from": 3.14, # Starting value of the bucket range.
|
|
},
|
|
},
|
|
],
|
|
"maxValue": 3.14, # Stores the maximum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
"minValue": 3.14, # Stores the minimum value of the numeric field. Will be populated only if
|
|
# [NumericBucketingOption.requires_min_max] is set to true.
|
|
},
|
|
},
|
|
],
|
|
},
|
|
"jobView": "A String", # Corresponds to SearchJobsRequest.job_view.
|
|
"appliedCommuteFilter": { # Input only. # The commute filter the service applied to the specified query. This
|
|
# information is only available when query has a valid CommutePreference.
|
|
#
|
|
# Parameters needed for commute search.
|
|
"departureHourLocal": 42, # Optional.
|
|
#
|
|
# The departure hour to use to calculate traffic impact. Accepts an
|
|
# integer between 0 and 23, representing the hour in the time zone of the
|
|
# start_location. Must not be present if road_traffic is specified.
|
|
"roadTraffic": "A String", # Optional.
|
|
#
|
|
# Specifies the traffic density to use when calculating commute time.
|
|
# Must not be present if departure_hour_local is specified.
|
|
"allowNonStreetLevelAddress": True or False, # Optional.
|
|
# If `true`, jobs without street level addresses may also be returned.
|
|
# For city level addresses, the city center is used. For state and coarser
|
|
# level addresses, text matching is used.
|
|
# If this field is set to `false` or is not specified, only jobs that include
|
|
# street level addresses will be returned by commute search.
|
|
"travelTime": "A String", # Required.
|
|
#
|
|
# The maximum travel time in seconds. The maximum allowed value is `3600s`
|
|
# (one hour). Format is `123s`.
|
|
"startLocation": { # An object representing a latitude/longitude pair. This is expressed as a pair # Required.
|
|
#
|
|
# The latitude and longitude of the location from which to calculate the
|
|
# commute time.
|
|
# of doubles representing degrees latitude and degrees longitude. Unless
|
|
# specified otherwise, this must conform to the
|
|
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
|
|
# standard</a>. Values must be within normalized ranges.
|
|
"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
|
|
"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
|
|
},
|
|
"method": "A String", # Required.
|
|
#
|
|
# The method of transportation for which to calculate the commute time.
|
|
},
|
|
"spellResult": { # Output only. # The spell checking result, and correction.
|
|
#
|
|
# Spell check result.
|
|
"corrected": True or False, # Indicates if the query was corrected by the spell checker.
|
|
"correctedText": "A String", # Correction output consisting of the corrected keyword string.
|
|
},
|
|
"metadata": { # Output only. # Additional information for the API invocation, such as the request
|
|
# tracking id.
|
|
#
|
|
# Additional information returned to client, such as debugging
|
|
# information.
|
|
"requestId": "A String", # A unique id associated with this call.
|
|
# This id is logged for tracking purposes.
|
|
"experimentIdList": [ # Identifiers for the versions of the search algorithm used during
|
|
# this API invocation if multiple algorithms are used.
|
|
# The default value is empty.
|
|
# For search response only.
|
|
42,
|
|
],
|
|
"mode": "A String", # For search response only. Indicates the mode of a performed search.
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="searchForAlert_next">searchForAlert_next(previous_request, previous_response)</code>
|
|
<pre>Retrieves the next page of results.
|
|
|
|
Args:
|
|
previous_request: The request for the previous page. (required)
|
|
previous_response: The response from the request for the previous page. (required)
|
|
|
|
Returns:
|
|
A request object that you can call 'execute()' on to request the next
|
|
page. Returns None if there are no more items in the collection.
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="search_next">search_next(previous_request, previous_response)</code>
|
|
<pre>Retrieves the next page of results.
|
|
|
|
Args:
|
|
previous_request: The request for the previous page. (required)
|
|
previous_response: The response from the request for the previous page. (required)
|
|
|
|
Returns:
|
|
A request object that you can call 'execute()' on to request the next
|
|
page. Returns None if there are no more items in the collection.
|
|
</pre>
|
|
</div>
|
|
|
|
</body></html> |