docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/jobs_v3.projects.jobs.html b/docs/dyn/jobs_v3.projects.jobs.html
index ca5a66d..478917f 100644
--- a/docs/dyn/jobs_v3.projects.jobs.html
+++ b/docs/dyn/jobs_v3.projects.jobs.html
@@ -87,7 +87,7 @@
<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="#list">list(parent, jobView=None, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageToken=None, pageSize=None, filter=None, jobView=None, x__xgafv=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>
@@ -177,24 +177,6 @@
"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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -219,13 +201,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -234,6 +209,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -257,9 +239,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -267,13 +246,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -295,53 +279,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -368,28 +305,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -428,39 +410,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -470,7 +419,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -479,11 +427,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -492,6 +440,7 @@
# 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.
@@ -507,11 +456,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -520,6 +465,7 @@
# 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", # Optional. Compensation type.
#
@@ -529,7 +475,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -538,11 +483,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -551,6 +496,7 @@
# 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
@@ -564,8 +510,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -614,6 +596,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -647,13 +636,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -699,6 +681,24 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
},
}
@@ -713,24 +713,6 @@
{ # 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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -755,13 +737,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -770,6 +745,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -793,9 +775,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -803,13 +782,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -831,53 +815,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -904,28 +841,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -964,39 +946,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -1006,7 +955,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1015,11 +963,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1028,6 +976,7 @@
# 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.
@@ -1043,11 +992,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1056,6 +1001,7 @@
# 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", # Optional. Compensation type.
#
@@ -1065,7 +1011,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1074,11 +1019,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1087,6 +1032,7 @@
# 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
@@ -1100,8 +1046,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -1150,6 +1132,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -1183,13 +1172,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -1235,6 +1217,24 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
}</pre>
</div>
@@ -1291,24 +1291,6 @@
{ # 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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -1333,13 +1315,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -1348,6 +1323,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -1371,9 +1353,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -1381,13 +1360,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -1409,53 +1393,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -1482,28 +1419,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -1542,39 +1524,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -1584,7 +1533,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1593,11 +1541,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1606,6 +1554,7 @@
# 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.
@@ -1621,11 +1570,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1634,6 +1579,7 @@
# 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", # Optional. Compensation type.
#
@@ -1643,7 +1589,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1652,11 +1597,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -1665,6 +1610,7 @@
# 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
@@ -1678,8 +1624,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -1728,6 +1710,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -1761,13 +1750,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -1813,11 +1795,29 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, jobView=None, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageToken=None, pageSize=None, filter=None, jobView=None, x__xgafv=None)</code>
<pre>Lists jobs by filter.
Args:
@@ -1825,9 +1825,6 @@
The format is "projects/{project_id}", for example,
"projects/api-test-project". (required)
- jobView: string, Optional. The desired job attributes returned for jobs in the
-search response. Defaults to JobView.JOB_VIEW_FULL if no value is
-specified.
pageToken: string, Optional. The starting point of a query result.
pageSize: integer, Optional. The maximum number of jobs to be returned per page of results.
@@ -1849,6 +1846,9 @@
* companyName = "projects/api-test-project/companies/123"
* companyName = "projects/api-test-project/companies/123" AND requisitionId
= "req-1"
+ jobView: string, Optional. The desired job attributes returned for jobs in the
+search response. Defaults to JobView.JOB_VIEW_FULL if no value is
+specified.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1860,6 +1860,14 @@
{ # Output only.
#
# List jobs response.
+ "nextPageToken": "A String", # A token to retrieve the next page of results.
+ "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.
+ },
"jobs": [ # The Jobs for a given company.
#
# The maximum number of items returned is based on the limit field
@@ -1867,24 +1875,6 @@
{ # 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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -1909,13 +1899,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -1924,6 +1907,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -1947,9 +1937,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -1957,13 +1944,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -1985,53 +1977,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -2058,28 +2003,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -2118,39 +2108,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -2160,7 +2117,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2169,11 +2125,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2182,6 +2138,7 @@
# 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.
@@ -2197,11 +2154,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2210,6 +2163,7 @@
# 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", # Optional. Compensation type.
#
@@ -2219,7 +2173,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2228,11 +2181,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2241,6 +2194,7 @@
# 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
@@ -2254,8 +2208,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -2304,6 +2294,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -2337,13 +2334,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -2389,16 +2379,26 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
},
],
- "nextPageToken": "A String", # A token to retrieve the next page of results.
- "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.
- },
}</pre>
</div>
@@ -2443,24 +2443,6 @@
"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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -2485,13 +2467,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -2500,6 +2475,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -2523,9 +2505,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -2533,13 +2512,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -2561,53 +2545,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -2634,28 +2571,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -2694,39 +2676,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -2736,7 +2685,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2745,11 +2693,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2758,6 +2706,7 @@
# 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.
@@ -2773,11 +2722,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2786,6 +2731,7 @@
# 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", # Optional. Compensation type.
#
@@ -2795,7 +2741,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2804,11 +2749,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -2817,6 +2762,7 @@
# 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
@@ -2830,8 +2776,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -2880,6 +2862,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -2913,13 +2902,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -2965,6 +2947,24 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
},
"updateMask": "A String", # Optional but strongly recommended to be provided for the best service
# experience.
@@ -2987,24 +2987,6 @@
{ # 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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -3029,13 +3011,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -3044,6 +3019,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -3067,9 +3049,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -3077,13 +3056,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -3105,53 +3089,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -3178,28 +3115,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -3238,39 +3220,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -3280,7 +3229,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -3289,11 +3237,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -3302,6 +3250,7 @@
# 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.
@@ -3317,11 +3266,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -3330,6 +3275,7 @@
# 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", # Optional. Compensation type.
#
@@ -3339,7 +3285,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -3348,11 +3293,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -3361,6 +3306,7 @@
# 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
@@ -3374,8 +3320,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -3424,6 +3406,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -3457,13 +3446,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -3509,6 +3491,24 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
}</pre>
</div>
@@ -3531,12 +3531,68 @@
{ # Input only.
#
# The Request body of the `SearchJobs` call.
+ "disableKeywordMatch": True or False, # Optional. Controls whether to disable exact keyword match on Job.job_title,
+ # Job.description, Job.company_display_name, Job.locations,
+ # Job.qualifications. When disable keyword match is turned off, a
+ # keyword match returns jobs that do not match given category filters when
+ # there are matching keywords. For example, the query "program manager," a
+ # result is returned even if the job posting has the title "software
+ # developer," which does not fall into "program manager" ontology, but does
+ # have "program manager" appearing in its description.
+ #
+ # For queries like "cloud" that does not contain title or
+ # location specific ontology, jobs with "cloud" keyword matches are returned
+ # regardless of this flag's value.
+ #
+ # Please use Company.keyword_searchable_custom_fields or
+ # Company.keyword_searchable_custom_attributes if company specific
+ # globally matched custom field/attribute string values is needed. Enabling
+ # keyword match improves recall of subsequent search requests.
+ #
+ # Defaults to false.
+ "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.
+ "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.
+ #
+ # The maximum allowed value is 5000. Otherwise an error is thrown.
+ #
+ # For example, 0 means to return results starting from the first matching
+ # job, and 10 means to return from the 11th job. This can be used for
+ # pagination, (for example, pageSize = 10 and offset = 10 means to return
+ # from the second page).
"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.
"histogramFacets": { # Input only. # Optional. Histogram requests for jobs matching JobQuery.
#
# Histogram facets to be specified in SearchJobsRequest.
+ "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`.
+ },
+ ],
"customAttributeHistogramFacets": [ # Optional. Specifies the custom attributes histogram requests.
# Duplicate values of CustomAttributeHistogramRequest.key are not
# allowed.
@@ -3547,14 +3603,14 @@
# filterable long custom field values, or min/max value requirements.
#
# Use this field to specify bucketing option for the histogram search response.
- "requiresMinMax": True or False, # Optional. If set to true, the histogram result includes minimum/maximum
- # value of the numeric field.
"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
@@ -3568,28 +3624,6 @@
# `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.
"A String",
],
- "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.
- "requiresMinMax": True or False, # Optional. If set to true, the histogram result includes minimum/maximum
- # value of the numeric field.
- "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,
- ],
- },
- "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`.
- },
- ],
},
"orderBy": "A String", # Optional. The criteria determining how search results are sorted. Default is
# "relevance desc".
@@ -3624,25 +3658,6 @@
"jobQuery": { # Input only. # Optional. Query used to search against jobs, such as keyword, location filters, etc.
#
# The query required to perform a search query.
- "queryLanguageCode": "A String", # The language code of query. For example, "en-US". This field helps to
- # better interpret the query.
- #
- # If a value isn't specified, the query language code is automatically
- # detected, which may not be accurate.
- #
- # Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
- # For more information, see
- # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
- "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 includes any
- # employment type.
- #
- # If multiple values are specified, jobs in the search results include
- # any of the specified employment types.
- "A String",
- ],
"customAttributeFilter": "A String", # Optional. This filter specifies a structured syntax to match against the
# Job.custom_attributes marked as `filterable`.
#
@@ -3667,8 +3682,8 @@
# driving_years > 10`
"publishTimeRange": { # Message representing a period of time between two timestamps. # Optional. Jobs published within a range specified by this filter are searched
# against.
- "endTime": "A String", # End of the period.
"startTime": "A String", # Begin of the period.
+ "endTime": "A String", # End of the period.
},
"locationFilters": [ # Optional. The location filter specifies geo-regions containing the jobs to
# search against. See LocationFilter for more information.
@@ -3685,6 +3700,20 @@
{ # Input only.
#
# Geographic region of the search.
+ "regionCode": "A String", # Optional. CLDR region code of the country/region of the address. This is used
+ # to address ambiguity of the user-input location, for example, "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.
+ "address": "A String", # Optional. The address name, such as "Mountain View" or "Bay Area".
+ "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.
"telecommutePreference": "A String", # Optional. Allows the client to return jobs without a
# set location, specifically, telecommuting jobs (telecommuting is considered
# by the service as a special location.
@@ -3707,39 +3736,11 @@
# 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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
- "regionCode": "A String", # Optional. CLDR region code of the country/region of the address. This is used
- # to address ambiguity of the user-input location, for example, "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.
- "address": "A String", # Optional. The address name, such as "Mountain View" or "Bay Area".
- "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.
},
],
- "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",
- ],
"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
@@ -3748,6 +3749,18 @@
# Currently we don't support sorting by commute time.
#
# Parameters needed for commute search.
+ "travelDuration": "A String", # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
+ # (one hour). Format is `123s`.
+ "startCoordinates": { # 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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "commuteMethod": "A String", # Required. The method of transportation for which to calculate the commute time.
"roadTraffic": "A String", # Optional. Specifies the traffic density to use when calculating commute time.
"allowImpreciseAddresses": True or False, # Optional. If true, jobs without "precise" addresses (street level addresses or GPS
# coordinates) might also be returned. For city and coarser level addresses,
@@ -3772,19 +3785,21 @@
# allow the value 60 if it allows leap-seconds.
"minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
},
- "travelDuration": "A String", # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
- # (one hour). Format is `123s`.
- "startCoordinates": { # 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].
- },
- "commuteMethod": "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 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",
+ ],
"query": "A String", # Optional. The query string that matches against the job title, description, and
# location fields.
#
@@ -3796,6 +3811,35 @@
# are searched.
#
# Filter on job compensation type and amount.
+ "range": { # Compensation range. # Optional. Compensation range.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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. If set to true, jobs with unspecified compensation range fields are
# included.
@@ -3803,36 +3847,12 @@
# CompensationInfo.CompensationUnit.
"A String",
],
- "range": { # Compensation range. # Optional. Compensation range.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
},
+ "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.
"companyDisplayNames": [ # Optional. This filter specifies the exact company display
# name of the jobs to search against.
#
@@ -3845,11 +3865,6 @@
# At most 20 company display name filters are allowed.
"A String",
],
- "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.
"jobCategories": [ # Optional. The category filter specifies the categories of jobs to search against.
# See Category for more information.
#
@@ -3873,6 +3888,25 @@
# At most 20 company filters are allowed.
"A String",
],
+ "queryLanguageCode": "A String", # The language code of query. For example, "en-US". This field helps to
+ # better interpret the query.
+ #
+ # If a value isn't specified, the query language code is automatically
+ # detected, which may not be accurate.
+ #
+ # Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
+ # For more information, see
+ # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
+ "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 includes any
+ # employment type.
+ #
+ # If multiple values are specified, jobs in the search results include
+ # any of the specified employment types.
+ "A String",
+ ],
},
"jobView": "A String", # Optional. The desired job attributes returned for jobs in the
# search response. Defaults to JobView.SMALL if no value is specified.
@@ -3907,6 +3941,25 @@
# 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": { # Device information collected from the job seeker, candidate, or # Optional. The type of device used by the job seeker at the time of the call to the
+ # service.
+ # 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 certain
+ # period.
+ # Obfuscate this field for privacy concerns before
+ # providing it to the service.
+ #
+ # If this field is not available for some reason, send "UNKNOWN". Note
+ # that any improvements to the model for a particular tenant
+ # site, rely on this field being set correctly to some unique session_id.
+ #
+ # The maximum number of allowed characters is 255.
"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.
@@ -3932,60 +3985,7 @@
# site, rely on this field being set correctly to a unique user_id.
#
# The maximum number of allowed characters is 255.
- "deviceInfo": { # Device information collected from the job seeker, candidate, or # Optional. The type of device used by the job seeker at the time of the call to the
- # service.
- # 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 certain
- # period.
- # Obfuscate this field for privacy concerns before
- # providing it to the service.
- #
- # If this field is not available for some reason, send "UNKNOWN". Note
- # that any improvements to the model for a particular tenant
- # site, rely on this field being set correctly to some unique session_id.
- #
- # The maximum number of allowed characters is 255.
},
- "disableKeywordMatch": True or False, # Optional. Controls whether to disable exact keyword match on Job.job_title,
- # Job.description, Job.company_display_name, Job.locations,
- # Job.qualifications. When disable keyword match is turned off, a
- # keyword match returns jobs that do not match given category filters when
- # there are matching keywords. For example, the query "program manager," a
- # result is returned even if the job posting has the title "software
- # developer," which does not fall into "program manager" ontology, but does
- # have "program manager" appearing in its description.
- #
- # For queries like "cloud" that does not contain title or
- # location specific ontology, jobs with "cloud" keyword matches are returned
- # regardless of this flag's value.
- #
- # Please use Company.keyword_searchable_custom_fields or
- # Company.keyword_searchable_custom_attributes if company specific
- # globally matched custom field/attribute string values is needed. Enabling
- # keyword match improves recall of subsequent search requests.
- #
- # Defaults to false.
- "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.
- "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.
- #
- # The maximum allowed value is 5000. Otherwise an error is thrown.
- #
- # For example, 0 means to return results starting from the first matching
- # job, and 10 means to return from the 11th job. This can be used for
- # pagination, (for example, pageSize = 10 and offset = 10 means to return
- # from the second page).
}
x__xgafv: string, V1 error format.
@@ -3999,125 +3999,13 @@
{ # Output only.
#
# Response for SearchJob method.
- "locationFilters": [ # 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.
- "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].
- },
- "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/google/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
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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.).
- "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".
- "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).
- "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",
- ],
- },
- "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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
- },
- ],
+ "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.
+ },
"histogramResults": { # Output only. # The histogram results that match specified
# SearchJobsRequest.histogram_facets.
#
@@ -4203,171 +4091,13 @@
},
],
},
- "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.
- },
"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.
- "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.
- "jobSummary": "A String", # A summary of the job with core information that's displayed on the search
- # results listing page.
- "commuteInfo": { # Output only. # Commute information which is generated based on specified
- # CommuteFilter.
- #
- # 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.
- "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].
- },
- "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/google/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
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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.).
- "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".
- "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).
- "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",
- ],
- },
- "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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
- },
- },
"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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -4392,13 +4122,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -4407,6 +4130,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -4430,9 +4160,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -4440,13 +4167,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -4468,53 +4200,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -4541,28 +4226,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -4601,39 +4331,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -4643,7 +4340,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -4652,11 +4348,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -4665,6 +4361,7 @@
# 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.
@@ -4680,11 +4377,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -4693,6 +4386,7 @@
# 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", # Optional. Compensation type.
#
@@ -4702,7 +4396,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -4711,11 +4404,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -4724,6 +4417,7 @@
# 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
@@ -4737,8 +4431,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -4787,6 +4517,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -4820,13 +4557,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -4872,6 +4602,157 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
+ },
+ "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.
+ "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.
+ "jobSummary": "A String", # A summary of the job with core information that's displayed on the search
+ # results listing page.
+ "commuteInfo": { # Output only. # Commute information which is generated based on specified
+ # CommuteFilter.
+ #
+ # 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.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
+ "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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "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/google/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
+ "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.).
+ "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".
+ "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).
+ "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",
+ ],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
+ },
+ "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.
+ },
},
},
],
@@ -4883,10 +4764,6 @@
"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.
},
- "estimatedTotalSize": 42, # An estimation of the number of jobs that match the specified query.
- #
- # This number is not guaranteed to be accurate. For accurate results,
- # see enable_precise_result_size.
"broadenedQueryJobsCount": 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
@@ -4894,9 +4771,132 @@
# set, 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.
+ "estimatedTotalSize": 42, # An estimation of the number of jobs that match the specified query.
+ #
+ # This number is not guaranteed to be accurate. For accurate results,
+ # see enable_precise_result_size.
"totalSize": 42, # 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 is `-1`.
+ "locationFilters": [ # 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.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
+ "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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "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/google/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
+ "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.).
+ "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".
+ "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).
+ "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",
+ ],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
+ },
+ "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.
+ },
+ ],
}</pre>
</div>
@@ -4924,12 +4924,68 @@
{ # Input only.
#
# The Request body of the `SearchJobs` call.
+ "disableKeywordMatch": True or False, # Optional. Controls whether to disable exact keyword match on Job.job_title,
+ # Job.description, Job.company_display_name, Job.locations,
+ # Job.qualifications. When disable keyword match is turned off, a
+ # keyword match returns jobs that do not match given category filters when
+ # there are matching keywords. For example, the query "program manager," a
+ # result is returned even if the job posting has the title "software
+ # developer," which does not fall into "program manager" ontology, but does
+ # have "program manager" appearing in its description.
+ #
+ # For queries like "cloud" that does not contain title or
+ # location specific ontology, jobs with "cloud" keyword matches are returned
+ # regardless of this flag's value.
+ #
+ # Please use Company.keyword_searchable_custom_fields or
+ # Company.keyword_searchable_custom_attributes if company specific
+ # globally matched custom field/attribute string values is needed. Enabling
+ # keyword match improves recall of subsequent search requests.
+ #
+ # Defaults to false.
+ "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.
+ "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.
+ #
+ # The maximum allowed value is 5000. Otherwise an error is thrown.
+ #
+ # For example, 0 means to return results starting from the first matching
+ # job, and 10 means to return from the 11th job. This can be used for
+ # pagination, (for example, pageSize = 10 and offset = 10 means to return
+ # from the second page).
"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.
"histogramFacets": { # Input only. # Optional. Histogram requests for jobs matching JobQuery.
#
# Histogram facets to be specified in SearchJobsRequest.
+ "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`.
+ },
+ ],
"customAttributeHistogramFacets": [ # Optional. Specifies the custom attributes histogram requests.
# Duplicate values of CustomAttributeHistogramRequest.key are not
# allowed.
@@ -4940,14 +4996,14 @@
# filterable long custom field values, or min/max value requirements.
#
# Use this field to specify bucketing option for the histogram search response.
- "requiresMinMax": True or False, # Optional. If set to true, the histogram result includes minimum/maximum
- # value of the numeric field.
"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
@@ -4961,28 +5017,6 @@
# `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.
"A String",
],
- "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.
- "requiresMinMax": True or False, # Optional. If set to true, the histogram result includes minimum/maximum
- # value of the numeric field.
- "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,
- ],
- },
- "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`.
- },
- ],
},
"orderBy": "A String", # Optional. The criteria determining how search results are sorted. Default is
# "relevance desc".
@@ -5017,25 +5051,6 @@
"jobQuery": { # Input only. # Optional. Query used to search against jobs, such as keyword, location filters, etc.
#
# The query required to perform a search query.
- "queryLanguageCode": "A String", # The language code of query. For example, "en-US". This field helps to
- # better interpret the query.
- #
- # If a value isn't specified, the query language code is automatically
- # detected, which may not be accurate.
- #
- # Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
- # For more information, see
- # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
- "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 includes any
- # employment type.
- #
- # If multiple values are specified, jobs in the search results include
- # any of the specified employment types.
- "A String",
- ],
"customAttributeFilter": "A String", # Optional. This filter specifies a structured syntax to match against the
# Job.custom_attributes marked as `filterable`.
#
@@ -5060,8 +5075,8 @@
# driving_years > 10`
"publishTimeRange": { # Message representing a period of time between two timestamps. # Optional. Jobs published within a range specified by this filter are searched
# against.
- "endTime": "A String", # End of the period.
"startTime": "A String", # Begin of the period.
+ "endTime": "A String", # End of the period.
},
"locationFilters": [ # Optional. The location filter specifies geo-regions containing the jobs to
# search against. See LocationFilter for more information.
@@ -5078,6 +5093,20 @@
{ # Input only.
#
# Geographic region of the search.
+ "regionCode": "A String", # Optional. CLDR region code of the country/region of the address. This is used
+ # to address ambiguity of the user-input location, for example, "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.
+ "address": "A String", # Optional. The address name, such as "Mountain View" or "Bay Area".
+ "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.
"telecommutePreference": "A String", # Optional. Allows the client to return jobs without a
# set location, specifically, telecommuting jobs (telecommuting is considered
# by the service as a special location.
@@ -5100,39 +5129,11 @@
# 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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
- "regionCode": "A String", # Optional. CLDR region code of the country/region of the address. This is used
- # to address ambiguity of the user-input location, for example, "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.
- "address": "A String", # Optional. The address name, such as "Mountain View" or "Bay Area".
- "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.
},
],
- "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",
- ],
"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
@@ -5141,6 +5142,18 @@
# Currently we don't support sorting by commute time.
#
# Parameters needed for commute search.
+ "travelDuration": "A String", # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
+ # (one hour). Format is `123s`.
+ "startCoordinates": { # 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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "commuteMethod": "A String", # Required. The method of transportation for which to calculate the commute time.
"roadTraffic": "A String", # Optional. Specifies the traffic density to use when calculating commute time.
"allowImpreciseAddresses": True or False, # Optional. If true, jobs without "precise" addresses (street level addresses or GPS
# coordinates) might also be returned. For city and coarser level addresses,
@@ -5165,19 +5178,21 @@
# allow the value 60 if it allows leap-seconds.
"minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
},
- "travelDuration": "A String", # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
- # (one hour). Format is `123s`.
- "startCoordinates": { # 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].
- },
- "commuteMethod": "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 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",
+ ],
"query": "A String", # Optional. The query string that matches against the job title, description, and
# location fields.
#
@@ -5189,6 +5204,35 @@
# are searched.
#
# Filter on job compensation type and amount.
+ "range": { # Compensation range. # Optional. Compensation range.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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. If set to true, jobs with unspecified compensation range fields are
# included.
@@ -5196,36 +5240,12 @@
# CompensationInfo.CompensationUnit.
"A String",
],
- "range": { # Compensation range. # Optional. Compensation range.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
},
+ "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.
"companyDisplayNames": [ # Optional. This filter specifies the exact company display
# name of the jobs to search against.
#
@@ -5238,11 +5258,6 @@
# At most 20 company display name filters are allowed.
"A String",
],
- "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.
"jobCategories": [ # Optional. The category filter specifies the categories of jobs to search against.
# See Category for more information.
#
@@ -5266,6 +5281,25 @@
# At most 20 company filters are allowed.
"A String",
],
+ "queryLanguageCode": "A String", # The language code of query. For example, "en-US". This field helps to
+ # better interpret the query.
+ #
+ # If a value isn't specified, the query language code is automatically
+ # detected, which may not be accurate.
+ #
+ # Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
+ # For more information, see
+ # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
+ "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 includes any
+ # employment type.
+ #
+ # If multiple values are specified, jobs in the search results include
+ # any of the specified employment types.
+ "A String",
+ ],
},
"jobView": "A String", # Optional. The desired job attributes returned for jobs in the
# search response. Defaults to JobView.SMALL if no value is specified.
@@ -5300,6 +5334,25 @@
# 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": { # Device information collected from the job seeker, candidate, or # Optional. The type of device used by the job seeker at the time of the call to the
+ # service.
+ # 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 certain
+ # period.
+ # Obfuscate this field for privacy concerns before
+ # providing it to the service.
+ #
+ # If this field is not available for some reason, send "UNKNOWN". Note
+ # that any improvements to the model for a particular tenant
+ # site, rely on this field being set correctly to some unique session_id.
+ #
+ # The maximum number of allowed characters is 255.
"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.
@@ -5325,60 +5378,7 @@
# site, rely on this field being set correctly to a unique user_id.
#
# The maximum number of allowed characters is 255.
- "deviceInfo": { # Device information collected from the job seeker, candidate, or # Optional. The type of device used by the job seeker at the time of the call to the
- # service.
- # 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 certain
- # period.
- # Obfuscate this field for privacy concerns before
- # providing it to the service.
- #
- # If this field is not available for some reason, send "UNKNOWN". Note
- # that any improvements to the model for a particular tenant
- # site, rely on this field being set correctly to some unique session_id.
- #
- # The maximum number of allowed characters is 255.
},
- "disableKeywordMatch": True or False, # Optional. Controls whether to disable exact keyword match on Job.job_title,
- # Job.description, Job.company_display_name, Job.locations,
- # Job.qualifications. When disable keyword match is turned off, a
- # keyword match returns jobs that do not match given category filters when
- # there are matching keywords. For example, the query "program manager," a
- # result is returned even if the job posting has the title "software
- # developer," which does not fall into "program manager" ontology, but does
- # have "program manager" appearing in its description.
- #
- # For queries like "cloud" that does not contain title or
- # location specific ontology, jobs with "cloud" keyword matches are returned
- # regardless of this flag's value.
- #
- # Please use Company.keyword_searchable_custom_fields or
- # Company.keyword_searchable_custom_attributes if company specific
- # globally matched custom field/attribute string values is needed. Enabling
- # keyword match improves recall of subsequent search requests.
- #
- # Defaults to false.
- "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.
- "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.
- #
- # The maximum allowed value is 5000. Otherwise an error is thrown.
- #
- # For example, 0 means to return results starting from the first matching
- # job, and 10 means to return from the 11th job. This can be used for
- # pagination, (for example, pageSize = 10 and offset = 10 means to return
- # from the second page).
}
x__xgafv: string, V1 error format.
@@ -5392,125 +5392,13 @@
{ # Output only.
#
# Response for SearchJob method.
- "locationFilters": [ # 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.
- "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].
- },
- "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/google/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
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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.).
- "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".
- "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).
- "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",
- ],
- },
- "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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
- },
- ],
+ "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.
+ },
"histogramResults": { # Output only. # The histogram results that match specified
# SearchJobsRequest.histogram_facets.
#
@@ -5596,171 +5484,13 @@
},
],
},
- "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.
- },
"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.
- "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.
- "jobSummary": "A String", # A summary of the job with core information that's displayed on the search
- # results listing page.
- "commuteInfo": { # Output only. # Commute information which is generated based on specified
- # CommuteFilter.
- #
- # 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.
- "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].
- },
- "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/google/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
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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.).
- "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".
- "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).
- "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",
- ],
- },
- "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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
- },
- },
"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.
- "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
- "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'.
- "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
- "visibility": "A String", # Deprecated. The job is only visible to the owner.
- #
- # The visibility of the job.
- #
- # Defaults to Visibility.ACCOUNT_ONLY if not specified.
"name": "A String", # Required during job update.
#
# The resource name for the job. This is generated by the service when a
@@ -5785,13 +5515,6 @@
#
# The maximum number of allowed characters is 500.
"companyDisplayName": "A String", # Output only. Display name of the company listing the job.
- "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 postings. A job is not allowed
- # to be created if there is another job with the same [company_name],
- # language_code and requisition_id.
- #
- # 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.
@@ -5800,6 +5523,13 @@
# bold, italic, ordered list, and unordered list markup tags.
#
# 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 postings. A job is not allowed
+ # to be created if there is another job with the same [company_name],
+ # language_code and requisition_id.
+ #
+ # The maximum number of allowed characters is 255.
"processingOptions": { # Input only. # Optional. Options for job processing.
#
# Options for job processing.
@@ -5823,9 +5553,6 @@
"derivedInfo": { # Output only. # Output only. Derived details about the job posting.
#
# Derived details about the job posting.
- "jobCategories": [ # Job categories derived from Job.title and Job.description.
- "A String",
- ],
"locations": [ # Structured locations of the job, resolved from Job.addresses.
#
# locations are exactly matched to Job.addresses in the same
@@ -5833,13 +5560,18 @@
{ # Output only.
#
# A resource that represents a location with full geographic information.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
"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].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
},
"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,
@@ -5861,53 +5593,6 @@
#
# For more guidance on how to use this schema, please see:
# https://support.google.com/business/answer/6397478
- "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.
- "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.
- "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.
- "organization": "A String", # Optional. The name of the organization at the address.
- "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.
- "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
@@ -5934,28 +5619,73 @@
# For example, it might contain "care of" information.
"A String",
],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
},
"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.
- "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
- # location bounding box in which a circle with the specified radius
- # centered from LatLng covers the area associated with the job location.
- # For example, currently, "Mountain View, CA, USA" has a radius of
- # 6.17 miles.
},
],
+ "jobCategories": [ # Job categories derived from Job.title and Job.description.
+ "A String",
+ ],
},
+ "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.
"employmentTypes": [ # Optional. The employment type(s) of a job, for example,
# full time or
# part time.
"A String",
],
- "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.
"postingCreateTime": "A String", # Output only. The timestamp when this job posting was created.
"addresses": [ # Optional but strongly recommended for the best service experience.
#
@@ -5994,39 +5724,6 @@
"A String",
],
"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.
- "maxCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- },
"annualizedTotalCompensationRange": { # Compensation range. # Output only. Annualized total compensation range. Computed as
# all compensation entries' CompensationEntry.compensation times
# CompensationEntry.expected_units_per_year.
@@ -6036,7 +5733,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -6045,11 +5741,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -6058,6 +5754,7 @@
# 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.
@@ -6073,11 +5770,7 @@
# - 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.
- "unit": "A String", # Optional. Frequency of the specified amount.
- #
- # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
"amount": { # Represents an amount of money with its currency type. # Optional. Compensation amount.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -6086,6 +5779,7 @@
# 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", # Optional. Compensation type.
#
@@ -6095,7 +5789,6 @@
# to a maximal compensation value and the currency code is set to
# match the currency code of
# min_compensation.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -6104,11 +5797,11 @@
# 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.
},
"minCompensation": { # 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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
"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.
@@ -6117,6 +5810,7 @@
# 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
@@ -6130,8 +5824,44 @@
"description": "A String", # Optional. Compensation description. For example, could
# indicate equity terms or provide additional context to an estimated
# bonus.
+ "unit": "A String", # Optional. Frequency of the specified amount.
+ #
+ # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
},
],
+ "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.
+ "maxCompensation": { # 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.
+ },
+ "minCompensation": { # 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.
+ },
+ },
},
"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
@@ -6180,6 +5910,13 @@
#
# The maximum number of allowed characters is 3,000.
},
+ "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
+ # If this field is set to PostingRegion.NATION or
+ # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
+ # to the same location level as this field is strongly recommended.
"postingExpireTime": "A String", # Optional but strongly recommended for the best service
# experience.
#
@@ -6213,13 +5950,6 @@
# 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.
- "postingRegion": "A String", # Optional. The job PostingRegion (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 posting if an exact location match isn't specified.
- # If this field is set to PostingRegion.NATION or
- # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
- # to the same location level as this field is strongly recommended.
"postingPublishTime": "A String", # Optional. The timestamp this job posting was most recently published. The default
# value is the time the request arrives at the server. Invalid timestamps are
# ignored.
@@ -6265,6 +5995,157 @@
],
},
},
+ "jobLevel": "A String", # Optional. The experience level associated with the job, such as "Entry Level".
+ "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'.
+ "visibility": "A String", # Deprecated. The job is only visible to the owner.
+ #
+ # The visibility of the job.
+ #
+ # Defaults to Visibility.ACCOUNT_ONLY if not specified.
+ "postingUpdateTime": "A String", # Output only. The timestamp when this job posting was last updated.
+ },
+ "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.
+ "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.
+ "jobSummary": "A String", # A summary of the job with core information that's displayed on the search
+ # results listing page.
+ "commuteInfo": { # Output only. # Commute information which is generated based on specified
+ # CommuteFilter.
+ #
+ # 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.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
+ "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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "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/google/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
+ "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.).
+ "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".
+ "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).
+ "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",
+ ],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
+ },
+ "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.
+ },
},
},
],
@@ -6276,10 +6157,6 @@
"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.
},
- "estimatedTotalSize": 42, # An estimation of the number of jobs that match the specified query.
- #
- # This number is not guaranteed to be accurate. For accurate results,
- # see enable_precise_result_size.
"broadenedQueryJobsCount": 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
@@ -6287,9 +6164,132 @@
# set, 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.
+ "estimatedTotalSize": 42, # An estimation of the number of jobs that match the specified query.
+ #
+ # This number is not guaranteed to be accurate. For accurate results,
+ # see enable_precise_result_size.
"totalSize": 42, # 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 is `-1`.
+ "locationFilters": [ # 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.
+ "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
+ # location bounding box in which a circle with the specified radius
+ # centered from LatLng covers the area associated with the job location.
+ # For example, currently, "Mountain View, CA, USA" has a radius of
+ # 6.17 miles.
+ "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.
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ },
+ "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/google/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
+ "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.).
+ "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".
+ "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).
+ "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",
+ ],
+ "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.
+ "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.
+ "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.
+ "organization": "A String", # Optional. The name of the organization at the address.
+ "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",
+ ],
+ "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.
+ },
+ "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.
+ },
+ ],
}</pre>
</div>