blob: a3dc956d6161e4d4c0b00d233d5374b98768769f [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="jobs_v2.html">Cloud Talent Solution API</a> . <a href="jobs_v2.jobs.html">jobs</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070078 <code><a href="#batchDelete">batchDelete(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070079<p class="firstline">Deletes a list of Job postings by filter.</p>
80<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070081 <code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070082<p class="firstline">Creates a new job.</p>
83<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070084 <code><a href="#delete">delete(name, disableFastProcess=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070085<p class="firstline">Deletes the specified job.</p>
86<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070087 <code><a href="#deleteByFilter">deleteByFilter(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070088<p class="firstline">Deprecated. Use BatchDeleteJobs instead.</p>
89<p class="toc_element">
90 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
91<p class="firstline">Retrieves the specified job, whose status is OPEN or recently EXPIRED</p>
92<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070093 <code><a href="#histogram">histogram(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070094<p class="firstline">Deprecated. Use SearchJobsRequest.histogram_facets instead to make</p>
95<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070096 <code><a href="#list">list(idsOnly=None, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070097<p class="firstline">Lists jobs by filter.</p>
98<p class="toc_element">
99 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
100<p class="firstline">Retrieves the next page of results.</p>
101<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700102 <code><a href="#patch">patch(name, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700103<p class="firstline">Updates specified job.</p>
104<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700105 <code><a href="#search">search(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700106<p class="firstline">Searches for jobs using the provided SearchJobsRequest.</p>
107<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700108 <code><a href="#searchForAlert">searchForAlert(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700109<p class="firstline">Searches for jobs using the provided SearchJobsRequest.</p>
110<p class="toc_element">
111 <code><a href="#searchForAlert_next">searchForAlert_next(previous_request, previous_response)</a></code></p>
112<p class="firstline">Retrieves the next page of results.</p>
113<p class="toc_element">
114 <code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
115<p class="firstline">Retrieves the next page of results.</p>
116<h3>Method Details</h3>
117<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700118 <code class="details" id="batchDelete">batchDelete(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700119 <pre>Deletes a list of Job postings by filter.
120
121Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700122 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700123 The object takes the form of:
124
125{ # Input only.
126 #
127 # Batch delete jobs request.
Bu Sun Kim65020912020-05-20 12:08:20 -0700128 &quot;filter&quot;: &quot;A String&quot;, # Required. The filter string specifies the jobs to be deleted.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700129 #
130 # Supported operator: =, AND
131 #
132 # The fields eligible for filtering are:
133 #
134 # * `companyName` (Required)
135 # * `requisitionId` (Required)
136 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700137 # Sample Query: companyName = &quot;companies/123&quot; AND requisitionId = &quot;req-1&quot;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700138 }
139
140 x__xgafv: string, V1 error format.
141 Allowed values
142 1 - v1 error format
143 2 - v2 error format
144
145Returns:
146 An object of the form:
147
148 { # A generic empty message that you can re-use to avoid defining duplicated
149 # empty messages in your APIs. A typical example is to use it as the request
150 # or the response type of an API method. For instance:
151 #
152 # service Foo {
153 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
154 # }
155 #
156 # The JSON representation for `Empty` is empty JSON object `{}`.
157 }</pre>
158</div>
159
160<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700161 <code class="details" id="create">create(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700162 <pre>Creates a new job.
163
164Typically, the job becomes searchable within 10 seconds, but it may take
165up to 5 minutes.
166
167Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700168 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700169 The object takes the form of:
170
171{ # Input only.
172 #
173 # Create job request.
Bu Sun Kim65020912020-05-20 12:08:20 -0700174 &quot;processingOptions&quot;: { # Input only. # Optional. Options for job processing.
175 #
176 # Options for job processing.
177 &quot;disableStreetAddressResolution&quot;: True or False, # Optional. If set to `true`, the service does not attempt to resolve a
178 # more precise address for the job.
179 &quot;htmlSanitization&quot;: &quot;A String&quot;, # Optional. Option for job HTML content sanitization. Applied fields are:
180 #
181 # * description
182 # * applicationInstruction
183 # * incentives
184 # * qualifications
185 # * responsibilities
186 #
187 # HTML tags in these fields may be stripped if sanitiazation is not disabled.
188 #
189 # Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
190 },
191 &quot;disableStreetAddressResolution&quot;: True or False, # Deprecated. Please use processing_options. This flag is ignored if
192 # processing_options is set.
193 #
194 # Optional.
195 #
196 # If set to `true`, the service does not attempt to resolve a
197 # more precise address for the job.
198 &quot;job&quot;: { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot; # Required. The Job to be created.
199 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700200 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -0700201 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
202 # is available. If this field is set, a
203 # LocationFilter in a search query within the job region
204 # finds this job if an exact location match is not specified.
205 # If this field is set, setting job locations
206 # to the same location level as this field is strongly recommended.
207 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
208 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700209 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700210 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700211 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700212 # The name of the company listing the job.
213 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
214 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
215 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700216 # CompensationEntry.expected_units_per_year.
217 #
218 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -0700219 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
220 # to zero and the currency code is set to match the
221 # currency code of max_compensation.
222 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
223 # The value must be between -999,999,999 and +999,999,999 inclusive.
224 # If `units` is positive, `nanos` must be positive or zero.
225 # If `units` is zero, `nanos` can be positive, zero, or negative.
226 # If `units` is negative, `nanos` must be negative or zero.
227 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
228 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
229 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
230 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
231 },
232 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700233 # to a maximal compensation value and the currency code is set to
234 # match the currency code of
235 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700236 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700237 # The value must be between -999,999,999 and +999,999,999 inclusive.
238 # If `units` is positive, `nanos` must be positive or zero.
239 # If `units` is zero, `nanos` can be positive, zero, or negative.
240 # If `units` is negative, `nanos` must be negative or zero.
241 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -0700242 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
243 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
244 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700245 },
246 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700247 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700248 #
249 # Optional.
250 #
251 # The amount of compensation or pay for the job.
252 # As an alternative, compensation_amount_min and
253 # compensation_amount_max may be used to define a range of
254 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700255 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700256 # The value must be between -999,999,999 and +999,999,999 inclusive.
257 # If `units` is positive, `nanos` must be positive or zero.
258 # If `units` is zero, `nanos` can be positive, zero, or negative.
259 # If `units` is negative, `nanos` must be negative or zero.
260 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -0700261 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
262 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
263 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700264 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700265 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
266 #
267 # Optional.
268 #
269 # Type of job compensation.
270 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
271 #
272 # Optional.
273 #
274 # An upper bound on a range for compensation or pay for the job.
275 # The currency type is specified in compensation_amount.
276 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
277 # The value must be between -999,999,999 and +999,999,999 inclusive.
278 # If `units` is positive, `nanos` must be positive or zero.
279 # If `units` is zero, `nanos` can be positive, zero, or negative.
280 # If `units` is negative, `nanos` must be negative or zero.
281 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
282 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
283 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
284 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
285 },
286 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
287 # all compensation entries&#x27; CompensationEntry.compensation times
288 # CompensationEntry.expected_units_per_year.
289 #
290 # See CompensationEntry for explanation on compensation annualization.
291 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
292 # to zero and the currency code is set to match the
293 # currency code of max_compensation.
294 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
295 # The value must be between -999,999,999 and +999,999,999 inclusive.
296 # If `units` is positive, `nanos` must be positive or zero.
297 # If `units` is zero, `nanos` can be positive, zero, or negative.
298 # If `units` is negative, `nanos` must be negative or zero.
299 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
300 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
301 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
302 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
303 },
304 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
305 # to a maximal compensation value and the currency code is set to
306 # match the currency code of
307 # min_compensation.
308 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
309 # The value must be between -999,999,999 and +999,999,999 inclusive.
310 # If `units` is positive, `nanos` must be positive or zero.
311 # If `units` is zero, `nanos` can be positive, zero, or negative.
312 # If `units` is negative, `nanos` must be negative or zero.
313 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
314 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
315 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
316 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
317 },
318 },
319 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
320 #
321 # Optional.
322 #
323 # A lower bound on a range for compensation or pay for the job.
324 # The currency type is specified in compensation_amount.
325 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
326 # The value must be between -999,999,999 and +999,999,999 inclusive.
327 # If `units` is positive, `nanos` must be positive or zero.
328 # If `units` is zero, `nanos` can be positive, zero, or negative.
329 # If `units` is negative, `nanos` must be negative or zero.
330 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
331 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
332 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
333 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
334 },
335 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700336 #
337 # At most one entry can be of type
338 # CompensationInfo.CompensationType.BASE, which is
339 # referred as ** base compensation entry ** for the job.
340 { # A compensation entry that represents one component of compensation, such
341 # as base pay, bonus, or other compensation type.
342 #
343 # Annualization: One compensation entry can be annualized if
344 # - it contains valid amount or range.
345 # - and its expected_units_per_year is set or can be derived.
346 # Its annualized range is determined as (amount or range) times
347 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -0700348 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
349 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
350 # to zero and the currency code is set to match the
351 # currency code of max_compensation.
352 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
353 # The value must be between -999,999,999 and +999,999,999 inclusive.
354 # If `units` is positive, `nanos` must be positive or zero.
355 # If `units` is zero, `nanos` can be positive, zero, or negative.
356 # If `units` is negative, `nanos` must be negative or zero.
357 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
358 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
359 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
360 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
361 },
362 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700363 # to a maximal compensation value and the currency code is set to
364 # match the currency code of
365 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700366 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700367 # The value must be between -999,999,999 and +999,999,999 inclusive.
368 # If `units` is positive, `nanos` must be positive or zero.
369 # If `units` is zero, `nanos` can be positive, zero, or negative.
370 # If `units` is negative, `nanos` must be negative or zero.
371 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -0700372 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
373 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
374 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700375 },
376 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700377 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700378 # Job.employment_types is FULLTIME, a default value is inferred
379 # based on unit. Default values:
380 # - HOURLY: 2080
381 # - DAILY: 260
382 # - WEEKLY: 52
383 # - MONTHLY: 12
384 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -0700385 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
386 # indicate equity terms or provide additional context to an estimated
387 # bonus.
388 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
389 #
390 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
391 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
392 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700393 # The value must be between -999,999,999 and +999,999,999 inclusive.
394 # If `units` is positive, `nanos` must be positive or zero.
395 # If `units` is zero, `nanos` can be positive, zero, or negative.
396 # If `units` is negative, `nanos` must be negative or zero.
397 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -0700398 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
399 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
400 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700401 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700402 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700403 },
404 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700405 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700406 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
407 # recommended as an alternative to using the more general description
408 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700409 #
410 # This field accepts and sanitizes HTML input, and also accepts
411 # bold, italic, ordered list, and unordered list markup tags.
412 #
413 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -0700414 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700415 # experience.
416 #
417 # The expiration timestamp of the job. After this timestamp, the
418 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -0700419 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700420 # ListJobs APIs, but it can be retrieved with the GetJob API or
421 # updated with the UpdateJob API. An expired job can be updated and
422 # opened again by using a future expiration timestamp. Updating an expired
423 # job fails if there is another existing open job with same
424 # requisition_id, company_name and language_code.
425 #
426 # The expired jobs are retained in our system for 90 days. However, the
427 # overall expired job count cannot exceed 3 times the maximum of open jobs
428 # count over the past week, otherwise jobs with earlier expire time are
429 # cleaned first. Expired jobs are no longer accessible after they are cleaned
430 # out.
431 # The format of this field is RFC 3339 date strings. Example:
432 # 2000-01-01T00:00:00.999999999Z
433 # See
434 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
435 #
436 # A valid date range is between 1970-01-01T00:00:00.0Z and
437 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
438 # time not provided.
439 #
440 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -0700441 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700442 # example, if the job was created on 2017/01/01 13:00AM UTC with an
443 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
444 #
445 # If this value is not provided but expiry_date is, expiry_date is
446 # used.
447 #
448 # If this value is not provided on job update, it depends on the field masks
449 # set by UpdateJobRequest.update_job_fields. If the field masks include
450 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -0700451 # updated, the job posting expires after 30 days from the job&#x27;s last
452 # update time. Otherwise the expiration date isn&#x27;t updated.
453 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
454 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
455 { # Output only.
456 #
457 # A resource that represents a location with full geographic
458 # information.
459 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
460 # such as postal delivery and payments addresses. Given a postal address,
461 # a postal service can deliver items to a premises, P.O. Box, or other
462 # delivery location.
463 # Given a postal address, a postal service can deliver items to a premise, P.O.
464 # Box or similar.
465 # It is not intended to model geographical locations (roads, towns,
466 # mountains).
467 #
468 # In typical usage an address would be created via user input or from importing
469 # existing data, depending on the type of process.
470 #
471 # Advice on address input / editing:
472 # - Use an i18n-ready address widget such as
473 # https://github.com/google/libaddressinput)
474 # - Users should not be presented with UI elements for input or editing of
475 # fields outside countries where that field is used.
476 #
477 # For more guidance on how to use this schema, please see:
478 # https://support.google.com/business/answer/6397478
479 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
480 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
481 # is never inferred and it is up to the user to ensure the value is
482 # correct. See http://cldr.unicode.org/ and
483 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
484 # for details. Example: &quot;CH&quot; for Switzerland.
485 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
486 #
487 # Because values in address_lines do not have type information and may
488 # sometimes contain multiple values in a single field (e.g.
489 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
490 # address lines should be &quot;envelope order&quot; for the country/region of the
491 # address. In places where this can vary (e.g. Japan), address_language is
492 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
493 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
494 # an address can be selected based on the language.
495 #
496 # The minimum permitted structural representation of an address consists
497 # of a region_code with all remaining information placed in the
498 # address_lines. It would be possible to format such an address very
499 # approximately without geocoding, but no semantic reasoning could be
500 # made about any of the address components until it was at least
501 # partially resolved.
502 #
503 # Creating an address only containing a region_code and address_lines, and
504 # then geocoding is the recommended way to handle completely unstructured
505 # addresses (as opposed to guessing which parts of the address should be
506 # localities or administrative areas).
507 &quot;A String&quot;,
508 ],
509 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
510 # postal codes to be present, but where they are used, they may trigger
511 # additional validation with other parts of the address (e.g. state/zip
512 # validation in the U.S.A.).
513 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
514 # in most regions. Where it is used, the value is either a string like
515 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
516 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
517 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
518 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
519 # known). This is often the UI language of the input form or is expected
520 # to match one of the languages used in the address&#x27; country/region, or their
521 # transliterated equivalents.
522 # This can affect formatting in certain countries, but is not critical
523 # to the correctness of the data and will never affect any validation or
524 # other non-formatting related operations.
525 #
526 # If this value is not known, it should be omitted (rather than specifying a
527 # possibly incorrect default).
528 #
529 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
530 &quot;recipients&quot;: [ # Optional. The recipient at the address.
531 # This field may, under certain circumstances, contain multiline information.
532 # For example, it might contain &quot;care of&quot; information.
533 &quot;A String&quot;,
534 ],
535 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
536 # For example, this can be neighborhoods, boroughs, districts.
537 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
538 # the latest revision.
539 #
540 # All new revisions **must** be backward compatible with old revisions.
541 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
542 # addresses of a country or region.
543 # For example, this can be a state, a province, an oblast, or a prefecture.
544 # Specifically, for Spain this is the province and not the autonomous
545 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
546 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
547 # in Switzerland this should be left unpopulated.
548 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
549 # Examples: US city, IT comune, UK post town.
550 # In regions of the world where localities are not well defined or do not fit
551 # into this structure well, leave locality empty and use address_lines.
552 },
553 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
554 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
555 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
556 # LocationType#LOCALITY.
557 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
558 # location bounding box in which a circle with the specified radius
559 # centered from LatLng coves the area associated with the job location.
560 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
561 # 7885.79 meters.
562 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
563 # of doubles representing degrees latitude and degrees longitude. Unless
564 # specified otherwise, this must conform to the
565 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
566 # standard&lt;/a&gt;. Values must be within normalized ranges.
567 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
568 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
569 },
570 },
571 ],
572 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
573 # position.
574 #
575 # The maximum number of allowed characters is 255.
576 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
577 #
578 # Optional.
579 #
580 # A map of fields to hold non-filterable custom job attributes, similar to
581 # filterable_custom_fields. These fields are distinct in that the data
582 # in these fields are not indexed. Therefore, the client cannot search
583 # against them, nor can the client use them to list jobs.
584 #
585 # The key of the map can be any valid string.
586 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
587 &quot;values&quot;: [ # Optional. The values of the custom data.
588 &quot;A String&quot;,
589 ],
590 },
591 },
592 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
593 #
594 # Optional but strongly recommended to be provided for the best service
595 # experience.
596 #
597 # The expiration date of the job in UTC time. After 12 am on this date, the
598 # job is marked as expired, and it no longer appears in search results.
599 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
600 # ListJobs APIs, but it can be retrieved with the GetJob API or
601 # updated with the UpdateJob API. An expired job can be updated and
602 # opened again by using a future expiration date. It can also remain expired.
603 # Updating an expired job to be open fails if there is another existing open
604 # job with same requisition_id, company_name and language_code.
605 #
606 # The expired jobs are retained in our system for 90 days. However, the
607 # overall expired job count cannot exceed 3 times the maximum of open jobs
608 # count over the past week, otherwise jobs with earlier expire time are
609 # removed first. Expired jobs are no longer accessible after they are cleaned
610 # out.
611 #
612 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
613 # ignored and treated as expiry date not provided.
614 #
615 # If this value is not provided on job creation or is invalid, the job
616 # posting expires after 30 days from the job&#x27;s creation time. For example, if
617 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
618 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
619 #
620 # If this value is not provided on job update, it depends on the field masks
621 # set by UpdateJobRequest.update_job_fields. If the field masks include
622 # expiry_date, or the masks are empty meaning that every field is
623 # updated, the job expires after 30 days from the job&#x27;s last update time.
624 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700625 # and time zone are either specified elsewhere or are not significant. The date
626 # is relative to the Proleptic Gregorian Calendar. This can represent:
627 #
628 # * A full date, with non-zero year, month and day values
629 # * A month and day value, with a zero year, e.g. an anniversary
630 # * A year on its own, with zero month and day values
631 # * A year and month value, with a zero day, e.g. a credit card expiration date
632 #
633 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700634 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700635 # if specifying a year by itself or a year and month where the day is not
636 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -0700637 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700638 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -0700639 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
640 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700641 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700642 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
643 # is used for contracting engagements.
644 # Dates prior to 1970/1/1 and invalid date formats are ignored.
645 # and time zone are either specified elsewhere or are not significant. The date
646 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700647 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700648 # * A full date, with non-zero year, month and day values
649 # * A month and day value, with a zero year, e.g. an anniversary
650 # * A year on its own, with zero month and day values
651 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700652 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700653 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
654 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
655 # if specifying a year by itself or a year and month where the day is not
656 # significant.
657 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
658 # a year.
659 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
660 # month and day.
661 },
662 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
663 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
664 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700665 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700666 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700667 # attributes that are not covered by the provided structured fields.
668 #
669 # This field is a more general combination of the deprecated id-based
670 # filterable_custom_fields and string-based
671 # non_filterable_custom_fields.
672 #
673 # The keys of the map are strings up to 64 bytes and must match the
674 # pattern: a-zA-Z*.
675 #
676 # At most 100 filterable and at most 100 unfilterable keys are supported.
677 # For filterable `string_values`, across all keys at most 200 values are
678 # allowed, with each string no more than 255 characters. For unfilterable
679 # `string_values`, the maximum total size of `string_values` across all keys
680 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -0700681 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
682 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700683 # If false, values are not searchable.
684 #
685 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -0700686 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
687 # be specified.
688 #
689 # This field is used to perform number range search.
690 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
691 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
692 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700693 # be specified.
694 #
695 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
696 # `CASE_INSENSITIVE_MATCH`) search.
697 # For filterable `string_values`, a maximum total number of 200 values
698 # is allowed, with each `string_value` has a byte size of no more than
699 # 255B. For unfilterable `string_values`, the maximum total byte size of
700 # unfilterable `string_values` is 50KB.
701 #
702 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700703 &quot;values&quot;: [ # Required. String values.
704 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700705 ],
706 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700707 },
708 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700709 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
710 #
711 # Optional.
712 #
713 # A map of fields to hold filterable custom job attributes not captured by
714 # the standard fields such as job_title, company_name, or
715 # level. These custom fields store arbitrary
716 # string values, and can be used for purposes not covered by
717 # the structured fields. For the best search experience, use of the
718 # structured rather than custom fields is recommended.
719 #
720 # Data stored in these custom fields fields are indexed and
721 # searched against by keyword searches (see
722 # SearchJobsRequest.custom_field_filters][]).
723 #
724 # The map key must be a number between 1-20. If an invalid key is
725 # provided on job create or update, an error is returned.
726 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
727 &quot;values&quot;: [ # Optional. The values of the custom data.
728 &quot;A String&quot;,
729 ],
730 },
731 },
732 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
733 # any requirements for fluency that are associated with the job.
734 #
735 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
736 # For more information, see
737 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
738 # class=&quot;external&quot; target=&quot;_blank&quot; }.
739 #
740 # If this field is unspecified and Job.description is present, detected
741 # language code based on Job.description is assigned, otherwise
742 # defaults to &#x27;en_US&#x27;.
743 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
744 # Defaults to JobVisibility.PRIVATE if not specified.
745 # Currently only JobVisibility.PRIVATE is supported.
746 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
747 #
748 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
749 # of this field in job queries and API calls is preferred over the use of
750 # requisition_id since this value is unique.
751 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700752 # provided.
753 #
754 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -0700755 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700756 # this field, and is the recommended field to use to identify companies.
757 #
758 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -0700759 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
760 # The value determines the sort order of the jobs returned when searching for
761 # jobs using the featured jobs search call, with higher promotional values
762 # being returned first and ties being resolved by relevance sort. Only the
763 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
764 #
765 # Default value is 0, and negative values are treated as 0.
766 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
767 # value is the time the request arrives at the server.
768 # and time zone are either specified elsewhere or are not significant. The date
769 # is relative to the Proleptic Gregorian Calendar. This can represent:
770 #
771 # * A full date, with non-zero year, month and day values
772 # * A month and day value, with a zero year, e.g. an anniversary
773 # * A year on its own, with zero month and day values
774 # * A year and month value, with a zero day, e.g. a credit card expiration date
775 #
776 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
777 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
778 # if specifying a year by itself or a year and month where the day is not
779 # significant.
780 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
781 # a year.
782 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
783 # month and day.
784 },
785 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
786 # application_email_list or application_instruction must be
787 # specified.
788 #
789 # Use this URL field to direct an applicant to a website, for example to
790 # link to an online application form.
791 #
792 # The maximum number of allowed characters is 2,000.
793 &quot;A String&quot;,
794 ],
795 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
796 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
797 # client to identify a job. This field is intended to be used by clients
798 # for client identification and tracking of listings. A job is not allowed
799 # to be created if there is another job with the same requisition_id,
800 # company_name and language_code.
801 #
802 # The maximum number of allowed characters is 255.
803 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
804 # job. The use of this field is recommended
805 # as an alternative to using the more general description field.
806 #
807 # This field accepts and sanitizes HTML input, and also accepts
808 # bold, italic, ordered list, and unordered list markup tags.
809 #
810 # The maximum number of allowed characters is 10,000.
811 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
812 # is used for contracting engagements.
813 # Dates prior to 1970/1/1 and invalid date formats are ignored.
814 # and time zone are either specified elsewhere or are not significant. The date
815 # is relative to the Proleptic Gregorian Calendar. This can represent:
816 #
817 # * A full date, with non-zero year, month and day values
818 # * A month and day value, with a zero year, e.g. an anniversary
819 # * A year on its own, with zero month and day values
820 # * A year and month value, with a zero day, e.g. a credit card expiration date
821 #
822 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
823 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
824 # if specifying a year by itself or a year and month where the day is not
825 # significant.
826 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
827 # a year.
828 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
829 # month and day.
830 },
831 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
832 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
833 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
834 # application_email_list or application_instruction must be
835 # specified.
836 #
837 # Use this field to provide instructions, such as &quot;Mail your application
838 # to ...&quot;, that a candidate can follow to apply for the job.
839 #
840 # This field accepts and sanitizes HTML input, and also accepts
841 # bold, italic, ordered list, and unordered list markup tags.
842 #
843 # The maximum number of allowed characters is 3,000.
844 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
845 &quot;A String&quot;,
846 ],
847 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
848 # incentives associated with the job not including salary or pay.
849 #
850 # The maximum number of allowed characters is 10,000.
851 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
852 # full time or
853 # part time.
854 &quot;A String&quot;,
855 ],
856 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
857 #
858 # Location(s) where the emploeyer is looking to hire for this job posting.
859 #
860 # Specifying the full street address(es) of the hiring location enables
861 # better API results, especially job searches by commute time.
862 #
863 # At most 50 locations are allowed for best search performance. If a job has
864 # more locations, it is suggested to split it into multiple jobs with unique
865 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
866 # multiple jobs with the same requisition_id, company_name and
867 # language_code are not allowed. If the original requisition_id must
868 # be preserved, a custom field should be used for storage. It is also
869 # suggested to group the locations that close to each other in the same job
870 # for better search experience.
871 #
872 # The maximum number of allowed characters is 500.
873 &quot;A String&quot;,
874 ],
875 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
876 #
877 # Optional.
878 #
879 # Job compensation information.
880 #
881 # This field replaces compensation_info. Only
882 # CompensationInfo.entries or extended_compensation_info can be set,
883 # otherwise an exception is thrown.
884 #
885 # Describes job compensation.
886 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
887 # currency code.
888 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
889 #
890 # Compensation range.
891 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
892 #
893 # Decimal number.
894 &quot;micros&quot;: 42, # Micro (10^-6) units.
895 # The value must be between -999,999 and +999,999 inclusive.
896 # If `units` is positive, `micros` must be positive or zero.
897 # If `units` is zero, `micros` can be positive, zero, or negative.
898 # If `units` is negative, `micros` must be negative or zero.
899 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
900 &quot;units&quot;: &quot;A String&quot;, # Whole units.
901 },
902 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
903 #
904 # Decimal number.
905 &quot;micros&quot;: 42, # Micro (10^-6) units.
906 # The value must be between -999,999 and +999,999 inclusive.
907 # If `units` is positive, `micros` must be positive or zero.
908 # If `units` is zero, `micros` can be positive, zero, or negative.
909 # If `units` is negative, `micros` must be negative or zero.
910 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
911 &quot;units&quot;: &quot;A String&quot;, # Whole units.
912 },
913 },
914 &quot;entries&quot;: [ # Optional. Job compensation information.
915 #
916 # At most one entry can be of type
917 # ExtendedCompensationInfo.CompensationType.BASE, which is
918 # referred as ** base compensation entry ** for the job.
919 { # Deprecated. See CompensationInfo.
920 #
921 # A compensation entry that represents one component of compensation, such
922 # as base pay, bonus, or other compensation type.
923 #
924 # Annualization: One compensation entry can be annualized if
925 # - it contains valid amount or range.
926 # - and its expected_units_per_year is set or can be derived.
927 # Its annualized range is determined as (amount or range) times
928 # expected_units_per_year.
929 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
930 #
931 # Compensation range.
932 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
933 #
934 # Decimal number.
935 &quot;micros&quot;: 42, # Micro (10^-6) units.
936 # The value must be between -999,999 and +999,999 inclusive.
937 # If `units` is positive, `micros` must be positive or zero.
938 # If `units` is zero, `micros` can be positive, zero, or negative.
939 # If `units` is negative, `micros` must be negative or zero.
940 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
941 &quot;units&quot;: &quot;A String&quot;, # Whole units.
942 },
943 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
944 #
945 # Decimal number.
946 &quot;micros&quot;: 42, # Micro (10^-6) units.
947 # The value must be between -999,999 and +999,999 inclusive.
948 # If `units` is positive, `micros` must be positive or zero.
949 # If `units` is zero, `micros` can be positive, zero, or negative.
950 # If `units` is negative, `micros` must be negative or zero.
951 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
952 &quot;units&quot;: &quot;A String&quot;, # Whole units.
953 },
954 },
955 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
956 # Job.employment_types is FULLTIME, a default value is inferred
957 # based on unit. Default values:
958 # - HOURLY: 2080
959 # - DAILY: 260
960 # - WEEKLY: 52
961 # - MONTHLY: 12
962 # - ANNUAL: 1
963 #
964 # Decimal number.
965 &quot;micros&quot;: 42, # Micro (10^-6) units.
966 # The value must be between -999,999 and +999,999 inclusive.
967 # If `units` is positive, `micros` must be positive or zero.
968 # If `units` is zero, `micros` can be positive, zero, or negative.
969 # If `units` is negative, `micros` must be negative or zero.
970 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
971 &quot;units&quot;: &quot;A String&quot;, # Whole units.
972 },
973 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
974 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
975 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
976 #
977 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
978 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
979 #
980 # Decimal number.
981 &quot;micros&quot;: 42, # Micro (10^-6) units.
982 # The value must be between -999,999 and +999,999 inclusive.
983 # If `units` is positive, `micros` must be positive or zero.
984 # If `units` is zero, `micros` can be positive, zero, or negative.
985 # If `units` is negative, `micros` must be negative or zero.
986 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
987 &quot;units&quot;: &quot;A String&quot;, # Whole units.
988 },
989 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
990 },
991 ],
992 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
993 # the job&#x27;s all CompensationEntry cannot be annualized.
994 # See CompensationEntry for explanation on annualization and base
995 # compensation entry.
996 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
997 #
998 # Compensation range.
999 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
1000 #
1001 # Decimal number.
1002 &quot;micros&quot;: 42, # Micro (10^-6) units.
1003 # The value must be between -999,999 and +999,999 inclusive.
1004 # If `units` is positive, `micros` must be positive or zero.
1005 # If `units` is zero, `micros` can be positive, zero, or negative.
1006 # If `units` is negative, `micros` must be negative or zero.
1007 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1008 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1009 },
1010 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
1011 #
1012 # Decimal number.
1013 &quot;micros&quot;: 42, # Micro (10^-6) units.
1014 # The value must be between -999,999 and +999,999 inclusive.
1015 # If `units` is positive, `micros` must be positive or zero.
1016 # If `units` is zero, `micros` can be positive, zero, or negative.
1017 # If `units` is negative, `micros` must be negative or zero.
1018 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1019 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1020 },
1021 },
1022 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
1023 # the job&#x27;s base compensation entry cannot be annualized.
1024 # See CompensationEntry for explanation on annualization and base
1025 # compensation entry.
1026 },
1027 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
1028 # provided.
1029 #
1030 # The resource name of the company listing the job, such as
1031 # /companies/foo. This field takes precedence over the
1032 # distributor-assigned company identifier, distributor_company_id.
1033 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
1034 # description of the company and related information. Separate fields are
1035 # provided on the job object for responsibilities,
1036 # qualifications, and other job characteristics. Use of
1037 # these separate job fields is recommended.
1038 #
1039 # This field accepts and sanitizes HTML input, and also accepts
1040 # bold, italic, ordered list, and unordered list markup tags.
1041 #
1042 # The maximum number of allowed characters is 100,000.
1043 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
1044 # application_email_list or application_instruction must be
1045 # specified.
1046 #
1047 # Use this field to specify email address(es) to which resumes or
1048 # applications can be sent.
1049 #
1050 # The maximum number of allowed characters is 255.
1051 &quot;A String&quot;,
1052 ],
1053 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
1054 #
1055 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001056 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001057 }
1058
1059 x__xgafv: string, V1 error format.
1060 Allowed values
1061 1 - v1 error format
1062 2 - v2 error format
1063
1064Returns:
1065 An object of the form:
1066
Bu Sun Kim65020912020-05-20 12:08:20 -07001067 { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot;
1068 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001069 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07001070 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
1071 # is available. If this field is set, a
1072 # LocationFilter in a search query within the job region
1073 # finds this job if an exact location match is not specified.
1074 # If this field is set, setting job locations
1075 # to the same location level as this field is strongly recommended.
1076 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
1077 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001078 #
Bu Sun Kim65020912020-05-20 12:08:20 -07001079 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001080 #
Bu Sun Kim65020912020-05-20 12:08:20 -07001081 # The name of the company listing the job.
1082 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
1083 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
1084 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001085 # CompensationEntry.expected_units_per_year.
1086 #
1087 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07001088 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
1089 # to zero and the currency code is set to match the
1090 # currency code of max_compensation.
1091 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1092 # The value must be between -999,999,999 and +999,999,999 inclusive.
1093 # If `units` is positive, `nanos` must be positive or zero.
1094 # If `units` is zero, `nanos` can be positive, zero, or negative.
1095 # If `units` is negative, `nanos` must be negative or zero.
1096 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1097 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1098 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1099 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1100 },
1101 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001102 # to a maximal compensation value and the currency code is set to
1103 # match the currency code of
1104 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07001105 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001106 # The value must be between -999,999,999 and +999,999,999 inclusive.
1107 # If `units` is positive, `nanos` must be positive or zero.
1108 # If `units` is zero, `nanos` can be positive, zero, or negative.
1109 # If `units` is negative, `nanos` must be negative or zero.
1110 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07001111 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1112 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1113 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001114 },
1115 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001116 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001117 #
1118 # Optional.
1119 #
1120 # The amount of compensation or pay for the job.
1121 # As an alternative, compensation_amount_min and
1122 # compensation_amount_max may be used to define a range of
1123 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07001124 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001125 # The value must be between -999,999,999 and +999,999,999 inclusive.
1126 # If `units` is positive, `nanos` must be positive or zero.
1127 # If `units` is zero, `nanos` can be positive, zero, or negative.
1128 # If `units` is negative, `nanos` must be negative or zero.
1129 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07001130 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1131 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1132 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001133 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001134 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
1135 #
1136 # Optional.
1137 #
1138 # Type of job compensation.
1139 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
1140 #
1141 # Optional.
1142 #
1143 # An upper bound on a range for compensation or pay for the job.
1144 # The currency type is specified in compensation_amount.
1145 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1146 # The value must be between -999,999,999 and +999,999,999 inclusive.
1147 # If `units` is positive, `nanos` must be positive or zero.
1148 # If `units` is zero, `nanos` can be positive, zero, or negative.
1149 # If `units` is negative, `nanos` must be negative or zero.
1150 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1151 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1152 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1153 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1154 },
1155 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
1156 # all compensation entries&#x27; CompensationEntry.compensation times
1157 # CompensationEntry.expected_units_per_year.
1158 #
1159 # See CompensationEntry for explanation on compensation annualization.
1160 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
1161 # to zero and the currency code is set to match the
1162 # currency code of max_compensation.
1163 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1164 # The value must be between -999,999,999 and +999,999,999 inclusive.
1165 # If `units` is positive, `nanos` must be positive or zero.
1166 # If `units` is zero, `nanos` can be positive, zero, or negative.
1167 # If `units` is negative, `nanos` must be negative or zero.
1168 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1169 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1170 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1171 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1172 },
1173 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
1174 # to a maximal compensation value and the currency code is set to
1175 # match the currency code of
1176 # min_compensation.
1177 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1178 # The value must be between -999,999,999 and +999,999,999 inclusive.
1179 # If `units` is positive, `nanos` must be positive or zero.
1180 # If `units` is zero, `nanos` can be positive, zero, or negative.
1181 # If `units` is negative, `nanos` must be negative or zero.
1182 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1183 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1184 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1185 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1186 },
1187 },
1188 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
1189 #
1190 # Optional.
1191 #
1192 # A lower bound on a range for compensation or pay for the job.
1193 # The currency type is specified in compensation_amount.
1194 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1195 # The value must be between -999,999,999 and +999,999,999 inclusive.
1196 # If `units` is positive, `nanos` must be positive or zero.
1197 # If `units` is zero, `nanos` can be positive, zero, or negative.
1198 # If `units` is negative, `nanos` must be negative or zero.
1199 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1200 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1201 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1202 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1203 },
1204 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001205 #
1206 # At most one entry can be of type
1207 # CompensationInfo.CompensationType.BASE, which is
1208 # referred as ** base compensation entry ** for the job.
1209 { # A compensation entry that represents one component of compensation, such
1210 # as base pay, bonus, or other compensation type.
1211 #
1212 # Annualization: One compensation entry can be annualized if
1213 # - it contains valid amount or range.
1214 # - and its expected_units_per_year is set or can be derived.
1215 # Its annualized range is determined as (amount or range) times
1216 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07001217 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
1218 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
1219 # to zero and the currency code is set to match the
1220 # currency code of max_compensation.
1221 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
1222 # The value must be between -999,999,999 and +999,999,999 inclusive.
1223 # If `units` is positive, `nanos` must be positive or zero.
1224 # If `units` is zero, `nanos` can be positive, zero, or negative.
1225 # If `units` is negative, `nanos` must be negative or zero.
1226 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
1227 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1228 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1229 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
1230 },
1231 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001232 # to a maximal compensation value and the currency code is set to
1233 # match the currency code of
1234 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07001235 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001236 # The value must be between -999,999,999 and +999,999,999 inclusive.
1237 # If `units` is positive, `nanos` must be positive or zero.
1238 # If `units` is zero, `nanos` can be positive, zero, or negative.
1239 # If `units` is negative, `nanos` must be negative or zero.
1240 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07001241 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1242 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1243 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001244 },
1245 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001246 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001247 # Job.employment_types is FULLTIME, a default value is inferred
1248 # based on unit. Default values:
1249 # - HOURLY: 2080
1250 # - DAILY: 260
1251 # - WEEKLY: 52
1252 # - MONTHLY: 12
1253 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07001254 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
1255 # indicate equity terms or provide additional context to an estimated
1256 # bonus.
1257 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
1258 #
1259 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
1260 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
1261 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001262 # The value must be between -999,999,999 and +999,999,999 inclusive.
1263 # If `units` is positive, `nanos` must be positive or zero.
1264 # If `units` is zero, `nanos` can be positive, zero, or negative.
1265 # If `units` is negative, `nanos` must be negative or zero.
1266 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07001267 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
1268 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
1269 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001270 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001271 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001272 },
1273 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001274 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001275 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
1276 # recommended as an alternative to using the more general description
1277 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001278 #
1279 # This field accepts and sanitizes HTML input, and also accepts
1280 # bold, italic, ordered list, and unordered list markup tags.
1281 #
1282 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07001283 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001284 # experience.
1285 #
1286 # The expiration timestamp of the job. After this timestamp, the
1287 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07001288 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001289 # ListJobs APIs, but it can be retrieved with the GetJob API or
1290 # updated with the UpdateJob API. An expired job can be updated and
1291 # opened again by using a future expiration timestamp. Updating an expired
1292 # job fails if there is another existing open job with same
1293 # requisition_id, company_name and language_code.
1294 #
1295 # The expired jobs are retained in our system for 90 days. However, the
1296 # overall expired job count cannot exceed 3 times the maximum of open jobs
1297 # count over the past week, otherwise jobs with earlier expire time are
1298 # cleaned first. Expired jobs are no longer accessible after they are cleaned
1299 # out.
1300 # The format of this field is RFC 3339 date strings. Example:
1301 # 2000-01-01T00:00:00.999999999Z
1302 # See
1303 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
1304 #
1305 # A valid date range is between 1970-01-01T00:00:00.0Z and
1306 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
1307 # time not provided.
1308 #
1309 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07001310 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001311 # example, if the job was created on 2017/01/01 13:00AM UTC with an
1312 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
1313 #
1314 # If this value is not provided but expiry_date is, expiry_date is
1315 # used.
1316 #
1317 # If this value is not provided on job update, it depends on the field masks
1318 # set by UpdateJobRequest.update_job_fields. If the field masks include
1319 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07001320 # updated, the job posting expires after 30 days from the job&#x27;s last
1321 # update time. Otherwise the expiration date isn&#x27;t updated.
1322 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
1323 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
1324 { # Output only.
1325 #
1326 # A resource that represents a location with full geographic
1327 # information.
1328 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
1329 # such as postal delivery and payments addresses. Given a postal address,
1330 # a postal service can deliver items to a premises, P.O. Box, or other
1331 # delivery location.
1332 # Given a postal address, a postal service can deliver items to a premise, P.O.
1333 # Box or similar.
1334 # It is not intended to model geographical locations (roads, towns,
1335 # mountains).
1336 #
1337 # In typical usage an address would be created via user input or from importing
1338 # existing data, depending on the type of process.
1339 #
1340 # Advice on address input / editing:
1341 # - Use an i18n-ready address widget such as
1342 # https://github.com/google/libaddressinput)
1343 # - Users should not be presented with UI elements for input or editing of
1344 # fields outside countries where that field is used.
1345 #
1346 # For more guidance on how to use this schema, please see:
1347 # https://support.google.com/business/answer/6397478
1348 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
1349 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
1350 # is never inferred and it is up to the user to ensure the value is
1351 # correct. See http://cldr.unicode.org/ and
1352 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
1353 # for details. Example: &quot;CH&quot; for Switzerland.
1354 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
1355 #
1356 # Because values in address_lines do not have type information and may
1357 # sometimes contain multiple values in a single field (e.g.
1358 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
1359 # address lines should be &quot;envelope order&quot; for the country/region of the
1360 # address. In places where this can vary (e.g. Japan), address_language is
1361 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
1362 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
1363 # an address can be selected based on the language.
1364 #
1365 # The minimum permitted structural representation of an address consists
1366 # of a region_code with all remaining information placed in the
1367 # address_lines. It would be possible to format such an address very
1368 # approximately without geocoding, but no semantic reasoning could be
1369 # made about any of the address components until it was at least
1370 # partially resolved.
1371 #
1372 # Creating an address only containing a region_code and address_lines, and
1373 # then geocoding is the recommended way to handle completely unstructured
1374 # addresses (as opposed to guessing which parts of the address should be
1375 # localities or administrative areas).
1376 &quot;A String&quot;,
1377 ],
1378 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
1379 # postal codes to be present, but where they are used, they may trigger
1380 # additional validation with other parts of the address (e.g. state/zip
1381 # validation in the U.S.A.).
1382 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
1383 # in most regions. Where it is used, the value is either a string like
1384 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
1385 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
1386 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
1387 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
1388 # known). This is often the UI language of the input form or is expected
1389 # to match one of the languages used in the address&#x27; country/region, or their
1390 # transliterated equivalents.
1391 # This can affect formatting in certain countries, but is not critical
1392 # to the correctness of the data and will never affect any validation or
1393 # other non-formatting related operations.
1394 #
1395 # If this value is not known, it should be omitted (rather than specifying a
1396 # possibly incorrect default).
1397 #
1398 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
1399 &quot;recipients&quot;: [ # Optional. The recipient at the address.
1400 # This field may, under certain circumstances, contain multiline information.
1401 # For example, it might contain &quot;care of&quot; information.
1402 &quot;A String&quot;,
1403 ],
1404 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
1405 # For example, this can be neighborhoods, boroughs, districts.
1406 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
1407 # the latest revision.
1408 #
1409 # All new revisions **must** be backward compatible with old revisions.
1410 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
1411 # addresses of a country or region.
1412 # For example, this can be a state, a province, an oblast, or a prefecture.
1413 # Specifically, for Spain this is the province and not the autonomous
1414 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
1415 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
1416 # in Switzerland this should be left unpopulated.
1417 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
1418 # Examples: US city, IT comune, UK post town.
1419 # In regions of the world where localities are not well defined or do not fit
1420 # into this structure well, leave locality empty and use address_lines.
1421 },
1422 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
1423 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
1424 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
1425 # LocationType#LOCALITY.
1426 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
1427 # location bounding box in which a circle with the specified radius
1428 # centered from LatLng coves the area associated with the job location.
1429 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
1430 # 7885.79 meters.
1431 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
1432 # of doubles representing degrees latitude and degrees longitude. Unless
1433 # specified otherwise, this must conform to the
1434 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
1435 # standard&lt;/a&gt;. Values must be within normalized ranges.
1436 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
1437 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
1438 },
1439 },
1440 ],
1441 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
1442 # position.
1443 #
1444 # The maximum number of allowed characters is 255.
1445 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
1446 #
1447 # Optional.
1448 #
1449 # A map of fields to hold non-filterable custom job attributes, similar to
1450 # filterable_custom_fields. These fields are distinct in that the data
1451 # in these fields are not indexed. Therefore, the client cannot search
1452 # against them, nor can the client use them to list jobs.
1453 #
1454 # The key of the map can be any valid string.
1455 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
1456 &quot;values&quot;: [ # Optional. The values of the custom data.
1457 &quot;A String&quot;,
1458 ],
1459 },
1460 },
1461 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
1462 #
1463 # Optional but strongly recommended to be provided for the best service
1464 # experience.
1465 #
1466 # The expiration date of the job in UTC time. After 12 am on this date, the
1467 # job is marked as expired, and it no longer appears in search results.
1468 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
1469 # ListJobs APIs, but it can be retrieved with the GetJob API or
1470 # updated with the UpdateJob API. An expired job can be updated and
1471 # opened again by using a future expiration date. It can also remain expired.
1472 # Updating an expired job to be open fails if there is another existing open
1473 # job with same requisition_id, company_name and language_code.
1474 #
1475 # The expired jobs are retained in our system for 90 days. However, the
1476 # overall expired job count cannot exceed 3 times the maximum of open jobs
1477 # count over the past week, otherwise jobs with earlier expire time are
1478 # removed first. Expired jobs are no longer accessible after they are cleaned
1479 # out.
1480 #
1481 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
1482 # ignored and treated as expiry date not provided.
1483 #
1484 # If this value is not provided on job creation or is invalid, the job
1485 # posting expires after 30 days from the job&#x27;s creation time. For example, if
1486 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
1487 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
1488 #
1489 # If this value is not provided on job update, it depends on the field masks
1490 # set by UpdateJobRequest.update_job_fields. If the field masks include
1491 # expiry_date, or the masks are empty meaning that every field is
1492 # updated, the job expires after 30 days from the job&#x27;s last update time.
1493 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001494 # and time zone are either specified elsewhere or are not significant. The date
1495 # is relative to the Proleptic Gregorian Calendar. This can represent:
1496 #
1497 # * A full date, with non-zero year, month and day values
1498 # * A month and day value, with a zero year, e.g. an anniversary
1499 # * A year on its own, with zero month and day values
1500 # * A year and month value, with a zero day, e.g. a credit card expiration date
1501 #
1502 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07001503 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001504 # if specifying a year by itself or a year and month where the day is not
1505 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07001506 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001507 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07001508 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1509 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001510 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001511 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
1512 # is used for contracting engagements.
1513 # Dates prior to 1970/1/1 and invalid date formats are ignored.
1514 # and time zone are either specified elsewhere or are not significant. The date
1515 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001516 #
Bu Sun Kim65020912020-05-20 12:08:20 -07001517 # * A full date, with non-zero year, month and day values
1518 # * A month and day value, with a zero year, e.g. an anniversary
1519 # * A year on its own, with zero month and day values
1520 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001521 #
Bu Sun Kim65020912020-05-20 12:08:20 -07001522 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
1523 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
1524 # if specifying a year by itself or a year and month where the day is not
1525 # significant.
1526 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1527 # a year.
1528 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1529 # month and day.
1530 },
1531 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
1532 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
1533 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001534 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07001535 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001536 # attributes that are not covered by the provided structured fields.
1537 #
1538 # This field is a more general combination of the deprecated id-based
1539 # filterable_custom_fields and string-based
1540 # non_filterable_custom_fields.
1541 #
1542 # The keys of the map are strings up to 64 bytes and must match the
1543 # pattern: a-zA-Z*.
1544 #
1545 # At most 100 filterable and at most 100 unfilterable keys are supported.
1546 # For filterable `string_values`, across all keys at most 200 values are
1547 # allowed, with each string no more than 255 characters. For unfilterable
1548 # `string_values`, the maximum total size of `string_values` across all keys
1549 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07001550 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
1551 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001552 # If false, values are not searchable.
1553 #
1554 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07001555 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
1556 # be specified.
1557 #
1558 # This field is used to perform number range search.
1559 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
1560 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
1561 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001562 # be specified.
1563 #
1564 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
1565 # `CASE_INSENSITIVE_MATCH`) search.
1566 # For filterable `string_values`, a maximum total number of 200 values
1567 # is allowed, with each `string_value` has a byte size of no more than
1568 # 255B. For unfilterable `string_values`, the maximum total byte size of
1569 # unfilterable `string_values` is 50KB.
1570 #
1571 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07001572 &quot;values&quot;: [ # Required. String values.
1573 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001574 ],
1575 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001576 },
1577 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001578 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
1579 #
1580 # Optional.
1581 #
1582 # A map of fields to hold filterable custom job attributes not captured by
1583 # the standard fields such as job_title, company_name, or
1584 # level. These custom fields store arbitrary
1585 # string values, and can be used for purposes not covered by
1586 # the structured fields. For the best search experience, use of the
1587 # structured rather than custom fields is recommended.
1588 #
1589 # Data stored in these custom fields fields are indexed and
1590 # searched against by keyword searches (see
1591 # SearchJobsRequest.custom_field_filters][]).
1592 #
1593 # The map key must be a number between 1-20. If an invalid key is
1594 # provided on job create or update, an error is returned.
1595 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
1596 &quot;values&quot;: [ # Optional. The values of the custom data.
1597 &quot;A String&quot;,
1598 ],
1599 },
1600 },
1601 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
1602 # any requirements for fluency that are associated with the job.
1603 #
1604 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
1605 # For more information, see
1606 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
1607 # class=&quot;external&quot; target=&quot;_blank&quot; }.
1608 #
1609 # If this field is unspecified and Job.description is present, detected
1610 # language code based on Job.description is assigned, otherwise
1611 # defaults to &#x27;en_US&#x27;.
1612 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
1613 # Defaults to JobVisibility.PRIVATE if not specified.
1614 # Currently only JobVisibility.PRIVATE is supported.
1615 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
1616 #
1617 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
1618 # of this field in job queries and API calls is preferred over the use of
1619 # requisition_id since this value is unique.
1620 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001621 # provided.
1622 #
1623 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07001624 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001625 # this field, and is the recommended field to use to identify companies.
1626 #
1627 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07001628 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
1629 # The value determines the sort order of the jobs returned when searching for
1630 # jobs using the featured jobs search call, with higher promotional values
1631 # being returned first and ties being resolved by relevance sort. Only the
1632 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
1633 #
1634 # Default value is 0, and negative values are treated as 0.
1635 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
1636 # value is the time the request arrives at the server.
1637 # and time zone are either specified elsewhere or are not significant. The date
1638 # is relative to the Proleptic Gregorian Calendar. This can represent:
1639 #
1640 # * A full date, with non-zero year, month and day values
1641 # * A month and day value, with a zero year, e.g. an anniversary
1642 # * A year on its own, with zero month and day values
1643 # * A year and month value, with a zero day, e.g. a credit card expiration date
1644 #
1645 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
1646 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
1647 # if specifying a year by itself or a year and month where the day is not
1648 # significant.
1649 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1650 # a year.
1651 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1652 # month and day.
1653 },
1654 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
1655 # application_email_list or application_instruction must be
1656 # specified.
1657 #
1658 # Use this URL field to direct an applicant to a website, for example to
1659 # link to an online application form.
1660 #
1661 # The maximum number of allowed characters is 2,000.
1662 &quot;A String&quot;,
1663 ],
1664 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
1665 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
1666 # client to identify a job. This field is intended to be used by clients
1667 # for client identification and tracking of listings. A job is not allowed
1668 # to be created if there is another job with the same requisition_id,
1669 # company_name and language_code.
1670 #
1671 # The maximum number of allowed characters is 255.
1672 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
1673 # job. The use of this field is recommended
1674 # as an alternative to using the more general description field.
1675 #
1676 # This field accepts and sanitizes HTML input, and also accepts
1677 # bold, italic, ordered list, and unordered list markup tags.
1678 #
1679 # The maximum number of allowed characters is 10,000.
1680 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
1681 # is used for contracting engagements.
1682 # Dates prior to 1970/1/1 and invalid date formats are ignored.
1683 # and time zone are either specified elsewhere or are not significant. The date
1684 # is relative to the Proleptic Gregorian Calendar. This can represent:
1685 #
1686 # * A full date, with non-zero year, month and day values
1687 # * A month and day value, with a zero year, e.g. an anniversary
1688 # * A year on its own, with zero month and day values
1689 # * A year and month value, with a zero day, e.g. a credit card expiration date
1690 #
1691 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
1692 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
1693 # if specifying a year by itself or a year and month where the day is not
1694 # significant.
1695 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1696 # a year.
1697 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1698 # month and day.
1699 },
1700 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
1701 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
1702 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
1703 # application_email_list or application_instruction must be
1704 # specified.
1705 #
1706 # Use this field to provide instructions, such as &quot;Mail your application
1707 # to ...&quot;, that a candidate can follow to apply for the job.
1708 #
1709 # This field accepts and sanitizes HTML input, and also accepts
1710 # bold, italic, ordered list, and unordered list markup tags.
1711 #
1712 # The maximum number of allowed characters is 3,000.
1713 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
1714 &quot;A String&quot;,
1715 ],
1716 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
1717 # incentives associated with the job not including salary or pay.
1718 #
1719 # The maximum number of allowed characters is 10,000.
1720 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
1721 # full time or
1722 # part time.
1723 &quot;A String&quot;,
1724 ],
1725 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
1726 #
1727 # Location(s) where the emploeyer is looking to hire for this job posting.
1728 #
1729 # Specifying the full street address(es) of the hiring location enables
1730 # better API results, especially job searches by commute time.
1731 #
1732 # At most 50 locations are allowed for best search performance. If a job has
1733 # more locations, it is suggested to split it into multiple jobs with unique
1734 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
1735 # multiple jobs with the same requisition_id, company_name and
1736 # language_code are not allowed. If the original requisition_id must
1737 # be preserved, a custom field should be used for storage. It is also
1738 # suggested to group the locations that close to each other in the same job
1739 # for better search experience.
1740 #
1741 # The maximum number of allowed characters is 500.
1742 &quot;A String&quot;,
1743 ],
1744 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
1745 #
1746 # Optional.
1747 #
1748 # Job compensation information.
1749 #
1750 # This field replaces compensation_info. Only
1751 # CompensationInfo.entries or extended_compensation_info can be set,
1752 # otherwise an exception is thrown.
1753 #
1754 # Describes job compensation.
1755 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
1756 # currency code.
1757 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
1758 #
1759 # Compensation range.
1760 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
1761 #
1762 # Decimal number.
1763 &quot;micros&quot;: 42, # Micro (10^-6) units.
1764 # The value must be between -999,999 and +999,999 inclusive.
1765 # If `units` is positive, `micros` must be positive or zero.
1766 # If `units` is zero, `micros` can be positive, zero, or negative.
1767 # If `units` is negative, `micros` must be negative or zero.
1768 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1769 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1770 },
1771 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
1772 #
1773 # Decimal number.
1774 &quot;micros&quot;: 42, # Micro (10^-6) units.
1775 # The value must be between -999,999 and +999,999 inclusive.
1776 # If `units` is positive, `micros` must be positive or zero.
1777 # If `units` is zero, `micros` can be positive, zero, or negative.
1778 # If `units` is negative, `micros` must be negative or zero.
1779 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1780 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1781 },
1782 },
1783 &quot;entries&quot;: [ # Optional. Job compensation information.
1784 #
1785 # At most one entry can be of type
1786 # ExtendedCompensationInfo.CompensationType.BASE, which is
1787 # referred as ** base compensation entry ** for the job.
1788 { # Deprecated. See CompensationInfo.
1789 #
1790 # A compensation entry that represents one component of compensation, such
1791 # as base pay, bonus, or other compensation type.
1792 #
1793 # Annualization: One compensation entry can be annualized if
1794 # - it contains valid amount or range.
1795 # - and its expected_units_per_year is set or can be derived.
1796 # Its annualized range is determined as (amount or range) times
1797 # expected_units_per_year.
1798 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
1799 #
1800 # Compensation range.
1801 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
1802 #
1803 # Decimal number.
1804 &quot;micros&quot;: 42, # Micro (10^-6) units.
1805 # The value must be between -999,999 and +999,999 inclusive.
1806 # If `units` is positive, `micros` must be positive or zero.
1807 # If `units` is zero, `micros` can be positive, zero, or negative.
1808 # If `units` is negative, `micros` must be negative or zero.
1809 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1810 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1811 },
1812 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
1813 #
1814 # Decimal number.
1815 &quot;micros&quot;: 42, # Micro (10^-6) units.
1816 # The value must be between -999,999 and +999,999 inclusive.
1817 # If `units` is positive, `micros` must be positive or zero.
1818 # If `units` is zero, `micros` can be positive, zero, or negative.
1819 # If `units` is negative, `micros` must be negative or zero.
1820 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1821 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1822 },
1823 },
1824 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
1825 # Job.employment_types is FULLTIME, a default value is inferred
1826 # based on unit. Default values:
1827 # - HOURLY: 2080
1828 # - DAILY: 260
1829 # - WEEKLY: 52
1830 # - MONTHLY: 12
1831 # - ANNUAL: 1
1832 #
1833 # Decimal number.
1834 &quot;micros&quot;: 42, # Micro (10^-6) units.
1835 # The value must be between -999,999 and +999,999 inclusive.
1836 # If `units` is positive, `micros` must be positive or zero.
1837 # If `units` is zero, `micros` can be positive, zero, or negative.
1838 # If `units` is negative, `micros` must be negative or zero.
1839 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1840 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1841 },
1842 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
1843 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
1844 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
1845 #
1846 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
1847 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
1848 #
1849 # Decimal number.
1850 &quot;micros&quot;: 42, # Micro (10^-6) units.
1851 # The value must be between -999,999 and +999,999 inclusive.
1852 # If `units` is positive, `micros` must be positive or zero.
1853 # If `units` is zero, `micros` can be positive, zero, or negative.
1854 # If `units` is negative, `micros` must be negative or zero.
1855 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1856 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1857 },
1858 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
1859 },
1860 ],
1861 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
1862 # the job&#x27;s all CompensationEntry cannot be annualized.
1863 # See CompensationEntry for explanation on annualization and base
1864 # compensation entry.
1865 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
1866 #
1867 # Compensation range.
1868 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
1869 #
1870 # Decimal number.
1871 &quot;micros&quot;: 42, # Micro (10^-6) units.
1872 # The value must be between -999,999 and +999,999 inclusive.
1873 # If `units` is positive, `micros` must be positive or zero.
1874 # If `units` is zero, `micros` can be positive, zero, or negative.
1875 # If `units` is negative, `micros` must be negative or zero.
1876 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1877 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1878 },
1879 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
1880 #
1881 # Decimal number.
1882 &quot;micros&quot;: 42, # Micro (10^-6) units.
1883 # The value must be between -999,999 and +999,999 inclusive.
1884 # If `units` is positive, `micros` must be positive or zero.
1885 # If `units` is zero, `micros` can be positive, zero, or negative.
1886 # If `units` is negative, `micros` must be negative or zero.
1887 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
1888 &quot;units&quot;: &quot;A String&quot;, # Whole units.
1889 },
1890 },
1891 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
1892 # the job&#x27;s base compensation entry cannot be annualized.
1893 # See CompensationEntry for explanation on annualization and base
1894 # compensation entry.
1895 },
1896 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
1897 # provided.
1898 #
1899 # The resource name of the company listing the job, such as
1900 # /companies/foo. This field takes precedence over the
1901 # distributor-assigned company identifier, distributor_company_id.
1902 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
1903 # description of the company and related information. Separate fields are
1904 # provided on the job object for responsibilities,
1905 # qualifications, and other job characteristics. Use of
1906 # these separate job fields is recommended.
1907 #
1908 # This field accepts and sanitizes HTML input, and also accepts
1909 # bold, italic, ordered list, and unordered list markup tags.
1910 #
1911 # The maximum number of allowed characters is 100,000.
1912 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
1913 # application_email_list or application_instruction must be
1914 # specified.
1915 #
1916 # Use this field to specify email address(es) to which resumes or
1917 # applications can be sent.
1918 #
1919 # The maximum number of allowed characters is 255.
1920 &quot;A String&quot;,
1921 ],
1922 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
1923 #
1924 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001925 }</pre>
1926</div>
1927
1928<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -07001929 <code class="details" id="delete">delete(name, disableFastProcess=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001930 <pre>Deletes the specified job.
1931
1932Typically, the job becomes unsearchable within 10 seconds, but it may take
1933up to 5 minutes.
1934
1935Args:
Bu Sun Kim65020912020-05-20 12:08:20 -07001936 name: string, Required. The resource name of the job to be deleted, such as &quot;jobs/11111111&quot;. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001937 disableFastProcess: boolean, Deprecated. This field is not working anymore.
1938
1939Optional.
1940
1941If set to true, this call waits for all processing steps to complete
1942before the job is cleaned up. Otherwise, the call returns while some
1943steps are still taking place asynchronously, hence faster.
Bu Sun Kim65020912020-05-20 12:08:20 -07001944 x__xgafv: string, V1 error format.
1945 Allowed values
1946 1 - v1 error format
1947 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001948
1949Returns:
1950 An object of the form:
1951
1952 { # A generic empty message that you can re-use to avoid defining duplicated
1953 # empty messages in your APIs. A typical example is to use it as the request
1954 # or the response type of an API method. For instance:
1955 #
1956 # service Foo {
1957 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
1958 # }
1959 #
1960 # The JSON representation for `Empty` is empty JSON object `{}`.
1961 }</pre>
1962</div>
1963
1964<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -07001965 <code class="details" id="deleteByFilter">deleteByFilter(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001966 <pre>Deprecated. Use BatchDeleteJobs instead.
1967
1968Deletes the specified job by filter. You can specify whether to
1969synchronously wait for validation, indexing, and general processing to be
1970completed before the response is returned.
1971
1972Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07001973 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001974 The object takes the form of:
1975
1976{ # Deprecated. Use BatchDeleteJobsRequest instead.
1977 #
1978 # Input only.
1979 #
1980 # Delete job by filter request.
1981 #
1982 # The job typically becomes unsearchable within 10 seconds, but it may take
1983 # up to 5 minutes.
Bu Sun Kim65020912020-05-20 12:08:20 -07001984 &quot;disableFastProcess&quot;: True or False, # Optional. If set to true, this call waits for all processing steps to complete
1985 # before the job is cleaned up. Otherwise, the call returns while some
1986 # steps are still taking place asynchronously, hence faster.
1987 &quot;filter&quot;: { # Deprecated. Use BatchDeleteJobsRequest instead. # Required. Restrictions on the scope of the delete request.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001988 #
1989 # Input only.
1990 #
1991 # Filter for jobs to be deleted.
Bu Sun Kim65020912020-05-20 12:08:20 -07001992 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID (or posting ID) assigned by the client to identify a
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001993 # job. This is intended for client identification and tracking of
1994 # listings.
1995 # name takes precedence over this field
1996 # The maximum number of allowed characters is 225.
1997 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001998 }
1999
2000 x__xgafv: string, V1 error format.
2001 Allowed values
2002 1 - v1 error format
2003 2 - v2 error format
2004
2005Returns:
2006 An object of the form:
2007
2008 { # A generic empty message that you can re-use to avoid defining duplicated
2009 # empty messages in your APIs. A typical example is to use it as the request
2010 # or the response type of an API method. For instance:
2011 #
2012 # service Foo {
2013 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
2014 # }
2015 #
2016 # The JSON representation for `Empty` is empty JSON object `{}`.
2017 }</pre>
2018</div>
2019
2020<div class="method">
2021 <code class="details" id="get">get(name, x__xgafv=None)</code>
2022 <pre>Retrieves the specified job, whose status is OPEN or recently EXPIRED
2023within the last 90 days.
2024
2025Args:
Bu Sun Kim65020912020-05-20 12:08:20 -07002026 name: string, Required. The resource name of the job to retrieve, such as &quot;jobs/11111111&quot;. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002027 x__xgafv: string, V1 error format.
2028 Allowed values
2029 1 - v1 error format
2030 2 - v2 error format
2031
2032Returns:
2033 An object of the form:
2034
Bu Sun Kim65020912020-05-20 12:08:20 -07002035 { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot;
2036 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002037 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07002038 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
2039 # is available. If this field is set, a
2040 # LocationFilter in a search query within the job region
2041 # finds this job if an exact location match is not specified.
2042 # If this field is set, setting job locations
2043 # to the same location level as this field is strongly recommended.
2044 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
2045 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002046 #
Bu Sun Kim65020912020-05-20 12:08:20 -07002047 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002048 #
Bu Sun Kim65020912020-05-20 12:08:20 -07002049 # The name of the company listing the job.
2050 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
2051 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
2052 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002053 # CompensationEntry.expected_units_per_year.
2054 #
2055 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07002056 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
2057 # to zero and the currency code is set to match the
2058 # currency code of max_compensation.
2059 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2060 # The value must be between -999,999,999 and +999,999,999 inclusive.
2061 # If `units` is positive, `nanos` must be positive or zero.
2062 # If `units` is zero, `nanos` can be positive, zero, or negative.
2063 # If `units` is negative, `nanos` must be negative or zero.
2064 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2065 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2066 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2067 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2068 },
2069 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002070 # to a maximal compensation value and the currency code is set to
2071 # match the currency code of
2072 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07002073 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002074 # The value must be between -999,999,999 and +999,999,999 inclusive.
2075 # If `units` is positive, `nanos` must be positive or zero.
2076 # If `units` is zero, `nanos` can be positive, zero, or negative.
2077 # If `units` is negative, `nanos` must be negative or zero.
2078 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07002079 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2080 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2081 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002082 },
2083 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002084 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002085 #
2086 # Optional.
2087 #
2088 # The amount of compensation or pay for the job.
2089 # As an alternative, compensation_amount_min and
2090 # compensation_amount_max may be used to define a range of
2091 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07002092 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002093 # The value must be between -999,999,999 and +999,999,999 inclusive.
2094 # If `units` is positive, `nanos` must be positive or zero.
2095 # If `units` is zero, `nanos` can be positive, zero, or negative.
2096 # If `units` is negative, `nanos` must be negative or zero.
2097 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07002098 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2099 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2100 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002101 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002102 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
2103 #
2104 # Optional.
2105 #
2106 # Type of job compensation.
2107 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
2108 #
2109 # Optional.
2110 #
2111 # An upper bound on a range for compensation or pay for the job.
2112 # The currency type is specified in compensation_amount.
2113 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2114 # The value must be between -999,999,999 and +999,999,999 inclusive.
2115 # If `units` is positive, `nanos` must be positive or zero.
2116 # If `units` is zero, `nanos` can be positive, zero, or negative.
2117 # If `units` is negative, `nanos` must be negative or zero.
2118 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2119 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2120 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2121 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2122 },
2123 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
2124 # all compensation entries&#x27; CompensationEntry.compensation times
2125 # CompensationEntry.expected_units_per_year.
2126 #
2127 # See CompensationEntry for explanation on compensation annualization.
2128 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
2129 # to zero and the currency code is set to match the
2130 # currency code of max_compensation.
2131 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2132 # The value must be between -999,999,999 and +999,999,999 inclusive.
2133 # If `units` is positive, `nanos` must be positive or zero.
2134 # If `units` is zero, `nanos` can be positive, zero, or negative.
2135 # If `units` is negative, `nanos` must be negative or zero.
2136 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2137 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2138 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2139 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2140 },
2141 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
2142 # to a maximal compensation value and the currency code is set to
2143 # match the currency code of
2144 # min_compensation.
2145 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2146 # The value must be between -999,999,999 and +999,999,999 inclusive.
2147 # If `units` is positive, `nanos` must be positive or zero.
2148 # If `units` is zero, `nanos` can be positive, zero, or negative.
2149 # If `units` is negative, `nanos` must be negative or zero.
2150 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2151 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2152 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2153 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2154 },
2155 },
2156 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
2157 #
2158 # Optional.
2159 #
2160 # A lower bound on a range for compensation or pay for the job.
2161 # The currency type is specified in compensation_amount.
2162 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2163 # The value must be between -999,999,999 and +999,999,999 inclusive.
2164 # If `units` is positive, `nanos` must be positive or zero.
2165 # If `units` is zero, `nanos` can be positive, zero, or negative.
2166 # If `units` is negative, `nanos` must be negative or zero.
2167 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2168 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2169 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2170 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2171 },
2172 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002173 #
2174 # At most one entry can be of type
2175 # CompensationInfo.CompensationType.BASE, which is
2176 # referred as ** base compensation entry ** for the job.
2177 { # A compensation entry that represents one component of compensation, such
2178 # as base pay, bonus, or other compensation type.
2179 #
2180 # Annualization: One compensation entry can be annualized if
2181 # - it contains valid amount or range.
2182 # - and its expected_units_per_year is set or can be derived.
2183 # Its annualized range is determined as (amount or range) times
2184 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07002185 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
2186 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
2187 # to zero and the currency code is set to match the
2188 # currency code of max_compensation.
2189 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
2190 # The value must be between -999,999,999 and +999,999,999 inclusive.
2191 # If `units` is positive, `nanos` must be positive or zero.
2192 # If `units` is zero, `nanos` can be positive, zero, or negative.
2193 # If `units` is negative, `nanos` must be negative or zero.
2194 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
2195 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2196 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2197 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
2198 },
2199 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002200 # to a maximal compensation value and the currency code is set to
2201 # match the currency code of
2202 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07002203 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002204 # The value must be between -999,999,999 and +999,999,999 inclusive.
2205 # If `units` is positive, `nanos` must be positive or zero.
2206 # If `units` is zero, `nanos` can be positive, zero, or negative.
2207 # If `units` is negative, `nanos` must be negative or zero.
2208 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07002209 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2210 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2211 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002212 },
2213 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002214 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002215 # Job.employment_types is FULLTIME, a default value is inferred
2216 # based on unit. Default values:
2217 # - HOURLY: 2080
2218 # - DAILY: 260
2219 # - WEEKLY: 52
2220 # - MONTHLY: 12
2221 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07002222 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
2223 # indicate equity terms or provide additional context to an estimated
2224 # bonus.
2225 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
2226 #
2227 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
2228 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
2229 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002230 # The value must be between -999,999,999 and +999,999,999 inclusive.
2231 # If `units` is positive, `nanos` must be positive or zero.
2232 # If `units` is zero, `nanos` can be positive, zero, or negative.
2233 # If `units` is negative, `nanos` must be negative or zero.
2234 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07002235 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
2236 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
2237 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002238 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002239 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002240 },
2241 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002242 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002243 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
2244 # recommended as an alternative to using the more general description
2245 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002246 #
2247 # This field accepts and sanitizes HTML input, and also accepts
2248 # bold, italic, ordered list, and unordered list markup tags.
2249 #
2250 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07002251 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002252 # experience.
2253 #
2254 # The expiration timestamp of the job. After this timestamp, the
2255 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07002256 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002257 # ListJobs APIs, but it can be retrieved with the GetJob API or
2258 # updated with the UpdateJob API. An expired job can be updated and
2259 # opened again by using a future expiration timestamp. Updating an expired
2260 # job fails if there is another existing open job with same
2261 # requisition_id, company_name and language_code.
2262 #
2263 # The expired jobs are retained in our system for 90 days. However, the
2264 # overall expired job count cannot exceed 3 times the maximum of open jobs
2265 # count over the past week, otherwise jobs with earlier expire time are
2266 # cleaned first. Expired jobs are no longer accessible after they are cleaned
2267 # out.
2268 # The format of this field is RFC 3339 date strings. Example:
2269 # 2000-01-01T00:00:00.999999999Z
2270 # See
2271 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
2272 #
2273 # A valid date range is between 1970-01-01T00:00:00.0Z and
2274 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
2275 # time not provided.
2276 #
2277 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07002278 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002279 # example, if the job was created on 2017/01/01 13:00AM UTC with an
2280 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
2281 #
2282 # If this value is not provided but expiry_date is, expiry_date is
2283 # used.
2284 #
2285 # If this value is not provided on job update, it depends on the field masks
2286 # set by UpdateJobRequest.update_job_fields. If the field masks include
2287 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07002288 # updated, the job posting expires after 30 days from the job&#x27;s last
2289 # update time. Otherwise the expiration date isn&#x27;t updated.
2290 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
2291 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
2292 { # Output only.
2293 #
2294 # A resource that represents a location with full geographic
2295 # information.
2296 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
2297 # such as postal delivery and payments addresses. Given a postal address,
2298 # a postal service can deliver items to a premises, P.O. Box, or other
2299 # delivery location.
2300 # Given a postal address, a postal service can deliver items to a premise, P.O.
2301 # Box or similar.
2302 # It is not intended to model geographical locations (roads, towns,
2303 # mountains).
2304 #
2305 # In typical usage an address would be created via user input or from importing
2306 # existing data, depending on the type of process.
2307 #
2308 # Advice on address input / editing:
2309 # - Use an i18n-ready address widget such as
2310 # https://github.com/google/libaddressinput)
2311 # - Users should not be presented with UI elements for input or editing of
2312 # fields outside countries where that field is used.
2313 #
2314 # For more guidance on how to use this schema, please see:
2315 # https://support.google.com/business/answer/6397478
2316 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
2317 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
2318 # is never inferred and it is up to the user to ensure the value is
2319 # correct. See http://cldr.unicode.org/ and
2320 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
2321 # for details. Example: &quot;CH&quot; for Switzerland.
2322 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
2323 #
2324 # Because values in address_lines do not have type information and may
2325 # sometimes contain multiple values in a single field (e.g.
2326 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
2327 # address lines should be &quot;envelope order&quot; for the country/region of the
2328 # address. In places where this can vary (e.g. Japan), address_language is
2329 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
2330 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
2331 # an address can be selected based on the language.
2332 #
2333 # The minimum permitted structural representation of an address consists
2334 # of a region_code with all remaining information placed in the
2335 # address_lines. It would be possible to format such an address very
2336 # approximately without geocoding, but no semantic reasoning could be
2337 # made about any of the address components until it was at least
2338 # partially resolved.
2339 #
2340 # Creating an address only containing a region_code and address_lines, and
2341 # then geocoding is the recommended way to handle completely unstructured
2342 # addresses (as opposed to guessing which parts of the address should be
2343 # localities or administrative areas).
2344 &quot;A String&quot;,
2345 ],
2346 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
2347 # postal codes to be present, but where they are used, they may trigger
2348 # additional validation with other parts of the address (e.g. state/zip
2349 # validation in the U.S.A.).
2350 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
2351 # in most regions. Where it is used, the value is either a string like
2352 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
2353 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
2354 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
2355 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
2356 # known). This is often the UI language of the input form or is expected
2357 # to match one of the languages used in the address&#x27; country/region, or their
2358 # transliterated equivalents.
2359 # This can affect formatting in certain countries, but is not critical
2360 # to the correctness of the data and will never affect any validation or
2361 # other non-formatting related operations.
2362 #
2363 # If this value is not known, it should be omitted (rather than specifying a
2364 # possibly incorrect default).
2365 #
2366 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
2367 &quot;recipients&quot;: [ # Optional. The recipient at the address.
2368 # This field may, under certain circumstances, contain multiline information.
2369 # For example, it might contain &quot;care of&quot; information.
2370 &quot;A String&quot;,
2371 ],
2372 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
2373 # For example, this can be neighborhoods, boroughs, districts.
2374 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
2375 # the latest revision.
2376 #
2377 # All new revisions **must** be backward compatible with old revisions.
2378 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
2379 # addresses of a country or region.
2380 # For example, this can be a state, a province, an oblast, or a prefecture.
2381 # Specifically, for Spain this is the province and not the autonomous
2382 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
2383 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
2384 # in Switzerland this should be left unpopulated.
2385 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
2386 # Examples: US city, IT comune, UK post town.
2387 # In regions of the world where localities are not well defined or do not fit
2388 # into this structure well, leave locality empty and use address_lines.
2389 },
2390 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
2391 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
2392 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
2393 # LocationType#LOCALITY.
2394 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
2395 # location bounding box in which a circle with the specified radius
2396 # centered from LatLng coves the area associated with the job location.
2397 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
2398 # 7885.79 meters.
2399 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
2400 # of doubles representing degrees latitude and degrees longitude. Unless
2401 # specified otherwise, this must conform to the
2402 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
2403 # standard&lt;/a&gt;. Values must be within normalized ranges.
2404 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
2405 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
2406 },
2407 },
2408 ],
2409 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
2410 # position.
2411 #
2412 # The maximum number of allowed characters is 255.
2413 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
2414 #
2415 # Optional.
2416 #
2417 # A map of fields to hold non-filterable custom job attributes, similar to
2418 # filterable_custom_fields. These fields are distinct in that the data
2419 # in these fields are not indexed. Therefore, the client cannot search
2420 # against them, nor can the client use them to list jobs.
2421 #
2422 # The key of the map can be any valid string.
2423 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
2424 &quot;values&quot;: [ # Optional. The values of the custom data.
2425 &quot;A String&quot;,
2426 ],
2427 },
2428 },
2429 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
2430 #
2431 # Optional but strongly recommended to be provided for the best service
2432 # experience.
2433 #
2434 # The expiration date of the job in UTC time. After 12 am on this date, the
2435 # job is marked as expired, and it no longer appears in search results.
2436 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
2437 # ListJobs APIs, but it can be retrieved with the GetJob API or
2438 # updated with the UpdateJob API. An expired job can be updated and
2439 # opened again by using a future expiration date. It can also remain expired.
2440 # Updating an expired job to be open fails if there is another existing open
2441 # job with same requisition_id, company_name and language_code.
2442 #
2443 # The expired jobs are retained in our system for 90 days. However, the
2444 # overall expired job count cannot exceed 3 times the maximum of open jobs
2445 # count over the past week, otherwise jobs with earlier expire time are
2446 # removed first. Expired jobs are no longer accessible after they are cleaned
2447 # out.
2448 #
2449 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
2450 # ignored and treated as expiry date not provided.
2451 #
2452 # If this value is not provided on job creation or is invalid, the job
2453 # posting expires after 30 days from the job&#x27;s creation time. For example, if
2454 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
2455 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
2456 #
2457 # If this value is not provided on job update, it depends on the field masks
2458 # set by UpdateJobRequest.update_job_fields. If the field masks include
2459 # expiry_date, or the masks are empty meaning that every field is
2460 # updated, the job expires after 30 days from the job&#x27;s last update time.
2461 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002462 # and time zone are either specified elsewhere or are not significant. The date
2463 # is relative to the Proleptic Gregorian Calendar. This can represent:
2464 #
2465 # * A full date, with non-zero year, month and day values
2466 # * A month and day value, with a zero year, e.g. an anniversary
2467 # * A year on its own, with zero month and day values
2468 # * A year and month value, with a zero day, e.g. a credit card expiration date
2469 #
2470 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07002471 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002472 # if specifying a year by itself or a year and month where the day is not
2473 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07002474 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002475 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07002476 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2477 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002478 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002479 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
2480 # is used for contracting engagements.
2481 # Dates prior to 1970/1/1 and invalid date formats are ignored.
2482 # and time zone are either specified elsewhere or are not significant. The date
2483 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002484 #
Bu Sun Kim65020912020-05-20 12:08:20 -07002485 # * A full date, with non-zero year, month and day values
2486 # * A month and day value, with a zero year, e.g. an anniversary
2487 # * A year on its own, with zero month and day values
2488 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002489 #
Bu Sun Kim65020912020-05-20 12:08:20 -07002490 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2491 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2492 # if specifying a year by itself or a year and month where the day is not
2493 # significant.
2494 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2495 # a year.
2496 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2497 # month and day.
2498 },
2499 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
2500 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
2501 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002502 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07002503 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002504 # attributes that are not covered by the provided structured fields.
2505 #
2506 # This field is a more general combination of the deprecated id-based
2507 # filterable_custom_fields and string-based
2508 # non_filterable_custom_fields.
2509 #
2510 # The keys of the map are strings up to 64 bytes and must match the
2511 # pattern: a-zA-Z*.
2512 #
2513 # At most 100 filterable and at most 100 unfilterable keys are supported.
2514 # For filterable `string_values`, across all keys at most 200 values are
2515 # allowed, with each string no more than 255 characters. For unfilterable
2516 # `string_values`, the maximum total size of `string_values` across all keys
2517 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07002518 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
2519 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002520 # If false, values are not searchable.
2521 #
2522 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07002523 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
2524 # be specified.
2525 #
2526 # This field is used to perform number range search.
2527 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
2528 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
2529 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002530 # be specified.
2531 #
2532 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
2533 # `CASE_INSENSITIVE_MATCH`) search.
2534 # For filterable `string_values`, a maximum total number of 200 values
2535 # is allowed, with each `string_value` has a byte size of no more than
2536 # 255B. For unfilterable `string_values`, the maximum total byte size of
2537 # unfilterable `string_values` is 50KB.
2538 #
2539 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07002540 &quot;values&quot;: [ # Required. String values.
2541 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002542 ],
2543 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002544 },
2545 },
Bu Sun Kim65020912020-05-20 12:08:20 -07002546 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
2547 #
2548 # Optional.
2549 #
2550 # A map of fields to hold filterable custom job attributes not captured by
2551 # the standard fields such as job_title, company_name, or
2552 # level. These custom fields store arbitrary
2553 # string values, and can be used for purposes not covered by
2554 # the structured fields. For the best search experience, use of the
2555 # structured rather than custom fields is recommended.
2556 #
2557 # Data stored in these custom fields fields are indexed and
2558 # searched against by keyword searches (see
2559 # SearchJobsRequest.custom_field_filters][]).
2560 #
2561 # The map key must be a number between 1-20. If an invalid key is
2562 # provided on job create or update, an error is returned.
2563 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
2564 &quot;values&quot;: [ # Optional. The values of the custom data.
2565 &quot;A String&quot;,
2566 ],
2567 },
2568 },
2569 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
2570 # any requirements for fluency that are associated with the job.
2571 #
2572 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
2573 # For more information, see
2574 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
2575 # class=&quot;external&quot; target=&quot;_blank&quot; }.
2576 #
2577 # If this field is unspecified and Job.description is present, detected
2578 # language code based on Job.description is assigned, otherwise
2579 # defaults to &#x27;en_US&#x27;.
2580 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
2581 # Defaults to JobVisibility.PRIVATE if not specified.
2582 # Currently only JobVisibility.PRIVATE is supported.
2583 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
2584 #
2585 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
2586 # of this field in job queries and API calls is preferred over the use of
2587 # requisition_id since this value is unique.
2588 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002589 # provided.
2590 #
2591 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07002592 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002593 # this field, and is the recommended field to use to identify companies.
2594 #
2595 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07002596 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
2597 # The value determines the sort order of the jobs returned when searching for
2598 # jobs using the featured jobs search call, with higher promotional values
2599 # being returned first and ties being resolved by relevance sort. Only the
2600 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
2601 #
2602 # Default value is 0, and negative values are treated as 0.
2603 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
2604 # value is the time the request arrives at the server.
2605 # and time zone are either specified elsewhere or are not significant. The date
2606 # is relative to the Proleptic Gregorian Calendar. This can represent:
2607 #
2608 # * A full date, with non-zero year, month and day values
2609 # * A month and day value, with a zero year, e.g. an anniversary
2610 # * A year on its own, with zero month and day values
2611 # * A year and month value, with a zero day, e.g. a credit card expiration date
2612 #
2613 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2614 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2615 # if specifying a year by itself or a year and month where the day is not
2616 # significant.
2617 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2618 # a year.
2619 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2620 # month and day.
2621 },
2622 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
2623 # application_email_list or application_instruction must be
2624 # specified.
2625 #
2626 # Use this URL field to direct an applicant to a website, for example to
2627 # link to an online application form.
2628 #
2629 # The maximum number of allowed characters is 2,000.
2630 &quot;A String&quot;,
2631 ],
2632 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
2633 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
2634 # client to identify a job. This field is intended to be used by clients
2635 # for client identification and tracking of listings. A job is not allowed
2636 # to be created if there is another job with the same requisition_id,
2637 # company_name and language_code.
2638 #
2639 # The maximum number of allowed characters is 255.
2640 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
2641 # job. The use of this field is recommended
2642 # as an alternative to using the more general description field.
2643 #
2644 # This field accepts and sanitizes HTML input, and also accepts
2645 # bold, italic, ordered list, and unordered list markup tags.
2646 #
2647 # The maximum number of allowed characters is 10,000.
2648 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
2649 # is used for contracting engagements.
2650 # Dates prior to 1970/1/1 and invalid date formats are ignored.
2651 # and time zone are either specified elsewhere or are not significant. The date
2652 # is relative to the Proleptic Gregorian Calendar. This can represent:
2653 #
2654 # * A full date, with non-zero year, month and day values
2655 # * A month and day value, with a zero year, e.g. an anniversary
2656 # * A year on its own, with zero month and day values
2657 # * A year and month value, with a zero day, e.g. a credit card expiration date
2658 #
2659 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2660 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2661 # if specifying a year by itself or a year and month where the day is not
2662 # significant.
2663 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2664 # a year.
2665 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2666 # month and day.
2667 },
2668 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
2669 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
2670 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
2671 # application_email_list or application_instruction must be
2672 # specified.
2673 #
2674 # Use this field to provide instructions, such as &quot;Mail your application
2675 # to ...&quot;, that a candidate can follow to apply for the job.
2676 #
2677 # This field accepts and sanitizes HTML input, and also accepts
2678 # bold, italic, ordered list, and unordered list markup tags.
2679 #
2680 # The maximum number of allowed characters is 3,000.
2681 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
2682 &quot;A String&quot;,
2683 ],
2684 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
2685 # incentives associated with the job not including salary or pay.
2686 #
2687 # The maximum number of allowed characters is 10,000.
2688 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
2689 # full time or
2690 # part time.
2691 &quot;A String&quot;,
2692 ],
2693 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
2694 #
2695 # Location(s) where the emploeyer is looking to hire for this job posting.
2696 #
2697 # Specifying the full street address(es) of the hiring location enables
2698 # better API results, especially job searches by commute time.
2699 #
2700 # At most 50 locations are allowed for best search performance. If a job has
2701 # more locations, it is suggested to split it into multiple jobs with unique
2702 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
2703 # multiple jobs with the same requisition_id, company_name and
2704 # language_code are not allowed. If the original requisition_id must
2705 # be preserved, a custom field should be used for storage. It is also
2706 # suggested to group the locations that close to each other in the same job
2707 # for better search experience.
2708 #
2709 # The maximum number of allowed characters is 500.
2710 &quot;A String&quot;,
2711 ],
2712 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
2713 #
2714 # Optional.
2715 #
2716 # Job compensation information.
2717 #
2718 # This field replaces compensation_info. Only
2719 # CompensationInfo.entries or extended_compensation_info can be set,
2720 # otherwise an exception is thrown.
2721 #
2722 # Describes job compensation.
2723 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
2724 # currency code.
2725 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
2726 #
2727 # Compensation range.
2728 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
2729 #
2730 # Decimal number.
2731 &quot;micros&quot;: 42, # Micro (10^-6) units.
2732 # The value must be between -999,999 and +999,999 inclusive.
2733 # If `units` is positive, `micros` must be positive or zero.
2734 # If `units` is zero, `micros` can be positive, zero, or negative.
2735 # If `units` is negative, `micros` must be negative or zero.
2736 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2737 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2738 },
2739 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
2740 #
2741 # Decimal number.
2742 &quot;micros&quot;: 42, # Micro (10^-6) units.
2743 # The value must be between -999,999 and +999,999 inclusive.
2744 # If `units` is positive, `micros` must be positive or zero.
2745 # If `units` is zero, `micros` can be positive, zero, or negative.
2746 # If `units` is negative, `micros` must be negative or zero.
2747 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2748 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2749 },
2750 },
2751 &quot;entries&quot;: [ # Optional. Job compensation information.
2752 #
2753 # At most one entry can be of type
2754 # ExtendedCompensationInfo.CompensationType.BASE, which is
2755 # referred as ** base compensation entry ** for the job.
2756 { # Deprecated. See CompensationInfo.
2757 #
2758 # A compensation entry that represents one component of compensation, such
2759 # as base pay, bonus, or other compensation type.
2760 #
2761 # Annualization: One compensation entry can be annualized if
2762 # - it contains valid amount or range.
2763 # - and its expected_units_per_year is set or can be derived.
2764 # Its annualized range is determined as (amount or range) times
2765 # expected_units_per_year.
2766 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
2767 #
2768 # Compensation range.
2769 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
2770 #
2771 # Decimal number.
2772 &quot;micros&quot;: 42, # Micro (10^-6) units.
2773 # The value must be between -999,999 and +999,999 inclusive.
2774 # If `units` is positive, `micros` must be positive or zero.
2775 # If `units` is zero, `micros` can be positive, zero, or negative.
2776 # If `units` is negative, `micros` must be negative or zero.
2777 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2778 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2779 },
2780 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
2781 #
2782 # Decimal number.
2783 &quot;micros&quot;: 42, # Micro (10^-6) units.
2784 # The value must be between -999,999 and +999,999 inclusive.
2785 # If `units` is positive, `micros` must be positive or zero.
2786 # If `units` is zero, `micros` can be positive, zero, or negative.
2787 # If `units` is negative, `micros` must be negative or zero.
2788 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2789 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2790 },
2791 },
2792 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
2793 # Job.employment_types is FULLTIME, a default value is inferred
2794 # based on unit. Default values:
2795 # - HOURLY: 2080
2796 # - DAILY: 260
2797 # - WEEKLY: 52
2798 # - MONTHLY: 12
2799 # - ANNUAL: 1
2800 #
2801 # Decimal number.
2802 &quot;micros&quot;: 42, # Micro (10^-6) units.
2803 # The value must be between -999,999 and +999,999 inclusive.
2804 # If `units` is positive, `micros` must be positive or zero.
2805 # If `units` is zero, `micros` can be positive, zero, or negative.
2806 # If `units` is negative, `micros` must be negative or zero.
2807 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2808 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2809 },
2810 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
2811 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
2812 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
2813 #
2814 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
2815 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
2816 #
2817 # Decimal number.
2818 &quot;micros&quot;: 42, # Micro (10^-6) units.
2819 # The value must be between -999,999 and +999,999 inclusive.
2820 # If `units` is positive, `micros` must be positive or zero.
2821 # If `units` is zero, `micros` can be positive, zero, or negative.
2822 # If `units` is negative, `micros` must be negative or zero.
2823 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2824 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2825 },
2826 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
2827 },
2828 ],
2829 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
2830 # the job&#x27;s all CompensationEntry cannot be annualized.
2831 # See CompensationEntry for explanation on annualization and base
2832 # compensation entry.
2833 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
2834 #
2835 # Compensation range.
2836 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
2837 #
2838 # Decimal number.
2839 &quot;micros&quot;: 42, # Micro (10^-6) units.
2840 # The value must be between -999,999 and +999,999 inclusive.
2841 # If `units` is positive, `micros` must be positive or zero.
2842 # If `units` is zero, `micros` can be positive, zero, or negative.
2843 # If `units` is negative, `micros` must be negative or zero.
2844 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2845 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2846 },
2847 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
2848 #
2849 # Decimal number.
2850 &quot;micros&quot;: 42, # Micro (10^-6) units.
2851 # The value must be between -999,999 and +999,999 inclusive.
2852 # If `units` is positive, `micros` must be positive or zero.
2853 # If `units` is zero, `micros` can be positive, zero, or negative.
2854 # If `units` is negative, `micros` must be negative or zero.
2855 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
2856 &quot;units&quot;: &quot;A String&quot;, # Whole units.
2857 },
2858 },
2859 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
2860 # the job&#x27;s base compensation entry cannot be annualized.
2861 # See CompensationEntry for explanation on annualization and base
2862 # compensation entry.
2863 },
2864 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
2865 # provided.
2866 #
2867 # The resource name of the company listing the job, such as
2868 # /companies/foo. This field takes precedence over the
2869 # distributor-assigned company identifier, distributor_company_id.
2870 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
2871 # description of the company and related information. Separate fields are
2872 # provided on the job object for responsibilities,
2873 # qualifications, and other job characteristics. Use of
2874 # these separate job fields is recommended.
2875 #
2876 # This field accepts and sanitizes HTML input, and also accepts
2877 # bold, italic, ordered list, and unordered list markup tags.
2878 #
2879 # The maximum number of allowed characters is 100,000.
2880 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
2881 # application_email_list or application_instruction must be
2882 # specified.
2883 #
2884 # Use this field to specify email address(es) to which resumes or
2885 # applications can be sent.
2886 #
2887 # The maximum number of allowed characters is 255.
2888 &quot;A String&quot;,
2889 ],
2890 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
2891 #
2892 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002893 }</pre>
2894</div>
2895
2896<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -07002897 <code class="details" id="histogram">histogram(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002898 <pre>Deprecated. Use SearchJobsRequest.histogram_facets instead to make
2899a single call with both search and histogram.
2900
2901Retrieves a histogram for the given
2902GetHistogramRequest. This call provides a structured
2903count of jobs that match against the search query, grouped by specified
2904facets.
2905
2906This call constrains the visibility of jobs
2907present in the database, and only counts jobs the caller has
2908permission to search against.
2909
2910For example, use this call to generate the
2911number of jobs in the U.S. by state.
2912
2913Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07002914 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002915 The object takes the form of:
2916
2917{ # Deprecated. Use SearchJobsRequest.histogram_facets instead to make
2918 # a single call with both search and histogram.
2919 #
2920 # Input only.
2921 #
2922 # A request for the `GetHistogram` method.
Bu Sun Kim65020912020-05-20 12:08:20 -07002923 &quot;allowBroadening&quot;: True or False, # Optional. Controls whether to broaden the search to avoid too few results for a
2924 # given query in instances where a search has sparse results. Results from a
2925 # broadened query is a superset of the results from the original query.
2926 #
2927 # Defaults to false.
2928 &quot;requestMetadata&quot;: { # Input only. # Meta information, such as `user_id`, collected from the job searcher or
2929 # other entity conducting a job search, is used to improve the service&#x27;s
2930 # search quality. Users determine identifier values, which must be
2931 # unique and consist.
2932 #
2933 # Meta information related to the job searcher or entity
2934 # conducting the job search. This information is used to improve the
2935 # performance of the service.
2936 &quot;sessionId&quot;: &quot;A String&quot;, # Required. A unique session identification string. A session is defined as the
2937 # duration of an end user&#x27;s interaction with the service over a period.
2938 # Obfuscate this field for privacy concerns before
2939 # providing it to the API.
2940 #
2941 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
2942 # that any improvements to the service model for a particular tenant site,
2943 # rely on this field being set correctly to some unique session_id.
2944 &quot;domain&quot;: &quot;A String&quot;, # Required. The client-defined scope or source of the service call, which typically
2945 # is the domain on
2946 # which the service has been implemented and is currently being run.
2947 #
2948 # For example, if the service is being run by client &lt;em&gt;Foo, Inc.&lt;/em&gt;, on
2949 # job board www.foo.com and career site www.bar.com, then this field is
2950 # set to &quot;foo.com&quot; for use on the job board, and &quot;bar.com&quot; for use on the
2951 # career site.
2952 #
2953 # If this field is not available for some reason, send &quot;UNKNOWN&quot;. Note that
2954 # any improvements to the service model for a particular tenant site rely on
2955 # this field being set correctly to some domain.
2956 &quot;userId&quot;: &quot;A String&quot;, # Required. A unique user identification string, as determined by the client. The
2957 # client is responsible for ensuring client-level uniqueness of this value
2958 # in order to have the strongest positive impact on search quality.
2959 # Obfuscate this field for privacy concerns before
2960 # providing it to the service.
2961 #
2962 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
2963 # that any improvements to the service model for a particular tenant site,
2964 # rely on this field being set correctly to some unique user_id.
2965 &quot;deviceInfo&quot;: { # Input only. # Optional. The type of device used by the job seeker at the time of the call to the
2966 # service.
2967 #
2968 # Device information collected from the job seeker, candidate, or
2969 # other entity conducting the job search. Providing this information improves
2970 # the quality of the search results across devices.
2971 &quot;deviceType&quot;: &quot;A String&quot;, # Optional. Type of the device.
2972 &quot;id&quot;: &quot;A String&quot;, # Optional. A device-specific ID. The ID must be a unique identifier that distinguishes
2973 # the device from other devices.
2974 },
2975 },
2976 &quot;searchTypes&quot;: [ # Required. A list of facets that specify the histogram data to be calculated
2977 # against and returned.
2978 #
2979 # Histogram response times can be slow, and counts
2980 # can be approximations. This call may be temporarily or permanently removed
2981 # prior to the production release of Cloud Talent Solution.
2982 &quot;A String&quot;,
2983 ],
2984 &quot;query&quot;: { # Input only. # Optional. Query used to search against jobs, such as keyword, location filters, etc.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002985 #
2986 # The query required to perform a search query or histogram.
Bu Sun Kim65020912020-05-20 12:08:20 -07002987 &quot;companyNames&quot;: [ # Optional. This filter specifies the company entities to search against.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002988 #
Bu Sun Kim65020912020-05-20 12:08:20 -07002989 # If a value isn&#x27;t specified, jobs are searched for against all
2990 # companies.
2991 #
2992 # If multiple values are specified, jobs are searched against the
2993 # companies specified.
2994 #
2995 # At most 20 company filters are allowed.
2996 &quot;A String&quot;,
2997 ],
2998 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
2999 # search against, such as EmploymentType.FULL_TIME.
3000 #
3001 # If a value is not specified, jobs in the search results include any
3002 # employment type.
3003 #
3004 # If multiple values are specified, jobs in the search results include
3005 # any of the specified employment types.
3006 &quot;A String&quot;,
3007 ],
3008 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
3009 # See Category for more information.
3010 #
3011 # If a value is not specified, jobs from any category are searched against.
3012 #
3013 # If multiple values are specified, jobs from any of the specified
3014 # categories are searched against.
3015 &quot;A String&quot;,
3016 ],
3017 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003018 # Job.custom_attributes marked as `filterable`.
3019 #
3020 # The syntax for this expression is a subset of Google SQL syntax.
3021 #
Dan O'Mearadd494642020-05-01 07:42:23 -07003022 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003023 # is a custom field key and the right of the operator is a number or string
3024 # (surrounded by quotes) value.
3025 #
Dan O'Mearadd494642020-05-01 07:42:23 -07003026 # Supported functions are LOWER(&lt;field_name&gt;) to
3027 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003028 # existence of a key.
3029 #
3030 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
Bu Sun Kim65020912020-05-20 12:08:20 -07003031 # nesting (for example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), a maximum of 50
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003032 # comparisons/functions are allowed in the expression. The expression
Dan O'Mearadd494642020-05-01 07:42:23 -07003033 # must be &lt; 2000 characters in length.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003034 #
3035 # Sample Query:
Bu Sun Kim65020912020-05-20 12:08:20 -07003036 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
3037 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003038 # search against. See LocationFilter for more information.
3039 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003040 # If a location value isn&#x27;t specified, jobs fitting the other search
3041 # criteria are retrieved regardless of where they&#x27;re located.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003042 #
3043 # If multiple values are specified, jobs are retrieved from any of the
3044 # specified locations. If different values are specified for the
3045 # LocationFilter.distance_in_miles parameter, the maximum provided
3046 # distance is used for all locations.
3047 #
3048 # At most 5 location filters are allowed.
3049 { # Input only.
3050 #
3051 # Geographic region of the search.
Bu Sun Kim65020912020-05-20 12:08:20 -07003052 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
3053 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
3054 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
3055 #
3056 # Set this field if all the jobs to search against are from a same region,
3057 # or jobs are world-wide but the job seeker is from a specific region.
3058 #
3059 # See http://cldr.unicode.org/ and
3060 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
3061 # for details. Example: &quot;CH&quot; for Switzerland.
3062 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
3063 # identified as a city or smaller. When the location being searched for is a
3064 # state or larger, this field is ignored.
3065 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003066 # set location, specifically, telecommuting jobs (telecomuting is considered
3067 # by the service as a special location.
3068 # Job.allow_telecommute indicates if a job permits telecommuting.
3069 # If this field is true, telecommuting jobs are searched, and
3070 # name and lat_lng are
3071 # ignored.
3072 # This filter can be used by itself to search exclusively for telecommuting
3073 # jobs, or it can be combined with another location
3074 # filter to search for a combination of job locations,
Bu Sun Kim65020912020-05-20 12:08:20 -07003075 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003076 # combination with other location filters, telecommuting jobs can be
3077 # treated as less relevant than other jobs in the search response.
Bu Sun Kim65020912020-05-20 12:08:20 -07003078 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
3079 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
Dan O'Mearadd494642020-05-01 07:42:23 -07003080 # search. This field is ignored if `location_name` is provided.
3081 # of doubles representing degrees latitude and degrees longitude. Unless
3082 # specified otherwise, this must conform to the
Bu Sun Kim65020912020-05-20 12:08:20 -07003083 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
Dan O'Mearadd494642020-05-01 07:42:23 -07003084 # standard&lt;/a&gt;. Values must be within normalized ranges.
Bu Sun Kim65020912020-05-20 12:08:20 -07003085 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
3086 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Dan O'Mearadd494642020-05-01 07:42:23 -07003087 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003088 },
3089 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07003090 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
3091 # against, for example, DateRange.PAST_MONTH. If a value isn&#x27;t
3092 # specified, all open jobs are searched against regardless of their
3093 # published date.
3094 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (for
3095 # example, driving or public transit). Note: This only works with COMMUTE
3096 # MODE. When specified, [JobQuery.location_filters] is
3097 # ignored.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003098 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003099 # Currently we don&#x27;t support sorting by commute time.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003100 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003101 # Parameters needed for commute search.
3102 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
3103 # integer between 0 and 23, representing the hour in the time zone of the
3104 # start_location. Must not be present if road_traffic is specified.
3105 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
3106 # For city level addresses, the city center is used. For state and coarser
3107 # level addresses, text matching is used.
3108 # If this field is set to `false` or is not specified, only jobs that include
3109 # street level addresses will be returned by commute search.
3110 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
3111 # (one hour). Format is `123s`.
3112 &quot;startLocation&quot;: { # 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
3113 # commute time.
3114 # of doubles representing degrees latitude and degrees longitude. Unless
3115 # specified otherwise, this must conform to the
3116 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
3117 # standard&lt;/a&gt;. Values must be within normalized ranges.
3118 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
3119 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
3120 },
3121 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
3122 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
3123 # Must not be present if departure_hour_local is specified.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003124 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003125 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
3126 # for example, &quot;en-US&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003127 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003128 # If a value isn&#x27;t specified, the search results can contain jobs in any
3129 # locale.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003130 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003131 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003132 # Language codes should be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
3133 # For more information, see
3134 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003135 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003136 # At most 10 language code filters are allowed.
3137 &quot;A String&quot;,
3138 ],
3139 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
3140 # Job.compensation_info. For example, if the filter is specified
3141 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs meeting
3142 # these criteria are searched. If a filter isn&#x27;t defined, all open jobs
3143 # are searched.
3144 #
3145 # Filter on job compensation type and amount.
3146 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
3147 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
3148 # CompensationInfo.CompensationUnit.
3149 &quot;A String&quot;,
3150 ],
3151 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
3152 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
3153 # to zero and the currency code is set to match the
3154 # currency code of max_compensation.
3155 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3156 # The value must be between -999,999,999 and +999,999,999 inclusive.
3157 # If `units` is positive, `nanos` must be positive or zero.
3158 # If `units` is zero, `nanos` can be positive, zero, or negative.
3159 # If `units` is negative, `nanos` must be negative or zero.
3160 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3161 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3162 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3163 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3164 },
3165 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
3166 # to a maximal compensation value and the currency code is set to
3167 # match the currency code of
3168 # min_compensation.
3169 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3170 # The value must be between -999,999,999 and +999,999,999 inclusive.
3171 # If `units` is positive, `nanos` must be positive or zero.
3172 # If `units` is zero, `nanos` can be positive, zero, or negative.
3173 # If `units` is negative, `nanos` must be negative or zero.
3174 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3175 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3176 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3177 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3178 },
3179 },
3180 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
3181 },
3182 &quot;query&quot;: &quot;A String&quot;, # Optional. The query string that matches against the job title, description, and
3183 # location fields.
3184 #
3185 # The maximum query size is 255 bytes.
3186 &quot;companyDisplayNames&quot;: [ # Optional. This filter specifies the exact company display
3187 # name of the jobs to search against.
3188 #
3189 # If a value isn&#x27;t specified, jobs within the search results are
3190 # associated with any company.
3191 #
3192 # If multiple values are specified, jobs within the search results may be
3193 # associated with any of the specified companies.
3194 #
3195 # At most 20 company display name filters are allowed.
3196 &quot;A String&quot;,
3197 ],
3198 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
3199 # service attempts to correct a misspelled query,
3200 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
3201 #
3202 # Defaults to false: a spell check is performed.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003203 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003204 &quot;filters&quot;: { # Input only. # Deprecated. Use query instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003205 #
3206 # Optional.
3207 #
3208 # Restrictions on the scope of the histogram.
3209 #
3210 # Deprecated. Use JobQuery instead.
3211 #
3212 # The filters required to perform a search query or histogram.
Bu Sun Kim65020912020-05-20 12:08:20 -07003213 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003214 # search against. See LocationFilter for more information.
3215 #
3216 # If a location value is not specified, jobs are retrieved
3217 # from all locations.
3218 #
3219 # If multiple values are specified, jobs are retrieved from any of the
3220 # specified locations. If different values are specified for the
3221 # LocationFilter.distance_in_miles parameter, the maximum provided
3222 # distance is used for all locations.
3223 #
3224 # At most 5 location filters are allowed.
3225 { # Input only.
3226 #
3227 # Geographic region of the search.
Bu Sun Kim65020912020-05-20 12:08:20 -07003228 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
3229 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
3230 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
3231 #
3232 # Set this field if all the jobs to search against are from a same region,
3233 # or jobs are world-wide but the job seeker is from a specific region.
3234 #
3235 # See http://cldr.unicode.org/ and
3236 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
3237 # for details. Example: &quot;CH&quot; for Switzerland.
3238 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
3239 # identified as a city or smaller. When the location being searched for is a
3240 # state or larger, this field is ignored.
3241 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003242 # set location, specifically, telecommuting jobs (telecomuting is considered
3243 # by the service as a special location.
3244 # Job.allow_telecommute indicates if a job permits telecommuting.
3245 # If this field is true, telecommuting jobs are searched, and
3246 # name and lat_lng are
3247 # ignored.
3248 # This filter can be used by itself to search exclusively for telecommuting
3249 # jobs, or it can be combined with another location
3250 # filter to search for a combination of job locations,
Bu Sun Kim65020912020-05-20 12:08:20 -07003251 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003252 # combination with other location filters, telecommuting jobs can be
3253 # treated as less relevant than other jobs in the search response.
Bu Sun Kim65020912020-05-20 12:08:20 -07003254 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
3255 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
Dan O'Mearadd494642020-05-01 07:42:23 -07003256 # search. This field is ignored if `location_name` is provided.
3257 # of doubles representing degrees latitude and degrees longitude. Unless
3258 # specified otherwise, this must conform to the
Bu Sun Kim65020912020-05-20 12:08:20 -07003259 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
Dan O'Mearadd494642020-05-01 07:42:23 -07003260 # standard&lt;/a&gt;. Values must be within normalized ranges.
Bu Sun Kim65020912020-05-20 12:08:20 -07003261 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
3262 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Dan O'Mearadd494642020-05-01 07:42:23 -07003263 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003264 },
3265 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07003266 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
3267 # against, for example, DateRange.PAST_MONTH. If a value is not
3268 # specified, all open jobs are searched against regardless of the
3269 # date they were published.
3270 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (e.g.
3271 # driving or public transit). Note: this only works with COMMUTE
3272 # MODE. When specified, [JobFilters.location_filters] will be
3273 # ignored.
3274 #
3275 # Currently we do not support sorting by commute time.
3276 #
3277 # Parameters needed for commute search.
3278 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
3279 # integer between 0 and 23, representing the hour in the time zone of the
3280 # start_location. Must not be present if road_traffic is specified.
3281 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
3282 # For city level addresses, the city center is used. For state and coarser
3283 # level addresses, text matching is used.
3284 # If this field is set to `false` or is not specified, only jobs that include
3285 # street level addresses will be returned by commute search.
3286 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
3287 # (one hour). Format is `123s`.
3288 &quot;startLocation&quot;: { # 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
3289 # commute time.
3290 # of doubles representing degrees latitude and degrees longitude. Unless
3291 # specified otherwise, this must conform to the
3292 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
3293 # standard&lt;/a&gt;. Values must be within normalized ranges.
3294 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
3295 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
3296 },
3297 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
3298 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
3299 # Must not be present if departure_hour_local is specified.
3300 },
3301 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
3302 # for example, &quot;en-US&quot;.
3303 #
3304 # If a value is not specified, the search results may contain jobs in any
3305 # locale.
3306 #
3307 #
3308 # Language codes should be in BCP-47 format, for example, &quot;en-US&quot; or
3309 # &quot;sr-Latn&quot;. For more information, see [Tags for Identifying
3310 # Languages](https://tools.ietf.org/html/bcp47).
3311 #
3312 # At most 10 language code filters are allowed.
3313 &quot;A String&quot;,
3314 ],
3315 &quot;companyTitles&quot;: [ # Optional. This filter specifies the exact company titles
3316 # of jobs to search against.
3317 #
3318 # If a value is not specified, jobs within the search results can be
3319 # associated with any company.
3320 #
3321 # If multiple values are specified, jobs within the search results may be
3322 # associated with any of the specified companies.
3323 #
3324 # At most 20 company title filters are allowed.
3325 &quot;A String&quot;,
3326 ],
3327 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003328 # Job.compensation_info. For example, if the filter is specified
Bu Sun Kim65020912020-05-20 12:08:20 -07003329 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003330 # this criteria are searched. If a filter is not defined, all open jobs
3331 # are searched.
3332 #
3333 # Filter on job compensation type and amount.
Bu Sun Kim65020912020-05-20 12:08:20 -07003334 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
3335 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003336 # CompensationInfo.CompensationUnit.
Bu Sun Kim65020912020-05-20 12:08:20 -07003337 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003338 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07003339 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
3340 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
3341 # to zero and the currency code is set to match the
3342 # currency code of max_compensation.
3343 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3344 # The value must be between -999,999,999 and +999,999,999 inclusive.
3345 # If `units` is positive, `nanos` must be positive or zero.
3346 # If `units` is zero, `nanos` can be positive, zero, or negative.
3347 # If `units` is negative, `nanos` must be negative or zero.
3348 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3349 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3350 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3351 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3352 },
3353 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003354 # to a maximal compensation value and the currency code is set to
3355 # match the currency code of
3356 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07003357 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003358 # The value must be between -999,999,999 and +999,999,999 inclusive.
3359 # If `units` is positive, `nanos` must be positive or zero.
3360 # If `units` is zero, `nanos` can be positive, zero, or negative.
3361 # If `units` is negative, `nanos` must be negative or zero.
3362 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003363 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3364 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3365 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003366 },
3367 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003368 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003369 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003370 &quot;query&quot;: &quot;A String&quot;, # Optional. The query filter contains the keywords that match against the job
3371 # title, description, and location fields.
3372 #
3373 # The maximum query size is 255 bytes/characters.
3374 &quot;extendedCompensationFilter&quot;: { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
3375 #
3376 # Optional.
3377 #
3378 # This search filter is applied only to
3379 # Job.extended_compensation_info. For example, if the filter is specified
3380 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
3381 # these criteria are searched. If a filter is not defined, all open jobs
3382 # are searched.
3383 #
3384 # Input only.
3385 #
3386 # Filter on job compensation type and amount.
3387 &quot;includeJobWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
3388 &quot;compensationUnits&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
3389 # ExtendedCompensationInfo.CompensationUnit.
3390 &quot;A String&quot;,
3391 ],
3392 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
3393 &quot;currency&quot;: &quot;A String&quot;, # Optional. Specify currency in 3-letter
3394 # [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
3395 # unspecified, jobs are returned regardless of currency.
3396 &quot;compensationRange&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
3397 #
3398 # Compensation range.
3399 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
3400 #
3401 # Decimal number.
3402 &quot;micros&quot;: 42, # Micro (10^-6) units.
3403 # The value must be between -999,999 and +999,999 inclusive.
3404 # If `units` is positive, `micros` must be positive or zero.
3405 # If `units` is zero, `micros` can be positive, zero, or negative.
3406 # If `units` is negative, `micros` must be negative or zero.
3407 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
3408 &quot;units&quot;: &quot;A String&quot;, # Whole units.
3409 },
3410 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
3411 #
3412 # Decimal number.
3413 &quot;micros&quot;: 42, # Micro (10^-6) units.
3414 # The value must be between -999,999 and +999,999 inclusive.
3415 # If `units` is positive, `micros` must be positive or zero.
3416 # If `units` is zero, `micros` can be positive, zero, or negative.
3417 # If `units` is negative, `micros` must be negative or zero.
3418 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
3419 &quot;units&quot;: &quot;A String&quot;, # Whole units.
3420 },
3421 },
3422 },
3423 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
3424 # service attempts to correct a misspelled query,
3425 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
3426 #
3427 # Defaults to false: a spell check is performed.
3428 &quot;customFieldFilters&quot;: { # Deprecated. Use custom_attribute_filter instead.
3429 #
3430 # Optional.
3431 #
3432 # This filter specifies searching against
3433 # custom field values. See Job.filterable_custom_fields for information.
3434 # The key value specifies a number between 1-20 (the service
3435 # supports 20 custom fields) corresponding to the desired custom field map
3436 # value. If an invalid key is provided or specified together with
3437 # custom_attribute_filter, an error is thrown.
3438 &quot;a_key&quot;: { # Input only.
3439 #
3440 # Custom field filter of the search.
3441 &quot;type&quot;: &quot;A String&quot;, # Optional. The type of filter.
3442 # Defaults to FilterType.OR.
3443 &quot;queries&quot;: [ # Required. The query strings for the filter.
3444 &quot;A String&quot;,
3445 ],
3446 },
3447 },
3448 &quot;companyNames&quot;: [ # Optional. The company names filter specifies the company entities to search
3449 # against.
3450 #
3451 # If a value is not specified, jobs are searched for against all companies.
3452 #
3453 # If multiple values are specified, jobs are searched against the
3454 # specified companies.
3455 #
3456 # At most 20 company filters are allowed.
3457 &quot;A String&quot;,
3458 ],
3459 &quot;tenantJobOnly&quot;: True or False, # Deprecated. Do not use this field.
3460 #
3461 # This flag controls whether the job search should be restricted to jobs
3462 # owned by the current user.
3463 #
3464 # Defaults to false where all jobs accessible to the
3465 # user are searched against.
3466 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
3467 # search against, such as EmploymentType.FULL_TIME.
3468 #
3469 # If a value is not specified, jobs in the search results include any
3470 # employment type.
3471 #
3472 # If multiple values are specified, jobs in the search results include any
3473 # of the specified employment types.
3474 &quot;A String&quot;,
3475 ],
3476 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
3477 # See Category for more information.
3478 #
3479 # If a value is not specified, jobs from any category are searched against.
3480 #
3481 # If multiple values are specified, jobs from any of the specified
3482 # categories are searched against.
3483 &quot;A String&quot;,
3484 ],
3485 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
3486 # Job.custom_attributes that are marked as `filterable`.
3487 #
3488 # The syntax for this expression is a subset of Google SQL syntax.
3489 #
3490 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
3491 # is a custom field key and the right of the operator is a number or string
3492 # (surrounded by quotes) value.
3493 #
3494 # Supported functions are LOWER(&lt;field_name&gt;) to
3495 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
3496 # existence of a key.
3497 #
3498 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
3499 # nesting (For example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), and there can
3500 # be a maximum of 100 comparisons/functions in the expression. The expression
3501 # must be &lt; 3000 bytes in length.
3502 #
3503 # Sample Query:
3504 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003505 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003506 }
3507
3508 x__xgafv: string, V1 error format.
3509 Allowed values
3510 1 - v1 error format
3511 2 - v2 error format
3512
3513Returns:
3514 An object of the form:
3515
3516 { # Deprecated. Use SearchJobsRequest.histogram_facets instead to make
3517 # a single call with both search and histogram.
3518 #
3519 # Output only.
3520 #
3521 # The response of the GetHistogram method.
Bu Sun Kim65020912020-05-20 12:08:20 -07003522 &quot;results&quot;: [ # The Histogram results.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003523 { # Output only.
3524 #
3525 # Result of a histogram call. The response contains the histogram map for the
3526 # search type specified by HistogramResult.field.
3527 # The response is a map of each filter value to the corresponding count of
3528 # jobs for that filter.
Bu Sun Kim65020912020-05-20 12:08:20 -07003529 &quot;values&quot;: { # A map from the values of field to the number of jobs with that value
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003530 # in this search result.
3531 #
3532 # Key: search type (filter names, such as the companyName).
3533 #
3534 # Values: the count of jobs that match the filter for this search.
Bu Sun Kim65020912020-05-20 12:08:20 -07003535 &quot;a_key&quot;: 42,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003536 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003537 &quot;searchType&quot;: &quot;A String&quot;, # The Histogram search filters.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003538 },
3539 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07003540 &quot;metadata&quot;: { # Output only. # Additional information for the API invocation, such as the request
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003541 # tracking id.
3542 #
3543 # Additional information returned to client, such as debugging
3544 # information.
Bu Sun Kim65020912020-05-20 12:08:20 -07003545 &quot;requestId&quot;: &quot;A String&quot;, # A unique id associated with this call.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003546 # This id is logged for tracking purposes.
Bu Sun Kim65020912020-05-20 12:08:20 -07003547 &quot;mode&quot;: &quot;A String&quot;, # For search response only. Indicates the mode of a performed search.
3548 &quot;experimentIdList&quot;: [ # Identifiers for the versions of the search algorithm used during
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003549 # this API invocation if multiple algorithms are used.
3550 # The default value is empty.
3551 # For search response only.
3552 42,
3553 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003554 },
3555 }</pre>
3556</div>
3557
3558<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -07003559 <code class="details" id="list">list(idsOnly=None, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003560 <pre>Lists jobs by filter.
3561
3562Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07003563 idsOnly: boolean, Optional. If set to `true`, only Job.name, Job.requisition_id and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003564Job.language_code will be returned.
3565
3566A typical use case is to synchronize job repositories.
3567
3568Defaults to false.
Bu Sun Kim65020912020-05-20 12:08:20 -07003569 pageSize: integer, Optional. The maximum number of jobs to be returned per page of results.
3570
3571If ids_only is set to true, the maximum allowed page size
3572is 1000. Otherwise, the maximum allowed page size is 100.
3573
3574Default is 100 if empty or a number &lt; 1 is specified.
Dan O'Mearadd494642020-05-01 07:42:23 -07003575 filter: string, Required. The filter string specifies the jobs to be enumerated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003576
3577Supported operator: =, AND
3578
3579The fields eligible for filtering are:
3580
3581* `companyName` (Required)
3582* `requisitionId` (Optional)
3583
3584Sample Query:
3585
Bu Sun Kim65020912020-05-20 12:08:20 -07003586* companyName = &quot;companies/123&quot;
3587* companyName = &quot;companies/123&quot; AND requisitionId = &quot;req-1&quot;
3588 pageToken: string, Optional. The starting point of a query result.
3589 x__xgafv: string, V1 error format.
3590 Allowed values
3591 1 - v1 error format
3592 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003593
3594Returns:
3595 An object of the form:
3596
3597 { # Output only.
3598 #
3599 # List jobs response.
Bu Sun Kim65020912020-05-20 12:08:20 -07003600 &quot;metadata&quot;: { # Output only. # Additional information for the API invocation, such as the request
3601 # tracking id.
3602 #
3603 # Additional information returned to client, such as debugging
3604 # information.
3605 &quot;requestId&quot;: &quot;A String&quot;, # A unique id associated with this call.
3606 # This id is logged for tracking purposes.
3607 &quot;mode&quot;: &quot;A String&quot;, # For search response only. Indicates the mode of a performed search.
3608 &quot;experimentIdList&quot;: [ # Identifiers for the versions of the search algorithm used during
3609 # this API invocation if multiple algorithms are used.
3610 # The default value is empty.
3611 # For search response only.
3612 42,
3613 ],
3614 },
3615 &quot;jobs&quot;: [ # The Jobs for a given company.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003616 #
3617 # The maximum number of items returned is based on the limit field
3618 # provided in the request.
Bu Sun Kim65020912020-05-20 12:08:20 -07003619 { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot;
3620 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003621 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07003622 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
3623 # is available. If this field is set, a
3624 # LocationFilter in a search query within the job region
3625 # finds this job if an exact location match is not specified.
3626 # If this field is set, setting job locations
3627 # to the same location level as this field is strongly recommended.
3628 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
3629 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003630 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003631 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003632 #
Bu Sun Kim65020912020-05-20 12:08:20 -07003633 # The name of the company listing the job.
3634 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
3635 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
3636 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003637 # CompensationEntry.expected_units_per_year.
3638 #
3639 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07003640 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
3641 # to zero and the currency code is set to match the
3642 # currency code of max_compensation.
3643 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3644 # The value must be between -999,999,999 and +999,999,999 inclusive.
3645 # If `units` is positive, `nanos` must be positive or zero.
3646 # If `units` is zero, `nanos` can be positive, zero, or negative.
3647 # If `units` is negative, `nanos` must be negative or zero.
3648 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3649 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3650 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3651 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3652 },
3653 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003654 # to a maximal compensation value and the currency code is set to
3655 # match the currency code of
3656 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07003657 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003658 # The value must be between -999,999,999 and +999,999,999 inclusive.
3659 # If `units` is positive, `nanos` must be positive or zero.
3660 # If `units` is zero, `nanos` can be positive, zero, or negative.
3661 # If `units` is negative, `nanos` must be negative or zero.
3662 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003663 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3664 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3665 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003666 },
3667 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003668 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003669 #
3670 # Optional.
3671 #
3672 # The amount of compensation or pay for the job.
3673 # As an alternative, compensation_amount_min and
3674 # compensation_amount_max may be used to define a range of
3675 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07003676 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003677 # The value must be between -999,999,999 and +999,999,999 inclusive.
3678 # If `units` is positive, `nanos` must be positive or zero.
3679 # If `units` is zero, `nanos` can be positive, zero, or negative.
3680 # If `units` is negative, `nanos` must be negative or zero.
3681 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003682 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3683 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3684 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003685 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003686 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
3687 #
3688 # Optional.
3689 #
3690 # Type of job compensation.
3691 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
3692 #
3693 # Optional.
3694 #
3695 # An upper bound on a range for compensation or pay for the job.
3696 # The currency type is specified in compensation_amount.
3697 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3698 # The value must be between -999,999,999 and +999,999,999 inclusive.
3699 # If `units` is positive, `nanos` must be positive or zero.
3700 # If `units` is zero, `nanos` can be positive, zero, or negative.
3701 # If `units` is negative, `nanos` must be negative or zero.
3702 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3703 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3704 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3705 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3706 },
3707 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
3708 # all compensation entries&#x27; CompensationEntry.compensation times
3709 # CompensationEntry.expected_units_per_year.
3710 #
3711 # See CompensationEntry for explanation on compensation annualization.
3712 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
3713 # to zero and the currency code is set to match the
3714 # currency code of max_compensation.
3715 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3716 # The value must be between -999,999,999 and +999,999,999 inclusive.
3717 # If `units` is positive, `nanos` must be positive or zero.
3718 # If `units` is zero, `nanos` can be positive, zero, or negative.
3719 # If `units` is negative, `nanos` must be negative or zero.
3720 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3721 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3722 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3723 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3724 },
3725 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
3726 # to a maximal compensation value and the currency code is set to
3727 # match the currency code of
3728 # min_compensation.
3729 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3730 # The value must be between -999,999,999 and +999,999,999 inclusive.
3731 # If `units` is positive, `nanos` must be positive or zero.
3732 # If `units` is zero, `nanos` can be positive, zero, or negative.
3733 # If `units` is negative, `nanos` must be negative or zero.
3734 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3735 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3736 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3737 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3738 },
3739 },
3740 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
3741 #
3742 # Optional.
3743 #
3744 # A lower bound on a range for compensation or pay for the job.
3745 # The currency type is specified in compensation_amount.
3746 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3747 # The value must be between -999,999,999 and +999,999,999 inclusive.
3748 # If `units` is positive, `nanos` must be positive or zero.
3749 # If `units` is zero, `nanos` can be positive, zero, or negative.
3750 # If `units` is negative, `nanos` must be negative or zero.
3751 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3752 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3753 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3754 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3755 },
3756 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003757 #
3758 # At most one entry can be of type
3759 # CompensationInfo.CompensationType.BASE, which is
3760 # referred as ** base compensation entry ** for the job.
3761 { # A compensation entry that represents one component of compensation, such
3762 # as base pay, bonus, or other compensation type.
3763 #
3764 # Annualization: One compensation entry can be annualized if
3765 # - it contains valid amount or range.
3766 # - and its expected_units_per_year is set or can be derived.
3767 # Its annualized range is determined as (amount or range) times
3768 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07003769 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
3770 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
3771 # to zero and the currency code is set to match the
3772 # currency code of max_compensation.
3773 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
3774 # The value must be between -999,999,999 and +999,999,999 inclusive.
3775 # If `units` is positive, `nanos` must be positive or zero.
3776 # If `units` is zero, `nanos` can be positive, zero, or negative.
3777 # If `units` is negative, `nanos` must be negative or zero.
3778 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
3779 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3780 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3781 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
3782 },
3783 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003784 # to a maximal compensation value and the currency code is set to
3785 # match the currency code of
3786 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07003787 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003788 # The value must be between -999,999,999 and +999,999,999 inclusive.
3789 # If `units` is positive, `nanos` must be positive or zero.
3790 # If `units` is zero, `nanos` can be positive, zero, or negative.
3791 # If `units` is negative, `nanos` must be negative or zero.
3792 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003793 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3794 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3795 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003796 },
3797 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003798 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003799 # Job.employment_types is FULLTIME, a default value is inferred
3800 # based on unit. Default values:
3801 # - HOURLY: 2080
3802 # - DAILY: 260
3803 # - WEEKLY: 52
3804 # - MONTHLY: 12
3805 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07003806 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
3807 # indicate equity terms or provide additional context to an estimated
3808 # bonus.
3809 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
3810 #
3811 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
3812 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
3813 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003814 # The value must be between -999,999,999 and +999,999,999 inclusive.
3815 # If `units` is positive, `nanos` must be positive or zero.
3816 # If `units` is zero, `nanos` can be positive, zero, or negative.
3817 # If `units` is negative, `nanos` must be negative or zero.
3818 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003819 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
3820 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
3821 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003822 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003823 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003824 },
3825 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003826 },
Bu Sun Kim65020912020-05-20 12:08:20 -07003827 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
3828 # recommended as an alternative to using the more general description
3829 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003830 #
3831 # This field accepts and sanitizes HTML input, and also accepts
3832 # bold, italic, ordered list, and unordered list markup tags.
3833 #
3834 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07003835 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003836 # experience.
3837 #
3838 # The expiration timestamp of the job. After this timestamp, the
3839 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07003840 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003841 # ListJobs APIs, but it can be retrieved with the GetJob API or
3842 # updated with the UpdateJob API. An expired job can be updated and
3843 # opened again by using a future expiration timestamp. Updating an expired
3844 # job fails if there is another existing open job with same
3845 # requisition_id, company_name and language_code.
3846 #
3847 # The expired jobs are retained in our system for 90 days. However, the
3848 # overall expired job count cannot exceed 3 times the maximum of open jobs
3849 # count over the past week, otherwise jobs with earlier expire time are
3850 # cleaned first. Expired jobs are no longer accessible after they are cleaned
3851 # out.
3852 # The format of this field is RFC 3339 date strings. Example:
3853 # 2000-01-01T00:00:00.999999999Z
3854 # See
3855 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
3856 #
3857 # A valid date range is between 1970-01-01T00:00:00.0Z and
3858 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
3859 # time not provided.
3860 #
3861 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07003862 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003863 # example, if the job was created on 2017/01/01 13:00AM UTC with an
3864 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
3865 #
3866 # If this value is not provided but expiry_date is, expiry_date is
3867 # used.
3868 #
3869 # If this value is not provided on job update, it depends on the field masks
3870 # set by UpdateJobRequest.update_job_fields. If the field masks include
3871 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07003872 # updated, the job posting expires after 30 days from the job&#x27;s last
3873 # update time. Otherwise the expiration date isn&#x27;t updated.
3874 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
3875 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
3876 { # Output only.
3877 #
3878 # A resource that represents a location with full geographic
3879 # information.
3880 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
3881 # such as postal delivery and payments addresses. Given a postal address,
3882 # a postal service can deliver items to a premises, P.O. Box, or other
3883 # delivery location.
3884 # Given a postal address, a postal service can deliver items to a premise, P.O.
3885 # Box or similar.
3886 # It is not intended to model geographical locations (roads, towns,
3887 # mountains).
3888 #
3889 # In typical usage an address would be created via user input or from importing
3890 # existing data, depending on the type of process.
3891 #
3892 # Advice on address input / editing:
3893 # - Use an i18n-ready address widget such as
3894 # https://github.com/google/libaddressinput)
3895 # - Users should not be presented with UI elements for input or editing of
3896 # fields outside countries where that field is used.
3897 #
3898 # For more guidance on how to use this schema, please see:
3899 # https://support.google.com/business/answer/6397478
3900 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
3901 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
3902 # is never inferred and it is up to the user to ensure the value is
3903 # correct. See http://cldr.unicode.org/ and
3904 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
3905 # for details. Example: &quot;CH&quot; for Switzerland.
3906 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
3907 #
3908 # Because values in address_lines do not have type information and may
3909 # sometimes contain multiple values in a single field (e.g.
3910 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
3911 # address lines should be &quot;envelope order&quot; for the country/region of the
3912 # address. In places where this can vary (e.g. Japan), address_language is
3913 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
3914 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
3915 # an address can be selected based on the language.
3916 #
3917 # The minimum permitted structural representation of an address consists
3918 # of a region_code with all remaining information placed in the
3919 # address_lines. It would be possible to format such an address very
3920 # approximately without geocoding, but no semantic reasoning could be
3921 # made about any of the address components until it was at least
3922 # partially resolved.
3923 #
3924 # Creating an address only containing a region_code and address_lines, and
3925 # then geocoding is the recommended way to handle completely unstructured
3926 # addresses (as opposed to guessing which parts of the address should be
3927 # localities or administrative areas).
3928 &quot;A String&quot;,
3929 ],
3930 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
3931 # postal codes to be present, but where they are used, they may trigger
3932 # additional validation with other parts of the address (e.g. state/zip
3933 # validation in the U.S.A.).
3934 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
3935 # in most regions. Where it is used, the value is either a string like
3936 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
3937 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
3938 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
3939 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
3940 # known). This is often the UI language of the input form or is expected
3941 # to match one of the languages used in the address&#x27; country/region, or their
3942 # transliterated equivalents.
3943 # This can affect formatting in certain countries, but is not critical
3944 # to the correctness of the data and will never affect any validation or
3945 # other non-formatting related operations.
3946 #
3947 # If this value is not known, it should be omitted (rather than specifying a
3948 # possibly incorrect default).
3949 #
3950 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
3951 &quot;recipients&quot;: [ # Optional. The recipient at the address.
3952 # This field may, under certain circumstances, contain multiline information.
3953 # For example, it might contain &quot;care of&quot; information.
3954 &quot;A String&quot;,
3955 ],
3956 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
3957 # For example, this can be neighborhoods, boroughs, districts.
3958 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
3959 # the latest revision.
3960 #
3961 # All new revisions **must** be backward compatible with old revisions.
3962 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
3963 # addresses of a country or region.
3964 # For example, this can be a state, a province, an oblast, or a prefecture.
3965 # Specifically, for Spain this is the province and not the autonomous
3966 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
3967 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
3968 # in Switzerland this should be left unpopulated.
3969 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
3970 # Examples: US city, IT comune, UK post town.
3971 # In regions of the world where localities are not well defined or do not fit
3972 # into this structure well, leave locality empty and use address_lines.
3973 },
3974 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
3975 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
3976 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
3977 # LocationType#LOCALITY.
3978 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
3979 # location bounding box in which a circle with the specified radius
3980 # centered from LatLng coves the area associated with the job location.
3981 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
3982 # 7885.79 meters.
3983 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
3984 # of doubles representing degrees latitude and degrees longitude. Unless
3985 # specified otherwise, this must conform to the
3986 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
3987 # standard&lt;/a&gt;. Values must be within normalized ranges.
3988 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
3989 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
3990 },
3991 },
3992 ],
3993 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
3994 # position.
3995 #
3996 # The maximum number of allowed characters is 255.
3997 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
3998 #
3999 # Optional.
4000 #
4001 # A map of fields to hold non-filterable custom job attributes, similar to
4002 # filterable_custom_fields. These fields are distinct in that the data
4003 # in these fields are not indexed. Therefore, the client cannot search
4004 # against them, nor can the client use them to list jobs.
4005 #
4006 # The key of the map can be any valid string.
4007 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
4008 &quot;values&quot;: [ # Optional. The values of the custom data.
4009 &quot;A String&quot;,
4010 ],
4011 },
4012 },
4013 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
4014 #
4015 # Optional but strongly recommended to be provided for the best service
4016 # experience.
4017 #
4018 # The expiration date of the job in UTC time. After 12 am on this date, the
4019 # job is marked as expired, and it no longer appears in search results.
4020 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
4021 # ListJobs APIs, but it can be retrieved with the GetJob API or
4022 # updated with the UpdateJob API. An expired job can be updated and
4023 # opened again by using a future expiration date. It can also remain expired.
4024 # Updating an expired job to be open fails if there is another existing open
4025 # job with same requisition_id, company_name and language_code.
4026 #
4027 # The expired jobs are retained in our system for 90 days. However, the
4028 # overall expired job count cannot exceed 3 times the maximum of open jobs
4029 # count over the past week, otherwise jobs with earlier expire time are
4030 # removed first. Expired jobs are no longer accessible after they are cleaned
4031 # out.
4032 #
4033 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
4034 # ignored and treated as expiry date not provided.
4035 #
4036 # If this value is not provided on job creation or is invalid, the job
4037 # posting expires after 30 days from the job&#x27;s creation time. For example, if
4038 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
4039 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
4040 #
4041 # If this value is not provided on job update, it depends on the field masks
4042 # set by UpdateJobRequest.update_job_fields. If the field masks include
4043 # expiry_date, or the masks are empty meaning that every field is
4044 # updated, the job expires after 30 days from the job&#x27;s last update time.
4045 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004046 # and time zone are either specified elsewhere or are not significant. The date
4047 # is relative to the Proleptic Gregorian Calendar. This can represent:
4048 #
4049 # * A full date, with non-zero year, month and day values
4050 # * A month and day value, with a zero year, e.g. an anniversary
4051 # * A year on its own, with zero month and day values
4052 # * A year and month value, with a zero day, e.g. a credit card expiration date
4053 #
4054 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07004055 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004056 # if specifying a year by itself or a year and month where the day is not
4057 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07004058 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004059 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07004060 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4061 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004062 },
Bu Sun Kim65020912020-05-20 12:08:20 -07004063 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
4064 # is used for contracting engagements.
4065 # Dates prior to 1970/1/1 and invalid date formats are ignored.
4066 # and time zone are either specified elsewhere or are not significant. The date
4067 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004068 #
Bu Sun Kim65020912020-05-20 12:08:20 -07004069 # * A full date, with non-zero year, month and day values
4070 # * A month and day value, with a zero year, e.g. an anniversary
4071 # * A year on its own, with zero month and day values
4072 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004073 #
Bu Sun Kim65020912020-05-20 12:08:20 -07004074 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4075 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4076 # if specifying a year by itself or a year and month where the day is not
4077 # significant.
4078 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4079 # a year.
4080 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4081 # month and day.
4082 },
4083 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
4084 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
4085 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004086 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07004087 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004088 # attributes that are not covered by the provided structured fields.
4089 #
4090 # This field is a more general combination of the deprecated id-based
4091 # filterable_custom_fields and string-based
4092 # non_filterable_custom_fields.
4093 #
4094 # The keys of the map are strings up to 64 bytes and must match the
4095 # pattern: a-zA-Z*.
4096 #
4097 # At most 100 filterable and at most 100 unfilterable keys are supported.
4098 # For filterable `string_values`, across all keys at most 200 values are
4099 # allowed, with each string no more than 255 characters. For unfilterable
4100 # `string_values`, the maximum total size of `string_values` across all keys
4101 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07004102 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
4103 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004104 # If false, values are not searchable.
4105 #
4106 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07004107 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
4108 # be specified.
4109 #
4110 # This field is used to perform number range search.
4111 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
4112 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
4113 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004114 # be specified.
4115 #
4116 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
4117 # `CASE_INSENSITIVE_MATCH`) search.
4118 # For filterable `string_values`, a maximum total number of 200 values
4119 # is allowed, with each `string_value` has a byte size of no more than
4120 # 255B. For unfilterable `string_values`, the maximum total byte size of
4121 # unfilterable `string_values` is 50KB.
4122 #
4123 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07004124 &quot;values&quot;: [ # Required. String values.
4125 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004126 ],
4127 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004128 },
4129 },
Bu Sun Kim65020912020-05-20 12:08:20 -07004130 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
4131 #
4132 # Optional.
4133 #
4134 # A map of fields to hold filterable custom job attributes not captured by
4135 # the standard fields such as job_title, company_name, or
4136 # level. These custom fields store arbitrary
4137 # string values, and can be used for purposes not covered by
4138 # the structured fields. For the best search experience, use of the
4139 # structured rather than custom fields is recommended.
4140 #
4141 # Data stored in these custom fields fields are indexed and
4142 # searched against by keyword searches (see
4143 # SearchJobsRequest.custom_field_filters][]).
4144 #
4145 # The map key must be a number between 1-20. If an invalid key is
4146 # provided on job create or update, an error is returned.
4147 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
4148 &quot;values&quot;: [ # Optional. The values of the custom data.
4149 &quot;A String&quot;,
4150 ],
4151 },
4152 },
4153 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
4154 # any requirements for fluency that are associated with the job.
4155 #
4156 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
4157 # For more information, see
4158 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
4159 # class=&quot;external&quot; target=&quot;_blank&quot; }.
4160 #
4161 # If this field is unspecified and Job.description is present, detected
4162 # language code based on Job.description is assigned, otherwise
4163 # defaults to &#x27;en_US&#x27;.
4164 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
4165 # Defaults to JobVisibility.PRIVATE if not specified.
4166 # Currently only JobVisibility.PRIVATE is supported.
4167 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
4168 #
4169 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
4170 # of this field in job queries and API calls is preferred over the use of
4171 # requisition_id since this value is unique.
4172 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004173 # provided.
4174 #
4175 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07004176 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004177 # this field, and is the recommended field to use to identify companies.
4178 #
4179 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07004180 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
4181 # The value determines the sort order of the jobs returned when searching for
4182 # jobs using the featured jobs search call, with higher promotional values
4183 # being returned first and ties being resolved by relevance sort. Only the
4184 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
4185 #
4186 # Default value is 0, and negative values are treated as 0.
4187 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
4188 # value is the time the request arrives at the server.
4189 # and time zone are either specified elsewhere or are not significant. The date
4190 # is relative to the Proleptic Gregorian Calendar. This can represent:
4191 #
4192 # * A full date, with non-zero year, month and day values
4193 # * A month and day value, with a zero year, e.g. an anniversary
4194 # * A year on its own, with zero month and day values
4195 # * A year and month value, with a zero day, e.g. a credit card expiration date
4196 #
4197 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4198 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4199 # if specifying a year by itself or a year and month where the day is not
4200 # significant.
4201 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4202 # a year.
4203 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4204 # month and day.
4205 },
4206 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
4207 # application_email_list or application_instruction must be
4208 # specified.
4209 #
4210 # Use this URL field to direct an applicant to a website, for example to
4211 # link to an online application form.
4212 #
4213 # The maximum number of allowed characters is 2,000.
4214 &quot;A String&quot;,
4215 ],
4216 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
4217 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
4218 # client to identify a job. This field is intended to be used by clients
4219 # for client identification and tracking of listings. A job is not allowed
4220 # to be created if there is another job with the same requisition_id,
4221 # company_name and language_code.
4222 #
4223 # The maximum number of allowed characters is 255.
4224 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
4225 # job. The use of this field is recommended
4226 # as an alternative to using the more general description field.
4227 #
4228 # This field accepts and sanitizes HTML input, and also accepts
4229 # bold, italic, ordered list, and unordered list markup tags.
4230 #
4231 # The maximum number of allowed characters is 10,000.
4232 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
4233 # is used for contracting engagements.
4234 # Dates prior to 1970/1/1 and invalid date formats are ignored.
4235 # and time zone are either specified elsewhere or are not significant. The date
4236 # is relative to the Proleptic Gregorian Calendar. This can represent:
4237 #
4238 # * A full date, with non-zero year, month and day values
4239 # * A month and day value, with a zero year, e.g. an anniversary
4240 # * A year on its own, with zero month and day values
4241 # * A year and month value, with a zero day, e.g. a credit card expiration date
4242 #
4243 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4244 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4245 # if specifying a year by itself or a year and month where the day is not
4246 # significant.
4247 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4248 # a year.
4249 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4250 # month and day.
4251 },
4252 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
4253 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
4254 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
4255 # application_email_list or application_instruction must be
4256 # specified.
4257 #
4258 # Use this field to provide instructions, such as &quot;Mail your application
4259 # to ...&quot;, that a candidate can follow to apply for the job.
4260 #
4261 # This field accepts and sanitizes HTML input, and also accepts
4262 # bold, italic, ordered list, and unordered list markup tags.
4263 #
4264 # The maximum number of allowed characters is 3,000.
4265 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
4266 &quot;A String&quot;,
4267 ],
4268 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
4269 # incentives associated with the job not including salary or pay.
4270 #
4271 # The maximum number of allowed characters is 10,000.
4272 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
4273 # full time or
4274 # part time.
4275 &quot;A String&quot;,
4276 ],
4277 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
4278 #
4279 # Location(s) where the emploeyer is looking to hire for this job posting.
4280 #
4281 # Specifying the full street address(es) of the hiring location enables
4282 # better API results, especially job searches by commute time.
4283 #
4284 # At most 50 locations are allowed for best search performance. If a job has
4285 # more locations, it is suggested to split it into multiple jobs with unique
4286 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
4287 # multiple jobs with the same requisition_id, company_name and
4288 # language_code are not allowed. If the original requisition_id must
4289 # be preserved, a custom field should be used for storage. It is also
4290 # suggested to group the locations that close to each other in the same job
4291 # for better search experience.
4292 #
4293 # The maximum number of allowed characters is 500.
4294 &quot;A String&quot;,
4295 ],
4296 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
4297 #
4298 # Optional.
4299 #
4300 # Job compensation information.
4301 #
4302 # This field replaces compensation_info. Only
4303 # CompensationInfo.entries or extended_compensation_info can be set,
4304 # otherwise an exception is thrown.
4305 #
4306 # Describes job compensation.
4307 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
4308 # currency code.
4309 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
4310 #
4311 # Compensation range.
4312 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
4313 #
4314 # Decimal number.
4315 &quot;micros&quot;: 42, # Micro (10^-6) units.
4316 # The value must be between -999,999 and +999,999 inclusive.
4317 # If `units` is positive, `micros` must be positive or zero.
4318 # If `units` is zero, `micros` can be positive, zero, or negative.
4319 # If `units` is negative, `micros` must be negative or zero.
4320 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4321 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4322 },
4323 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
4324 #
4325 # Decimal number.
4326 &quot;micros&quot;: 42, # Micro (10^-6) units.
4327 # The value must be between -999,999 and +999,999 inclusive.
4328 # If `units` is positive, `micros` must be positive or zero.
4329 # If `units` is zero, `micros` can be positive, zero, or negative.
4330 # If `units` is negative, `micros` must be negative or zero.
4331 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4332 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4333 },
4334 },
4335 &quot;entries&quot;: [ # Optional. Job compensation information.
4336 #
4337 # At most one entry can be of type
4338 # ExtendedCompensationInfo.CompensationType.BASE, which is
4339 # referred as ** base compensation entry ** for the job.
4340 { # Deprecated. See CompensationInfo.
4341 #
4342 # A compensation entry that represents one component of compensation, such
4343 # as base pay, bonus, or other compensation type.
4344 #
4345 # Annualization: One compensation entry can be annualized if
4346 # - it contains valid amount or range.
4347 # - and its expected_units_per_year is set or can be derived.
4348 # Its annualized range is determined as (amount or range) times
4349 # expected_units_per_year.
4350 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
4351 #
4352 # Compensation range.
4353 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
4354 #
4355 # Decimal number.
4356 &quot;micros&quot;: 42, # Micro (10^-6) units.
4357 # The value must be between -999,999 and +999,999 inclusive.
4358 # If `units` is positive, `micros` must be positive or zero.
4359 # If `units` is zero, `micros` can be positive, zero, or negative.
4360 # If `units` is negative, `micros` must be negative or zero.
4361 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4362 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4363 },
4364 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
4365 #
4366 # Decimal number.
4367 &quot;micros&quot;: 42, # Micro (10^-6) units.
4368 # The value must be between -999,999 and +999,999 inclusive.
4369 # If `units` is positive, `micros` must be positive or zero.
4370 # If `units` is zero, `micros` can be positive, zero, or negative.
4371 # If `units` is negative, `micros` must be negative or zero.
4372 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4373 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4374 },
4375 },
4376 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
4377 # Job.employment_types is FULLTIME, a default value is inferred
4378 # based on unit. Default values:
4379 # - HOURLY: 2080
4380 # - DAILY: 260
4381 # - WEEKLY: 52
4382 # - MONTHLY: 12
4383 # - ANNUAL: 1
4384 #
4385 # Decimal number.
4386 &quot;micros&quot;: 42, # Micro (10^-6) units.
4387 # The value must be between -999,999 and +999,999 inclusive.
4388 # If `units` is positive, `micros` must be positive or zero.
4389 # If `units` is zero, `micros` can be positive, zero, or negative.
4390 # If `units` is negative, `micros` must be negative or zero.
4391 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4392 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4393 },
4394 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
4395 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
4396 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
4397 #
4398 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
4399 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
4400 #
4401 # Decimal number.
4402 &quot;micros&quot;: 42, # Micro (10^-6) units.
4403 # The value must be between -999,999 and +999,999 inclusive.
4404 # If `units` is positive, `micros` must be positive or zero.
4405 # If `units` is zero, `micros` can be positive, zero, or negative.
4406 # If `units` is negative, `micros` must be negative or zero.
4407 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4408 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4409 },
4410 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
4411 },
4412 ],
4413 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
4414 # the job&#x27;s all CompensationEntry cannot be annualized.
4415 # See CompensationEntry for explanation on annualization and base
4416 # compensation entry.
4417 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
4418 #
4419 # Compensation range.
4420 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
4421 #
4422 # Decimal number.
4423 &quot;micros&quot;: 42, # Micro (10^-6) units.
4424 # The value must be between -999,999 and +999,999 inclusive.
4425 # If `units` is positive, `micros` must be positive or zero.
4426 # If `units` is zero, `micros` can be positive, zero, or negative.
4427 # If `units` is negative, `micros` must be negative or zero.
4428 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4429 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4430 },
4431 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
4432 #
4433 # Decimal number.
4434 &quot;micros&quot;: 42, # Micro (10^-6) units.
4435 # The value must be between -999,999 and +999,999 inclusive.
4436 # If `units` is positive, `micros` must be positive or zero.
4437 # If `units` is zero, `micros` can be positive, zero, or negative.
4438 # If `units` is negative, `micros` must be negative or zero.
4439 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
4440 &quot;units&quot;: &quot;A String&quot;, # Whole units.
4441 },
4442 },
4443 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
4444 # the job&#x27;s base compensation entry cannot be annualized.
4445 # See CompensationEntry for explanation on annualization and base
4446 # compensation entry.
4447 },
4448 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
4449 # provided.
4450 #
4451 # The resource name of the company listing the job, such as
4452 # /companies/foo. This field takes precedence over the
4453 # distributor-assigned company identifier, distributor_company_id.
4454 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
4455 # description of the company and related information. Separate fields are
4456 # provided on the job object for responsibilities,
4457 # qualifications, and other job characteristics. Use of
4458 # these separate job fields is recommended.
4459 #
4460 # This field accepts and sanitizes HTML input, and also accepts
4461 # bold, italic, ordered list, and unordered list markup tags.
4462 #
4463 # The maximum number of allowed characters is 100,000.
4464 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
4465 # application_email_list or application_instruction must be
4466 # specified.
4467 #
4468 # Use this field to specify email address(es) to which resumes or
4469 # applications can be sent.
4470 #
4471 # The maximum number of allowed characters is 255.
4472 &quot;A String&quot;,
4473 ],
4474 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
4475 #
4476 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004477 },
4478 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07004479 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004480 }</pre>
4481</div>
4482
4483<div class="method">
4484 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
4485 <pre>Retrieves the next page of results.
4486
4487Args:
4488 previous_request: The request for the previous page. (required)
4489 previous_response: The response from the request for the previous page. (required)
4490
4491Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -07004492 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004493 page. Returns None if there are no more items in the collection.
4494 </pre>
4495</div>
4496
4497<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -07004498 <code class="details" id="patch">patch(name, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004499 <pre>Updates specified job.
4500
4501Typically, updated contents become visible in search results within 10
4502seconds, but it may take up to 5 minutes.
4503
4504Args:
4505 name: string, Required during job update.
4506
Bu Sun Kim65020912020-05-20 12:08:20 -07004507Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004508of this field in job queries and API calls is preferred over the use of
4509requisition_id since this value is unique. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -07004510 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07004511 The object takes the form of:
4512
4513{ # Input only.
4514 #
4515 # Update job request.
Bu Sun Kim65020912020-05-20 12:08:20 -07004516 &quot;job&quot;: { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot; # Required. The Job to be updated.
4517 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
4518 # entity responsible for the job.
4519 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
4520 # is available. If this field is set, a
4521 # LocationFilter in a search query within the job region
4522 # finds this job if an exact location match is not specified.
4523 # If this field is set, setting job locations
4524 # to the same location level as this field is strongly recommended.
4525 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
4526 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
4527 #
4528 # Output only.
4529 #
4530 # The name of the company listing the job.
4531 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
4532 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
4533 # base compensation entry&#x27;s CompensationEntry.compensation times
4534 # CompensationEntry.expected_units_per_year.
4535 #
4536 # See CompensationEntry for explanation on compensation annualization.
4537 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
4538 # to zero and the currency code is set to match the
4539 # currency code of max_compensation.
4540 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4541 # The value must be between -999,999,999 and +999,999,999 inclusive.
4542 # If `units` is positive, `nanos` must be positive or zero.
4543 # If `units` is zero, `nanos` can be positive, zero, or negative.
4544 # If `units` is negative, `nanos` must be negative or zero.
4545 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4546 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4547 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4548 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4549 },
4550 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
4551 # to a maximal compensation value and the currency code is set to
4552 # match the currency code of
4553 # min_compensation.
4554 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4555 # The value must be between -999,999,999 and +999,999,999 inclusive.
4556 # If `units` is positive, `nanos` must be positive or zero.
4557 # If `units` is zero, `nanos` can be positive, zero, or negative.
4558 # If `units` is negative, `nanos` must be negative or zero.
4559 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4560 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4561 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4562 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4563 },
4564 },
4565 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
4566 #
4567 # Optional.
4568 #
4569 # The amount of compensation or pay for the job.
4570 # As an alternative, compensation_amount_min and
4571 # compensation_amount_max may be used to define a range of
4572 # compensation.
4573 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4574 # The value must be between -999,999,999 and +999,999,999 inclusive.
4575 # If `units` is positive, `nanos` must be positive or zero.
4576 # If `units` is zero, `nanos` can be positive, zero, or negative.
4577 # If `units` is negative, `nanos` must be negative or zero.
4578 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4579 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4580 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4581 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4582 },
4583 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
4584 #
4585 # Optional.
4586 #
4587 # Type of job compensation.
4588 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
4589 #
4590 # Optional.
4591 #
4592 # An upper bound on a range for compensation or pay for the job.
4593 # The currency type is specified in compensation_amount.
4594 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4595 # The value must be between -999,999,999 and +999,999,999 inclusive.
4596 # If `units` is positive, `nanos` must be positive or zero.
4597 # If `units` is zero, `nanos` can be positive, zero, or negative.
4598 # If `units` is negative, `nanos` must be negative or zero.
4599 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4600 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4601 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4602 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4603 },
4604 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
4605 # all compensation entries&#x27; CompensationEntry.compensation times
4606 # CompensationEntry.expected_units_per_year.
4607 #
4608 # See CompensationEntry for explanation on compensation annualization.
4609 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
4610 # to zero and the currency code is set to match the
4611 # currency code of max_compensation.
4612 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4613 # The value must be between -999,999,999 and +999,999,999 inclusive.
4614 # If `units` is positive, `nanos` must be positive or zero.
4615 # If `units` is zero, `nanos` can be positive, zero, or negative.
4616 # If `units` is negative, `nanos` must be negative or zero.
4617 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4618 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4619 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4620 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4621 },
4622 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
4623 # to a maximal compensation value and the currency code is set to
4624 # match the currency code of
4625 # min_compensation.
4626 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4627 # The value must be between -999,999,999 and +999,999,999 inclusive.
4628 # If `units` is positive, `nanos` must be positive or zero.
4629 # If `units` is zero, `nanos` can be positive, zero, or negative.
4630 # If `units` is negative, `nanos` must be negative or zero.
4631 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4632 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4633 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4634 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4635 },
4636 },
4637 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
4638 #
4639 # Optional.
4640 #
4641 # A lower bound on a range for compensation or pay for the job.
4642 # The currency type is specified in compensation_amount.
4643 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4644 # The value must be between -999,999,999 and +999,999,999 inclusive.
4645 # If `units` is positive, `nanos` must be positive or zero.
4646 # If `units` is zero, `nanos` can be positive, zero, or negative.
4647 # If `units` is negative, `nanos` must be negative or zero.
4648 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4649 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4650 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4651 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4652 },
4653 &quot;entries&quot;: [ # Optional. Job compensation information.
4654 #
4655 # At most one entry can be of type
4656 # CompensationInfo.CompensationType.BASE, which is
4657 # referred as ** base compensation entry ** for the job.
4658 { # A compensation entry that represents one component of compensation, such
4659 # as base pay, bonus, or other compensation type.
4660 #
4661 # Annualization: One compensation entry can be annualized if
4662 # - it contains valid amount or range.
4663 # - and its expected_units_per_year is set or can be derived.
4664 # Its annualized range is determined as (amount or range) times
4665 # expected_units_per_year.
4666 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
4667 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
4668 # to zero and the currency code is set to match the
4669 # currency code of max_compensation.
4670 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4671 # The value must be between -999,999,999 and +999,999,999 inclusive.
4672 # If `units` is positive, `nanos` must be positive or zero.
4673 # If `units` is zero, `nanos` can be positive, zero, or negative.
4674 # If `units` is negative, `nanos` must be negative or zero.
4675 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4676 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4677 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4678 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4679 },
4680 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
4681 # to a maximal compensation value and the currency code is set to
4682 # match the currency code of
4683 # min_compensation.
4684 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4685 # The value must be between -999,999,999 and +999,999,999 inclusive.
4686 # If `units` is positive, `nanos` must be positive or zero.
4687 # If `units` is zero, `nanos` can be positive, zero, or negative.
4688 # If `units` is negative, `nanos` must be negative or zero.
4689 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4690 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4691 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4692 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4693 },
4694 },
4695 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
4696 # Job.employment_types is FULLTIME, a default value is inferred
4697 # based on unit. Default values:
4698 # - HOURLY: 2080
4699 # - DAILY: 260
4700 # - WEEKLY: 52
4701 # - MONTHLY: 12
4702 # - ANNUAL: 1
4703 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
4704 # indicate equity terms or provide additional context to an estimated
4705 # bonus.
4706 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
4707 #
4708 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
4709 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
4710 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
4711 # The value must be between -999,999,999 and +999,999,999 inclusive.
4712 # If `units` is positive, `nanos` must be positive or zero.
4713 # If `units` is zero, `nanos` can be positive, zero, or negative.
4714 # If `units` is negative, `nanos` must be negative or zero.
4715 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
4716 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
4717 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
4718 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
4719 },
4720 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
4721 },
4722 ],
4723 },
4724 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
4725 # recommended as an alternative to using the more general description
4726 # field.
4727 #
4728 # This field accepts and sanitizes HTML input, and also accepts
4729 # bold, italic, ordered list, and unordered list markup tags.
4730 #
4731 # The maximum number of allowed characters is 10,000.
4732 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
4733 # experience.
4734 #
4735 # The expiration timestamp of the job. After this timestamp, the
4736 # job is marked as expired, and it no longer appears in search results. The
4737 # expired job can&#x27;t be deleted or listed by the DeleteJob and
4738 # ListJobs APIs, but it can be retrieved with the GetJob API or
4739 # updated with the UpdateJob API. An expired job can be updated and
4740 # opened again by using a future expiration timestamp. Updating an expired
4741 # job fails if there is another existing open job with same
4742 # requisition_id, company_name and language_code.
4743 #
4744 # The expired jobs are retained in our system for 90 days. However, the
4745 # overall expired job count cannot exceed 3 times the maximum of open jobs
4746 # count over the past week, otherwise jobs with earlier expire time are
4747 # cleaned first. Expired jobs are no longer accessible after they are cleaned
4748 # out.
4749 # The format of this field is RFC 3339 date strings. Example:
4750 # 2000-01-01T00:00:00.999999999Z
4751 # See
4752 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
4753 #
4754 # A valid date range is between 1970-01-01T00:00:00.0Z and
4755 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
4756 # time not provided.
4757 #
4758 # If this value is not provided at the time of job creation or is invalid,
4759 # the job posting expires after 30 days from the job&#x27;s creation time. For
4760 # example, if the job was created on 2017/01/01 13:00AM UTC with an
4761 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
4762 #
4763 # If this value is not provided but expiry_date is, expiry_date is
4764 # used.
4765 #
4766 # If this value is not provided on job update, it depends on the field masks
4767 # set by UpdateJobRequest.update_job_fields. If the field masks include
4768 # expiry_time, or the masks are empty meaning that every field is
4769 # updated, the job posting expires after 30 days from the job&#x27;s last
4770 # update time. Otherwise the expiration date isn&#x27;t updated.
4771 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
4772 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
4773 { # Output only.
4774 #
4775 # A resource that represents a location with full geographic
4776 # information.
4777 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
4778 # such as postal delivery and payments addresses. Given a postal address,
4779 # a postal service can deliver items to a premises, P.O. Box, or other
4780 # delivery location.
4781 # Given a postal address, a postal service can deliver items to a premise, P.O.
4782 # Box or similar.
4783 # It is not intended to model geographical locations (roads, towns,
4784 # mountains).
4785 #
4786 # In typical usage an address would be created via user input or from importing
4787 # existing data, depending on the type of process.
4788 #
4789 # Advice on address input / editing:
4790 # - Use an i18n-ready address widget such as
4791 # https://github.com/google/libaddressinput)
4792 # - Users should not be presented with UI elements for input or editing of
4793 # fields outside countries where that field is used.
4794 #
4795 # For more guidance on how to use this schema, please see:
4796 # https://support.google.com/business/answer/6397478
4797 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
4798 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
4799 # is never inferred and it is up to the user to ensure the value is
4800 # correct. See http://cldr.unicode.org/ and
4801 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
4802 # for details. Example: &quot;CH&quot; for Switzerland.
4803 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
4804 #
4805 # Because values in address_lines do not have type information and may
4806 # sometimes contain multiple values in a single field (e.g.
4807 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
4808 # address lines should be &quot;envelope order&quot; for the country/region of the
4809 # address. In places where this can vary (e.g. Japan), address_language is
4810 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
4811 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
4812 # an address can be selected based on the language.
4813 #
4814 # The minimum permitted structural representation of an address consists
4815 # of a region_code with all remaining information placed in the
4816 # address_lines. It would be possible to format such an address very
4817 # approximately without geocoding, but no semantic reasoning could be
4818 # made about any of the address components until it was at least
4819 # partially resolved.
4820 #
4821 # Creating an address only containing a region_code and address_lines, and
4822 # then geocoding is the recommended way to handle completely unstructured
4823 # addresses (as opposed to guessing which parts of the address should be
4824 # localities or administrative areas).
4825 &quot;A String&quot;,
4826 ],
4827 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
4828 # postal codes to be present, but where they are used, they may trigger
4829 # additional validation with other parts of the address (e.g. state/zip
4830 # validation in the U.S.A.).
4831 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
4832 # in most regions. Where it is used, the value is either a string like
4833 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
4834 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
4835 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
4836 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
4837 # known). This is often the UI language of the input form or is expected
4838 # to match one of the languages used in the address&#x27; country/region, or their
4839 # transliterated equivalents.
4840 # This can affect formatting in certain countries, but is not critical
4841 # to the correctness of the data and will never affect any validation or
4842 # other non-formatting related operations.
4843 #
4844 # If this value is not known, it should be omitted (rather than specifying a
4845 # possibly incorrect default).
4846 #
4847 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
4848 &quot;recipients&quot;: [ # Optional. The recipient at the address.
4849 # This field may, under certain circumstances, contain multiline information.
4850 # For example, it might contain &quot;care of&quot; information.
4851 &quot;A String&quot;,
4852 ],
4853 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
4854 # For example, this can be neighborhoods, boroughs, districts.
4855 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
4856 # the latest revision.
4857 #
4858 # All new revisions **must** be backward compatible with old revisions.
4859 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
4860 # addresses of a country or region.
4861 # For example, this can be a state, a province, an oblast, or a prefecture.
4862 # Specifically, for Spain this is the province and not the autonomous
4863 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
4864 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
4865 # in Switzerland this should be left unpopulated.
4866 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
4867 # Examples: US city, IT comune, UK post town.
4868 # In regions of the world where localities are not well defined or do not fit
4869 # into this structure well, leave locality empty and use address_lines.
4870 },
4871 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
4872 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
4873 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
4874 # LocationType#LOCALITY.
4875 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
4876 # location bounding box in which a circle with the specified radius
4877 # centered from LatLng coves the area associated with the job location.
4878 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
4879 # 7885.79 meters.
4880 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
4881 # of doubles representing degrees latitude and degrees longitude. Unless
4882 # specified otherwise, this must conform to the
4883 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
4884 # standard&lt;/a&gt;. Values must be within normalized ranges.
4885 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
4886 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
4887 },
4888 },
4889 ],
4890 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
4891 # position.
4892 #
4893 # The maximum number of allowed characters is 255.
4894 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
4895 #
4896 # Optional.
4897 #
4898 # A map of fields to hold non-filterable custom job attributes, similar to
4899 # filterable_custom_fields. These fields are distinct in that the data
4900 # in these fields are not indexed. Therefore, the client cannot search
4901 # against them, nor can the client use them to list jobs.
4902 #
4903 # The key of the map can be any valid string.
4904 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
4905 &quot;values&quot;: [ # Optional. The values of the custom data.
4906 &quot;A String&quot;,
4907 ],
4908 },
4909 },
4910 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
4911 #
4912 # Optional but strongly recommended to be provided for the best service
4913 # experience.
4914 #
4915 # The expiration date of the job in UTC time. After 12 am on this date, the
4916 # job is marked as expired, and it no longer appears in search results.
4917 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
4918 # ListJobs APIs, but it can be retrieved with the GetJob API or
4919 # updated with the UpdateJob API. An expired job can be updated and
4920 # opened again by using a future expiration date. It can also remain expired.
4921 # Updating an expired job to be open fails if there is another existing open
4922 # job with same requisition_id, company_name and language_code.
4923 #
4924 # The expired jobs are retained in our system for 90 days. However, the
4925 # overall expired job count cannot exceed 3 times the maximum of open jobs
4926 # count over the past week, otherwise jobs with earlier expire time are
4927 # removed first. Expired jobs are no longer accessible after they are cleaned
4928 # out.
4929 #
4930 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
4931 # ignored and treated as expiry date not provided.
4932 #
4933 # If this value is not provided on job creation or is invalid, the job
4934 # posting expires after 30 days from the job&#x27;s creation time. For example, if
4935 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
4936 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
4937 #
4938 # If this value is not provided on job update, it depends on the field masks
4939 # set by UpdateJobRequest.update_job_fields. If the field masks include
4940 # expiry_date, or the masks are empty meaning that every field is
4941 # updated, the job expires after 30 days from the job&#x27;s last update time.
4942 # Otherwise the expiration date isn&#x27;t updated.
4943 # and time zone are either specified elsewhere or are not significant. The date
4944 # is relative to the Proleptic Gregorian Calendar. This can represent:
4945 #
4946 # * A full date, with non-zero year, month and day values
4947 # * A month and day value, with a zero year, e.g. an anniversary
4948 # * A year on its own, with zero month and day values
4949 # * A year and month value, with a zero day, e.g. a credit card expiration date
4950 #
4951 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4952 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4953 # if specifying a year by itself or a year and month where the day is not
4954 # significant.
4955 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4956 # a year.
4957 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4958 # month and day.
4959 },
4960 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
4961 # is used for contracting engagements.
4962 # Dates prior to 1970/1/1 and invalid date formats are ignored.
4963 # and time zone are either specified elsewhere or are not significant. The date
4964 # is relative to the Proleptic Gregorian Calendar. This can represent:
4965 #
4966 # * A full date, with non-zero year, month and day values
4967 # * A month and day value, with a zero year, e.g. an anniversary
4968 # * A year on its own, with zero month and day values
4969 # * A year and month value, with a zero day, e.g. a credit card expiration date
4970 #
4971 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4972 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4973 # if specifying a year by itself or a year and month where the day is not
4974 # significant.
4975 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4976 # a year.
4977 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4978 # month and day.
4979 },
4980 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
4981 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
4982 &quot;A String&quot;,
4983 ],
4984 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
4985 # attributes that are not covered by the provided structured fields.
4986 #
4987 # This field is a more general combination of the deprecated id-based
4988 # filterable_custom_fields and string-based
4989 # non_filterable_custom_fields.
4990 #
4991 # The keys of the map are strings up to 64 bytes and must match the
4992 # pattern: a-zA-Z*.
4993 #
4994 # At most 100 filterable and at most 100 unfilterable keys are supported.
4995 # For filterable `string_values`, across all keys at most 200 values are
4996 # allowed, with each string no more than 255 characters. For unfilterable
4997 # `string_values`, the maximum total size of `string_values` across all keys
4998 # is 50KB.
4999 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
5000 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
5001 # If false, values are not searchable.
5002 #
5003 # Default is false.
5004 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
5005 # be specified.
5006 #
5007 # This field is used to perform number range search.
5008 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
5009 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
5010 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
5011 # be specified.
5012 #
5013 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
5014 # `CASE_INSENSITIVE_MATCH`) search.
5015 # For filterable `string_values`, a maximum total number of 200 values
5016 # is allowed, with each `string_value` has a byte size of no more than
5017 # 255B. For unfilterable `string_values`, the maximum total byte size of
5018 # unfilterable `string_values` is 50KB.
5019 #
5020 # Empty strings are not allowed.
5021 &quot;values&quot;: [ # Required. String values.
5022 &quot;A String&quot;,
5023 ],
5024 },
5025 },
5026 },
5027 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
5028 #
5029 # Optional.
5030 #
5031 # A map of fields to hold filterable custom job attributes not captured by
5032 # the standard fields such as job_title, company_name, or
5033 # level. These custom fields store arbitrary
5034 # string values, and can be used for purposes not covered by
5035 # the structured fields. For the best search experience, use of the
5036 # structured rather than custom fields is recommended.
5037 #
5038 # Data stored in these custom fields fields are indexed and
5039 # searched against by keyword searches (see
5040 # SearchJobsRequest.custom_field_filters][]).
5041 #
5042 # The map key must be a number between 1-20. If an invalid key is
5043 # provided on job create or update, an error is returned.
5044 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
5045 &quot;values&quot;: [ # Optional. The values of the custom data.
5046 &quot;A String&quot;,
5047 ],
5048 },
5049 },
5050 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
5051 # any requirements for fluency that are associated with the job.
5052 #
5053 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
5054 # For more information, see
5055 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
5056 # class=&quot;external&quot; target=&quot;_blank&quot; }.
5057 #
5058 # If this field is unspecified and Job.description is present, detected
5059 # language code based on Job.description is assigned, otherwise
5060 # defaults to &#x27;en_US&#x27;.
5061 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
5062 # Defaults to JobVisibility.PRIVATE if not specified.
5063 # Currently only JobVisibility.PRIVATE is supported.
5064 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
5065 #
5066 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
5067 # of this field in job queries and API calls is preferred over the use of
5068 # requisition_id since this value is unique.
5069 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
5070 # provided.
5071 #
5072 # A unique company identifier used by job distributors to identify an
5073 # employer&#x27;s company entity. company_name takes precedence over
5074 # this field, and is the recommended field to use to identify companies.
5075 #
5076 # The maximum number of allowed characters is 255.
5077 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
5078 # The value determines the sort order of the jobs returned when searching for
5079 # jobs using the featured jobs search call, with higher promotional values
5080 # being returned first and ties being resolved by relevance sort. Only the
5081 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
5082 #
5083 # Default value is 0, and negative values are treated as 0.
5084 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
5085 # value is the time the request arrives at the server.
5086 # and time zone are either specified elsewhere or are not significant. The date
5087 # is relative to the Proleptic Gregorian Calendar. This can represent:
5088 #
5089 # * A full date, with non-zero year, month and day values
5090 # * A month and day value, with a zero year, e.g. an anniversary
5091 # * A year on its own, with zero month and day values
5092 # * A year and month value, with a zero day, e.g. a credit card expiration date
5093 #
5094 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
5095 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
5096 # if specifying a year by itself or a year and month where the day is not
5097 # significant.
5098 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
5099 # a year.
5100 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5101 # month and day.
5102 },
5103 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
5104 # application_email_list or application_instruction must be
5105 # specified.
5106 #
5107 # Use this URL field to direct an applicant to a website, for example to
5108 # link to an online application form.
5109 #
5110 # The maximum number of allowed characters is 2,000.
5111 &quot;A String&quot;,
5112 ],
5113 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
5114 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
5115 # client to identify a job. This field is intended to be used by clients
5116 # for client identification and tracking of listings. A job is not allowed
5117 # to be created if there is another job with the same requisition_id,
5118 # company_name and language_code.
5119 #
5120 # The maximum number of allowed characters is 255.
5121 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
5122 # job. The use of this field is recommended
5123 # as an alternative to using the more general description field.
5124 #
5125 # This field accepts and sanitizes HTML input, and also accepts
5126 # bold, italic, ordered list, and unordered list markup tags.
5127 #
5128 # The maximum number of allowed characters is 10,000.
5129 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
5130 # is used for contracting engagements.
5131 # Dates prior to 1970/1/1 and invalid date formats are ignored.
5132 # and time zone are either specified elsewhere or are not significant. The date
5133 # is relative to the Proleptic Gregorian Calendar. This can represent:
5134 #
5135 # * A full date, with non-zero year, month and day values
5136 # * A month and day value, with a zero year, e.g. an anniversary
5137 # * A year on its own, with zero month and day values
5138 # * A year and month value, with a zero day, e.g. a credit card expiration date
5139 #
5140 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
5141 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
5142 # if specifying a year by itself or a year and month where the day is not
5143 # significant.
5144 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
5145 # a year.
5146 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5147 # month and day.
5148 },
5149 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
5150 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
5151 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
5152 # application_email_list or application_instruction must be
5153 # specified.
5154 #
5155 # Use this field to provide instructions, such as &quot;Mail your application
5156 # to ...&quot;, that a candidate can follow to apply for the job.
5157 #
5158 # This field accepts and sanitizes HTML input, and also accepts
5159 # bold, italic, ordered list, and unordered list markup tags.
5160 #
5161 # The maximum number of allowed characters is 3,000.
5162 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
5163 &quot;A String&quot;,
5164 ],
5165 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
5166 # incentives associated with the job not including salary or pay.
5167 #
5168 # The maximum number of allowed characters is 10,000.
5169 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
5170 # full time or
5171 # part time.
5172 &quot;A String&quot;,
5173 ],
5174 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
5175 #
5176 # Location(s) where the emploeyer is looking to hire for this job posting.
5177 #
5178 # Specifying the full street address(es) of the hiring location enables
5179 # better API results, especially job searches by commute time.
5180 #
5181 # At most 50 locations are allowed for best search performance. If a job has
5182 # more locations, it is suggested to split it into multiple jobs with unique
5183 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
5184 # multiple jobs with the same requisition_id, company_name and
5185 # language_code are not allowed. If the original requisition_id must
5186 # be preserved, a custom field should be used for storage. It is also
5187 # suggested to group the locations that close to each other in the same job
5188 # for better search experience.
5189 #
5190 # The maximum number of allowed characters is 500.
5191 &quot;A String&quot;,
5192 ],
5193 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
5194 #
5195 # Optional.
5196 #
5197 # Job compensation information.
5198 #
5199 # This field replaces compensation_info. Only
5200 # CompensationInfo.entries or extended_compensation_info can be set,
5201 # otherwise an exception is thrown.
5202 #
5203 # Describes job compensation.
5204 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
5205 # currency code.
5206 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
5207 #
5208 # Compensation range.
5209 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
5210 #
5211 # Decimal number.
5212 &quot;micros&quot;: 42, # Micro (10^-6) units.
5213 # The value must be between -999,999 and +999,999 inclusive.
5214 # If `units` is positive, `micros` must be positive or zero.
5215 # If `units` is zero, `micros` can be positive, zero, or negative.
5216 # If `units` is negative, `micros` must be negative or zero.
5217 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5218 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5219 },
5220 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
5221 #
5222 # Decimal number.
5223 &quot;micros&quot;: 42, # Micro (10^-6) units.
5224 # The value must be between -999,999 and +999,999 inclusive.
5225 # If `units` is positive, `micros` must be positive or zero.
5226 # If `units` is zero, `micros` can be positive, zero, or negative.
5227 # If `units` is negative, `micros` must be negative or zero.
5228 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5229 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5230 },
5231 },
5232 &quot;entries&quot;: [ # Optional. Job compensation information.
5233 #
5234 # At most one entry can be of type
5235 # ExtendedCompensationInfo.CompensationType.BASE, which is
5236 # referred as ** base compensation entry ** for the job.
5237 { # Deprecated. See CompensationInfo.
5238 #
5239 # A compensation entry that represents one component of compensation, such
5240 # as base pay, bonus, or other compensation type.
5241 #
5242 # Annualization: One compensation entry can be annualized if
5243 # - it contains valid amount or range.
5244 # - and its expected_units_per_year is set or can be derived.
5245 # Its annualized range is determined as (amount or range) times
5246 # expected_units_per_year.
5247 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
5248 #
5249 # Compensation range.
5250 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
5251 #
5252 # Decimal number.
5253 &quot;micros&quot;: 42, # Micro (10^-6) units.
5254 # The value must be between -999,999 and +999,999 inclusive.
5255 # If `units` is positive, `micros` must be positive or zero.
5256 # If `units` is zero, `micros` can be positive, zero, or negative.
5257 # If `units` is negative, `micros` must be negative or zero.
5258 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5259 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5260 },
5261 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
5262 #
5263 # Decimal number.
5264 &quot;micros&quot;: 42, # Micro (10^-6) units.
5265 # The value must be between -999,999 and +999,999 inclusive.
5266 # If `units` is positive, `micros` must be positive or zero.
5267 # If `units` is zero, `micros` can be positive, zero, or negative.
5268 # If `units` is negative, `micros` must be negative or zero.
5269 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5270 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5271 },
5272 },
5273 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
5274 # Job.employment_types is FULLTIME, a default value is inferred
5275 # based on unit. Default values:
5276 # - HOURLY: 2080
5277 # - DAILY: 260
5278 # - WEEKLY: 52
5279 # - MONTHLY: 12
5280 # - ANNUAL: 1
5281 #
5282 # Decimal number.
5283 &quot;micros&quot;: 42, # Micro (10^-6) units.
5284 # The value must be between -999,999 and +999,999 inclusive.
5285 # If `units` is positive, `micros` must be positive or zero.
5286 # If `units` is zero, `micros` can be positive, zero, or negative.
5287 # If `units` is negative, `micros` must be negative or zero.
5288 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5289 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5290 },
5291 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
5292 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
5293 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
5294 #
5295 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
5296 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
5297 #
5298 # Decimal number.
5299 &quot;micros&quot;: 42, # Micro (10^-6) units.
5300 # The value must be between -999,999 and +999,999 inclusive.
5301 # If `units` is positive, `micros` must be positive or zero.
5302 # If `units` is zero, `micros` can be positive, zero, or negative.
5303 # If `units` is negative, `micros` must be negative or zero.
5304 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5305 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5306 },
5307 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
5308 },
5309 ],
5310 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
5311 # the job&#x27;s all CompensationEntry cannot be annualized.
5312 # See CompensationEntry for explanation on annualization and base
5313 # compensation entry.
5314 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
5315 #
5316 # Compensation range.
5317 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
5318 #
5319 # Decimal number.
5320 &quot;micros&quot;: 42, # Micro (10^-6) units.
5321 # The value must be between -999,999 and +999,999 inclusive.
5322 # If `units` is positive, `micros` must be positive or zero.
5323 # If `units` is zero, `micros` can be positive, zero, or negative.
5324 # If `units` is negative, `micros` must be negative or zero.
5325 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5326 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5327 },
5328 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
5329 #
5330 # Decimal number.
5331 &quot;micros&quot;: 42, # Micro (10^-6) units.
5332 # The value must be between -999,999 and +999,999 inclusive.
5333 # If `units` is positive, `micros` must be positive or zero.
5334 # If `units` is zero, `micros` can be positive, zero, or negative.
5335 # If `units` is negative, `micros` must be negative or zero.
5336 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
5337 &quot;units&quot;: &quot;A String&quot;, # Whole units.
5338 },
5339 },
5340 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
5341 # the job&#x27;s base compensation entry cannot be annualized.
5342 # See CompensationEntry for explanation on annualization and base
5343 # compensation entry.
5344 },
5345 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
5346 # provided.
5347 #
5348 # The resource name of the company listing the job, such as
5349 # /companies/foo. This field takes precedence over the
5350 # distributor-assigned company identifier, distributor_company_id.
5351 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
5352 # description of the company and related information. Separate fields are
5353 # provided on the job object for responsibilities,
5354 # qualifications, and other job characteristics. Use of
5355 # these separate job fields is recommended.
5356 #
5357 # This field accepts and sanitizes HTML input, and also accepts
5358 # bold, italic, ordered list, and unordered list markup tags.
5359 #
5360 # The maximum number of allowed characters is 100,000.
5361 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
5362 # application_email_list or application_instruction must be
5363 # specified.
5364 #
5365 # Use this field to specify email address(es) to which resumes or
5366 # applications can be sent.
5367 #
5368 # The maximum number of allowed characters is 255.
5369 &quot;A String&quot;,
5370 ],
5371 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
5372 #
5373 # The maximum number of allowed characters is 500.
5374 },
5375 &quot;processingOptions&quot;: { # Input only. # Optional. Options for job processing.
5376 #
5377 # UpdateJobRequest.disable_street_address_resolution is ignored if this
5378 # flag is set.
5379 #
5380 # Options for job processing.
5381 &quot;disableStreetAddressResolution&quot;: True or False, # Optional. If set to `true`, the service does not attempt to resolve a
5382 # more precise address for the job.
5383 &quot;htmlSanitization&quot;: &quot;A String&quot;, # Optional. Option for job HTML content sanitization. Applied fields are:
5384 #
5385 # * description
5386 # * applicationInstruction
5387 # * incentives
5388 # * qualifications
5389 # * responsibilities
5390 #
5391 # HTML tags in these fields may be stripped if sanitiazation is not disabled.
5392 #
5393 # Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
5394 },
5395 &quot;disableStreetAddressResolution&quot;: True or False, # Deprecated. Please use processing_options. This flag is ignored if
5396 # processing_options is set.
5397 #
5398 # Optional.
5399 #
5400 # If set to `true`, the service does not attempt resolve a more precise
5401 # address for the job.
5402 &quot;updateJobFields&quot;: &quot;A String&quot;, # Optional but strongly recommended to be provided for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005403 # experience.
5404 #
5405 # If update_job_fields is provided, only the specified fields in
5406 # job are updated. Otherwise all the fields are updated.
5407 #
5408 # A field mask to restrict the fields that are updated. Valid values are:
5409 #
5410 # * jobTitle
5411 # * employmentTypes
5412 # * description
5413 # * applicationUrls
5414 # * applicationEmailList
5415 # * applicationInstruction
5416 # * responsibilities
5417 # * qualifications
5418 # * educationLevels
5419 # * level
5420 # * department
5421 # * startDate
5422 # * endDate
5423 # * compensationInfo
5424 # * incentives
5425 # * languageCode
5426 # * benefits
5427 # * expireTime
5428 # * customAttributes
5429 # * visibility
5430 # * publishDate
5431 # * promotionValue
5432 # * locations
5433 # * region
5434 # * expiryDate (deprecated)
5435 # * filterableCustomFields (deprecated)
5436 # * unindexedCustomFields (deprecated)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005437 }
5438
5439 x__xgafv: string, V1 error format.
5440 Allowed values
5441 1 - v1 error format
5442 2 - v2 error format
5443
5444Returns:
5445 An object of the form:
5446
Bu Sun Kim65020912020-05-20 12:08:20 -07005447 { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot;
5448 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005449 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07005450 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
5451 # is available. If this field is set, a
5452 # LocationFilter in a search query within the job region
5453 # finds this job if an exact location match is not specified.
5454 # If this field is set, setting job locations
5455 # to the same location level as this field is strongly recommended.
5456 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
5457 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005458 #
Bu Sun Kim65020912020-05-20 12:08:20 -07005459 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005460 #
Bu Sun Kim65020912020-05-20 12:08:20 -07005461 # The name of the company listing the job.
5462 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
5463 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
5464 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005465 # CompensationEntry.expected_units_per_year.
5466 #
5467 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07005468 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
5469 # to zero and the currency code is set to match the
5470 # currency code of max_compensation.
5471 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5472 # The value must be between -999,999,999 and +999,999,999 inclusive.
5473 # If `units` is positive, `nanos` must be positive or zero.
5474 # If `units` is zero, `nanos` can be positive, zero, or negative.
5475 # If `units` is negative, `nanos` must be negative or zero.
5476 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5477 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5478 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5479 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5480 },
5481 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005482 # to a maximal compensation value and the currency code is set to
5483 # match the currency code of
5484 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07005485 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005486 # The value must be between -999,999,999 and +999,999,999 inclusive.
5487 # If `units` is positive, `nanos` must be positive or zero.
5488 # If `units` is zero, `nanos` can be positive, zero, or negative.
5489 # If `units` is negative, `nanos` must be negative or zero.
5490 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07005491 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5492 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5493 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005494 },
5495 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005496 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005497 #
5498 # Optional.
5499 #
5500 # The amount of compensation or pay for the job.
5501 # As an alternative, compensation_amount_min and
5502 # compensation_amount_max may be used to define a range of
5503 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07005504 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005505 # The value must be between -999,999,999 and +999,999,999 inclusive.
5506 # If `units` is positive, `nanos` must be positive or zero.
5507 # If `units` is zero, `nanos` can be positive, zero, or negative.
5508 # If `units` is negative, `nanos` must be negative or zero.
5509 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07005510 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5511 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5512 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005513 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005514 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
5515 #
5516 # Optional.
5517 #
5518 # Type of job compensation.
5519 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
5520 #
5521 # Optional.
5522 #
5523 # An upper bound on a range for compensation or pay for the job.
5524 # The currency type is specified in compensation_amount.
5525 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5526 # The value must be between -999,999,999 and +999,999,999 inclusive.
5527 # If `units` is positive, `nanos` must be positive or zero.
5528 # If `units` is zero, `nanos` can be positive, zero, or negative.
5529 # If `units` is negative, `nanos` must be negative or zero.
5530 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5531 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5532 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5533 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5534 },
5535 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
5536 # all compensation entries&#x27; CompensationEntry.compensation times
5537 # CompensationEntry.expected_units_per_year.
5538 #
5539 # See CompensationEntry for explanation on compensation annualization.
5540 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
5541 # to zero and the currency code is set to match the
5542 # currency code of max_compensation.
5543 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5544 # The value must be between -999,999,999 and +999,999,999 inclusive.
5545 # If `units` is positive, `nanos` must be positive or zero.
5546 # If `units` is zero, `nanos` can be positive, zero, or negative.
5547 # If `units` is negative, `nanos` must be negative or zero.
5548 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5549 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5550 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5551 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5552 },
5553 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
5554 # to a maximal compensation value and the currency code is set to
5555 # match the currency code of
5556 # min_compensation.
5557 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5558 # The value must be between -999,999,999 and +999,999,999 inclusive.
5559 # If `units` is positive, `nanos` must be positive or zero.
5560 # If `units` is zero, `nanos` can be positive, zero, or negative.
5561 # If `units` is negative, `nanos` must be negative or zero.
5562 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5563 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5564 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5565 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5566 },
5567 },
5568 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
5569 #
5570 # Optional.
5571 #
5572 # A lower bound on a range for compensation or pay for the job.
5573 # The currency type is specified in compensation_amount.
5574 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5575 # The value must be between -999,999,999 and +999,999,999 inclusive.
5576 # If `units` is positive, `nanos` must be positive or zero.
5577 # If `units` is zero, `nanos` can be positive, zero, or negative.
5578 # If `units` is negative, `nanos` must be negative or zero.
5579 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5580 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5581 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5582 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5583 },
5584 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005585 #
5586 # At most one entry can be of type
5587 # CompensationInfo.CompensationType.BASE, which is
5588 # referred as ** base compensation entry ** for the job.
5589 { # A compensation entry that represents one component of compensation, such
5590 # as base pay, bonus, or other compensation type.
5591 #
5592 # Annualization: One compensation entry can be annualized if
5593 # - it contains valid amount or range.
5594 # - and its expected_units_per_year is set or can be derived.
5595 # Its annualized range is determined as (amount or range) times
5596 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07005597 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
5598 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
5599 # to zero and the currency code is set to match the
5600 # currency code of max_compensation.
5601 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
5602 # The value must be between -999,999,999 and +999,999,999 inclusive.
5603 # If `units` is positive, `nanos` must be positive or zero.
5604 # If `units` is zero, `nanos` can be positive, zero, or negative.
5605 # If `units` is negative, `nanos` must be negative or zero.
5606 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
5607 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5608 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5609 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
5610 },
5611 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005612 # to a maximal compensation value and the currency code is set to
5613 # match the currency code of
5614 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07005615 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005616 # The value must be between -999,999,999 and +999,999,999 inclusive.
5617 # If `units` is positive, `nanos` must be positive or zero.
5618 # If `units` is zero, `nanos` can be positive, zero, or negative.
5619 # If `units` is negative, `nanos` must be negative or zero.
5620 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07005621 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5622 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5623 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005624 },
5625 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005626 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005627 # Job.employment_types is FULLTIME, a default value is inferred
5628 # based on unit. Default values:
5629 # - HOURLY: 2080
5630 # - DAILY: 260
5631 # - WEEKLY: 52
5632 # - MONTHLY: 12
5633 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07005634 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
5635 # indicate equity terms or provide additional context to an estimated
5636 # bonus.
5637 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
5638 #
5639 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
5640 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
5641 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005642 # The value must be between -999,999,999 and +999,999,999 inclusive.
5643 # If `units` is positive, `nanos` must be positive or zero.
5644 # If `units` is zero, `nanos` can be positive, zero, or negative.
5645 # If `units` is negative, `nanos` must be negative or zero.
5646 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07005647 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
5648 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
5649 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005650 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005651 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005652 },
5653 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005654 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005655 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
5656 # recommended as an alternative to using the more general description
5657 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005658 #
5659 # This field accepts and sanitizes HTML input, and also accepts
5660 # bold, italic, ordered list, and unordered list markup tags.
5661 #
5662 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07005663 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005664 # experience.
5665 #
5666 # The expiration timestamp of the job. After this timestamp, the
5667 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07005668 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005669 # ListJobs APIs, but it can be retrieved with the GetJob API or
5670 # updated with the UpdateJob API. An expired job can be updated and
5671 # opened again by using a future expiration timestamp. Updating an expired
5672 # job fails if there is another existing open job with same
5673 # requisition_id, company_name and language_code.
5674 #
5675 # The expired jobs are retained in our system for 90 days. However, the
5676 # overall expired job count cannot exceed 3 times the maximum of open jobs
5677 # count over the past week, otherwise jobs with earlier expire time are
5678 # cleaned first. Expired jobs are no longer accessible after they are cleaned
5679 # out.
5680 # The format of this field is RFC 3339 date strings. Example:
5681 # 2000-01-01T00:00:00.999999999Z
5682 # See
5683 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
5684 #
5685 # A valid date range is between 1970-01-01T00:00:00.0Z and
5686 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
5687 # time not provided.
5688 #
5689 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07005690 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005691 # example, if the job was created on 2017/01/01 13:00AM UTC with an
5692 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
5693 #
5694 # If this value is not provided but expiry_date is, expiry_date is
5695 # used.
5696 #
5697 # If this value is not provided on job update, it depends on the field masks
5698 # set by UpdateJobRequest.update_job_fields. If the field masks include
5699 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07005700 # updated, the job posting expires after 30 days from the job&#x27;s last
5701 # update time. Otherwise the expiration date isn&#x27;t updated.
5702 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
5703 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
5704 { # Output only.
5705 #
5706 # A resource that represents a location with full geographic
5707 # information.
5708 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
5709 # such as postal delivery and payments addresses. Given a postal address,
5710 # a postal service can deliver items to a premises, P.O. Box, or other
5711 # delivery location.
5712 # Given a postal address, a postal service can deliver items to a premise, P.O.
5713 # Box or similar.
5714 # It is not intended to model geographical locations (roads, towns,
5715 # mountains).
5716 #
5717 # In typical usage an address would be created via user input or from importing
5718 # existing data, depending on the type of process.
5719 #
5720 # Advice on address input / editing:
5721 # - Use an i18n-ready address widget such as
5722 # https://github.com/google/libaddressinput)
5723 # - Users should not be presented with UI elements for input or editing of
5724 # fields outside countries where that field is used.
5725 #
5726 # For more guidance on how to use this schema, please see:
5727 # https://support.google.com/business/answer/6397478
5728 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
5729 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
5730 # is never inferred and it is up to the user to ensure the value is
5731 # correct. See http://cldr.unicode.org/ and
5732 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
5733 # for details. Example: &quot;CH&quot; for Switzerland.
5734 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
5735 #
5736 # Because values in address_lines do not have type information and may
5737 # sometimes contain multiple values in a single field (e.g.
5738 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
5739 # address lines should be &quot;envelope order&quot; for the country/region of the
5740 # address. In places where this can vary (e.g. Japan), address_language is
5741 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
5742 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
5743 # an address can be selected based on the language.
5744 #
5745 # The minimum permitted structural representation of an address consists
5746 # of a region_code with all remaining information placed in the
5747 # address_lines. It would be possible to format such an address very
5748 # approximately without geocoding, but no semantic reasoning could be
5749 # made about any of the address components until it was at least
5750 # partially resolved.
5751 #
5752 # Creating an address only containing a region_code and address_lines, and
5753 # then geocoding is the recommended way to handle completely unstructured
5754 # addresses (as opposed to guessing which parts of the address should be
5755 # localities or administrative areas).
5756 &quot;A String&quot;,
5757 ],
5758 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
5759 # postal codes to be present, but where they are used, they may trigger
5760 # additional validation with other parts of the address (e.g. state/zip
5761 # validation in the U.S.A.).
5762 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
5763 # in most regions. Where it is used, the value is either a string like
5764 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
5765 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
5766 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
5767 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
5768 # known). This is often the UI language of the input form or is expected
5769 # to match one of the languages used in the address&#x27; country/region, or their
5770 # transliterated equivalents.
5771 # This can affect formatting in certain countries, but is not critical
5772 # to the correctness of the data and will never affect any validation or
5773 # other non-formatting related operations.
5774 #
5775 # If this value is not known, it should be omitted (rather than specifying a
5776 # possibly incorrect default).
5777 #
5778 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
5779 &quot;recipients&quot;: [ # Optional. The recipient at the address.
5780 # This field may, under certain circumstances, contain multiline information.
5781 # For example, it might contain &quot;care of&quot; information.
5782 &quot;A String&quot;,
5783 ],
5784 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
5785 # For example, this can be neighborhoods, boroughs, districts.
5786 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
5787 # the latest revision.
5788 #
5789 # All new revisions **must** be backward compatible with old revisions.
5790 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
5791 # addresses of a country or region.
5792 # For example, this can be a state, a province, an oblast, or a prefecture.
5793 # Specifically, for Spain this is the province and not the autonomous
5794 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
5795 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
5796 # in Switzerland this should be left unpopulated.
5797 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
5798 # Examples: US city, IT comune, UK post town.
5799 # In regions of the world where localities are not well defined or do not fit
5800 # into this structure well, leave locality empty and use address_lines.
5801 },
5802 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
5803 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
5804 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
5805 # LocationType#LOCALITY.
5806 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
5807 # location bounding box in which a circle with the specified radius
5808 # centered from LatLng coves the area associated with the job location.
5809 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
5810 # 7885.79 meters.
5811 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
5812 # of doubles representing degrees latitude and degrees longitude. Unless
5813 # specified otherwise, this must conform to the
5814 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
5815 # standard&lt;/a&gt;. Values must be within normalized ranges.
5816 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
5817 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
5818 },
5819 },
5820 ],
5821 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
5822 # position.
5823 #
5824 # The maximum number of allowed characters is 255.
5825 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
5826 #
5827 # Optional.
5828 #
5829 # A map of fields to hold non-filterable custom job attributes, similar to
5830 # filterable_custom_fields. These fields are distinct in that the data
5831 # in these fields are not indexed. Therefore, the client cannot search
5832 # against them, nor can the client use them to list jobs.
5833 #
5834 # The key of the map can be any valid string.
5835 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
5836 &quot;values&quot;: [ # Optional. The values of the custom data.
5837 &quot;A String&quot;,
5838 ],
5839 },
5840 },
5841 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
5842 #
5843 # Optional but strongly recommended to be provided for the best service
5844 # experience.
5845 #
5846 # The expiration date of the job in UTC time. After 12 am on this date, the
5847 # job is marked as expired, and it no longer appears in search results.
5848 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
5849 # ListJobs APIs, but it can be retrieved with the GetJob API or
5850 # updated with the UpdateJob API. An expired job can be updated and
5851 # opened again by using a future expiration date. It can also remain expired.
5852 # Updating an expired job to be open fails if there is another existing open
5853 # job with same requisition_id, company_name and language_code.
5854 #
5855 # The expired jobs are retained in our system for 90 days. However, the
5856 # overall expired job count cannot exceed 3 times the maximum of open jobs
5857 # count over the past week, otherwise jobs with earlier expire time are
5858 # removed first. Expired jobs are no longer accessible after they are cleaned
5859 # out.
5860 #
5861 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
5862 # ignored and treated as expiry date not provided.
5863 #
5864 # If this value is not provided on job creation or is invalid, the job
5865 # posting expires after 30 days from the job&#x27;s creation time. For example, if
5866 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
5867 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
5868 #
5869 # If this value is not provided on job update, it depends on the field masks
5870 # set by UpdateJobRequest.update_job_fields. If the field masks include
5871 # expiry_date, or the masks are empty meaning that every field is
5872 # updated, the job expires after 30 days from the job&#x27;s last update time.
5873 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005874 # and time zone are either specified elsewhere or are not significant. The date
5875 # is relative to the Proleptic Gregorian Calendar. This can represent:
5876 #
5877 # * A full date, with non-zero year, month and day values
5878 # * A month and day value, with a zero year, e.g. an anniversary
5879 # * A year on its own, with zero month and day values
5880 # * A year and month value, with a zero day, e.g. a credit card expiration date
5881 #
5882 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07005883 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005884 # if specifying a year by itself or a year and month where the day is not
5885 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07005886 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005887 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07005888 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5889 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005890 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005891 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
5892 # is used for contracting engagements.
5893 # Dates prior to 1970/1/1 and invalid date formats are ignored.
5894 # and time zone are either specified elsewhere or are not significant. The date
5895 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005896 #
Bu Sun Kim65020912020-05-20 12:08:20 -07005897 # * A full date, with non-zero year, month and day values
5898 # * A month and day value, with a zero year, e.g. an anniversary
5899 # * A year on its own, with zero month and day values
5900 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005901 #
Bu Sun Kim65020912020-05-20 12:08:20 -07005902 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
5903 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
5904 # if specifying a year by itself or a year and month where the day is not
5905 # significant.
5906 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
5907 # a year.
5908 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5909 # month and day.
5910 },
5911 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
5912 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
5913 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005914 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07005915 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005916 # attributes that are not covered by the provided structured fields.
5917 #
5918 # This field is a more general combination of the deprecated id-based
5919 # filterable_custom_fields and string-based
5920 # non_filterable_custom_fields.
5921 #
5922 # The keys of the map are strings up to 64 bytes and must match the
5923 # pattern: a-zA-Z*.
5924 #
5925 # At most 100 filterable and at most 100 unfilterable keys are supported.
5926 # For filterable `string_values`, across all keys at most 200 values are
5927 # allowed, with each string no more than 255 characters. For unfilterable
5928 # `string_values`, the maximum total size of `string_values` across all keys
5929 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07005930 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
5931 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005932 # If false, values are not searchable.
5933 #
5934 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07005935 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
5936 # be specified.
5937 #
5938 # This field is used to perform number range search.
5939 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
5940 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
5941 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005942 # be specified.
5943 #
5944 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
5945 # `CASE_INSENSITIVE_MATCH`) search.
5946 # For filterable `string_values`, a maximum total number of 200 values
5947 # is allowed, with each `string_value` has a byte size of no more than
5948 # 255B. For unfilterable `string_values`, the maximum total byte size of
5949 # unfilterable `string_values` is 50KB.
5950 #
5951 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07005952 &quot;values&quot;: [ # Required. String values.
5953 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005954 ],
5955 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005956 },
5957 },
Bu Sun Kim65020912020-05-20 12:08:20 -07005958 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
5959 #
5960 # Optional.
5961 #
5962 # A map of fields to hold filterable custom job attributes not captured by
5963 # the standard fields such as job_title, company_name, or
5964 # level. These custom fields store arbitrary
5965 # string values, and can be used for purposes not covered by
5966 # the structured fields. For the best search experience, use of the
5967 # structured rather than custom fields is recommended.
5968 #
5969 # Data stored in these custom fields fields are indexed and
5970 # searched against by keyword searches (see
5971 # SearchJobsRequest.custom_field_filters][]).
5972 #
5973 # The map key must be a number between 1-20. If an invalid key is
5974 # provided on job create or update, an error is returned.
5975 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
5976 &quot;values&quot;: [ # Optional. The values of the custom data.
5977 &quot;A String&quot;,
5978 ],
5979 },
5980 },
5981 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
5982 # any requirements for fluency that are associated with the job.
5983 #
5984 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
5985 # For more information, see
5986 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
5987 # class=&quot;external&quot; target=&quot;_blank&quot; }.
5988 #
5989 # If this field is unspecified and Job.description is present, detected
5990 # language code based on Job.description is assigned, otherwise
5991 # defaults to &#x27;en_US&#x27;.
5992 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
5993 # Defaults to JobVisibility.PRIVATE if not specified.
5994 # Currently only JobVisibility.PRIVATE is supported.
5995 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
5996 #
5997 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
5998 # of this field in job queries and API calls is preferred over the use of
5999 # requisition_id since this value is unique.
6000 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006001 # provided.
6002 #
6003 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07006004 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006005 # this field, and is the recommended field to use to identify companies.
6006 #
6007 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07006008 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
6009 # The value determines the sort order of the jobs returned when searching for
6010 # jobs using the featured jobs search call, with higher promotional values
6011 # being returned first and ties being resolved by relevance sort. Only the
6012 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
6013 #
6014 # Default value is 0, and negative values are treated as 0.
6015 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
6016 # value is the time the request arrives at the server.
6017 # and time zone are either specified elsewhere or are not significant. The date
6018 # is relative to the Proleptic Gregorian Calendar. This can represent:
6019 #
6020 # * A full date, with non-zero year, month and day values
6021 # * A month and day value, with a zero year, e.g. an anniversary
6022 # * A year on its own, with zero month and day values
6023 # * A year and month value, with a zero day, e.g. a credit card expiration date
6024 #
6025 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6026 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6027 # if specifying a year by itself or a year and month where the day is not
6028 # significant.
6029 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6030 # a year.
6031 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6032 # month and day.
6033 },
6034 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
6035 # application_email_list or application_instruction must be
6036 # specified.
6037 #
6038 # Use this URL field to direct an applicant to a website, for example to
6039 # link to an online application form.
6040 #
6041 # The maximum number of allowed characters is 2,000.
6042 &quot;A String&quot;,
6043 ],
6044 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
6045 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
6046 # client to identify a job. This field is intended to be used by clients
6047 # for client identification and tracking of listings. A job is not allowed
6048 # to be created if there is another job with the same requisition_id,
6049 # company_name and language_code.
6050 #
6051 # The maximum number of allowed characters is 255.
6052 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
6053 # job. The use of this field is recommended
6054 # as an alternative to using the more general description field.
6055 #
6056 # This field accepts and sanitizes HTML input, and also accepts
6057 # bold, italic, ordered list, and unordered list markup tags.
6058 #
6059 # The maximum number of allowed characters is 10,000.
6060 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
6061 # is used for contracting engagements.
6062 # Dates prior to 1970/1/1 and invalid date formats are ignored.
6063 # and time zone are either specified elsewhere or are not significant. The date
6064 # is relative to the Proleptic Gregorian Calendar. This can represent:
6065 #
6066 # * A full date, with non-zero year, month and day values
6067 # * A month and day value, with a zero year, e.g. an anniversary
6068 # * A year on its own, with zero month and day values
6069 # * A year and month value, with a zero day, e.g. a credit card expiration date
6070 #
6071 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6072 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6073 # if specifying a year by itself or a year and month where the day is not
6074 # significant.
6075 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6076 # a year.
6077 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6078 # month and day.
6079 },
6080 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
6081 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
6082 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
6083 # application_email_list or application_instruction must be
6084 # specified.
6085 #
6086 # Use this field to provide instructions, such as &quot;Mail your application
6087 # to ...&quot;, that a candidate can follow to apply for the job.
6088 #
6089 # This field accepts and sanitizes HTML input, and also accepts
6090 # bold, italic, ordered list, and unordered list markup tags.
6091 #
6092 # The maximum number of allowed characters is 3,000.
6093 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
6094 &quot;A String&quot;,
6095 ],
6096 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
6097 # incentives associated with the job not including salary or pay.
6098 #
6099 # The maximum number of allowed characters is 10,000.
6100 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
6101 # full time or
6102 # part time.
6103 &quot;A String&quot;,
6104 ],
6105 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
6106 #
6107 # Location(s) where the emploeyer is looking to hire for this job posting.
6108 #
6109 # Specifying the full street address(es) of the hiring location enables
6110 # better API results, especially job searches by commute time.
6111 #
6112 # At most 50 locations are allowed for best search performance. If a job has
6113 # more locations, it is suggested to split it into multiple jobs with unique
6114 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
6115 # multiple jobs with the same requisition_id, company_name and
6116 # language_code are not allowed. If the original requisition_id must
6117 # be preserved, a custom field should be used for storage. It is also
6118 # suggested to group the locations that close to each other in the same job
6119 # for better search experience.
6120 #
6121 # The maximum number of allowed characters is 500.
6122 &quot;A String&quot;,
6123 ],
6124 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
6125 #
6126 # Optional.
6127 #
6128 # Job compensation information.
6129 #
6130 # This field replaces compensation_info. Only
6131 # CompensationInfo.entries or extended_compensation_info can be set,
6132 # otherwise an exception is thrown.
6133 #
6134 # Describes job compensation.
6135 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
6136 # currency code.
6137 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
6138 #
6139 # Compensation range.
6140 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
6141 #
6142 # Decimal number.
6143 &quot;micros&quot;: 42, # Micro (10^-6) units.
6144 # The value must be between -999,999 and +999,999 inclusive.
6145 # If `units` is positive, `micros` must be positive or zero.
6146 # If `units` is zero, `micros` can be positive, zero, or negative.
6147 # If `units` is negative, `micros` must be negative or zero.
6148 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6149 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6150 },
6151 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
6152 #
6153 # Decimal number.
6154 &quot;micros&quot;: 42, # Micro (10^-6) units.
6155 # The value must be between -999,999 and +999,999 inclusive.
6156 # If `units` is positive, `micros` must be positive or zero.
6157 # If `units` is zero, `micros` can be positive, zero, or negative.
6158 # If `units` is negative, `micros` must be negative or zero.
6159 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6160 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6161 },
6162 },
6163 &quot;entries&quot;: [ # Optional. Job compensation information.
6164 #
6165 # At most one entry can be of type
6166 # ExtendedCompensationInfo.CompensationType.BASE, which is
6167 # referred as ** base compensation entry ** for the job.
6168 { # Deprecated. See CompensationInfo.
6169 #
6170 # A compensation entry that represents one component of compensation, such
6171 # as base pay, bonus, or other compensation type.
6172 #
6173 # Annualization: One compensation entry can be annualized if
6174 # - it contains valid amount or range.
6175 # - and its expected_units_per_year is set or can be derived.
6176 # Its annualized range is determined as (amount or range) times
6177 # expected_units_per_year.
6178 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
6179 #
6180 # Compensation range.
6181 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
6182 #
6183 # Decimal number.
6184 &quot;micros&quot;: 42, # Micro (10^-6) units.
6185 # The value must be between -999,999 and +999,999 inclusive.
6186 # If `units` is positive, `micros` must be positive or zero.
6187 # If `units` is zero, `micros` can be positive, zero, or negative.
6188 # If `units` is negative, `micros` must be negative or zero.
6189 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6190 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6191 },
6192 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
6193 #
6194 # Decimal number.
6195 &quot;micros&quot;: 42, # Micro (10^-6) units.
6196 # The value must be between -999,999 and +999,999 inclusive.
6197 # If `units` is positive, `micros` must be positive or zero.
6198 # If `units` is zero, `micros` can be positive, zero, or negative.
6199 # If `units` is negative, `micros` must be negative or zero.
6200 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6201 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6202 },
6203 },
6204 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
6205 # Job.employment_types is FULLTIME, a default value is inferred
6206 # based on unit. Default values:
6207 # - HOURLY: 2080
6208 # - DAILY: 260
6209 # - WEEKLY: 52
6210 # - MONTHLY: 12
6211 # - ANNUAL: 1
6212 #
6213 # Decimal number.
6214 &quot;micros&quot;: 42, # Micro (10^-6) units.
6215 # The value must be between -999,999 and +999,999 inclusive.
6216 # If `units` is positive, `micros` must be positive or zero.
6217 # If `units` is zero, `micros` can be positive, zero, or negative.
6218 # If `units` is negative, `micros` must be negative or zero.
6219 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6220 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6221 },
6222 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
6223 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
6224 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
6225 #
6226 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
6227 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
6228 #
6229 # Decimal number.
6230 &quot;micros&quot;: 42, # Micro (10^-6) units.
6231 # The value must be between -999,999 and +999,999 inclusive.
6232 # If `units` is positive, `micros` must be positive or zero.
6233 # If `units` is zero, `micros` can be positive, zero, or negative.
6234 # If `units` is negative, `micros` must be negative or zero.
6235 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6236 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6237 },
6238 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
6239 },
6240 ],
6241 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
6242 # the job&#x27;s all CompensationEntry cannot be annualized.
6243 # See CompensationEntry for explanation on annualization and base
6244 # compensation entry.
6245 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
6246 #
6247 # Compensation range.
6248 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
6249 #
6250 # Decimal number.
6251 &quot;micros&quot;: 42, # Micro (10^-6) units.
6252 # The value must be between -999,999 and +999,999 inclusive.
6253 # If `units` is positive, `micros` must be positive or zero.
6254 # If `units` is zero, `micros` can be positive, zero, or negative.
6255 # If `units` is negative, `micros` must be negative or zero.
6256 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6257 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6258 },
6259 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
6260 #
6261 # Decimal number.
6262 &quot;micros&quot;: 42, # Micro (10^-6) units.
6263 # The value must be between -999,999 and +999,999 inclusive.
6264 # If `units` is positive, `micros` must be positive or zero.
6265 # If `units` is zero, `micros` can be positive, zero, or negative.
6266 # If `units` is negative, `micros` must be negative or zero.
6267 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6268 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6269 },
6270 },
6271 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
6272 # the job&#x27;s base compensation entry cannot be annualized.
6273 # See CompensationEntry for explanation on annualization and base
6274 # compensation entry.
6275 },
6276 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
6277 # provided.
6278 #
6279 # The resource name of the company listing the job, such as
6280 # /companies/foo. This field takes precedence over the
6281 # distributor-assigned company identifier, distributor_company_id.
6282 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
6283 # description of the company and related information. Separate fields are
6284 # provided on the job object for responsibilities,
6285 # qualifications, and other job characteristics. Use of
6286 # these separate job fields is recommended.
6287 #
6288 # This field accepts and sanitizes HTML input, and also accepts
6289 # bold, italic, ordered list, and unordered list markup tags.
6290 #
6291 # The maximum number of allowed characters is 100,000.
6292 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
6293 # application_email_list or application_instruction must be
6294 # specified.
6295 #
6296 # Use this field to specify email address(es) to which resumes or
6297 # applications can be sent.
6298 #
6299 # The maximum number of allowed characters is 255.
6300 &quot;A String&quot;,
6301 ],
6302 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
6303 #
6304 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006305 }</pre>
6306</div>
6307
6308<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -07006309 <code class="details" id="search">search(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006310 <pre>Searches for jobs using the provided SearchJobsRequest.
6311
6312This call constrains the visibility of jobs
6313present in the database, and only returns jobs that the caller has
6314permission to search against.
6315
6316Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07006317 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006318 The object takes the form of:
6319
6320{ # Input only.
6321 #
6322 # The Request body of the `SearchJobs` call.
Bu Sun Kim65020912020-05-20 12:08:20 -07006323 &quot;mode&quot;: &quot;A String&quot;, # Required. Mode of a search.
6324 &quot;offset&quot;: 42, # Optional. An integer that specifies the current offset (that is, starting result
6325 # location, amongst the jobs deemed by the API as relevant) in search
6326 # results. This field is only considered if page_token is unset.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006327 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006328 # For example, 0 means to return results starting from the first matching
6329 # job, and 10 means to return from the 11th job. This can be used for
6330 # pagination, (for example, pageSize = 10 and offset = 10 means to return
6331 # from the second page).
6332 &quot;pageSize&quot;: 42, # Optional. A limit on the number of jobs returned in the search results.
6333 # Increasing this value above the default value of 10 can increase search
6334 # response time. The value can be between 1 and 100.
6335 &quot;query&quot;: { # Input only. # Optional. Query used to search against jobs, such as keyword, location filters, etc.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006336 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006337 # The query required to perform a search query or histogram.
6338 &quot;companyNames&quot;: [ # Optional. This filter specifies the company entities to search against.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006339 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006340 # If a value isn&#x27;t specified, jobs are searched for against all
6341 # companies.
6342 #
6343 # If multiple values are specified, jobs are searched against the
6344 # companies specified.
6345 #
6346 # At most 20 company filters are allowed.
6347 &quot;A String&quot;,
6348 ],
6349 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
6350 # search against, such as EmploymentType.FULL_TIME.
6351 #
6352 # If a value is not specified, jobs in the search results include any
6353 # employment type.
6354 #
6355 # If multiple values are specified, jobs in the search results include
6356 # any of the specified employment types.
6357 &quot;A String&quot;,
6358 ],
6359 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
6360 # See Category for more information.
6361 #
6362 # If a value is not specified, jobs from any category are searched against.
6363 #
6364 # If multiple values are specified, jobs from any of the specified
6365 # categories are searched against.
6366 &quot;A String&quot;,
6367 ],
6368 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
6369 # Job.custom_attributes marked as `filterable`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006370 #
6371 # The syntax for this expression is a subset of Google SQL syntax.
6372 #
Dan O'Mearadd494642020-05-01 07:42:23 -07006373 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006374 # is a custom field key and the right of the operator is a number or string
6375 # (surrounded by quotes) value.
6376 #
Dan O'Mearadd494642020-05-01 07:42:23 -07006377 # Supported functions are LOWER(&lt;field_name&gt;) to
6378 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006379 # existence of a key.
6380 #
6381 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
Bu Sun Kim65020912020-05-20 12:08:20 -07006382 # nesting (for example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), a maximum of 50
6383 # comparisons/functions are allowed in the expression. The expression
6384 # must be &lt; 2000 characters in length.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006385 #
6386 # Sample Query:
Bu Sun Kim65020912020-05-20 12:08:20 -07006387 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
6388 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
6389 # search against. See LocationFilter for more information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006390 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006391 # If a location value isn&#x27;t specified, jobs fitting the other search
6392 # criteria are retrieved regardless of where they&#x27;re located.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006393 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006394 # If multiple values are specified, jobs are retrieved from any of the
6395 # specified locations. If different values are specified for the
6396 # LocationFilter.distance_in_miles parameter, the maximum provided
6397 # distance is used for all locations.
6398 #
6399 # At most 5 location filters are allowed.
6400 { # Input only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006401 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006402 # Geographic region of the search.
6403 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
6404 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
6405 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
6406 #
6407 # Set this field if all the jobs to search against are from a same region,
6408 # or jobs are world-wide but the job seeker is from a specific region.
6409 #
6410 # See http://cldr.unicode.org/ and
6411 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
6412 # for details. Example: &quot;CH&quot; for Switzerland.
6413 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
6414 # identified as a city or smaller. When the location being searched for is a
6415 # state or larger, this field is ignored.
6416 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
6417 # set location, specifically, telecommuting jobs (telecomuting is considered
6418 # by the service as a special location.
6419 # Job.allow_telecommute indicates if a job permits telecommuting.
6420 # If this field is true, telecommuting jobs are searched, and
6421 # name and lat_lng are
6422 # ignored.
6423 # This filter can be used by itself to search exclusively for telecommuting
6424 # jobs, or it can be combined with another location
6425 # filter to search for a combination of job locations,
6426 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
6427 # combination with other location filters, telecommuting jobs can be
6428 # treated as less relevant than other jobs in the search response.
6429 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
6430 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
6431 # search. This field is ignored if `location_name` is provided.
6432 # of doubles representing degrees latitude and degrees longitude. Unless
6433 # specified otherwise, this must conform to the
6434 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
6435 # standard&lt;/a&gt;. Values must be within normalized ranges.
6436 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
6437 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
6438 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006439 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006440 ],
6441 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
6442 # against, for example, DateRange.PAST_MONTH. If a value isn&#x27;t
6443 # specified, all open jobs are searched against regardless of their
6444 # published date.
6445 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (for
6446 # example, driving or public transit). Note: This only works with COMMUTE
6447 # MODE. When specified, [JobQuery.location_filters] is
6448 # ignored.
6449 #
6450 # Currently we don&#x27;t support sorting by commute time.
6451 #
6452 # Parameters needed for commute search.
6453 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
6454 # integer between 0 and 23, representing the hour in the time zone of the
6455 # start_location. Must not be present if road_traffic is specified.
6456 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
6457 # For city level addresses, the city center is used. For state and coarser
6458 # level addresses, text matching is used.
6459 # If this field is set to `false` or is not specified, only jobs that include
6460 # street level addresses will be returned by commute search.
6461 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
6462 # (one hour). Format is `123s`.
6463 &quot;startLocation&quot;: { # 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
6464 # commute time.
6465 # of doubles representing degrees latitude and degrees longitude. Unless
6466 # specified otherwise, this must conform to the
6467 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
6468 # standard&lt;/a&gt;. Values must be within normalized ranges.
6469 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
6470 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
6471 },
6472 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
6473 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
6474 # Must not be present if departure_hour_local is specified.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006475 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006476 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
6477 # for example, &quot;en-US&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006478 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006479 # If a value isn&#x27;t specified, the search results can contain jobs in any
6480 # locale.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006481 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006482 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006483 # Language codes should be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
6484 # For more information, see
6485 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006486 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006487 # At most 10 language code filters are allowed.
6488 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006489 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006490 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
6491 # Job.compensation_info. For example, if the filter is specified
6492 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs meeting
6493 # these criteria are searched. If a filter isn&#x27;t defined, all open jobs
6494 # are searched.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006495 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006496 # Filter on job compensation type and amount.
6497 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
6498 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
6499 # CompensationInfo.CompensationUnit.
6500 &quot;A String&quot;,
6501 ],
6502 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
6503 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
6504 # to zero and the currency code is set to match the
6505 # currency code of max_compensation.
6506 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
6507 # The value must be between -999,999,999 and +999,999,999 inclusive.
6508 # If `units` is positive, `nanos` must be positive or zero.
6509 # If `units` is zero, `nanos` can be positive, zero, or negative.
6510 # If `units` is negative, `nanos` must be negative or zero.
6511 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
6512 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
6513 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
6514 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
6515 },
6516 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
6517 # to a maximal compensation value and the currency code is set to
6518 # match the currency code of
6519 # min_compensation.
6520 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
6521 # The value must be between -999,999,999 and +999,999,999 inclusive.
6522 # If `units` is positive, `nanos` must be positive or zero.
6523 # If `units` is zero, `nanos` can be positive, zero, or negative.
6524 # If `units` is negative, `nanos` must be negative or zero.
6525 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
6526 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
6527 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
6528 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
6529 },
6530 },
6531 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
6532 },
6533 &quot;query&quot;: &quot;A String&quot;, # Optional. The query string that matches against the job title, description, and
6534 # location fields.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006535 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006536 # The maximum query size is 255 bytes.
6537 &quot;companyDisplayNames&quot;: [ # Optional. This filter specifies the exact company display
6538 # name of the jobs to search against.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006539 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006540 # If a value isn&#x27;t specified, jobs within the search results are
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006541 # associated with any company.
6542 #
6543 # If multiple values are specified, jobs within the search results may be
6544 # associated with any of the specified companies.
6545 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006546 # At most 20 company display name filters are allowed.
6547 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006548 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006549 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
6550 # service attempts to correct a misspelled query,
6551 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006552 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006553 # Defaults to false: a spell check is performed.
6554 },
6555 &quot;disableRelevanceThresholding&quot;: True or False, # Optional. Controls whether to disable relevance thresholding. Relevance
6556 # thresholding removes jobs that have low relevance in search results,
6557 # for example, removing &quot;Assistant to the CEO&quot; positions from the search
6558 # results of a search for &quot;CEO&quot;.
6559 #
6560 # Disabling relevance thresholding improves the accuracy of subsequent
6561 # search requests.
6562 #
6563 # Defaults to false.
6564 &quot;enablePreciseResultSize&quot;: True or False, # Optional. Controls if the search job request requires the return of a precise
6565 # count of the first 300 results. Setting this to `true` ensures
6566 # consistency in the number of results per page. Best practice is to set this
6567 # value to true if a client allows users to jump directly to a
6568 # non-sequential search results page.
6569 #
6570 # Enabling this flag may adversely impact performance.
6571 #
6572 # Defaults to false.
6573 &quot;histogramFacets&quot;: { # Input only. # Optional. Restrictions on what fields to perform histogram on, such as
6574 # `COMPANY_SIZE` etc.
6575 #
6576 # Histogram facets to be specified in SearchJobsRequest.
6577 &quot;compensationHistogramFacets&quot;: [ # Optional. Specifies compensation field-based histogram requests.
6578 # Duplicate values of CompensationHistogramRequest.type are not allowed.
6579 { # Input only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006580 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006581 # Compensation based histogram request.
6582 &quot;bucketingOption&quot;: { # Input only. # Required. Numeric histogram options, like buckets, whether include min or max value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006583 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006584 # Use this field to specify bucketing option for the histogram search response.
6585 &quot;requiresMinMax&quot;: True or False, # Optional. If set to true, the histogram result includes minimum/maximum
6586 # value of the numeric field.
6587 &quot;bucketBounds&quot;: [ # Required. Two adjacent values form a histogram bucket. Values should be in
6588 # ascending order. For example, if [5, 10, 15] are provided, four buckets are
6589 # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
6590 # [buckets_bound is supported.
6591 3.14,
6592 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006593 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006594 &quot;type&quot;: &quot;A String&quot;, # Required. Type of the request, representing which field the histogramming should be
6595 # performed over. A single request can only specify one histogram of each
6596 # `CompensationHistogramRequestType`.
6597 },
6598 ],
6599 &quot;customAttributeHistogramFacets&quot;: [ # Optional. Specifies the custom attributes histogram requests.
6600 # Duplicate values of CustomAttributeHistogramRequest.key are not
6601 # allowed.
6602 { # Custom attributes histogram request. An error will be thrown if neither
6603 # string_value_histogram or long_value_histogram_bucketing_option has
6604 # been defined.
6605 &quot;stringValueHistogram&quot;: True or False, # Optional. If set to true, the response will include the histogram value for
6606 # each key as a string.
6607 &quot;longValueHistogramBucketingOption&quot;: { # Input only. # Optional. Specifies buckets used to perform a range histogram on Job&#x27;s
6608 # filterable long custom field values, or min/max value requirements.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006609 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006610 # Use this field to specify bucketing option for the histogram search response.
6611 &quot;requiresMinMax&quot;: True or False, # Optional. If set to true, the histogram result includes minimum/maximum
6612 # value of the numeric field.
6613 &quot;bucketBounds&quot;: [ # Required. Two adjacent values form a histogram bucket. Values should be in
6614 # ascending order. For example, if [5, 10, 15] are provided, four buckets are
6615 # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
6616 # [buckets_bound is supported.
6617 3.14,
6618 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006619 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006620 &quot;key&quot;: &quot;A String&quot;, # Required. Specifies the custom field key to perform a histogram on. If specified
6621 # without `long_value_histogram_bucketing_option`, histogram on string values
6622 # of the given `key` is triggered, otherwise histogram is performed on long
6623 # values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006624 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006625 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006626 &quot;simpleHistogramFacets&quot;: [ # Optional. Specifies the simple type of histogram facets, for example,
6627 # `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc. This field is equivalent to
6628 # GetHistogramRequest.
6629 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006630 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006631 },
6632 &quot;orderBy&quot;: &quot;A String&quot;, # Deprecated. Use sort_by instead.
6633 #
6634 # Optional.
6635 #
6636 # The criteria determining how search results are sorted.
6637 # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
6638 &quot;jobView&quot;: &quot;A String&quot;, # Optional. The number of job attributes returned for jobs in the
6639 # search response. Defaults to JobView.SMALL if no value is specified.
6640 &quot;pageToken&quot;: &quot;A String&quot;, # Optional. The token specifying the current offset within
6641 # search results. See SearchJobsResponse.next_page_token for
6642 # an explanation of how to obtain the next set of query results.
6643 &quot;filters&quot;: { # Input only. # Deprecated. Use query instead.
6644 #
6645 # Optional.
6646 #
6647 # Restrictions on the scope of the search request, such as filtering
6648 # by location.
6649 #
6650 # Deprecated. Use JobQuery instead.
6651 #
6652 # The filters required to perform a search query or histogram.
6653 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006654 # search against. See LocationFilter for more information.
6655 #
6656 # If a location value is not specified, jobs are retrieved
6657 # from all locations.
6658 #
6659 # If multiple values are specified, jobs are retrieved from any of the
6660 # specified locations. If different values are specified for the
6661 # LocationFilter.distance_in_miles parameter, the maximum provided
6662 # distance is used for all locations.
6663 #
6664 # At most 5 location filters are allowed.
6665 { # Input only.
6666 #
6667 # Geographic region of the search.
Bu Sun Kim65020912020-05-20 12:08:20 -07006668 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
6669 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
6670 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
6671 #
6672 # Set this field if all the jobs to search against are from a same region,
6673 # or jobs are world-wide but the job seeker is from a specific region.
6674 #
6675 # See http://cldr.unicode.org/ and
6676 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
6677 # for details. Example: &quot;CH&quot; for Switzerland.
6678 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
6679 # identified as a city or smaller. When the location being searched for is a
6680 # state or larger, this field is ignored.
6681 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006682 # set location, specifically, telecommuting jobs (telecomuting is considered
6683 # by the service as a special location.
6684 # Job.allow_telecommute indicates if a job permits telecommuting.
6685 # If this field is true, telecommuting jobs are searched, and
6686 # name and lat_lng are
6687 # ignored.
6688 # This filter can be used by itself to search exclusively for telecommuting
6689 # jobs, or it can be combined with another location
6690 # filter to search for a combination of job locations,
Bu Sun Kim65020912020-05-20 12:08:20 -07006691 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006692 # combination with other location filters, telecommuting jobs can be
6693 # treated as less relevant than other jobs in the search response.
Bu Sun Kim65020912020-05-20 12:08:20 -07006694 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
6695 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
Dan O'Mearadd494642020-05-01 07:42:23 -07006696 # search. This field is ignored if `location_name` is provided.
6697 # of doubles representing degrees latitude and degrees longitude. Unless
6698 # specified otherwise, this must conform to the
Bu Sun Kim65020912020-05-20 12:08:20 -07006699 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
Dan O'Mearadd494642020-05-01 07:42:23 -07006700 # standard&lt;/a&gt;. Values must be within normalized ranges.
Bu Sun Kim65020912020-05-20 12:08:20 -07006701 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
6702 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Dan O'Mearadd494642020-05-01 07:42:23 -07006703 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006704 },
6705 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006706 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
6707 # against, for example, DateRange.PAST_MONTH. If a value is not
6708 # specified, all open jobs are searched against regardless of the
6709 # date they were published.
6710 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (e.g.
6711 # driving or public transit). Note: this only works with COMMUTE
6712 # MODE. When specified, [JobFilters.location_filters] will be
6713 # ignored.
6714 #
6715 # Currently we do not support sorting by commute time.
6716 #
6717 # Parameters needed for commute search.
6718 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
6719 # integer between 0 and 23, representing the hour in the time zone of the
6720 # start_location. Must not be present if road_traffic is specified.
6721 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
6722 # For city level addresses, the city center is used. For state and coarser
6723 # level addresses, text matching is used.
6724 # If this field is set to `false` or is not specified, only jobs that include
6725 # street level addresses will be returned by commute search.
6726 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
6727 # (one hour). Format is `123s`.
6728 &quot;startLocation&quot;: { # 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
6729 # commute time.
6730 # of doubles representing degrees latitude and degrees longitude. Unless
6731 # specified otherwise, this must conform to the
6732 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
6733 # standard&lt;/a&gt;. Values must be within normalized ranges.
6734 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
6735 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
6736 },
6737 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
6738 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
6739 # Must not be present if departure_hour_local is specified.
6740 },
6741 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
6742 # for example, &quot;en-US&quot;.
6743 #
6744 # If a value is not specified, the search results may contain jobs in any
6745 # locale.
6746 #
6747 #
6748 # Language codes should be in BCP-47 format, for example, &quot;en-US&quot; or
6749 # &quot;sr-Latn&quot;. For more information, see [Tags for Identifying
6750 # Languages](https://tools.ietf.org/html/bcp47).
6751 #
6752 # At most 10 language code filters are allowed.
6753 &quot;A String&quot;,
6754 ],
6755 &quot;companyTitles&quot;: [ # Optional. This filter specifies the exact company titles
6756 # of jobs to search against.
6757 #
6758 # If a value is not specified, jobs within the search results can be
6759 # associated with any company.
6760 #
6761 # If multiple values are specified, jobs within the search results may be
6762 # associated with any of the specified companies.
6763 #
6764 # At most 20 company title filters are allowed.
6765 &quot;A String&quot;,
6766 ],
6767 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006768 # Job.compensation_info. For example, if the filter is specified
Bu Sun Kim65020912020-05-20 12:08:20 -07006769 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006770 # this criteria are searched. If a filter is not defined, all open jobs
6771 # are searched.
6772 #
6773 # Filter on job compensation type and amount.
Bu Sun Kim65020912020-05-20 12:08:20 -07006774 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
6775 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006776 # CompensationInfo.CompensationUnit.
Bu Sun Kim65020912020-05-20 12:08:20 -07006777 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006778 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006779 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
6780 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
6781 # to zero and the currency code is set to match the
6782 # currency code of max_compensation.
6783 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
6784 # The value must be between -999,999,999 and +999,999,999 inclusive.
6785 # If `units` is positive, `nanos` must be positive or zero.
6786 # If `units` is zero, `nanos` can be positive, zero, or negative.
6787 # If `units` is negative, `nanos` must be negative or zero.
6788 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
6789 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
6790 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
6791 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
6792 },
6793 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006794 # to a maximal compensation value and the currency code is set to
6795 # match the currency code of
6796 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07006797 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006798 # The value must be between -999,999,999 and +999,999,999 inclusive.
6799 # If `units` is positive, `nanos` must be positive or zero.
6800 # If `units` is zero, `nanos` can be positive, zero, or negative.
6801 # If `units` is negative, `nanos` must be negative or zero.
6802 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07006803 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
6804 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
6805 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006806 },
6807 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006808 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006809 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006810 &quot;query&quot;: &quot;A String&quot;, # Optional. The query filter contains the keywords that match against the job
6811 # title, description, and location fields.
Dan O'Mearadd494642020-05-01 07:42:23 -07006812 #
Bu Sun Kim65020912020-05-20 12:08:20 -07006813 # The maximum query size is 255 bytes/characters.
6814 &quot;extendedCompensationFilter&quot;: { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
6815 #
6816 # Optional.
6817 #
6818 # This search filter is applied only to
6819 # Job.extended_compensation_info. For example, if the filter is specified
6820 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
6821 # these criteria are searched. If a filter is not defined, all open jobs
6822 # are searched.
6823 #
6824 # Input only.
6825 #
6826 # Filter on job compensation type and amount.
6827 &quot;includeJobWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
6828 &quot;compensationUnits&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
6829 # ExtendedCompensationInfo.CompensationUnit.
6830 &quot;A String&quot;,
6831 ],
6832 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
6833 &quot;currency&quot;: &quot;A String&quot;, # Optional. Specify currency in 3-letter
6834 # [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
6835 # unspecified, jobs are returned regardless of currency.
6836 &quot;compensationRange&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
6837 #
6838 # Compensation range.
6839 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
6840 #
6841 # Decimal number.
6842 &quot;micros&quot;: 42, # Micro (10^-6) units.
6843 # The value must be between -999,999 and +999,999 inclusive.
6844 # If `units` is positive, `micros` must be positive or zero.
6845 # If `units` is zero, `micros` can be positive, zero, or negative.
6846 # If `units` is negative, `micros` must be negative or zero.
6847 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6848 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6849 },
6850 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
6851 #
6852 # Decimal number.
6853 &quot;micros&quot;: 42, # Micro (10^-6) units.
6854 # The value must be between -999,999 and +999,999 inclusive.
6855 # If `units` is positive, `micros` must be positive or zero.
6856 # If `units` is zero, `micros` can be positive, zero, or negative.
6857 # If `units` is negative, `micros` must be negative or zero.
6858 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
6859 &quot;units&quot;: &quot;A String&quot;, # Whole units.
6860 },
6861 },
Dan O'Mearadd494642020-05-01 07:42:23 -07006862 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006863 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006864 # service attempts to correct a misspelled query,
Bu Sun Kim65020912020-05-20 12:08:20 -07006865 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006866 #
6867 # Defaults to false: a spell check is performed.
Bu Sun Kim65020912020-05-20 12:08:20 -07006868 &quot;customFieldFilters&quot;: { # Deprecated. Use custom_attribute_filter instead.
6869 #
6870 # Optional.
6871 #
6872 # This filter specifies searching against
6873 # custom field values. See Job.filterable_custom_fields for information.
6874 # The key value specifies a number between 1-20 (the service
6875 # supports 20 custom fields) corresponding to the desired custom field map
6876 # value. If an invalid key is provided or specified together with
6877 # custom_attribute_filter, an error is thrown.
6878 &quot;a_key&quot;: { # Input only.
6879 #
6880 # Custom field filter of the search.
6881 &quot;type&quot;: &quot;A String&quot;, # Optional. The type of filter.
6882 # Defaults to FilterType.OR.
6883 &quot;queries&quot;: [ # Required. The query strings for the filter.
6884 &quot;A String&quot;,
6885 ],
6886 },
6887 },
6888 &quot;companyNames&quot;: [ # Optional. The company names filter specifies the company entities to search
6889 # against.
6890 #
6891 # If a value is not specified, jobs are searched for against all companies.
6892 #
6893 # If multiple values are specified, jobs are searched against the
6894 # specified companies.
6895 #
6896 # At most 20 company filters are allowed.
6897 &quot;A String&quot;,
6898 ],
6899 &quot;tenantJobOnly&quot;: True or False, # Deprecated. Do not use this field.
6900 #
6901 # This flag controls whether the job search should be restricted to jobs
6902 # owned by the current user.
6903 #
6904 # Defaults to false where all jobs accessible to the
6905 # user are searched against.
6906 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
6907 # search against, such as EmploymentType.FULL_TIME.
6908 #
6909 # If a value is not specified, jobs in the search results include any
6910 # employment type.
6911 #
6912 # If multiple values are specified, jobs in the search results include any
6913 # of the specified employment types.
6914 &quot;A String&quot;,
6915 ],
6916 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
6917 # See Category for more information.
6918 #
6919 # If a value is not specified, jobs from any category are searched against.
6920 #
6921 # If multiple values are specified, jobs from any of the specified
6922 # categories are searched against.
6923 &quot;A String&quot;,
6924 ],
6925 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
6926 # Job.custom_attributes that are marked as `filterable`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006927 #
6928 # The syntax for this expression is a subset of Google SQL syntax.
6929 #
Dan O'Mearadd494642020-05-01 07:42:23 -07006930 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006931 # is a custom field key and the right of the operator is a number or string
6932 # (surrounded by quotes) value.
6933 #
Dan O'Mearadd494642020-05-01 07:42:23 -07006934 # Supported functions are LOWER(&lt;field_name&gt;) to
6935 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006936 # existence of a key.
6937 #
6938 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
Bu Sun Kim65020912020-05-20 12:08:20 -07006939 # nesting (For example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), and there can
6940 # be a maximum of 100 comparisons/functions in the expression. The expression
6941 # must be &lt; 3000 bytes in length.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006942 #
6943 # Sample Query:
Bu Sun Kim65020912020-05-20 12:08:20 -07006944 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07006945 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006946 &quot;sortBy&quot;: &quot;A String&quot;, # Optional. The criteria determining how search results are sorted.
Dan O'Mearadd494642020-05-01 07:42:23 -07006947 # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
Bu Sun Kim65020912020-05-20 12:08:20 -07006948 &quot;requestMetadata&quot;: { # Input only. # Required. The meta information collected about the job searcher, used to improve the
6949 # search quality of the service. The identifiers, (such as `user_id`) are
6950 # provided by users, and must be unique and consistent.
6951 #
6952 # Meta information related to the job searcher or entity
6953 # conducting the job search. This information is used to improve the
6954 # performance of the service.
6955 &quot;sessionId&quot;: &quot;A String&quot;, # Required. A unique session identification string. A session is defined as the
6956 # duration of an end user&#x27;s interaction with the service over a period.
6957 # Obfuscate this field for privacy concerns before
6958 # providing it to the API.
6959 #
6960 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
6961 # that any improvements to the service model for a particular tenant site,
6962 # rely on this field being set correctly to some unique session_id.
6963 &quot;domain&quot;: &quot;A String&quot;, # Required. The client-defined scope or source of the service call, which typically
6964 # is the domain on
6965 # which the service has been implemented and is currently being run.
6966 #
6967 # For example, if the service is being run by client &lt;em&gt;Foo, Inc.&lt;/em&gt;, on
6968 # job board www.foo.com and career site www.bar.com, then this field is
6969 # set to &quot;foo.com&quot; for use on the job board, and &quot;bar.com&quot; for use on the
6970 # career site.
6971 #
6972 # If this field is not available for some reason, send &quot;UNKNOWN&quot;. Note that
6973 # any improvements to the service model for a particular tenant site rely on
6974 # this field being set correctly to some domain.
6975 &quot;userId&quot;: &quot;A String&quot;, # Required. A unique user identification string, as determined by the client. The
6976 # client is responsible for ensuring client-level uniqueness of this value
6977 # in order to have the strongest positive impact on search quality.
6978 # Obfuscate this field for privacy concerns before
6979 # providing it to the service.
6980 #
6981 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
6982 # that any improvements to the service model for a particular tenant site,
6983 # rely on this field being set correctly to some unique user_id.
6984 &quot;deviceInfo&quot;: { # Input only. # Optional. The type of device used by the job seeker at the time of the call to the
6985 # service.
6986 #
6987 # Device information collected from the job seeker, candidate, or
6988 # other entity conducting the job search. Providing this information improves
6989 # the quality of the search results across devices.
6990 &quot;deviceType&quot;: &quot;A String&quot;, # Optional. Type of the device.
6991 &quot;id&quot;: &quot;A String&quot;, # Optional. A device-specific ID. The ID must be a unique identifier that distinguishes
6992 # the device from other devices.
6993 },
6994 },
6995 &quot;enableBroadening&quot;: True or False, # Optional. Controls whether to broaden the search when it produces sparse results.
6996 # Broadened queries append results to the end of the matching results
6997 # list.
6998 #
6999 # Defaults to false.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007000 }
7001
7002 x__xgafv: string, V1 error format.
7003 Allowed values
7004 1 - v1 error format
7005 2 - v2 error format
7006
7007Returns:
7008 An object of the form:
7009
7010 { # Output only.
7011 #
7012 # Response for SearchJob method.
Bu Sun Kim65020912020-05-20 12:08:20 -07007013 &quot;histogramResults&quot;: { # Output only. # The histogram results that match specified
7014 # SearchJobsRequest.HistogramFacets.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007015 #
Bu Sun Kim65020912020-05-20 12:08:20 -07007016 # Histogram results that matches HistogramFacets specified in
7017 # SearchJobsRequest.
7018 &quot;compensationHistogramResults&quot;: [ # Specifies compensation field-based histogram results that matches
7019 # HistogramFacets.compensation_histogram_requests.
7020 { # Output only.
7021 #
7022 # Compensation based histogram result.
7023 &quot;result&quot;: { # Output only. # Histogram result.
7024 #
7025 # Custom numeric bucketing result.
7026 &quot;counts&quot;: [ # Count within each bucket. Its size is the length of
7027 # NumericBucketingOption.bucket_bounds plus 1.
7028 { # Represents count of jobs within one bucket.
7029 &quot;count&quot;: 42, # Number of jobs whose numeric field value fall into `range`.
7030 &quot;range&quot;: { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
7031 # that is, the count represents number of jobs in this range.
7032 &quot;to&quot;: 3.14, # Ending value of the bucket range.
7033 &quot;from&quot;: 3.14, # Starting value of the bucket range.
7034 },
7035 },
7036 ],
7037 &quot;minValue&quot;: 3.14, # Stores the minimum value of the numeric field. Will be populated only if
7038 # [NumericBucketingOption.requires_min_max] is set to true.
7039 &quot;maxValue&quot;: 3.14, # Stores the maximum value of the numeric field. Will be populated only if
7040 # [NumericBucketingOption.requires_min_max] is set to true.
7041 },
7042 &quot;type&quot;: &quot;A String&quot;, # Type of the request, corresponding to
7043 # CompensationHistogramRequest.type.
7044 },
7045 ],
7046 &quot;customAttributeHistogramResults&quot;: [ # Specifies histogram results for custom attributes that
7047 # matches HistogramFacets.custom_attribute_histogram_facets.
7048 { # Output only.
7049 #
7050 # Custom attribute histogram result.
7051 &quot;key&quot;: &quot;A String&quot;, # Stores the key of custom attribute the histogram is performed on.
7052 &quot;longValueHistogramResult&quot;: { # Output only. # Stores bucketed histogram counting result or min/max values for
7053 # custom attribute long values associated with `key`.
7054 #
7055 # Custom numeric bucketing result.
7056 &quot;counts&quot;: [ # Count within each bucket. Its size is the length of
7057 # NumericBucketingOption.bucket_bounds plus 1.
7058 { # Represents count of jobs within one bucket.
7059 &quot;count&quot;: 42, # Number of jobs whose numeric field value fall into `range`.
7060 &quot;range&quot;: { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
7061 # that is, the count represents number of jobs in this range.
7062 &quot;to&quot;: 3.14, # Ending value of the bucket range.
7063 &quot;from&quot;: 3.14, # Starting value of the bucket range.
7064 },
7065 },
7066 ],
7067 &quot;minValue&quot;: 3.14, # Stores the minimum value of the numeric field. Will be populated only if
7068 # [NumericBucketingOption.requires_min_max] is set to true.
7069 &quot;maxValue&quot;: 3.14, # Stores the maximum value of the numeric field. Will be populated only if
7070 # [NumericBucketingOption.requires_min_max] is set to true.
7071 },
7072 &quot;stringValueHistogramResult&quot;: { # Stores a map from the values of string custom field associated
7073 # with `key` to the number of jobs with that value in this histogram result.
7074 &quot;a_key&quot;: 42,
7075 },
7076 },
7077 ],
7078 &quot;simpleHistogramResults&quot;: [ # Specifies histogram results that matches
7079 # HistogramFacets.simple_histogram_facets.
7080 { # Output only.
7081 #
7082 # Result of a histogram call. The response contains the histogram map for the
7083 # search type specified by HistogramResult.field.
7084 # The response is a map of each filter value to the corresponding count of
7085 # jobs for that filter.
7086 &quot;values&quot;: { # A map from the values of field to the number of jobs with that value
7087 # in this search result.
7088 #
7089 # Key: search type (filter names, such as the companyName).
7090 #
7091 # Values: the count of jobs that match the filter for this search.
7092 &quot;a_key&quot;: 42,
7093 },
7094 &quot;searchType&quot;: &quot;A String&quot;, # The Histogram search filters.
7095 },
7096 ],
7097 },
7098 &quot;spellResult&quot;: { # Output only. # The spell checking result, and correction.
7099 #
7100 # Spell check result.
7101 &quot;corrected&quot;: True or False, # Indicates if the query was corrected by the spell checker.
7102 &quot;correctedText&quot;: &quot;A String&quot;, # Correction output consisting of the corrected keyword string.
7103 },
7104 &quot;metadata&quot;: { # Output only. # Additional information for the API invocation, such as the request
7105 # tracking id.
7106 #
7107 # Additional information returned to client, such as debugging
7108 # information.
7109 &quot;requestId&quot;: &quot;A String&quot;, # A unique id associated with this call.
7110 # This id is logged for tracking purposes.
7111 &quot;mode&quot;: &quot;A String&quot;, # For search response only. Indicates the mode of a performed search.
7112 &quot;experimentIdList&quot;: [ # Identifiers for the versions of the search algorithm used during
7113 # this API invocation if multiple algorithms are used.
7114 # The default value is empty.
7115 # For search response only.
7116 42,
7117 ],
7118 },
7119 &quot;matchingJobs&quot;: [ # The Job entities that match the specified SearchJobsRequest.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007120 { # Output only.
7121 #
7122 # Job entry with metadata inside SearchJobsResponse.
Bu Sun Kim65020912020-05-20 12:08:20 -07007123 &quot;job&quot;: { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot; # Job resource that matches the specified SearchJobsRequest.
7124 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007125 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07007126 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
7127 # is available. If this field is set, a
7128 # LocationFilter in a search query within the job region
7129 # finds this job if an exact location match is not specified.
7130 # If this field is set, setting job locations
7131 # to the same location level as this field is strongly recommended.
7132 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
7133 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007134 #
Bu Sun Kim65020912020-05-20 12:08:20 -07007135 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007136 #
Bu Sun Kim65020912020-05-20 12:08:20 -07007137 # The name of the company listing the job.
7138 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
7139 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
7140 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007141 # CompensationEntry.expected_units_per_year.
7142 #
7143 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07007144 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
7145 # to zero and the currency code is set to match the
7146 # currency code of max_compensation.
7147 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7148 # The value must be between -999,999,999 and +999,999,999 inclusive.
7149 # If `units` is positive, `nanos` must be positive or zero.
7150 # If `units` is zero, `nanos` can be positive, zero, or negative.
7151 # If `units` is negative, `nanos` must be negative or zero.
7152 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7153 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7154 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7155 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7156 },
7157 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007158 # to a maximal compensation value and the currency code is set to
7159 # match the currency code of
7160 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07007161 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007162 # The value must be between -999,999,999 and +999,999,999 inclusive.
7163 # If `units` is positive, `nanos` must be positive or zero.
7164 # If `units` is zero, `nanos` can be positive, zero, or negative.
7165 # If `units` is negative, `nanos` must be negative or zero.
7166 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07007167 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7168 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7169 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007170 },
7171 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007172 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007173 #
7174 # Optional.
7175 #
7176 # The amount of compensation or pay for the job.
7177 # As an alternative, compensation_amount_min and
7178 # compensation_amount_max may be used to define a range of
7179 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07007180 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007181 # The value must be between -999,999,999 and +999,999,999 inclusive.
7182 # If `units` is positive, `nanos` must be positive or zero.
7183 # If `units` is zero, `nanos` can be positive, zero, or negative.
7184 # If `units` is negative, `nanos` must be negative or zero.
7185 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07007186 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7187 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7188 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007189 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007190 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
7191 #
7192 # Optional.
7193 #
7194 # Type of job compensation.
7195 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
7196 #
7197 # Optional.
7198 #
7199 # An upper bound on a range for compensation or pay for the job.
7200 # The currency type is specified in compensation_amount.
7201 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7202 # The value must be between -999,999,999 and +999,999,999 inclusive.
7203 # If `units` is positive, `nanos` must be positive or zero.
7204 # If `units` is zero, `nanos` can be positive, zero, or negative.
7205 # If `units` is negative, `nanos` must be negative or zero.
7206 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7207 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7208 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7209 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7210 },
7211 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
7212 # all compensation entries&#x27; CompensationEntry.compensation times
7213 # CompensationEntry.expected_units_per_year.
7214 #
7215 # See CompensationEntry for explanation on compensation annualization.
7216 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
7217 # to zero and the currency code is set to match the
7218 # currency code of max_compensation.
7219 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7220 # The value must be between -999,999,999 and +999,999,999 inclusive.
7221 # If `units` is positive, `nanos` must be positive or zero.
7222 # If `units` is zero, `nanos` can be positive, zero, or negative.
7223 # If `units` is negative, `nanos` must be negative or zero.
7224 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7225 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7226 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7227 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7228 },
7229 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
7230 # to a maximal compensation value and the currency code is set to
7231 # match the currency code of
7232 # min_compensation.
7233 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7234 # The value must be between -999,999,999 and +999,999,999 inclusive.
7235 # If `units` is positive, `nanos` must be positive or zero.
7236 # If `units` is zero, `nanos` can be positive, zero, or negative.
7237 # If `units` is negative, `nanos` must be negative or zero.
7238 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7239 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7240 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7241 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7242 },
7243 },
7244 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
7245 #
7246 # Optional.
7247 #
7248 # A lower bound on a range for compensation or pay for the job.
7249 # The currency type is specified in compensation_amount.
7250 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7251 # The value must be between -999,999,999 and +999,999,999 inclusive.
7252 # If `units` is positive, `nanos` must be positive or zero.
7253 # If `units` is zero, `nanos` can be positive, zero, or negative.
7254 # If `units` is negative, `nanos` must be negative or zero.
7255 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7256 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7257 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7258 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7259 },
7260 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007261 #
7262 # At most one entry can be of type
7263 # CompensationInfo.CompensationType.BASE, which is
7264 # referred as ** base compensation entry ** for the job.
7265 { # A compensation entry that represents one component of compensation, such
7266 # as base pay, bonus, or other compensation type.
7267 #
7268 # Annualization: One compensation entry can be annualized if
7269 # - it contains valid amount or range.
7270 # - and its expected_units_per_year is set or can be derived.
7271 # Its annualized range is determined as (amount or range) times
7272 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07007273 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
7274 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
7275 # to zero and the currency code is set to match the
7276 # currency code of max_compensation.
7277 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
7278 # The value must be between -999,999,999 and +999,999,999 inclusive.
7279 # If `units` is positive, `nanos` must be positive or zero.
7280 # If `units` is zero, `nanos` can be positive, zero, or negative.
7281 # If `units` is negative, `nanos` must be negative or zero.
7282 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
7283 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7284 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7285 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
7286 },
7287 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007288 # to a maximal compensation value and the currency code is set to
7289 # match the currency code of
7290 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07007291 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007292 # The value must be between -999,999,999 and +999,999,999 inclusive.
7293 # If `units` is positive, `nanos` must be positive or zero.
7294 # If `units` is zero, `nanos` can be positive, zero, or negative.
7295 # If `units` is negative, `nanos` must be negative or zero.
7296 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07007297 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7298 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7299 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007300 },
7301 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007302 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007303 # Job.employment_types is FULLTIME, a default value is inferred
7304 # based on unit. Default values:
7305 # - HOURLY: 2080
7306 # - DAILY: 260
7307 # - WEEKLY: 52
7308 # - MONTHLY: 12
7309 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07007310 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
7311 # indicate equity terms or provide additional context to an estimated
7312 # bonus.
7313 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
7314 #
7315 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
7316 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
7317 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007318 # The value must be between -999,999,999 and +999,999,999 inclusive.
7319 # If `units` is positive, `nanos` must be positive or zero.
7320 # If `units` is zero, `nanos` can be positive, zero, or negative.
7321 # If `units` is negative, `nanos` must be negative or zero.
7322 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07007323 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
7324 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
7325 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007326 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007327 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007328 },
7329 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007330 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007331 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
7332 # recommended as an alternative to using the more general description
7333 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007334 #
7335 # This field accepts and sanitizes HTML input, and also accepts
7336 # bold, italic, ordered list, and unordered list markup tags.
7337 #
7338 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07007339 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007340 # experience.
7341 #
7342 # The expiration timestamp of the job. After this timestamp, the
7343 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07007344 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007345 # ListJobs APIs, but it can be retrieved with the GetJob API or
7346 # updated with the UpdateJob API. An expired job can be updated and
7347 # opened again by using a future expiration timestamp. Updating an expired
7348 # job fails if there is another existing open job with same
7349 # requisition_id, company_name and language_code.
7350 #
7351 # The expired jobs are retained in our system for 90 days. However, the
7352 # overall expired job count cannot exceed 3 times the maximum of open jobs
7353 # count over the past week, otherwise jobs with earlier expire time are
7354 # cleaned first. Expired jobs are no longer accessible after they are cleaned
7355 # out.
7356 # The format of this field is RFC 3339 date strings. Example:
7357 # 2000-01-01T00:00:00.999999999Z
7358 # See
7359 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
7360 #
7361 # A valid date range is between 1970-01-01T00:00:00.0Z and
7362 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
7363 # time not provided.
7364 #
7365 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07007366 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007367 # example, if the job was created on 2017/01/01 13:00AM UTC with an
7368 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
7369 #
7370 # If this value is not provided but expiry_date is, expiry_date is
7371 # used.
7372 #
7373 # If this value is not provided on job update, it depends on the field masks
7374 # set by UpdateJobRequest.update_job_fields. If the field masks include
7375 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07007376 # updated, the job posting expires after 30 days from the job&#x27;s last
7377 # update time. Otherwise the expiration date isn&#x27;t updated.
7378 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
7379 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
7380 { # Output only.
7381 #
7382 # A resource that represents a location with full geographic
7383 # information.
7384 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
7385 # such as postal delivery and payments addresses. Given a postal address,
7386 # a postal service can deliver items to a premises, P.O. Box, or other
7387 # delivery location.
7388 # Given a postal address, a postal service can deliver items to a premise, P.O.
7389 # Box or similar.
7390 # It is not intended to model geographical locations (roads, towns,
7391 # mountains).
7392 #
7393 # In typical usage an address would be created via user input or from importing
7394 # existing data, depending on the type of process.
7395 #
7396 # Advice on address input / editing:
7397 # - Use an i18n-ready address widget such as
7398 # https://github.com/google/libaddressinput)
7399 # - Users should not be presented with UI elements for input or editing of
7400 # fields outside countries where that field is used.
7401 #
7402 # For more guidance on how to use this schema, please see:
7403 # https://support.google.com/business/answer/6397478
7404 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
7405 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
7406 # is never inferred and it is up to the user to ensure the value is
7407 # correct. See http://cldr.unicode.org/ and
7408 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
7409 # for details. Example: &quot;CH&quot; for Switzerland.
7410 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
7411 #
7412 # Because values in address_lines do not have type information and may
7413 # sometimes contain multiple values in a single field (e.g.
7414 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
7415 # address lines should be &quot;envelope order&quot; for the country/region of the
7416 # address. In places where this can vary (e.g. Japan), address_language is
7417 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
7418 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
7419 # an address can be selected based on the language.
7420 #
7421 # The minimum permitted structural representation of an address consists
7422 # of a region_code with all remaining information placed in the
7423 # address_lines. It would be possible to format such an address very
7424 # approximately without geocoding, but no semantic reasoning could be
7425 # made about any of the address components until it was at least
7426 # partially resolved.
7427 #
7428 # Creating an address only containing a region_code and address_lines, and
7429 # then geocoding is the recommended way to handle completely unstructured
7430 # addresses (as opposed to guessing which parts of the address should be
7431 # localities or administrative areas).
7432 &quot;A String&quot;,
7433 ],
7434 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
7435 # postal codes to be present, but where they are used, they may trigger
7436 # additional validation with other parts of the address (e.g. state/zip
7437 # validation in the U.S.A.).
7438 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
7439 # in most regions. Where it is used, the value is either a string like
7440 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
7441 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
7442 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
7443 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
7444 # known). This is often the UI language of the input form or is expected
7445 # to match one of the languages used in the address&#x27; country/region, or their
7446 # transliterated equivalents.
7447 # This can affect formatting in certain countries, but is not critical
7448 # to the correctness of the data and will never affect any validation or
7449 # other non-formatting related operations.
7450 #
7451 # If this value is not known, it should be omitted (rather than specifying a
7452 # possibly incorrect default).
7453 #
7454 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
7455 &quot;recipients&quot;: [ # Optional. The recipient at the address.
7456 # This field may, under certain circumstances, contain multiline information.
7457 # For example, it might contain &quot;care of&quot; information.
7458 &quot;A String&quot;,
7459 ],
7460 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
7461 # For example, this can be neighborhoods, boroughs, districts.
7462 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
7463 # the latest revision.
7464 #
7465 # All new revisions **must** be backward compatible with old revisions.
7466 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
7467 # addresses of a country or region.
7468 # For example, this can be a state, a province, an oblast, or a prefecture.
7469 # Specifically, for Spain this is the province and not the autonomous
7470 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
7471 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
7472 # in Switzerland this should be left unpopulated.
7473 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
7474 # Examples: US city, IT comune, UK post town.
7475 # In regions of the world where localities are not well defined or do not fit
7476 # into this structure well, leave locality empty and use address_lines.
7477 },
7478 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
7479 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
7480 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
7481 # LocationType#LOCALITY.
7482 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
7483 # location bounding box in which a circle with the specified radius
7484 # centered from LatLng coves the area associated with the job location.
7485 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
7486 # 7885.79 meters.
7487 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
7488 # of doubles representing degrees latitude and degrees longitude. Unless
7489 # specified otherwise, this must conform to the
7490 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
7491 # standard&lt;/a&gt;. Values must be within normalized ranges.
7492 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
7493 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
7494 },
7495 },
7496 ],
7497 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
7498 # position.
7499 #
7500 # The maximum number of allowed characters is 255.
7501 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
7502 #
7503 # Optional.
7504 #
7505 # A map of fields to hold non-filterable custom job attributes, similar to
7506 # filterable_custom_fields. These fields are distinct in that the data
7507 # in these fields are not indexed. Therefore, the client cannot search
7508 # against them, nor can the client use them to list jobs.
7509 #
7510 # The key of the map can be any valid string.
7511 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
7512 &quot;values&quot;: [ # Optional. The values of the custom data.
7513 &quot;A String&quot;,
7514 ],
7515 },
7516 },
7517 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
7518 #
7519 # Optional but strongly recommended to be provided for the best service
7520 # experience.
7521 #
7522 # The expiration date of the job in UTC time. After 12 am on this date, the
7523 # job is marked as expired, and it no longer appears in search results.
7524 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
7525 # ListJobs APIs, but it can be retrieved with the GetJob API or
7526 # updated with the UpdateJob API. An expired job can be updated and
7527 # opened again by using a future expiration date. It can also remain expired.
7528 # Updating an expired job to be open fails if there is another existing open
7529 # job with same requisition_id, company_name and language_code.
7530 #
7531 # The expired jobs are retained in our system for 90 days. However, the
7532 # overall expired job count cannot exceed 3 times the maximum of open jobs
7533 # count over the past week, otherwise jobs with earlier expire time are
7534 # removed first. Expired jobs are no longer accessible after they are cleaned
7535 # out.
7536 #
7537 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
7538 # ignored and treated as expiry date not provided.
7539 #
7540 # If this value is not provided on job creation or is invalid, the job
7541 # posting expires after 30 days from the job&#x27;s creation time. For example, if
7542 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
7543 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
7544 #
7545 # If this value is not provided on job update, it depends on the field masks
7546 # set by UpdateJobRequest.update_job_fields. If the field masks include
7547 # expiry_date, or the masks are empty meaning that every field is
7548 # updated, the job expires after 30 days from the job&#x27;s last update time.
7549 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007550 # and time zone are either specified elsewhere or are not significant. The date
7551 # is relative to the Proleptic Gregorian Calendar. This can represent:
7552 #
7553 # * A full date, with non-zero year, month and day values
7554 # * A month and day value, with a zero year, e.g. an anniversary
7555 # * A year on its own, with zero month and day values
7556 # * A year and month value, with a zero day, e.g. a credit card expiration date
7557 #
7558 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07007559 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007560 # if specifying a year by itself or a year and month where the day is not
7561 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07007562 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007563 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07007564 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7565 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007566 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007567 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
7568 # is used for contracting engagements.
7569 # Dates prior to 1970/1/1 and invalid date formats are ignored.
7570 # and time zone are either specified elsewhere or are not significant. The date
7571 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007572 #
Bu Sun Kim65020912020-05-20 12:08:20 -07007573 # * A full date, with non-zero year, month and day values
7574 # * A month and day value, with a zero year, e.g. an anniversary
7575 # * A year on its own, with zero month and day values
7576 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007577 #
Bu Sun Kim65020912020-05-20 12:08:20 -07007578 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7579 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7580 # if specifying a year by itself or a year and month where the day is not
7581 # significant.
7582 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7583 # a year.
7584 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7585 # month and day.
7586 },
7587 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
7588 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
7589 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007590 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07007591 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007592 # attributes that are not covered by the provided structured fields.
7593 #
7594 # This field is a more general combination of the deprecated id-based
7595 # filterable_custom_fields and string-based
7596 # non_filterable_custom_fields.
7597 #
7598 # The keys of the map are strings up to 64 bytes and must match the
7599 # pattern: a-zA-Z*.
7600 #
7601 # At most 100 filterable and at most 100 unfilterable keys are supported.
7602 # For filterable `string_values`, across all keys at most 200 values are
7603 # allowed, with each string no more than 255 characters. For unfilterable
7604 # `string_values`, the maximum total size of `string_values` across all keys
7605 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07007606 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
7607 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007608 # If false, values are not searchable.
7609 #
7610 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07007611 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
7612 # be specified.
7613 #
7614 # This field is used to perform number range search.
7615 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
7616 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
7617 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007618 # be specified.
7619 #
7620 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
7621 # `CASE_INSENSITIVE_MATCH`) search.
7622 # For filterable `string_values`, a maximum total number of 200 values
7623 # is allowed, with each `string_value` has a byte size of no more than
7624 # 255B. For unfilterable `string_values`, the maximum total byte size of
7625 # unfilterable `string_values` is 50KB.
7626 #
7627 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07007628 &quot;values&quot;: [ # Required. String values.
7629 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007630 ],
7631 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007632 },
7633 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007634 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
7635 #
7636 # Optional.
7637 #
7638 # A map of fields to hold filterable custom job attributes not captured by
7639 # the standard fields such as job_title, company_name, or
7640 # level. These custom fields store arbitrary
7641 # string values, and can be used for purposes not covered by
7642 # the structured fields. For the best search experience, use of the
7643 # structured rather than custom fields is recommended.
7644 #
7645 # Data stored in these custom fields fields are indexed and
7646 # searched against by keyword searches (see
7647 # SearchJobsRequest.custom_field_filters][]).
7648 #
7649 # The map key must be a number between 1-20. If an invalid key is
7650 # provided on job create or update, an error is returned.
7651 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
7652 &quot;values&quot;: [ # Optional. The values of the custom data.
7653 &quot;A String&quot;,
7654 ],
7655 },
7656 },
7657 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
7658 # any requirements for fluency that are associated with the job.
7659 #
7660 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
7661 # For more information, see
7662 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
7663 # class=&quot;external&quot; target=&quot;_blank&quot; }.
7664 #
7665 # If this field is unspecified and Job.description is present, detected
7666 # language code based on Job.description is assigned, otherwise
7667 # defaults to &#x27;en_US&#x27;.
7668 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
7669 # Defaults to JobVisibility.PRIVATE if not specified.
7670 # Currently only JobVisibility.PRIVATE is supported.
7671 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
7672 #
7673 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
7674 # of this field in job queries and API calls is preferred over the use of
7675 # requisition_id since this value is unique.
7676 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007677 # provided.
7678 #
7679 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07007680 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007681 # this field, and is the recommended field to use to identify companies.
7682 #
7683 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07007684 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
7685 # The value determines the sort order of the jobs returned when searching for
7686 # jobs using the featured jobs search call, with higher promotional values
7687 # being returned first and ties being resolved by relevance sort. Only the
7688 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
7689 #
7690 # Default value is 0, and negative values are treated as 0.
7691 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
7692 # value is the time the request arrives at the server.
7693 # and time zone are either specified elsewhere or are not significant. The date
7694 # is relative to the Proleptic Gregorian Calendar. This can represent:
7695 #
7696 # * A full date, with non-zero year, month and day values
7697 # * A month and day value, with a zero year, e.g. an anniversary
7698 # * A year on its own, with zero month and day values
7699 # * A year and month value, with a zero day, e.g. a credit card expiration date
7700 #
7701 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7702 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7703 # if specifying a year by itself or a year and month where the day is not
7704 # significant.
7705 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7706 # a year.
7707 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7708 # month and day.
7709 },
7710 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
7711 # application_email_list or application_instruction must be
7712 # specified.
7713 #
7714 # Use this URL field to direct an applicant to a website, for example to
7715 # link to an online application form.
7716 #
7717 # The maximum number of allowed characters is 2,000.
7718 &quot;A String&quot;,
7719 ],
7720 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
7721 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
7722 # client to identify a job. This field is intended to be used by clients
7723 # for client identification and tracking of listings. A job is not allowed
7724 # to be created if there is another job with the same requisition_id,
7725 # company_name and language_code.
7726 #
7727 # The maximum number of allowed characters is 255.
7728 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
7729 # job. The use of this field is recommended
7730 # as an alternative to using the more general description field.
7731 #
7732 # This field accepts and sanitizes HTML input, and also accepts
7733 # bold, italic, ordered list, and unordered list markup tags.
7734 #
7735 # The maximum number of allowed characters is 10,000.
7736 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
7737 # is used for contracting engagements.
7738 # Dates prior to 1970/1/1 and invalid date formats are ignored.
7739 # and time zone are either specified elsewhere or are not significant. The date
7740 # is relative to the Proleptic Gregorian Calendar. This can represent:
7741 #
7742 # * A full date, with non-zero year, month and day values
7743 # * A month and day value, with a zero year, e.g. an anniversary
7744 # * A year on its own, with zero month and day values
7745 # * A year and month value, with a zero day, e.g. a credit card expiration date
7746 #
7747 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7748 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7749 # if specifying a year by itself or a year and month where the day is not
7750 # significant.
7751 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7752 # a year.
7753 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7754 # month and day.
7755 },
7756 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
7757 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
7758 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
7759 # application_email_list or application_instruction must be
7760 # specified.
7761 #
7762 # Use this field to provide instructions, such as &quot;Mail your application
7763 # to ...&quot;, that a candidate can follow to apply for the job.
7764 #
7765 # This field accepts and sanitizes HTML input, and also accepts
7766 # bold, italic, ordered list, and unordered list markup tags.
7767 #
7768 # The maximum number of allowed characters is 3,000.
7769 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
7770 &quot;A String&quot;,
7771 ],
7772 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
7773 # incentives associated with the job not including salary or pay.
7774 #
7775 # The maximum number of allowed characters is 10,000.
7776 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
7777 # full time or
7778 # part time.
7779 &quot;A String&quot;,
7780 ],
7781 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
7782 #
7783 # Location(s) where the emploeyer is looking to hire for this job posting.
7784 #
7785 # Specifying the full street address(es) of the hiring location enables
7786 # better API results, especially job searches by commute time.
7787 #
7788 # At most 50 locations are allowed for best search performance. If a job has
7789 # more locations, it is suggested to split it into multiple jobs with unique
7790 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
7791 # multiple jobs with the same requisition_id, company_name and
7792 # language_code are not allowed. If the original requisition_id must
7793 # be preserved, a custom field should be used for storage. It is also
7794 # suggested to group the locations that close to each other in the same job
7795 # for better search experience.
7796 #
7797 # The maximum number of allowed characters is 500.
7798 &quot;A String&quot;,
7799 ],
7800 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
7801 #
7802 # Optional.
7803 #
7804 # Job compensation information.
7805 #
7806 # This field replaces compensation_info. Only
7807 # CompensationInfo.entries or extended_compensation_info can be set,
7808 # otherwise an exception is thrown.
7809 #
7810 # Describes job compensation.
7811 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
7812 # currency code.
7813 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
7814 #
7815 # Compensation range.
7816 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
7817 #
7818 # Decimal number.
7819 &quot;micros&quot;: 42, # Micro (10^-6) units.
7820 # The value must be between -999,999 and +999,999 inclusive.
7821 # If `units` is positive, `micros` must be positive or zero.
7822 # If `units` is zero, `micros` can be positive, zero, or negative.
7823 # If `units` is negative, `micros` must be negative or zero.
7824 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7825 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7826 },
7827 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
7828 #
7829 # Decimal number.
7830 &quot;micros&quot;: 42, # Micro (10^-6) units.
7831 # The value must be between -999,999 and +999,999 inclusive.
7832 # If `units` is positive, `micros` must be positive or zero.
7833 # If `units` is zero, `micros` can be positive, zero, or negative.
7834 # If `units` is negative, `micros` must be negative or zero.
7835 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7836 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7837 },
7838 },
7839 &quot;entries&quot;: [ # Optional. Job compensation information.
7840 #
7841 # At most one entry can be of type
7842 # ExtendedCompensationInfo.CompensationType.BASE, which is
7843 # referred as ** base compensation entry ** for the job.
7844 { # Deprecated. See CompensationInfo.
7845 #
7846 # A compensation entry that represents one component of compensation, such
7847 # as base pay, bonus, or other compensation type.
7848 #
7849 # Annualization: One compensation entry can be annualized if
7850 # - it contains valid amount or range.
7851 # - and its expected_units_per_year is set or can be derived.
7852 # Its annualized range is determined as (amount or range) times
7853 # expected_units_per_year.
7854 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
7855 #
7856 # Compensation range.
7857 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
7858 #
7859 # Decimal number.
7860 &quot;micros&quot;: 42, # Micro (10^-6) units.
7861 # The value must be between -999,999 and +999,999 inclusive.
7862 # If `units` is positive, `micros` must be positive or zero.
7863 # If `units` is zero, `micros` can be positive, zero, or negative.
7864 # If `units` is negative, `micros` must be negative or zero.
7865 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7866 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7867 },
7868 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
7869 #
7870 # Decimal number.
7871 &quot;micros&quot;: 42, # Micro (10^-6) units.
7872 # The value must be between -999,999 and +999,999 inclusive.
7873 # If `units` is positive, `micros` must be positive or zero.
7874 # If `units` is zero, `micros` can be positive, zero, or negative.
7875 # If `units` is negative, `micros` must be negative or zero.
7876 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7877 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7878 },
7879 },
7880 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
7881 # Job.employment_types is FULLTIME, a default value is inferred
7882 # based on unit. Default values:
7883 # - HOURLY: 2080
7884 # - DAILY: 260
7885 # - WEEKLY: 52
7886 # - MONTHLY: 12
7887 # - ANNUAL: 1
7888 #
7889 # Decimal number.
7890 &quot;micros&quot;: 42, # Micro (10^-6) units.
7891 # The value must be between -999,999 and +999,999 inclusive.
7892 # If `units` is positive, `micros` must be positive or zero.
7893 # If `units` is zero, `micros` can be positive, zero, or negative.
7894 # If `units` is negative, `micros` must be negative or zero.
7895 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7896 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7897 },
7898 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
7899 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
7900 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
7901 #
7902 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
7903 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
7904 #
7905 # Decimal number.
7906 &quot;micros&quot;: 42, # Micro (10^-6) units.
7907 # The value must be between -999,999 and +999,999 inclusive.
7908 # If `units` is positive, `micros` must be positive or zero.
7909 # If `units` is zero, `micros` can be positive, zero, or negative.
7910 # If `units` is negative, `micros` must be negative or zero.
7911 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7912 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7913 },
7914 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
7915 },
7916 ],
7917 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
7918 # the job&#x27;s all CompensationEntry cannot be annualized.
7919 # See CompensationEntry for explanation on annualization and base
7920 # compensation entry.
7921 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
7922 #
7923 # Compensation range.
7924 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
7925 #
7926 # Decimal number.
7927 &quot;micros&quot;: 42, # Micro (10^-6) units.
7928 # The value must be between -999,999 and +999,999 inclusive.
7929 # If `units` is positive, `micros` must be positive or zero.
7930 # If `units` is zero, `micros` can be positive, zero, or negative.
7931 # If `units` is negative, `micros` must be negative or zero.
7932 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7933 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7934 },
7935 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
7936 #
7937 # Decimal number.
7938 &quot;micros&quot;: 42, # Micro (10^-6) units.
7939 # The value must be between -999,999 and +999,999 inclusive.
7940 # If `units` is positive, `micros` must be positive or zero.
7941 # If `units` is zero, `micros` can be positive, zero, or negative.
7942 # If `units` is negative, `micros` must be negative or zero.
7943 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
7944 &quot;units&quot;: &quot;A String&quot;, # Whole units.
7945 },
7946 },
7947 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
7948 # the job&#x27;s base compensation entry cannot be annualized.
7949 # See CompensationEntry for explanation on annualization and base
7950 # compensation entry.
7951 },
7952 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
7953 # provided.
7954 #
7955 # The resource name of the company listing the job, such as
7956 # /companies/foo. This field takes precedence over the
7957 # distributor-assigned company identifier, distributor_company_id.
7958 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
7959 # description of the company and related information. Separate fields are
7960 # provided on the job object for responsibilities,
7961 # qualifications, and other job characteristics. Use of
7962 # these separate job fields is recommended.
7963 #
7964 # This field accepts and sanitizes HTML input, and also accepts
7965 # bold, italic, ordered list, and unordered list markup tags.
7966 #
7967 # The maximum number of allowed characters is 100,000.
7968 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
7969 # application_email_list or application_instruction must be
7970 # specified.
7971 #
7972 # Use this field to specify email address(es) to which resumes or
7973 # applications can be sent.
7974 #
7975 # The maximum number of allowed characters is 255.
7976 &quot;A String&quot;,
7977 ],
7978 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
7979 #
7980 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007981 },
Bu Sun Kim65020912020-05-20 12:08:20 -07007982 &quot;searchTextSnippet&quot;: &quot;A String&quot;, # Contains snippets of text from the Job.description and similar
7983 # fields that most closely match a search query&#x27;s keywords, if available.
7984 # All HTML tags in the original fields are stripped when returned in this
7985 # field, and matching query keywords are enclosed in HTML bold tags.
7986 &quot;jobTitleSnippet&quot;: &quot;A String&quot;, # Contains snippets of text from the Job.job_title field most
7987 # closely matching a search query&#x27;s keywords, if available. The matching
7988 # query keywords are enclosed in HTML bold tags.
7989 &quot;jobSummary&quot;: &quot;A String&quot;, # A summary of the job with core information that&#x27;s displayed on the search
7990 # results listing page.
7991 &quot;commuteInfo&quot;: { # Output only. # Commute information which is generated based on specified
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007992 # CommutePreference.
7993 #
7994 # Commute details related to this job.
Bu Sun Kim65020912020-05-20 12:08:20 -07007995 &quot;travelDuration&quot;: &quot;A String&quot;, # The number of seconds required to travel to the job location from the query
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007996 # location. A duration of 0 seconds indicates that the job is not
7997 # reachable within the requested duration, but was returned as part of an
7998 # expanded query.
Bu Sun Kim65020912020-05-20 12:08:20 -07007999 &quot;jobLocation&quot;: { # Output only. # Location used as the destination in the commute calculation.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008000 #
8001 # A resource that represents a location with full geographic
8002 # information.
Bu Sun Kim65020912020-05-20 12:08:20 -07008003 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008004 # such as postal delivery and payments addresses. Given a postal address,
8005 # a postal service can deliver items to a premises, P.O. Box, or other
8006 # delivery location.
8007 # Given a postal address, a postal service can deliver items to a premise, P.O.
8008 # Box or similar.
8009 # It is not intended to model geographical locations (roads, towns,
8010 # mountains).
8011 #
8012 # In typical usage an address would be created via user input or from importing
8013 # existing data, depending on the type of process.
8014 #
8015 # Advice on address input / editing:
8016 # - Use an i18n-ready address widget such as
Dan O'Mearadd494642020-05-01 07:42:23 -07008017 # https://github.com/google/libaddressinput)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008018 # - Users should not be presented with UI elements for input or editing of
8019 # fields outside countries where that field is used.
8020 #
8021 # For more guidance on how to use this schema, please see:
8022 # https://support.google.com/business/answer/6397478
Bu Sun Kim65020912020-05-20 12:08:20 -07008023 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
8024 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008025 # is never inferred and it is up to the user to ensure the value is
8026 # correct. See http://cldr.unicode.org/ and
8027 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
Bu Sun Kim65020912020-05-20 12:08:20 -07008028 # for details. Example: &quot;CH&quot; for Switzerland.
8029 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008030 #
8031 # Because values in address_lines do not have type information and may
8032 # sometimes contain multiple values in a single field (e.g.
Bu Sun Kim65020912020-05-20 12:08:20 -07008033 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
8034 # address lines should be &quot;envelope order&quot; for the country/region of the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008035 # address. In places where this can vary (e.g. Japan), address_language is
Bu Sun Kim65020912020-05-20 12:08:20 -07008036 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
8037 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008038 # an address can be selected based on the language.
8039 #
8040 # The minimum permitted structural representation of an address consists
8041 # of a region_code with all remaining information placed in the
8042 # address_lines. It would be possible to format such an address very
8043 # approximately without geocoding, but no semantic reasoning could be
8044 # made about any of the address components until it was at least
8045 # partially resolved.
8046 #
8047 # Creating an address only containing a region_code and address_lines, and
8048 # then geocoding is the recommended way to handle completely unstructured
8049 # addresses (as opposed to guessing which parts of the address should be
8050 # localities or administrative areas).
Bu Sun Kim65020912020-05-20 12:08:20 -07008051 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008052 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008053 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008054 # postal codes to be present, but where they are used, they may trigger
8055 # additional validation with other parts of the address (e.g. state/zip
8056 # validation in the U.S.A.).
Bu Sun Kim65020912020-05-20 12:08:20 -07008057 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
8058 # in most regions. Where it is used, the value is either a string like
8059 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
8060 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
8061 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
8062 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
8063 # known). This is often the UI language of the input form or is expected
8064 # to match one of the languages used in the address&#x27; country/region, or their
8065 # transliterated equivalents.
8066 # This can affect formatting in certain countries, but is not critical
8067 # to the correctness of the data and will never affect any validation or
8068 # other non-formatting related operations.
8069 #
8070 # If this value is not known, it should be omitted (rather than specifying a
8071 # possibly incorrect default).
8072 #
8073 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
8074 &quot;recipients&quot;: [ # Optional. The recipient at the address.
8075 # This field may, under certain circumstances, contain multiline information.
8076 # For example, it might contain &quot;care of&quot; information.
8077 &quot;A String&quot;,
8078 ],
8079 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008080 # For example, this can be neighborhoods, boroughs, districts.
Bu Sun Kim65020912020-05-20 12:08:20 -07008081 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008082 # the latest revision.
8083 #
8084 # All new revisions **must** be backward compatible with old revisions.
Bu Sun Kim65020912020-05-20 12:08:20 -07008085 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
8086 # addresses of a country or region.
8087 # For example, this can be a state, a province, an oblast, or a prefecture.
8088 # Specifically, for Spain this is the province and not the autonomous
8089 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
8090 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
8091 # in Switzerland this should be left unpopulated.
8092 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
8093 # Examples: US city, IT comune, UK post town.
8094 # In regions of the world where localities are not well defined or do not fit
8095 # into this structure well, leave locality empty and use address_lines.
8096 },
8097 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
8098 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
8099 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
8100 # LocationType#LOCALITY.
8101 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
8102 # location bounding box in which a circle with the specified radius
8103 # centered from LatLng coves the area associated with the job location.
8104 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
8105 # 7885.79 meters.
8106 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
8107 # of doubles representing degrees latitude and degrees longitude. Unless
8108 # specified otherwise, this must conform to the
8109 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8110 # standard&lt;/a&gt;. Values must be within normalized ranges.
8111 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8112 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008113 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008114 },
8115 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008116 },
8117 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008118 &quot;numJobsFromBroadenedQuery&quot;: 42, # If query broadening is enabled, we may append additional results from the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008119 # broadened query. This number indicates how many of the jobs returned in the
8120 # jobs field are from the broadened query. These results are always at the
8121 # end of the jobs list. In particular, a value of 0 means all the jobs in the
8122 # jobs list are from the original (without broadening) query. If this
8123 # field is non-zero, subsequent requests with offset after this result set
8124 # should contain all broadened results.
Bu Sun Kim65020912020-05-20 12:08:20 -07008125 &quot;appliedCommuteFilter&quot;: { # Input only. # The commute filter the service applied to the specified query. This
8126 # information is only available when query has a valid CommutePreference.
8127 #
8128 # Parameters needed for commute search.
8129 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
8130 # integer between 0 and 23, representing the hour in the time zone of the
8131 # start_location. Must not be present if road_traffic is specified.
8132 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
8133 # For city level addresses, the city center is used. For state and coarser
8134 # level addresses, text matching is used.
8135 # If this field is set to `false` or is not specified, only jobs that include
8136 # street level addresses will be returned by commute search.
8137 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
8138 # (one hour). Format is `123s`.
8139 &quot;startLocation&quot;: { # 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
8140 # commute time.
8141 # of doubles representing degrees latitude and degrees longitude. Unless
8142 # specified otherwise, this must conform to the
8143 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8144 # standard&lt;/a&gt;. Values must be within normalized ranges.
8145 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8146 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
8147 },
8148 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
8149 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
8150 # Must not be present if departure_hour_local is specified.
8151 },
8152 &quot;jobView&quot;: &quot;A String&quot;, # Corresponds to SearchJobsRequest.job_view.
8153 &quot;nextPageToken&quot;: &quot;A String&quot;, # The token that specifies the starting position of the next page of results.
8154 # This field is empty if there are no more results.
8155 &quot;estimatedTotalSize&quot;: &quot;A String&quot;, # An estimation of the number of jobs that match the specified query.
8156 #
8157 # This number is not guaranteed to be accurate. For accurate results,
8158 # seenenable_precise_result_size.
8159 &quot;appliedJobLocationFilters&quot;: [ # The location filters that the service applied to the specified query. If
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008160 # any filters are lat-lng based, the JobLocation.location_type is
8161 # JobLocation.LocationType#LOCATION_TYPE_UNSPECIFIED.
8162 { # Output only.
8163 #
8164 # A resource that represents a location with full geographic
8165 # information.
Bu Sun Kim65020912020-05-20 12:08:20 -07008166 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008167 # such as postal delivery and payments addresses. Given a postal address,
8168 # a postal service can deliver items to a premises, P.O. Box, or other
8169 # delivery location.
8170 # Given a postal address, a postal service can deliver items to a premise, P.O.
8171 # Box or similar.
8172 # It is not intended to model geographical locations (roads, towns,
8173 # mountains).
8174 #
8175 # In typical usage an address would be created via user input or from importing
8176 # existing data, depending on the type of process.
8177 #
8178 # Advice on address input / editing:
8179 # - Use an i18n-ready address widget such as
Dan O'Mearadd494642020-05-01 07:42:23 -07008180 # https://github.com/google/libaddressinput)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008181 # - Users should not be presented with UI elements for input or editing of
8182 # fields outside countries where that field is used.
8183 #
8184 # For more guidance on how to use this schema, please see:
8185 # https://support.google.com/business/answer/6397478
Bu Sun Kim65020912020-05-20 12:08:20 -07008186 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
8187 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008188 # is never inferred and it is up to the user to ensure the value is
8189 # correct. See http://cldr.unicode.org/ and
8190 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
Bu Sun Kim65020912020-05-20 12:08:20 -07008191 # for details. Example: &quot;CH&quot; for Switzerland.
8192 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008193 #
8194 # Because values in address_lines do not have type information and may
8195 # sometimes contain multiple values in a single field (e.g.
Bu Sun Kim65020912020-05-20 12:08:20 -07008196 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
8197 # address lines should be &quot;envelope order&quot; for the country/region of the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008198 # address. In places where this can vary (e.g. Japan), address_language is
Bu Sun Kim65020912020-05-20 12:08:20 -07008199 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
8200 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008201 # an address can be selected based on the language.
8202 #
8203 # The minimum permitted structural representation of an address consists
8204 # of a region_code with all remaining information placed in the
8205 # address_lines. It would be possible to format such an address very
8206 # approximately without geocoding, but no semantic reasoning could be
8207 # made about any of the address components until it was at least
8208 # partially resolved.
8209 #
8210 # Creating an address only containing a region_code and address_lines, and
8211 # then geocoding is the recommended way to handle completely unstructured
8212 # addresses (as opposed to guessing which parts of the address should be
8213 # localities or administrative areas).
Bu Sun Kim65020912020-05-20 12:08:20 -07008214 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008215 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008216 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008217 # postal codes to be present, but where they are used, they may trigger
8218 # additional validation with other parts of the address (e.g. state/zip
8219 # validation in the U.S.A.).
Bu Sun Kim65020912020-05-20 12:08:20 -07008220 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
8221 # in most regions. Where it is used, the value is either a string like
8222 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
8223 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
8224 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
8225 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
8226 # known). This is often the UI language of the input form or is expected
8227 # to match one of the languages used in the address&#x27; country/region, or their
8228 # transliterated equivalents.
8229 # This can affect formatting in certain countries, but is not critical
8230 # to the correctness of the data and will never affect any validation or
8231 # other non-formatting related operations.
8232 #
8233 # If this value is not known, it should be omitted (rather than specifying a
8234 # possibly incorrect default).
8235 #
8236 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
8237 &quot;recipients&quot;: [ # Optional. The recipient at the address.
8238 # This field may, under certain circumstances, contain multiline information.
8239 # For example, it might contain &quot;care of&quot; information.
8240 &quot;A String&quot;,
8241 ],
8242 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008243 # For example, this can be neighborhoods, boroughs, districts.
Bu Sun Kim65020912020-05-20 12:08:20 -07008244 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008245 # the latest revision.
8246 #
8247 # All new revisions **must** be backward compatible with old revisions.
Bu Sun Kim65020912020-05-20 12:08:20 -07008248 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
8249 # addresses of a country or region.
8250 # For example, this can be a state, a province, an oblast, or a prefecture.
8251 # Specifically, for Spain this is the province and not the autonomous
8252 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
8253 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
8254 # in Switzerland this should be left unpopulated.
8255 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
8256 # Examples: US city, IT comune, UK post town.
8257 # In regions of the world where localities are not well defined or do not fit
8258 # into this structure well, leave locality empty and use address_lines.
8259 },
8260 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
8261 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
8262 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
8263 # LocationType#LOCALITY.
8264 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
8265 # location bounding box in which a circle with the specified radius
8266 # centered from LatLng coves the area associated with the job location.
8267 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
8268 # 7885.79 meters.
8269 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
8270 # of doubles representing degrees latitude and degrees longitude. Unless
8271 # specified otherwise, this must conform to the
8272 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8273 # standard&lt;/a&gt;. Values must be within normalized ranges.
8274 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8275 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008276 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008277 },
8278 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008279 &quot;totalSize&quot;: &quot;A String&quot;, # The precise result count, which is available only if the client set
8280 # enable_precise_result_size to `true` or if the response
8281 # is the last page of results. Otherwise, the value will be `-1`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008282 }</pre>
8283</div>
8284
8285<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -07008286 <code class="details" id="searchForAlert">searchForAlert(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008287 <pre>Searches for jobs using the provided SearchJobsRequest.
8288
8289This API call is intended for the use case of targeting passive job
8290seekers (for example, job seekers who have signed up to receive email
8291alerts about potential job opportunities), and has different algorithmic
8292adjustments that are targeted to passive job seekers.
8293
8294This call constrains the visibility of jobs
8295present in the database, and only returns jobs the caller has
8296permission to search against.
8297
8298Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07008299 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008300 The object takes the form of:
8301
8302{ # Input only.
8303 #
8304 # The Request body of the `SearchJobs` call.
Bu Sun Kim65020912020-05-20 12:08:20 -07008305 &quot;mode&quot;: &quot;A String&quot;, # Required. Mode of a search.
8306 &quot;offset&quot;: 42, # Optional. An integer that specifies the current offset (that is, starting result
8307 # location, amongst the jobs deemed by the API as relevant) in search
8308 # results. This field is only considered if page_token is unset.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008309 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008310 # For example, 0 means to return results starting from the first matching
8311 # job, and 10 means to return from the 11th job. This can be used for
8312 # pagination, (for example, pageSize = 10 and offset = 10 means to return
8313 # from the second page).
8314 &quot;pageSize&quot;: 42, # Optional. A limit on the number of jobs returned in the search results.
8315 # Increasing this value above the default value of 10 can increase search
8316 # response time. The value can be between 1 and 100.
8317 &quot;query&quot;: { # Input only. # Optional. Query used to search against jobs, such as keyword, location filters, etc.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008318 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008319 # The query required to perform a search query or histogram.
8320 &quot;companyNames&quot;: [ # Optional. This filter specifies the company entities to search against.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008321 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008322 # If a value isn&#x27;t specified, jobs are searched for against all
8323 # companies.
8324 #
8325 # If multiple values are specified, jobs are searched against the
8326 # companies specified.
8327 #
8328 # At most 20 company filters are allowed.
8329 &quot;A String&quot;,
8330 ],
8331 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
8332 # search against, such as EmploymentType.FULL_TIME.
8333 #
8334 # If a value is not specified, jobs in the search results include any
8335 # employment type.
8336 #
8337 # If multiple values are specified, jobs in the search results include
8338 # any of the specified employment types.
8339 &quot;A String&quot;,
8340 ],
8341 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
8342 # See Category for more information.
8343 #
8344 # If a value is not specified, jobs from any category are searched against.
8345 #
8346 # If multiple values are specified, jobs from any of the specified
8347 # categories are searched against.
8348 &quot;A String&quot;,
8349 ],
8350 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
8351 # Job.custom_attributes marked as `filterable`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008352 #
8353 # The syntax for this expression is a subset of Google SQL syntax.
8354 #
Dan O'Mearadd494642020-05-01 07:42:23 -07008355 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008356 # is a custom field key and the right of the operator is a number or string
8357 # (surrounded by quotes) value.
8358 #
Dan O'Mearadd494642020-05-01 07:42:23 -07008359 # Supported functions are LOWER(&lt;field_name&gt;) to
8360 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008361 # existence of a key.
8362 #
8363 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
Bu Sun Kim65020912020-05-20 12:08:20 -07008364 # nesting (for example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), a maximum of 50
8365 # comparisons/functions are allowed in the expression. The expression
8366 # must be &lt; 2000 characters in length.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008367 #
8368 # Sample Query:
Bu Sun Kim65020912020-05-20 12:08:20 -07008369 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
8370 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
8371 # search against. See LocationFilter for more information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008372 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008373 # If a location value isn&#x27;t specified, jobs fitting the other search
8374 # criteria are retrieved regardless of where they&#x27;re located.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008375 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008376 # If multiple values are specified, jobs are retrieved from any of the
8377 # specified locations. If different values are specified for the
8378 # LocationFilter.distance_in_miles parameter, the maximum provided
8379 # distance is used for all locations.
8380 #
8381 # At most 5 location filters are allowed.
8382 { # Input only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008383 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008384 # Geographic region of the search.
8385 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
8386 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
8387 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
8388 #
8389 # Set this field if all the jobs to search against are from a same region,
8390 # or jobs are world-wide but the job seeker is from a specific region.
8391 #
8392 # See http://cldr.unicode.org/ and
8393 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
8394 # for details. Example: &quot;CH&quot; for Switzerland.
8395 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
8396 # identified as a city or smaller. When the location being searched for is a
8397 # state or larger, this field is ignored.
8398 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
8399 # set location, specifically, telecommuting jobs (telecomuting is considered
8400 # by the service as a special location.
8401 # Job.allow_telecommute indicates if a job permits telecommuting.
8402 # If this field is true, telecommuting jobs are searched, and
8403 # name and lat_lng are
8404 # ignored.
8405 # This filter can be used by itself to search exclusively for telecommuting
8406 # jobs, or it can be combined with another location
8407 # filter to search for a combination of job locations,
8408 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
8409 # combination with other location filters, telecommuting jobs can be
8410 # treated as less relevant than other jobs in the search response.
8411 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
8412 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
8413 # search. This field is ignored if `location_name` is provided.
8414 # of doubles representing degrees latitude and degrees longitude. Unless
8415 # specified otherwise, this must conform to the
8416 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8417 # standard&lt;/a&gt;. Values must be within normalized ranges.
8418 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8419 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
8420 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008421 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008422 ],
8423 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
8424 # against, for example, DateRange.PAST_MONTH. If a value isn&#x27;t
8425 # specified, all open jobs are searched against regardless of their
8426 # published date.
8427 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (for
8428 # example, driving or public transit). Note: This only works with COMMUTE
8429 # MODE. When specified, [JobQuery.location_filters] is
8430 # ignored.
8431 #
8432 # Currently we don&#x27;t support sorting by commute time.
8433 #
8434 # Parameters needed for commute search.
8435 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
8436 # integer between 0 and 23, representing the hour in the time zone of the
8437 # start_location. Must not be present if road_traffic is specified.
8438 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
8439 # For city level addresses, the city center is used. For state and coarser
8440 # level addresses, text matching is used.
8441 # If this field is set to `false` or is not specified, only jobs that include
8442 # street level addresses will be returned by commute search.
8443 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
8444 # (one hour). Format is `123s`.
8445 &quot;startLocation&quot;: { # 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
8446 # commute time.
8447 # of doubles representing degrees latitude and degrees longitude. Unless
8448 # specified otherwise, this must conform to the
8449 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8450 # standard&lt;/a&gt;. Values must be within normalized ranges.
8451 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8452 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
8453 },
8454 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
8455 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
8456 # Must not be present if departure_hour_local is specified.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008457 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008458 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
8459 # for example, &quot;en-US&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008460 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008461 # If a value isn&#x27;t specified, the search results can contain jobs in any
8462 # locale.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008463 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008464 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008465 # Language codes should be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
8466 # For more information, see
8467 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008468 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008469 # At most 10 language code filters are allowed.
8470 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008471 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008472 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
8473 # Job.compensation_info. For example, if the filter is specified
8474 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs meeting
8475 # these criteria are searched. If a filter isn&#x27;t defined, all open jobs
8476 # are searched.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008477 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008478 # Filter on job compensation type and amount.
8479 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
8480 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
8481 # CompensationInfo.CompensationUnit.
8482 &quot;A String&quot;,
8483 ],
8484 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
8485 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
8486 # to zero and the currency code is set to match the
8487 # currency code of max_compensation.
8488 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
8489 # The value must be between -999,999,999 and +999,999,999 inclusive.
8490 # If `units` is positive, `nanos` must be positive or zero.
8491 # If `units` is zero, `nanos` can be positive, zero, or negative.
8492 # If `units` is negative, `nanos` must be negative or zero.
8493 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
8494 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
8495 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
8496 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
8497 },
8498 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
8499 # to a maximal compensation value and the currency code is set to
8500 # match the currency code of
8501 # min_compensation.
8502 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
8503 # The value must be between -999,999,999 and +999,999,999 inclusive.
8504 # If `units` is positive, `nanos` must be positive or zero.
8505 # If `units` is zero, `nanos` can be positive, zero, or negative.
8506 # If `units` is negative, `nanos` must be negative or zero.
8507 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
8508 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
8509 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
8510 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
8511 },
8512 },
8513 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
8514 },
8515 &quot;query&quot;: &quot;A String&quot;, # Optional. The query string that matches against the job title, description, and
8516 # location fields.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008517 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008518 # The maximum query size is 255 bytes.
8519 &quot;companyDisplayNames&quot;: [ # Optional. This filter specifies the exact company display
8520 # name of the jobs to search against.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008521 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008522 # If a value isn&#x27;t specified, jobs within the search results are
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008523 # associated with any company.
8524 #
8525 # If multiple values are specified, jobs within the search results may be
8526 # associated with any of the specified companies.
8527 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008528 # At most 20 company display name filters are allowed.
8529 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008530 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008531 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
8532 # service attempts to correct a misspelled query,
8533 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008534 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008535 # Defaults to false: a spell check is performed.
8536 },
8537 &quot;disableRelevanceThresholding&quot;: True or False, # Optional. Controls whether to disable relevance thresholding. Relevance
8538 # thresholding removes jobs that have low relevance in search results,
8539 # for example, removing &quot;Assistant to the CEO&quot; positions from the search
8540 # results of a search for &quot;CEO&quot;.
8541 #
8542 # Disabling relevance thresholding improves the accuracy of subsequent
8543 # search requests.
8544 #
8545 # Defaults to false.
8546 &quot;enablePreciseResultSize&quot;: True or False, # Optional. Controls if the search job request requires the return of a precise
8547 # count of the first 300 results. Setting this to `true` ensures
8548 # consistency in the number of results per page. Best practice is to set this
8549 # value to true if a client allows users to jump directly to a
8550 # non-sequential search results page.
8551 #
8552 # Enabling this flag may adversely impact performance.
8553 #
8554 # Defaults to false.
8555 &quot;histogramFacets&quot;: { # Input only. # Optional. Restrictions on what fields to perform histogram on, such as
8556 # `COMPANY_SIZE` etc.
8557 #
8558 # Histogram facets to be specified in SearchJobsRequest.
8559 &quot;compensationHistogramFacets&quot;: [ # Optional. Specifies compensation field-based histogram requests.
8560 # Duplicate values of CompensationHistogramRequest.type are not allowed.
8561 { # Input only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008562 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008563 # Compensation based histogram request.
8564 &quot;bucketingOption&quot;: { # Input only. # Required. Numeric histogram options, like buckets, whether include min or max value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008565 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008566 # Use this field to specify bucketing option for the histogram search response.
8567 &quot;requiresMinMax&quot;: True or False, # Optional. If set to true, the histogram result includes minimum/maximum
8568 # value of the numeric field.
8569 &quot;bucketBounds&quot;: [ # Required. Two adjacent values form a histogram bucket. Values should be in
8570 # ascending order. For example, if [5, 10, 15] are provided, four buckets are
8571 # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
8572 # [buckets_bound is supported.
8573 3.14,
8574 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008575 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008576 &quot;type&quot;: &quot;A String&quot;, # Required. Type of the request, representing which field the histogramming should be
8577 # performed over. A single request can only specify one histogram of each
8578 # `CompensationHistogramRequestType`.
8579 },
8580 ],
8581 &quot;customAttributeHistogramFacets&quot;: [ # Optional. Specifies the custom attributes histogram requests.
8582 # Duplicate values of CustomAttributeHistogramRequest.key are not
8583 # allowed.
8584 { # Custom attributes histogram request. An error will be thrown if neither
8585 # string_value_histogram or long_value_histogram_bucketing_option has
8586 # been defined.
8587 &quot;stringValueHistogram&quot;: True or False, # Optional. If set to true, the response will include the histogram value for
8588 # each key as a string.
8589 &quot;longValueHistogramBucketingOption&quot;: { # Input only. # Optional. Specifies buckets used to perform a range histogram on Job&#x27;s
8590 # filterable long custom field values, or min/max value requirements.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008591 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008592 # Use this field to specify bucketing option for the histogram search response.
8593 &quot;requiresMinMax&quot;: True or False, # Optional. If set to true, the histogram result includes minimum/maximum
8594 # value of the numeric field.
8595 &quot;bucketBounds&quot;: [ # Required. Two adjacent values form a histogram bucket. Values should be in
8596 # ascending order. For example, if [5, 10, 15] are provided, four buckets are
8597 # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
8598 # [buckets_bound is supported.
8599 3.14,
8600 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008601 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008602 &quot;key&quot;: &quot;A String&quot;, # Required. Specifies the custom field key to perform a histogram on. If specified
8603 # without `long_value_histogram_bucketing_option`, histogram on string values
8604 # of the given `key` is triggered, otherwise histogram is performed on long
8605 # values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008606 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008607 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008608 &quot;simpleHistogramFacets&quot;: [ # Optional. Specifies the simple type of histogram facets, for example,
8609 # `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc. This field is equivalent to
8610 # GetHistogramRequest.
8611 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008612 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008613 },
8614 &quot;orderBy&quot;: &quot;A String&quot;, # Deprecated. Use sort_by instead.
8615 #
8616 # Optional.
8617 #
8618 # The criteria determining how search results are sorted.
8619 # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
8620 &quot;jobView&quot;: &quot;A String&quot;, # Optional. The number of job attributes returned for jobs in the
8621 # search response. Defaults to JobView.SMALL if no value is specified.
8622 &quot;pageToken&quot;: &quot;A String&quot;, # Optional. The token specifying the current offset within
8623 # search results. See SearchJobsResponse.next_page_token for
8624 # an explanation of how to obtain the next set of query results.
8625 &quot;filters&quot;: { # Input only. # Deprecated. Use query instead.
8626 #
8627 # Optional.
8628 #
8629 # Restrictions on the scope of the search request, such as filtering
8630 # by location.
8631 #
8632 # Deprecated. Use JobQuery instead.
8633 #
8634 # The filters required to perform a search query or histogram.
8635 &quot;locationFilters&quot;: [ # Optional. The location filter specifies geo-regions containing the jobs to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008636 # search against. See LocationFilter for more information.
8637 #
8638 # If a location value is not specified, jobs are retrieved
8639 # from all locations.
8640 #
8641 # If multiple values are specified, jobs are retrieved from any of the
8642 # specified locations. If different values are specified for the
8643 # LocationFilter.distance_in_miles parameter, the maximum provided
8644 # distance is used for all locations.
8645 #
8646 # At most 5 location filters are allowed.
8647 { # Input only.
8648 #
8649 # Geographic region of the search.
Bu Sun Kim65020912020-05-20 12:08:20 -07008650 &quot;regionCode&quot;: &quot;A String&quot;, # Optional. CLDR region code of the country/region of the address. This will be used
8651 # to address ambiguity of the user-input location, e.g. &quot;Liverpool&quot;
8652 # against &quot;Liverpool, NY, US&quot; or &quot;Liverpool, UK&quot;.
8653 #
8654 # Set this field if all the jobs to search against are from a same region,
8655 # or jobs are world-wide but the job seeker is from a specific region.
8656 #
8657 # See http://cldr.unicode.org/ and
8658 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
8659 # for details. Example: &quot;CH&quot; for Switzerland.
8660 &quot;distanceInMiles&quot;: 3.14, # Optional. The distance_in_miles is applied when the location being searched for is
8661 # identified as a city or smaller. When the location being searched for is a
8662 # state or larger, this field is ignored.
8663 &quot;isTelecommute&quot;: True or False, # Optional. Allows the client to return jobs without a
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008664 # set location, specifically, telecommuting jobs (telecomuting is considered
8665 # by the service as a special location.
8666 # Job.allow_telecommute indicates if a job permits telecommuting.
8667 # If this field is true, telecommuting jobs are searched, and
8668 # name and lat_lng are
8669 # ignored.
8670 # This filter can be used by itself to search exclusively for telecommuting
8671 # jobs, or it can be combined with another location
8672 # filter to search for a combination of job locations,
Bu Sun Kim65020912020-05-20 12:08:20 -07008673 # such as &quot;Mountain View&quot; or &quot;telecommuting&quot; jobs. However, when used in
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008674 # combination with other location filters, telecommuting jobs can be
8675 # treated as less relevant than other jobs in the search response.
Bu Sun Kim65020912020-05-20 12:08:20 -07008676 &quot;name&quot;: &quot;A String&quot;, # Optional. The address name, such as &quot;Mountain View&quot; or &quot;Bay Area&quot;.
8677 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # Optional. The latitude and longitude of the geographic center from which to
Dan O'Mearadd494642020-05-01 07:42:23 -07008678 # search. This field is ignored if `location_name` is provided.
8679 # of doubles representing degrees latitude and degrees longitude. Unless
8680 # specified otherwise, this must conform to the
Bu Sun Kim65020912020-05-20 12:08:20 -07008681 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
Dan O'Mearadd494642020-05-01 07:42:23 -07008682 # standard&lt;/a&gt;. Values must be within normalized ranges.
Bu Sun Kim65020912020-05-20 12:08:20 -07008683 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8684 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Dan O'Mearadd494642020-05-01 07:42:23 -07008685 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008686 },
8687 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008688 &quot;publishDateRange&quot;: &quot;A String&quot;, # Optional. Jobs published within a range specified by this filter are searched
8689 # against, for example, DateRange.PAST_MONTH. If a value is not
8690 # specified, all open jobs are searched against regardless of the
8691 # date they were published.
8692 &quot;commuteFilter&quot;: { # Input only. # Optional. Allows filtering jobs by commute time with different travel methods (e.g.
8693 # driving or public transit). Note: this only works with COMMUTE
8694 # MODE. When specified, [JobFilters.location_filters] will be
8695 # ignored.
8696 #
8697 # Currently we do not support sorting by commute time.
8698 #
8699 # Parameters needed for commute search.
8700 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
8701 # integer between 0 and 23, representing the hour in the time zone of the
8702 # start_location. Must not be present if road_traffic is specified.
8703 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
8704 # For city level addresses, the city center is used. For state and coarser
8705 # level addresses, text matching is used.
8706 # If this field is set to `false` or is not specified, only jobs that include
8707 # street level addresses will be returned by commute search.
8708 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
8709 # (one hour). Format is `123s`.
8710 &quot;startLocation&quot;: { # 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
8711 # commute time.
8712 # of doubles representing degrees latitude and degrees longitude. Unless
8713 # specified otherwise, this must conform to the
8714 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
8715 # standard&lt;/a&gt;. Values must be within normalized ranges.
8716 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
8717 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
8718 },
8719 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
8720 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
8721 # Must not be present if departure_hour_local is specified.
8722 },
8723 &quot;languageCodes&quot;: [ # Optional. This filter specifies the locale of jobs to search against,
8724 # for example, &quot;en-US&quot;.
8725 #
8726 # If a value is not specified, the search results may contain jobs in any
8727 # locale.
8728 #
8729 #
8730 # Language codes should be in BCP-47 format, for example, &quot;en-US&quot; or
8731 # &quot;sr-Latn&quot;. For more information, see [Tags for Identifying
8732 # Languages](https://tools.ietf.org/html/bcp47).
8733 #
8734 # At most 10 language code filters are allowed.
8735 &quot;A String&quot;,
8736 ],
8737 &quot;companyTitles&quot;: [ # Optional. This filter specifies the exact company titles
8738 # of jobs to search against.
8739 #
8740 # If a value is not specified, jobs within the search results can be
8741 # associated with any company.
8742 #
8743 # If multiple values are specified, jobs within the search results may be
8744 # associated with any of the specified companies.
8745 #
8746 # At most 20 company title filters are allowed.
8747 &quot;A String&quot;,
8748 ],
8749 &quot;compensationFilter&quot;: { # Input only. # Optional. This search filter is applied only to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008750 # Job.compensation_info. For example, if the filter is specified
Bu Sun Kim65020912020-05-20 12:08:20 -07008751 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008752 # this criteria are searched. If a filter is not defined, all open jobs
8753 # are searched.
8754 #
8755 # Filter on job compensation type and amount.
Bu Sun Kim65020912020-05-20 12:08:20 -07008756 &quot;includeJobsWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
8757 &quot;units&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008758 # CompensationInfo.CompensationUnit.
Bu Sun Kim65020912020-05-20 12:08:20 -07008759 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008760 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07008761 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
8762 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
8763 # to zero and the currency code is set to match the
8764 # currency code of max_compensation.
8765 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
8766 # The value must be between -999,999,999 and +999,999,999 inclusive.
8767 # If `units` is positive, `nanos` must be positive or zero.
8768 # If `units` is zero, `nanos` can be positive, zero, or negative.
8769 # If `units` is negative, `nanos` must be negative or zero.
8770 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
8771 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
8772 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
8773 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
8774 },
8775 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008776 # to a maximal compensation value and the currency code is set to
8777 # match the currency code of
8778 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07008779 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008780 # The value must be between -999,999,999 and +999,999,999 inclusive.
8781 # If `units` is positive, `nanos` must be positive or zero.
8782 # If `units` is zero, `nanos` can be positive, zero, or negative.
8783 # If `units` is negative, `nanos` must be negative or zero.
8784 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07008785 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
8786 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
8787 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008788 },
8789 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008790 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008791 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008792 &quot;query&quot;: &quot;A String&quot;, # Optional. The query filter contains the keywords that match against the job
8793 # title, description, and location fields.
Dan O'Mearadd494642020-05-01 07:42:23 -07008794 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008795 # The maximum query size is 255 bytes/characters.
8796 &quot;extendedCompensationFilter&quot;: { # Deprecated. Always use CompensationFilter. # Deprecated. Always use compensation_filter.
8797 #
8798 # Optional.
8799 #
8800 # This search filter is applied only to
8801 # Job.extended_compensation_info. For example, if the filter is specified
8802 # as &quot;Hourly job with per-hour compensation &gt; $15&quot;, only jobs that meet
8803 # these criteria are searched. If a filter is not defined, all open jobs
8804 # are searched.
8805 #
8806 # Input only.
8807 #
8808 # Filter on job compensation type and amount.
8809 &quot;includeJobWithUnspecifiedCompensationRange&quot;: True or False, # Optional. Whether to include jobs whose compensation range is unspecified.
8810 &quot;compensationUnits&quot;: [ # Required. Specify desired `base compensation entry&#x27;s`
8811 # ExtendedCompensationInfo.CompensationUnit.
8812 &quot;A String&quot;,
8813 ],
8814 &quot;type&quot;: &quot;A String&quot;, # Required. Type of filter.
8815 &quot;currency&quot;: &quot;A String&quot;, # Optional. Specify currency in 3-letter
8816 # [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) format. If
8817 # unspecified, jobs are returned regardless of currency.
8818 &quot;compensationRange&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
8819 #
8820 # Compensation range.
8821 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
8822 #
8823 # Decimal number.
8824 &quot;micros&quot;: 42, # Micro (10^-6) units.
8825 # The value must be between -999,999 and +999,999 inclusive.
8826 # If `units` is positive, `micros` must be positive or zero.
8827 # If `units` is zero, `micros` can be positive, zero, or negative.
8828 # If `units` is negative, `micros` must be negative or zero.
8829 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
8830 &quot;units&quot;: &quot;A String&quot;, # Whole units.
8831 },
8832 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
8833 #
8834 # Decimal number.
8835 &quot;micros&quot;: 42, # Micro (10^-6) units.
8836 # The value must be between -999,999 and +999,999 inclusive.
8837 # If `units` is positive, `micros` must be positive or zero.
8838 # If `units` is zero, `micros` can be positive, zero, or negative.
8839 # If `units` is negative, `micros` must be negative or zero.
8840 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
8841 &quot;units&quot;: &quot;A String&quot;, # Whole units.
8842 },
8843 },
Dan O'Mearadd494642020-05-01 07:42:23 -07008844 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008845 &quot;disableSpellCheck&quot;: True or False, # Optional. This flag controls the spell-check feature. If false, the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008846 # service attempts to correct a misspelled query,
Bu Sun Kim65020912020-05-20 12:08:20 -07008847 # for example, &quot;enginee&quot; is corrected to &quot;engineer&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008848 #
8849 # Defaults to false: a spell check is performed.
Bu Sun Kim65020912020-05-20 12:08:20 -07008850 &quot;customFieldFilters&quot;: { # Deprecated. Use custom_attribute_filter instead.
8851 #
8852 # Optional.
8853 #
8854 # This filter specifies searching against
8855 # custom field values. See Job.filterable_custom_fields for information.
8856 # The key value specifies a number between 1-20 (the service
8857 # supports 20 custom fields) corresponding to the desired custom field map
8858 # value. If an invalid key is provided or specified together with
8859 # custom_attribute_filter, an error is thrown.
8860 &quot;a_key&quot;: { # Input only.
8861 #
8862 # Custom field filter of the search.
8863 &quot;type&quot;: &quot;A String&quot;, # Optional. The type of filter.
8864 # Defaults to FilterType.OR.
8865 &quot;queries&quot;: [ # Required. The query strings for the filter.
8866 &quot;A String&quot;,
8867 ],
8868 },
8869 },
8870 &quot;companyNames&quot;: [ # Optional. The company names filter specifies the company entities to search
8871 # against.
8872 #
8873 # If a value is not specified, jobs are searched for against all companies.
8874 #
8875 # If multiple values are specified, jobs are searched against the
8876 # specified companies.
8877 #
8878 # At most 20 company filters are allowed.
8879 &quot;A String&quot;,
8880 ],
8881 &quot;tenantJobOnly&quot;: True or False, # Deprecated. Do not use this field.
8882 #
8883 # This flag controls whether the job search should be restricted to jobs
8884 # owned by the current user.
8885 #
8886 # Defaults to false where all jobs accessible to the
8887 # user are searched against.
8888 &quot;employmentTypes&quot;: [ # Optional. The employment type filter specifies the employment type of jobs to
8889 # search against, such as EmploymentType.FULL_TIME.
8890 #
8891 # If a value is not specified, jobs in the search results include any
8892 # employment type.
8893 #
8894 # If multiple values are specified, jobs in the search results include any
8895 # of the specified employment types.
8896 &quot;A String&quot;,
8897 ],
8898 &quot;categories&quot;: [ # Optional. The category filter specifies the categories of jobs to search against.
8899 # See Category for more information.
8900 #
8901 # If a value is not specified, jobs from any category are searched against.
8902 #
8903 # If multiple values are specified, jobs from any of the specified
8904 # categories are searched against.
8905 &quot;A String&quot;,
8906 ],
8907 &quot;customAttributeFilter&quot;: &quot;A String&quot;, # Optional. This filter specifies a structured syntax to match against the
8908 # Job.custom_attributes that are marked as `filterable`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008909 #
8910 # The syntax for this expression is a subset of Google SQL syntax.
8911 #
Dan O'Mearadd494642020-05-01 07:42:23 -07008912 # Supported operators are: =, !=, &lt;, &lt;=, &gt;, &gt;= where the left of the operator
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008913 # is a custom field key and the right of the operator is a number or string
8914 # (surrounded by quotes) value.
8915 #
Dan O'Mearadd494642020-05-01 07:42:23 -07008916 # Supported functions are LOWER(&lt;field_name&gt;) to
8917 # perform case insensitive match and EMPTY(&lt;field_name&gt;) to filter on the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008918 # existence of a key.
8919 #
8920 # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
Bu Sun Kim65020912020-05-20 12:08:20 -07008921 # nesting (For example, &quot;((A AND B AND C) OR NOT D) AND E&quot;), and there can
8922 # be a maximum of 100 comparisons/functions in the expression. The expression
8923 # must be &lt; 3000 bytes in length.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008924 #
8925 # Sample Query:
Bu Sun Kim65020912020-05-20 12:08:20 -07008926 # (key1 = &quot;TEST&quot; OR LOWER(key1)=&quot;test&quot; OR NOT EMPTY(key1)) AND key2 &gt; 100
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008927 },
Bu Sun Kim65020912020-05-20 12:08:20 -07008928 &quot;sortBy&quot;: &quot;A String&quot;, # Optional. The criteria determining how search results are sorted.
Dan O'Mearadd494642020-05-01 07:42:23 -07008929 # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
Bu Sun Kim65020912020-05-20 12:08:20 -07008930 &quot;requestMetadata&quot;: { # Input only. # Required. The meta information collected about the job searcher, used to improve the
8931 # search quality of the service. The identifiers, (such as `user_id`) are
8932 # provided by users, and must be unique and consistent.
8933 #
8934 # Meta information related to the job searcher or entity
8935 # conducting the job search. This information is used to improve the
8936 # performance of the service.
8937 &quot;sessionId&quot;: &quot;A String&quot;, # Required. A unique session identification string. A session is defined as the
8938 # duration of an end user&#x27;s interaction with the service over a period.
8939 # Obfuscate this field for privacy concerns before
8940 # providing it to the API.
8941 #
8942 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
8943 # that any improvements to the service model for a particular tenant site,
8944 # rely on this field being set correctly to some unique session_id.
8945 &quot;domain&quot;: &quot;A String&quot;, # Required. The client-defined scope or source of the service call, which typically
8946 # is the domain on
8947 # which the service has been implemented and is currently being run.
8948 #
8949 # For example, if the service is being run by client &lt;em&gt;Foo, Inc.&lt;/em&gt;, on
8950 # job board www.foo.com and career site www.bar.com, then this field is
8951 # set to &quot;foo.com&quot; for use on the job board, and &quot;bar.com&quot; for use on the
8952 # career site.
8953 #
8954 # If this field is not available for some reason, send &quot;UNKNOWN&quot;. Note that
8955 # any improvements to the service model for a particular tenant site rely on
8956 # this field being set correctly to some domain.
8957 &quot;userId&quot;: &quot;A String&quot;, # Required. A unique user identification string, as determined by the client. The
8958 # client is responsible for ensuring client-level uniqueness of this value
8959 # in order to have the strongest positive impact on search quality.
8960 # Obfuscate this field for privacy concerns before
8961 # providing it to the service.
8962 #
8963 # If this field is not available for some reason, please send &quot;UNKNOWN&quot;. Note
8964 # that any improvements to the service model for a particular tenant site,
8965 # rely on this field being set correctly to some unique user_id.
8966 &quot;deviceInfo&quot;: { # Input only. # Optional. The type of device used by the job seeker at the time of the call to the
8967 # service.
8968 #
8969 # Device information collected from the job seeker, candidate, or
8970 # other entity conducting the job search. Providing this information improves
8971 # the quality of the search results across devices.
8972 &quot;deviceType&quot;: &quot;A String&quot;, # Optional. Type of the device.
8973 &quot;id&quot;: &quot;A String&quot;, # Optional. A device-specific ID. The ID must be a unique identifier that distinguishes
8974 # the device from other devices.
8975 },
8976 },
8977 &quot;enableBroadening&quot;: True or False, # Optional. Controls whether to broaden the search when it produces sparse results.
8978 # Broadened queries append results to the end of the matching results
8979 # list.
8980 #
8981 # Defaults to false.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008982 }
8983
8984 x__xgafv: string, V1 error format.
8985 Allowed values
8986 1 - v1 error format
8987 2 - v2 error format
8988
8989Returns:
8990 An object of the form:
8991
8992 { # Output only.
8993 #
8994 # Response for SearchJob method.
Bu Sun Kim65020912020-05-20 12:08:20 -07008995 &quot;histogramResults&quot;: { # Output only. # The histogram results that match specified
8996 # SearchJobsRequest.HistogramFacets.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07008997 #
Bu Sun Kim65020912020-05-20 12:08:20 -07008998 # Histogram results that matches HistogramFacets specified in
8999 # SearchJobsRequest.
9000 &quot;compensationHistogramResults&quot;: [ # Specifies compensation field-based histogram results that matches
9001 # HistogramFacets.compensation_histogram_requests.
9002 { # Output only.
9003 #
9004 # Compensation based histogram result.
9005 &quot;result&quot;: { # Output only. # Histogram result.
9006 #
9007 # Custom numeric bucketing result.
9008 &quot;counts&quot;: [ # Count within each bucket. Its size is the length of
9009 # NumericBucketingOption.bucket_bounds plus 1.
9010 { # Represents count of jobs within one bucket.
9011 &quot;count&quot;: 42, # Number of jobs whose numeric field value fall into `range`.
9012 &quot;range&quot;: { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
9013 # that is, the count represents number of jobs in this range.
9014 &quot;to&quot;: 3.14, # Ending value of the bucket range.
9015 &quot;from&quot;: 3.14, # Starting value of the bucket range.
9016 },
9017 },
9018 ],
9019 &quot;minValue&quot;: 3.14, # Stores the minimum value of the numeric field. Will be populated only if
9020 # [NumericBucketingOption.requires_min_max] is set to true.
9021 &quot;maxValue&quot;: 3.14, # Stores the maximum value of the numeric field. Will be populated only if
9022 # [NumericBucketingOption.requires_min_max] is set to true.
9023 },
9024 &quot;type&quot;: &quot;A String&quot;, # Type of the request, corresponding to
9025 # CompensationHistogramRequest.type.
9026 },
9027 ],
9028 &quot;customAttributeHistogramResults&quot;: [ # Specifies histogram results for custom attributes that
9029 # matches HistogramFacets.custom_attribute_histogram_facets.
9030 { # Output only.
9031 #
9032 # Custom attribute histogram result.
9033 &quot;key&quot;: &quot;A String&quot;, # Stores the key of custom attribute the histogram is performed on.
9034 &quot;longValueHistogramResult&quot;: { # Output only. # Stores bucketed histogram counting result or min/max values for
9035 # custom attribute long values associated with `key`.
9036 #
9037 # Custom numeric bucketing result.
9038 &quot;counts&quot;: [ # Count within each bucket. Its size is the length of
9039 # NumericBucketingOption.bucket_bounds plus 1.
9040 { # Represents count of jobs within one bucket.
9041 &quot;count&quot;: 42, # Number of jobs whose numeric field value fall into `range`.
9042 &quot;range&quot;: { # Represents starting and ending value of a range in double. # Bucket range on which histogram was performed for the numeric field,
9043 # that is, the count represents number of jobs in this range.
9044 &quot;to&quot;: 3.14, # Ending value of the bucket range.
9045 &quot;from&quot;: 3.14, # Starting value of the bucket range.
9046 },
9047 },
9048 ],
9049 &quot;minValue&quot;: 3.14, # Stores the minimum value of the numeric field. Will be populated only if
9050 # [NumericBucketingOption.requires_min_max] is set to true.
9051 &quot;maxValue&quot;: 3.14, # Stores the maximum value of the numeric field. Will be populated only if
9052 # [NumericBucketingOption.requires_min_max] is set to true.
9053 },
9054 &quot;stringValueHistogramResult&quot;: { # Stores a map from the values of string custom field associated
9055 # with `key` to the number of jobs with that value in this histogram result.
9056 &quot;a_key&quot;: 42,
9057 },
9058 },
9059 ],
9060 &quot;simpleHistogramResults&quot;: [ # Specifies histogram results that matches
9061 # HistogramFacets.simple_histogram_facets.
9062 { # Output only.
9063 #
9064 # Result of a histogram call. The response contains the histogram map for the
9065 # search type specified by HistogramResult.field.
9066 # The response is a map of each filter value to the corresponding count of
9067 # jobs for that filter.
9068 &quot;values&quot;: { # A map from the values of field to the number of jobs with that value
9069 # in this search result.
9070 #
9071 # Key: search type (filter names, such as the companyName).
9072 #
9073 # Values: the count of jobs that match the filter for this search.
9074 &quot;a_key&quot;: 42,
9075 },
9076 &quot;searchType&quot;: &quot;A String&quot;, # The Histogram search filters.
9077 },
9078 ],
9079 },
9080 &quot;spellResult&quot;: { # Output only. # The spell checking result, and correction.
9081 #
9082 # Spell check result.
9083 &quot;corrected&quot;: True or False, # Indicates if the query was corrected by the spell checker.
9084 &quot;correctedText&quot;: &quot;A String&quot;, # Correction output consisting of the corrected keyword string.
9085 },
9086 &quot;metadata&quot;: { # Output only. # Additional information for the API invocation, such as the request
9087 # tracking id.
9088 #
9089 # Additional information returned to client, such as debugging
9090 # information.
9091 &quot;requestId&quot;: &quot;A String&quot;, # A unique id associated with this call.
9092 # This id is logged for tracking purposes.
9093 &quot;mode&quot;: &quot;A String&quot;, # For search response only. Indicates the mode of a performed search.
9094 &quot;experimentIdList&quot;: [ # Identifiers for the versions of the search algorithm used during
9095 # this API invocation if multiple algorithms are used.
9096 # The default value is empty.
9097 # For search response only.
9098 42,
9099 ],
9100 },
9101 &quot;matchingJobs&quot;: [ # The Job entities that match the specified SearchJobsRequest.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009102 { # Output only.
9103 #
9104 # Job entry with metadata inside SearchJobsResponse.
Bu Sun Kim65020912020-05-20 12:08:20 -07009105 &quot;job&quot;: { # A Job resource represents a job posting (also referred to as a &quot;job listing&quot; # Job resource that matches the specified SearchJobsRequest.
9106 # or &quot;job requisition&quot;). A job belongs to a Company, which is the hiring
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009107 # entity responsible for the job.
Bu Sun Kim65020912020-05-20 12:08:20 -07009108 &quot;region&quot;: &quot;A String&quot;, # Optional. The job Region (for example, state, country) throughout which the job
9109 # is available. If this field is set, a
9110 # LocationFilter in a search query within the job region
9111 # finds this job if an exact location match is not specified.
9112 # If this field is set, setting job locations
9113 # to the same location level as this field is strongly recommended.
9114 &quot;referenceUrl&quot;: &quot;A String&quot;, # Output only. The URL of a web page that displays job details.
9115 &quot;companyTitle&quot;: &quot;A String&quot;, # Deprecated. Use company_display_name instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009116 #
Bu Sun Kim65020912020-05-20 12:08:20 -07009117 # Output only.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009118 #
Bu Sun Kim65020912020-05-20 12:08:20 -07009119 # The name of the company listing the job.
9120 &quot;compensationInfo&quot;: { # Job compensation details. # Optional. Job compensation information.
9121 &quot;annualizedBaseCompensationRange&quot;: { # Compensation range. # Output only. Annualized base compensation range. Computed as
9122 # base compensation entry&#x27;s CompensationEntry.compensation times
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009123 # CompensationEntry.expected_units_per_year.
9124 #
9125 # See CompensationEntry for explanation on compensation annualization.
Bu Sun Kim65020912020-05-20 12:08:20 -07009126 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
9127 # to zero and the currency code is set to match the
9128 # currency code of max_compensation.
9129 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9130 # The value must be between -999,999,999 and +999,999,999 inclusive.
9131 # If `units` is positive, `nanos` must be positive or zero.
9132 # If `units` is zero, `nanos` can be positive, zero, or negative.
9133 # If `units` is negative, `nanos` must be negative or zero.
9134 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9135 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9136 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9137 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9138 },
9139 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009140 # to a maximal compensation value and the currency code is set to
9141 # match the currency code of
9142 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07009143 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009144 # The value must be between -999,999,999 and +999,999,999 inclusive.
9145 # If `units` is positive, `nanos` must be positive or zero.
9146 # If `units` is zero, `nanos` can be positive, zero, or negative.
9147 # If `units` is negative, `nanos` must be negative or zero.
9148 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07009149 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9150 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9151 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009152 },
9153 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009154 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009155 #
9156 # Optional.
9157 #
9158 # The amount of compensation or pay for the job.
9159 # As an alternative, compensation_amount_min and
9160 # compensation_amount_max may be used to define a range of
9161 # compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07009162 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009163 # The value must be between -999,999,999 and +999,999,999 inclusive.
9164 # If `units` is positive, `nanos` must be positive or zero.
9165 # If `units` is zero, `nanos` can be positive, zero, or negative.
9166 # If `units` is negative, `nanos` must be negative or zero.
9167 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07009168 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9169 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9170 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009171 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009172 &quot;type&quot;: &quot;A String&quot;, # Deprecated. Use entries instead.
9173 #
9174 # Optional.
9175 #
9176 # Type of job compensation.
9177 &quot;max&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
9178 #
9179 # Optional.
9180 #
9181 # An upper bound on a range for compensation or pay for the job.
9182 # The currency type is specified in compensation_amount.
9183 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9184 # The value must be between -999,999,999 and +999,999,999 inclusive.
9185 # If `units` is positive, `nanos` must be positive or zero.
9186 # If `units` is zero, `nanos` can be positive, zero, or negative.
9187 # If `units` is negative, `nanos` must be negative or zero.
9188 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9189 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9190 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9191 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9192 },
9193 &quot;annualizedTotalCompensationRange&quot;: { # Compensation range. # Output only. Annualized total compensation range. Computed as
9194 # all compensation entries&#x27; CompensationEntry.compensation times
9195 # CompensationEntry.expected_units_per_year.
9196 #
9197 # See CompensationEntry for explanation on compensation annualization.
9198 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
9199 # to zero and the currency code is set to match the
9200 # currency code of max_compensation.
9201 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9202 # The value must be between -999,999,999 and +999,999,999 inclusive.
9203 # If `units` is positive, `nanos` must be positive or zero.
9204 # If `units` is zero, `nanos` can be positive, zero, or negative.
9205 # If `units` is negative, `nanos` must be negative or zero.
9206 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9207 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9208 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9209 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9210 },
9211 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
9212 # to a maximal compensation value and the currency code is set to
9213 # match the currency code of
9214 # min_compensation.
9215 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9216 # The value must be between -999,999,999 and +999,999,999 inclusive.
9217 # If `units` is positive, `nanos` must be positive or zero.
9218 # If `units` is zero, `nanos` can be positive, zero, or negative.
9219 # If `units` is negative, `nanos` must be negative or zero.
9220 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9221 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9222 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9223 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9224 },
9225 },
9226 &quot;min&quot;: { # Represents an amount of money with its currency type. # Deprecated. Use entries instead.
9227 #
9228 # Optional.
9229 #
9230 # A lower bound on a range for compensation or pay for the job.
9231 # The currency type is specified in compensation_amount.
9232 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9233 # The value must be between -999,999,999 and +999,999,999 inclusive.
9234 # If `units` is positive, `nanos` must be positive or zero.
9235 # If `units` is zero, `nanos` can be positive, zero, or negative.
9236 # If `units` is negative, `nanos` must be negative or zero.
9237 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9238 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9239 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9240 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9241 },
9242 &quot;entries&quot;: [ # Optional. Job compensation information.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009243 #
9244 # At most one entry can be of type
9245 # CompensationInfo.CompensationType.BASE, which is
9246 # referred as ** base compensation entry ** for the job.
9247 { # A compensation entry that represents one component of compensation, such
9248 # as base pay, bonus, or other compensation type.
9249 #
9250 # Annualization: One compensation entry can be annualized if
9251 # - it contains valid amount or range.
9252 # - and its expected_units_per_year is set or can be derived.
9253 # Its annualized range is determined as (amount or range) times
9254 # expected_units_per_year.
Bu Sun Kim65020912020-05-20 12:08:20 -07009255 &quot;range&quot;: { # Compensation range. # Optional. Compensation range.
9256 &quot;min&quot;: { # Represents an amount of money with its currency type. # Optional. The minimum amount of compensation. If left empty, the value is set
9257 # to zero and the currency code is set to match the
9258 # currency code of max_compensation.
9259 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
9260 # The value must be between -999,999,999 and +999,999,999 inclusive.
9261 # If `units` is positive, `nanos` must be positive or zero.
9262 # If `units` is zero, `nanos` can be positive, zero, or negative.
9263 # If `units` is negative, `nanos` must be negative or zero.
9264 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
9265 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9266 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9267 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
9268 },
9269 &quot;max&quot;: { # Represents an amount of money with its currency type. # Optional. The maximum amount of compensation. If left empty, the value is set
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009270 # to a maximal compensation value and the currency code is set to
9271 # match the currency code of
9272 # min_compensation.
Bu Sun Kim65020912020-05-20 12:08:20 -07009273 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009274 # The value must be between -999,999,999 and +999,999,999 inclusive.
9275 # If `units` is positive, `nanos` must be positive or zero.
9276 # If `units` is zero, `nanos` can be positive, zero, or negative.
9277 # If `units` is negative, `nanos` must be negative or zero.
9278 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07009279 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9280 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9281 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009282 },
9283 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009284 &quot;expectedUnitsPerYear&quot;: 3.14, # Optional. Expected number of units paid each year. If not specified, when
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009285 # Job.employment_types is FULLTIME, a default value is inferred
9286 # based on unit. Default values:
9287 # - HOURLY: 2080
9288 # - DAILY: 260
9289 # - WEEKLY: 52
9290 # - MONTHLY: 12
9291 # - ANNUAL: 1
Bu Sun Kim65020912020-05-20 12:08:20 -07009292 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description. For example, could
9293 # indicate equity terms or provide additional context to an estimated
9294 # bonus.
9295 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
9296 #
9297 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
9298 &quot;amount&quot;: { # Represents an amount of money with its currency type. # Optional. Compensation amount.
9299 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009300 # The value must be between -999,999,999 and +999,999,999 inclusive.
9301 # If `units` is positive, `nanos` must be positive or zero.
9302 # If `units` is zero, `nanos` can be positive, zero, or negative.
9303 # If `units` is negative, `nanos` must be negative or zero.
9304 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07009305 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
9306 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
9307 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009308 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009309 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009310 },
9311 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009312 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009313 &quot;responsibilities&quot;: &quot;A String&quot;, # Optional. A description of job responsibilities. The use of this field is
9314 # recommended as an alternative to using the more general description
9315 # field.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009316 #
9317 # This field accepts and sanitizes HTML input, and also accepts
9318 # bold, italic, ordered list, and unordered list markup tags.
9319 #
9320 # The maximum number of allowed characters is 10,000.
Bu Sun Kim65020912020-05-20 12:08:20 -07009321 &quot;expireTime&quot;: &quot;A String&quot;, # Optional but strongly recommended for the best service
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009322 # experience.
9323 #
9324 # The expiration timestamp of the job. After this timestamp, the
9325 # job is marked as expired, and it no longer appears in search results. The
Bu Sun Kim65020912020-05-20 12:08:20 -07009326 # expired job can&#x27;t be deleted or listed by the DeleteJob and
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009327 # ListJobs APIs, but it can be retrieved with the GetJob API or
9328 # updated with the UpdateJob API. An expired job can be updated and
9329 # opened again by using a future expiration timestamp. Updating an expired
9330 # job fails if there is another existing open job with same
9331 # requisition_id, company_name and language_code.
9332 #
9333 # The expired jobs are retained in our system for 90 days. However, the
9334 # overall expired job count cannot exceed 3 times the maximum of open jobs
9335 # count over the past week, otherwise jobs with earlier expire time are
9336 # cleaned first. Expired jobs are no longer accessible after they are cleaned
9337 # out.
9338 # The format of this field is RFC 3339 date strings. Example:
9339 # 2000-01-01T00:00:00.999999999Z
9340 # See
9341 # [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
9342 #
9343 # A valid date range is between 1970-01-01T00:00:00.0Z and
9344 # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
9345 # time not provided.
9346 #
9347 # If this value is not provided at the time of job creation or is invalid,
Bu Sun Kim65020912020-05-20 12:08:20 -07009348 # the job posting expires after 30 days from the job&#x27;s creation time. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009349 # example, if the job was created on 2017/01/01 13:00AM UTC with an
9350 # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
9351 #
9352 # If this value is not provided but expiry_date is, expiry_date is
9353 # used.
9354 #
9355 # If this value is not provided on job update, it depends on the field masks
9356 # set by UpdateJobRequest.update_job_fields. If the field masks include
9357 # expiry_time, or the masks are empty meaning that every field is
Bu Sun Kim65020912020-05-20 12:08:20 -07009358 # updated, the job posting expires after 30 days from the job&#x27;s last
9359 # update time. Otherwise the expiration date isn&#x27;t updated.
9360 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was last updated.
9361 &quot;jobLocations&quot;: [ # Output only. Structured locations of the job, resolved from locations.
9362 { # Output only.
9363 #
9364 # A resource that represents a location with full geographic
9365 # information.
9366 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
9367 # such as postal delivery and payments addresses. Given a postal address,
9368 # a postal service can deliver items to a premises, P.O. Box, or other
9369 # delivery location.
9370 # Given a postal address, a postal service can deliver items to a premise, P.O.
9371 # Box or similar.
9372 # It is not intended to model geographical locations (roads, towns,
9373 # mountains).
9374 #
9375 # In typical usage an address would be created via user input or from importing
9376 # existing data, depending on the type of process.
9377 #
9378 # Advice on address input / editing:
9379 # - Use an i18n-ready address widget such as
9380 # https://github.com/google/libaddressinput)
9381 # - Users should not be presented with UI elements for input or editing of
9382 # fields outside countries where that field is used.
9383 #
9384 # For more guidance on how to use this schema, please see:
9385 # https://support.google.com/business/answer/6397478
9386 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
9387 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
9388 # is never inferred and it is up to the user to ensure the value is
9389 # correct. See http://cldr.unicode.org/ and
9390 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
9391 # for details. Example: &quot;CH&quot; for Switzerland.
9392 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
9393 #
9394 # Because values in address_lines do not have type information and may
9395 # sometimes contain multiple values in a single field (e.g.
9396 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
9397 # address lines should be &quot;envelope order&quot; for the country/region of the
9398 # address. In places where this can vary (e.g. Japan), address_language is
9399 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
9400 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
9401 # an address can be selected based on the language.
9402 #
9403 # The minimum permitted structural representation of an address consists
9404 # of a region_code with all remaining information placed in the
9405 # address_lines. It would be possible to format such an address very
9406 # approximately without geocoding, but no semantic reasoning could be
9407 # made about any of the address components until it was at least
9408 # partially resolved.
9409 #
9410 # Creating an address only containing a region_code and address_lines, and
9411 # then geocoding is the recommended way to handle completely unstructured
9412 # addresses (as opposed to guessing which parts of the address should be
9413 # localities or administrative areas).
9414 &quot;A String&quot;,
9415 ],
9416 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
9417 # postal codes to be present, but where they are used, they may trigger
9418 # additional validation with other parts of the address (e.g. state/zip
9419 # validation in the U.S.A.).
9420 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
9421 # in most regions. Where it is used, the value is either a string like
9422 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
9423 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
9424 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
9425 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
9426 # known). This is often the UI language of the input form or is expected
9427 # to match one of the languages used in the address&#x27; country/region, or their
9428 # transliterated equivalents.
9429 # This can affect formatting in certain countries, but is not critical
9430 # to the correctness of the data and will never affect any validation or
9431 # other non-formatting related operations.
9432 #
9433 # If this value is not known, it should be omitted (rather than specifying a
9434 # possibly incorrect default).
9435 #
9436 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
9437 &quot;recipients&quot;: [ # Optional. The recipient at the address.
9438 # This field may, under certain circumstances, contain multiline information.
9439 # For example, it might contain &quot;care of&quot; information.
9440 &quot;A String&quot;,
9441 ],
9442 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
9443 # For example, this can be neighborhoods, boroughs, districts.
9444 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
9445 # the latest revision.
9446 #
9447 # All new revisions **must** be backward compatible with old revisions.
9448 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
9449 # addresses of a country or region.
9450 # For example, this can be a state, a province, an oblast, or a prefecture.
9451 # Specifically, for Spain this is the province and not the autonomous
9452 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
9453 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
9454 # in Switzerland this should be left unpopulated.
9455 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
9456 # Examples: US city, IT comune, UK post town.
9457 # In regions of the world where localities are not well defined or do not fit
9458 # into this structure well, leave locality empty and use address_lines.
9459 },
9460 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
9461 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
9462 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
9463 # LocationType#LOCALITY.
9464 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
9465 # location bounding box in which a circle with the specified radius
9466 # centered from LatLng coves the area associated with the job location.
9467 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
9468 # 7885.79 meters.
9469 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
9470 # of doubles representing degrees latitude and degrees longitude. Unless
9471 # specified otherwise, this must conform to the
9472 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
9473 # standard&lt;/a&gt;. Values must be within normalized ranges.
9474 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
9475 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
9476 },
9477 },
9478 ],
9479 &quot;department&quot;: &quot;A String&quot;, # Optional. The department or functional area within the company with the open
9480 # position.
9481 #
9482 # The maximum number of allowed characters is 255.
9483 &quot;unindexedCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
9484 #
9485 # Optional.
9486 #
9487 # A map of fields to hold non-filterable custom job attributes, similar to
9488 # filterable_custom_fields. These fields are distinct in that the data
9489 # in these fields are not indexed. Therefore, the client cannot search
9490 # against them, nor can the client use them to list jobs.
9491 #
9492 # The key of the map can be any valid string.
9493 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
9494 &quot;values&quot;: [ # Optional. The values of the custom data.
9495 &quot;A String&quot;,
9496 ],
9497 },
9498 },
9499 &quot;expiryDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Deprecated. Use expire_time instead.
9500 #
9501 # Optional but strongly recommended to be provided for the best service
9502 # experience.
9503 #
9504 # The expiration date of the job in UTC time. After 12 am on this date, the
9505 # job is marked as expired, and it no longer appears in search results.
9506 # The expired job can&#x27;t be deleted or listed by the DeleteJob and
9507 # ListJobs APIs, but it can be retrieved with the GetJob API or
9508 # updated with the UpdateJob API. An expired job can be updated and
9509 # opened again by using a future expiration date. It can also remain expired.
9510 # Updating an expired job to be open fails if there is another existing open
9511 # job with same requisition_id, company_name and language_code.
9512 #
9513 # The expired jobs are retained in our system for 90 days. However, the
9514 # overall expired job count cannot exceed 3 times the maximum of open jobs
9515 # count over the past week, otherwise jobs with earlier expire time are
9516 # removed first. Expired jobs are no longer accessible after they are cleaned
9517 # out.
9518 #
9519 # A valid date range is between 1970/1/1 and 2100/12/31. Invalid dates are
9520 # ignored and treated as expiry date not provided.
9521 #
9522 # If this value is not provided on job creation or is invalid, the job
9523 # posting expires after 30 days from the job&#x27;s creation time. For example, if
9524 # the job was created on 2017/01/01 13:00AM UTC with an unspecified
9525 # expiration date, the job expires after 2017/01/31 13:00AM UTC.
9526 #
9527 # If this value is not provided on job update, it depends on the field masks
9528 # set by UpdateJobRequest.update_job_fields. If the field masks include
9529 # expiry_date, or the masks are empty meaning that every field is
9530 # updated, the job expires after 30 days from the job&#x27;s last update time.
9531 # Otherwise the expiration date isn&#x27;t updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009532 # and time zone are either specified elsewhere or are not significant. The date
9533 # is relative to the Proleptic Gregorian Calendar. This can represent:
9534 #
9535 # * A full date, with non-zero year, month and day values
9536 # * A month and day value, with a zero year, e.g. an anniversary
9537 # * A year on its own, with zero month and day values
9538 # * A year and month value, with a zero day, e.g. a credit card expiration date
9539 #
9540 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07009541 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009542 # if specifying a year by itself or a year and month where the day is not
9543 # significant.
Bu Sun Kim65020912020-05-20 12:08:20 -07009544 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009545 # a year.
Bu Sun Kim65020912020-05-20 12:08:20 -07009546 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9547 # month and day.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009548 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009549 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The end date of the job in UTC time zone. Typically this field
9550 # is used for contracting engagements.
9551 # Dates prior to 1970/1/1 and invalid date formats are ignored.
9552 # and time zone are either specified elsewhere or are not significant. The date
9553 # is relative to the Proleptic Gregorian Calendar. This can represent:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009554 #
Bu Sun Kim65020912020-05-20 12:08:20 -07009555 # * A full date, with non-zero year, month and day values
9556 # * A month and day value, with a zero year, e.g. an anniversary
9557 # * A year on its own, with zero month and day values
9558 # * A year and month value, with a zero day, e.g. a credit card expiration date
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009559 #
Bu Sun Kim65020912020-05-20 12:08:20 -07009560 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9561 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9562 # if specifying a year by itself or a year and month where the day is not
9563 # significant.
9564 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9565 # a year.
9566 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9567 # month and day.
9568 },
9569 &quot;educationLevels&quot;: [ # Optional. The desired education level for the job, such as
9570 # &quot;Bachelors&quot;, &quot;Masters&quot;, &quot;Doctorate&quot;.
9571 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009572 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07009573 &quot;customAttributes&quot;: { # Optional. A map of fields to hold both filterable and non-filterable custom job
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009574 # attributes that are not covered by the provided structured fields.
9575 #
9576 # This field is a more general combination of the deprecated id-based
9577 # filterable_custom_fields and string-based
9578 # non_filterable_custom_fields.
9579 #
9580 # The keys of the map are strings up to 64 bytes and must match the
9581 # pattern: a-zA-Z*.
9582 #
9583 # At most 100 filterable and at most 100 unfilterable keys are supported.
9584 # For filterable `string_values`, across all keys at most 200 values are
9585 # allowed, with each string no more than 255 characters. For unfilterable
9586 # `string_values`, the maximum total size of `string_values` across all keys
9587 # is 50KB.
Bu Sun Kim65020912020-05-20 12:08:20 -07009588 &quot;a_key&quot;: { # Custom attribute values that are either filterable or non-filterable.
9589 &quot;filterable&quot;: True or False, # Optional. If the `filterable` flag is true, custom field values are searchable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009590 # If false, values are not searchable.
9591 #
9592 # Default is false.
Bu Sun Kim65020912020-05-20 12:08:20 -07009593 &quot;longValue&quot;: &quot;A String&quot;, # Optional but at least one of string_values or long_value must
9594 # be specified.
9595 #
9596 # This field is used to perform number range search.
9597 # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. For
9598 # `long_value`, a value between Long.MIN and Long.MAX is allowed.
9599 &quot;stringValues&quot;: { # Represents array of string values. # Optional but at least one of string_values or long_value must
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009600 # be specified.
9601 #
9602 # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
9603 # `CASE_INSENSITIVE_MATCH`) search.
9604 # For filterable `string_values`, a maximum total number of 200 values
9605 # is allowed, with each `string_value` has a byte size of no more than
9606 # 255B. For unfilterable `string_values`, the maximum total byte size of
9607 # unfilterable `string_values` is 50KB.
9608 #
9609 # Empty strings are not allowed.
Bu Sun Kim65020912020-05-20 12:08:20 -07009610 &quot;values&quot;: [ # Required. String values.
9611 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009612 ],
9613 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009614 },
9615 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009616 &quot;filterableCustomFields&quot;: { # Deprecated. Use custom_attributes instead.
9617 #
9618 # Optional.
9619 #
9620 # A map of fields to hold filterable custom job attributes not captured by
9621 # the standard fields such as job_title, company_name, or
9622 # level. These custom fields store arbitrary
9623 # string values, and can be used for purposes not covered by
9624 # the structured fields. For the best search experience, use of the
9625 # structured rather than custom fields is recommended.
9626 #
9627 # Data stored in these custom fields fields are indexed and
9628 # searched against by keyword searches (see
9629 # SearchJobsRequest.custom_field_filters][]).
9630 #
9631 # The map key must be a number between 1-20. If an invalid key is
9632 # provided on job create or update, an error is returned.
9633 &quot;a_key&quot;: { # Resource that represents the custom data not captured by the standard fields.
9634 &quot;values&quot;: [ # Optional. The values of the custom data.
9635 &quot;A String&quot;,
9636 ],
9637 },
9638 },
9639 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the posting. This field is distinct from
9640 # any requirements for fluency that are associated with the job.
9641 #
9642 # Language codes must be in BCP-47 format, such as &quot;en-US&quot; or &quot;sr-Latn&quot;.
9643 # For more information, see
9644 # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
9645 # class=&quot;external&quot; target=&quot;_blank&quot; }.
9646 #
9647 # If this field is unspecified and Job.description is present, detected
9648 # language code based on Job.description is assigned, otherwise
9649 # defaults to &#x27;en_US&#x27;.
9650 &quot;visibility&quot;: &quot;A String&quot;, # Optional. The visibility of the job.
9651 # Defaults to JobVisibility.PRIVATE if not specified.
9652 # Currently only JobVisibility.PRIVATE is supported.
9653 &quot;name&quot;: &quot;A String&quot;, # Required during job update.
9654 #
9655 # Resource name assigned to a job by the API, for example, &quot;/jobs/foo&quot;. Use
9656 # of this field in job queries and API calls is preferred over the use of
9657 # requisition_id since this value is unique.
9658 &quot;distributorCompanyId&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009659 # provided.
9660 #
9661 # A unique company identifier used by job distributors to identify an
Bu Sun Kim65020912020-05-20 12:08:20 -07009662 # employer&#x27;s company entity. company_name takes precedence over
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009663 # this field, and is the recommended field to use to identify companies.
9664 #
9665 # The maximum number of allowed characters is 255.
Bu Sun Kim65020912020-05-20 12:08:20 -07009666 &quot;promotionValue&quot;: 42, # Optional. A promotion value of the job, as determined by the client.
9667 # The value determines the sort order of the jobs returned when searching for
9668 # jobs using the featured jobs search call, with higher promotional values
9669 # being returned first and ties being resolved by relevance sort. Only the
9670 # jobs with a promotionValue &gt;0 are returned in a FEATURED_JOB_SEARCH.
9671 #
9672 # Default value is 0, and negative values are treated as 0.
9673 &quot;publishDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The date this job was most recently published in UTC format. The default
9674 # value is the time the request arrives at the server.
9675 # and time zone are either specified elsewhere or are not significant. The date
9676 # is relative to the Proleptic Gregorian Calendar. This can represent:
9677 #
9678 # * A full date, with non-zero year, month and day values
9679 # * A month and day value, with a zero year, e.g. an anniversary
9680 # * A year on its own, with zero month and day values
9681 # * A year and month value, with a zero day, e.g. a credit card expiration date
9682 #
9683 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9684 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9685 # if specifying a year by itself or a year and month where the day is not
9686 # significant.
9687 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9688 # a year.
9689 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9690 # month and day.
9691 },
9692 &quot;applicationUrls&quot;: [ # Optional but at least one of application_urls,
9693 # application_email_list or application_instruction must be
9694 # specified.
9695 #
9696 # Use this URL field to direct an applicant to a website, for example to
9697 # link to an online application form.
9698 #
9699 # The maximum number of allowed characters is 2,000.
9700 &quot;A String&quot;,
9701 ],
9702 &quot;companyDisplayName&quot;: &quot;A String&quot;, # Output only. The name of the company listing the job.
9703 &quot;requisitionId&quot;: &quot;A String&quot;, # Required. The requisition ID, also referred to as the posting ID, assigned by the
9704 # client to identify a job. This field is intended to be used by clients
9705 # for client identification and tracking of listings. A job is not allowed
9706 # to be created if there is another job with the same requisition_id,
9707 # company_name and language_code.
9708 #
9709 # The maximum number of allowed characters is 255.
9710 &quot;qualifications&quot;: &quot;A String&quot;, # Optional. A description of the qualifications required to perform the
9711 # job. The use of this field is recommended
9712 # as an alternative to using the more general description field.
9713 #
9714 # This field accepts and sanitizes HTML input, and also accepts
9715 # bold, italic, ordered list, and unordered list markup tags.
9716 #
9717 # The maximum number of allowed characters is 10,000.
9718 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # Optional. The start date of the job in UTC time zone. Typically this field
9719 # is used for contracting engagements.
9720 # Dates prior to 1970/1/1 and invalid date formats are ignored.
9721 # and time zone are either specified elsewhere or are not significant. The date
9722 # is relative to the Proleptic Gregorian Calendar. This can represent:
9723 #
9724 # * A full date, with non-zero year, month and day values
9725 # * A month and day value, with a zero year, e.g. an anniversary
9726 # * A year on its own, with zero month and day values
9727 # * A year and month value, with a zero day, e.g. a credit card expiration date
9728 #
9729 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9730 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9731 # if specifying a year by itself or a year and month where the day is not
9732 # significant.
9733 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9734 # a year.
9735 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9736 # month and day.
9737 },
9738 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this job was created.
9739 &quot;level&quot;: &quot;A String&quot;, # Optional. The experience level associated with the job, such as &quot;Entry Level&quot;.
9740 &quot;applicationInstruction&quot;: &quot;A String&quot;, # Optional but at least one of application_urls,
9741 # application_email_list or application_instruction must be
9742 # specified.
9743 #
9744 # Use this field to provide instructions, such as &quot;Mail your application
9745 # to ...&quot;, that a candidate can follow to apply for the job.
9746 #
9747 # This field accepts and sanitizes HTML input, and also accepts
9748 # bold, italic, ordered list, and unordered list markup tags.
9749 #
9750 # The maximum number of allowed characters is 3,000.
9751 &quot;benefits&quot;: [ # Optional. The benefits included with the job.
9752 &quot;A String&quot;,
9753 ],
9754 &quot;incentives&quot;: &quot;A String&quot;, # Optional. A description of bonus, commission, and other compensation
9755 # incentives associated with the job not including salary or pay.
9756 #
9757 # The maximum number of allowed characters is 10,000.
9758 &quot;employmentTypes&quot;: [ # Optional. The employment type(s) of a job, for example,
9759 # full time or
9760 # part time.
9761 &quot;A String&quot;,
9762 ],
9763 &quot;locations&quot;: [ # Optional but strongly recommended for the best service experience.
9764 #
9765 # Location(s) where the emploeyer is looking to hire for this job posting.
9766 #
9767 # Specifying the full street address(es) of the hiring location enables
9768 # better API results, especially job searches by commute time.
9769 #
9770 # At most 50 locations are allowed for best search performance. If a job has
9771 # more locations, it is suggested to split it into multiple jobs with unique
9772 # requisition_ids (e.g. &#x27;ReqA&#x27; becomes &#x27;ReqA-1&#x27;, &#x27;ReqA-2&#x27;, etc.) as
9773 # multiple jobs with the same requisition_id, company_name and
9774 # language_code are not allowed. If the original requisition_id must
9775 # be preserved, a custom field should be used for storage. It is also
9776 # suggested to group the locations that close to each other in the same job
9777 # for better search experience.
9778 #
9779 # The maximum number of allowed characters is 500.
9780 &quot;A String&quot;,
9781 ],
9782 &quot;extendedCompensationInfo&quot;: { # Deprecated. Use CompensationInfo. # Deprecated. Always use compensation_info.
9783 #
9784 # Optional.
9785 #
9786 # Job compensation information.
9787 #
9788 # This field replaces compensation_info. Only
9789 # CompensationInfo.entries or extended_compensation_info can be set,
9790 # otherwise an exception is thrown.
9791 #
9792 # Describes job compensation.
9793 &quot;currency&quot;: &quot;A String&quot;, # Optional. A 3-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)
9794 # currency code.
9795 &quot;annualizedTotalCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized total compensation range.
9796 #
9797 # Compensation range.
9798 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
9799 #
9800 # Decimal number.
9801 &quot;micros&quot;: 42, # Micro (10^-6) units.
9802 # The value must be between -999,999 and +999,999 inclusive.
9803 # If `units` is positive, `micros` must be positive or zero.
9804 # If `units` is zero, `micros` can be positive, zero, or negative.
9805 # If `units` is negative, `micros` must be negative or zero.
9806 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9807 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9808 },
9809 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
9810 #
9811 # Decimal number.
9812 &quot;micros&quot;: 42, # Micro (10^-6) units.
9813 # The value must be between -999,999 and +999,999 inclusive.
9814 # If `units` is positive, `micros` must be positive or zero.
9815 # If `units` is zero, `micros` can be positive, zero, or negative.
9816 # If `units` is negative, `micros` must be negative or zero.
9817 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9818 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9819 },
9820 },
9821 &quot;entries&quot;: [ # Optional. Job compensation information.
9822 #
9823 # At most one entry can be of type
9824 # ExtendedCompensationInfo.CompensationType.BASE, which is
9825 # referred as ** base compensation entry ** for the job.
9826 { # Deprecated. See CompensationInfo.
9827 #
9828 # A compensation entry that represents one component of compensation, such
9829 # as base pay, bonus, or other compensation type.
9830 #
9831 # Annualization: One compensation entry can be annualized if
9832 # - it contains valid amount or range.
9833 # - and its expected_units_per_year is set or can be derived.
9834 # Its annualized range is determined as (amount or range) times
9835 # expected_units_per_year.
9836 &quot;range&quot;: { # Deprecated. See CompensationInfo. # Optional. Compensation range.
9837 #
9838 # Compensation range.
9839 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
9840 #
9841 # Decimal number.
9842 &quot;micros&quot;: 42, # Micro (10^-6) units.
9843 # The value must be between -999,999 and +999,999 inclusive.
9844 # If `units` is positive, `micros` must be positive or zero.
9845 # If `units` is zero, `micros` can be positive, zero, or negative.
9846 # If `units` is negative, `micros` must be negative or zero.
9847 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9848 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9849 },
9850 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
9851 #
9852 # Decimal number.
9853 &quot;micros&quot;: 42, # Micro (10^-6) units.
9854 # The value must be between -999,999 and +999,999 inclusive.
9855 # If `units` is positive, `micros` must be positive or zero.
9856 # If `units` is zero, `micros` can be positive, zero, or negative.
9857 # If `units` is negative, `micros` must be negative or zero.
9858 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9859 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9860 },
9861 },
9862 &quot;expectedUnitsPerYear&quot;: { # Deprecated. See CompensationInfo. # Optional. Expected number of units paid each year. If not specified, when
9863 # Job.employment_types is FULLTIME, a default value is inferred
9864 # based on unit. Default values:
9865 # - HOURLY: 2080
9866 # - DAILY: 260
9867 # - WEEKLY: 52
9868 # - MONTHLY: 12
9869 # - ANNUAL: 1
9870 #
9871 # Decimal number.
9872 &quot;micros&quot;: 42, # Micro (10^-6) units.
9873 # The value must be between -999,999 and +999,999 inclusive.
9874 # If `units` is positive, `micros` must be positive or zero.
9875 # If `units` is zero, `micros` can be positive, zero, or negative.
9876 # If `units` is negative, `micros` must be negative or zero.
9877 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9878 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9879 },
9880 &quot;unspecified&quot;: True or False, # Optional. Indicates compensation amount and range are unset.
9881 &quot;description&quot;: &quot;A String&quot;, # Optional. Compensation description.
9882 &quot;unit&quot;: &quot;A String&quot;, # Optional. Frequency of the specified amount.
9883 #
9884 # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
9885 &quot;amount&quot;: { # Deprecated. See CompensationInfo. # Optional. Monetary amount.
9886 #
9887 # Decimal number.
9888 &quot;micros&quot;: 42, # Micro (10^-6) units.
9889 # The value must be between -999,999 and +999,999 inclusive.
9890 # If `units` is positive, `micros` must be positive or zero.
9891 # If `units` is zero, `micros` can be positive, zero, or negative.
9892 # If `units` is negative, `micros` must be negative or zero.
9893 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9894 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9895 },
9896 &quot;type&quot;: &quot;A String&quot;, # Required. Compensation type.
9897 },
9898 ],
9899 &quot;annualizedTotalCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized total compensation range cannot be derived, due to
9900 # the job&#x27;s all CompensationEntry cannot be annualized.
9901 # See CompensationEntry for explanation on annualization and base
9902 # compensation entry.
9903 &quot;annualizedBaseCompensationRange&quot;: { # Deprecated. See CompensationInfo. # Output only. Annualized base compensation range.
9904 #
9905 # Compensation range.
9906 &quot;min&quot;: { # Deprecated. See CompensationInfo. # Required. Minimum value.
9907 #
9908 # Decimal number.
9909 &quot;micros&quot;: 42, # Micro (10^-6) units.
9910 # The value must be between -999,999 and +999,999 inclusive.
9911 # If `units` is positive, `micros` must be positive or zero.
9912 # If `units` is zero, `micros` can be positive, zero, or negative.
9913 # If `units` is negative, `micros` must be negative or zero.
9914 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9915 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9916 },
9917 &quot;max&quot;: { # Deprecated. See CompensationInfo. # Required. Maximum value.
9918 #
9919 # Decimal number.
9920 &quot;micros&quot;: 42, # Micro (10^-6) units.
9921 # The value must be between -999,999 and +999,999 inclusive.
9922 # If `units` is positive, `micros` must be positive or zero.
9923 # If `units` is zero, `micros` can be positive, zero, or negative.
9924 # If `units` is negative, `micros` must be negative or zero.
9925 # For example -1.75 is represented as `units`=-1 and `micros`=-750,000.
9926 &quot;units&quot;: &quot;A String&quot;, # Whole units.
9927 },
9928 },
9929 &quot;annualizedBaseCompensationUnspecified&quot;: True or False, # Output only. Indicates annualized base compensation range cannot be derived, due to
9930 # the job&#x27;s base compensation entry cannot be annualized.
9931 # See CompensationEntry for explanation on annualization and base
9932 # compensation entry.
9933 },
9934 &quot;companyName&quot;: &quot;A String&quot;, # Optional but one of company_name or distributor_company_id must be
9935 # provided.
9936 #
9937 # The resource name of the company listing the job, such as
9938 # /companies/foo. This field takes precedence over the
9939 # distributor-assigned company identifier, distributor_company_id.
9940 &quot;description&quot;: &quot;A String&quot;, # Required. The description of the job, which typically includes a multi-paragraph
9941 # description of the company and related information. Separate fields are
9942 # provided on the job object for responsibilities,
9943 # qualifications, and other job characteristics. Use of
9944 # these separate job fields is recommended.
9945 #
9946 # This field accepts and sanitizes HTML input, and also accepts
9947 # bold, italic, ordered list, and unordered list markup tags.
9948 #
9949 # The maximum number of allowed characters is 100,000.
9950 &quot;applicationEmailList&quot;: [ # Optional but at least one of application_urls,
9951 # application_email_list or application_instruction must be
9952 # specified.
9953 #
9954 # Use this field to specify email address(es) to which resumes or
9955 # applications can be sent.
9956 #
9957 # The maximum number of allowed characters is 255.
9958 &quot;A String&quot;,
9959 ],
9960 &quot;jobTitle&quot;: &quot;A String&quot;, # Required. The title of the job, such as &quot;Software Engineer&quot;
9961 #
9962 # The maximum number of allowed characters is 500.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009963 },
Bu Sun Kim65020912020-05-20 12:08:20 -07009964 &quot;searchTextSnippet&quot;: &quot;A String&quot;, # Contains snippets of text from the Job.description and similar
9965 # fields that most closely match a search query&#x27;s keywords, if available.
9966 # All HTML tags in the original fields are stripped when returned in this
9967 # field, and matching query keywords are enclosed in HTML bold tags.
9968 &quot;jobTitleSnippet&quot;: &quot;A String&quot;, # Contains snippets of text from the Job.job_title field most
9969 # closely matching a search query&#x27;s keywords, if available. The matching
9970 # query keywords are enclosed in HTML bold tags.
9971 &quot;jobSummary&quot;: &quot;A String&quot;, # A summary of the job with core information that&#x27;s displayed on the search
9972 # results listing page.
9973 &quot;commuteInfo&quot;: { # Output only. # Commute information which is generated based on specified
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009974 # CommutePreference.
9975 #
9976 # Commute details related to this job.
Bu Sun Kim65020912020-05-20 12:08:20 -07009977 &quot;travelDuration&quot;: &quot;A String&quot;, # The number of seconds required to travel to the job location from the query
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009978 # location. A duration of 0 seconds indicates that the job is not
9979 # reachable within the requested duration, but was returned as part of an
9980 # expanded query.
Bu Sun Kim65020912020-05-20 12:08:20 -07009981 &quot;jobLocation&quot;: { # Output only. # Location used as the destination in the commute calculation.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009982 #
9983 # A resource that represents a location with full geographic
9984 # information.
Bu Sun Kim65020912020-05-20 12:08:20 -07009985 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009986 # such as postal delivery and payments addresses. Given a postal address,
9987 # a postal service can deliver items to a premises, P.O. Box, or other
9988 # delivery location.
9989 # Given a postal address, a postal service can deliver items to a premise, P.O.
9990 # Box or similar.
9991 # It is not intended to model geographical locations (roads, towns,
9992 # mountains).
9993 #
9994 # In typical usage an address would be created via user input or from importing
9995 # existing data, depending on the type of process.
9996 #
9997 # Advice on address input / editing:
9998 # - Use an i18n-ready address widget such as
Dan O'Mearadd494642020-05-01 07:42:23 -07009999 # https://github.com/google/libaddressinput)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010000 # - Users should not be presented with UI elements for input or editing of
10001 # fields outside countries where that field is used.
10002 #
10003 # For more guidance on how to use this schema, please see:
10004 # https://support.google.com/business/answer/6397478
Bu Sun Kim65020912020-05-20 12:08:20 -070010005 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
10006 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010007 # is never inferred and it is up to the user to ensure the value is
10008 # correct. See http://cldr.unicode.org/ and
10009 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
Bu Sun Kim65020912020-05-20 12:08:20 -070010010 # for details. Example: &quot;CH&quot; for Switzerland.
10011 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010012 #
10013 # Because values in address_lines do not have type information and may
10014 # sometimes contain multiple values in a single field (e.g.
Bu Sun Kim65020912020-05-20 12:08:20 -070010015 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
10016 # address lines should be &quot;envelope order&quot; for the country/region of the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010017 # address. In places where this can vary (e.g. Japan), address_language is
Bu Sun Kim65020912020-05-20 12:08:20 -070010018 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
10019 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010020 # an address can be selected based on the language.
10021 #
10022 # The minimum permitted structural representation of an address consists
10023 # of a region_code with all remaining information placed in the
10024 # address_lines. It would be possible to format such an address very
10025 # approximately without geocoding, but no semantic reasoning could be
10026 # made about any of the address components until it was at least
10027 # partially resolved.
10028 #
10029 # Creating an address only containing a region_code and address_lines, and
10030 # then geocoding is the recommended way to handle completely unstructured
10031 # addresses (as opposed to guessing which parts of the address should be
10032 # localities or administrative areas).
Bu Sun Kim65020912020-05-20 12:08:20 -070010033 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010034 ],
Bu Sun Kim65020912020-05-20 12:08:20 -070010035 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010036 # postal codes to be present, but where they are used, they may trigger
10037 # additional validation with other parts of the address (e.g. state/zip
10038 # validation in the U.S.A.).
Bu Sun Kim65020912020-05-20 12:08:20 -070010039 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
10040 # in most regions. Where it is used, the value is either a string like
10041 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
10042 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
10043 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
10044 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
10045 # known). This is often the UI language of the input form or is expected
10046 # to match one of the languages used in the address&#x27; country/region, or their
10047 # transliterated equivalents.
10048 # This can affect formatting in certain countries, but is not critical
10049 # to the correctness of the data and will never affect any validation or
10050 # other non-formatting related operations.
10051 #
10052 # If this value is not known, it should be omitted (rather than specifying a
10053 # possibly incorrect default).
10054 #
10055 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
10056 &quot;recipients&quot;: [ # Optional. The recipient at the address.
10057 # This field may, under certain circumstances, contain multiline information.
10058 # For example, it might contain &quot;care of&quot; information.
10059 &quot;A String&quot;,
10060 ],
10061 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010062 # For example, this can be neighborhoods, boroughs, districts.
Bu Sun Kim65020912020-05-20 12:08:20 -070010063 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010064 # the latest revision.
10065 #
10066 # All new revisions **must** be backward compatible with old revisions.
Bu Sun Kim65020912020-05-20 12:08:20 -070010067 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
10068 # addresses of a country or region.
10069 # For example, this can be a state, a province, an oblast, or a prefecture.
10070 # Specifically, for Spain this is the province and not the autonomous
10071 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
10072 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
10073 # in Switzerland this should be left unpopulated.
10074 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
10075 # Examples: US city, IT comune, UK post town.
10076 # In regions of the world where localities are not well defined or do not fit
10077 # into this structure well, leave locality empty and use address_lines.
10078 },
10079 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
10080 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
10081 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
10082 # LocationType#LOCALITY.
10083 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
10084 # location bounding box in which a circle with the specified radius
10085 # centered from LatLng coves the area associated with the job location.
10086 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
10087 # 7885.79 meters.
10088 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
10089 # of doubles representing degrees latitude and degrees longitude. Unless
10090 # specified otherwise, this must conform to the
10091 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
10092 # standard&lt;/a&gt;. Values must be within normalized ranges.
10093 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
10094 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010095 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010096 },
10097 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010098 },
10099 ],
Bu Sun Kim65020912020-05-20 12:08:20 -070010100 &quot;numJobsFromBroadenedQuery&quot;: 42, # If query broadening is enabled, we may append additional results from the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010101 # broadened query. This number indicates how many of the jobs returned in the
10102 # jobs field are from the broadened query. These results are always at the
10103 # end of the jobs list. In particular, a value of 0 means all the jobs in the
10104 # jobs list are from the original (without broadening) query. If this
10105 # field is non-zero, subsequent requests with offset after this result set
10106 # should contain all broadened results.
Bu Sun Kim65020912020-05-20 12:08:20 -070010107 &quot;appliedCommuteFilter&quot;: { # Input only. # The commute filter the service applied to the specified query. This
10108 # information is only available when query has a valid CommutePreference.
10109 #
10110 # Parameters needed for commute search.
10111 &quot;departureHourLocal&quot;: 42, # Optional. The departure hour to use to calculate traffic impact. Accepts an
10112 # integer between 0 and 23, representing the hour in the time zone of the
10113 # start_location. Must not be present if road_traffic is specified.
10114 &quot;allowNonStreetLevelAddress&quot;: True or False, # Optional. If `true`, jobs without street level addresses may also be returned.
10115 # For city level addresses, the city center is used. For state and coarser
10116 # level addresses, text matching is used.
10117 # If this field is set to `false` or is not specified, only jobs that include
10118 # street level addresses will be returned by commute search.
10119 &quot;travelTime&quot;: &quot;A String&quot;, # Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
10120 # (one hour). Format is `123s`.
10121 &quot;startLocation&quot;: { # 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
10122 # commute time.
10123 # of doubles representing degrees latitude and degrees longitude. Unless
10124 # specified otherwise, this must conform to the
10125 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
10126 # standard&lt;/a&gt;. Values must be within normalized ranges.
10127 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
10128 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
10129 },
10130 &quot;method&quot;: &quot;A String&quot;, # Required. The method of transportation for which to calculate the commute time.
10131 &quot;roadTraffic&quot;: &quot;A String&quot;, # Optional. Specifies the traffic density to use when calculating commute time.
10132 # Must not be present if departure_hour_local is specified.
10133 },
10134 &quot;jobView&quot;: &quot;A String&quot;, # Corresponds to SearchJobsRequest.job_view.
10135 &quot;nextPageToken&quot;: &quot;A String&quot;, # The token that specifies the starting position of the next page of results.
10136 # This field is empty if there are no more results.
10137 &quot;estimatedTotalSize&quot;: &quot;A String&quot;, # An estimation of the number of jobs that match the specified query.
10138 #
10139 # This number is not guaranteed to be accurate. For accurate results,
10140 # seenenable_precise_result_size.
10141 &quot;appliedJobLocationFilters&quot;: [ # The location filters that the service applied to the specified query. If
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010142 # any filters are lat-lng based, the JobLocation.location_type is
10143 # JobLocation.LocationType#LOCATION_TYPE_UNSPECIFIED.
10144 { # Output only.
10145 #
10146 # A resource that represents a location with full geographic
10147 # information.
Bu Sun Kim65020912020-05-20 12:08:20 -070010148 &quot;postalAddress&quot;: { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010149 # such as postal delivery and payments addresses. Given a postal address,
10150 # a postal service can deliver items to a premises, P.O. Box, or other
10151 # delivery location.
10152 # Given a postal address, a postal service can deliver items to a premise, P.O.
10153 # Box or similar.
10154 # It is not intended to model geographical locations (roads, towns,
10155 # mountains).
10156 #
10157 # In typical usage an address would be created via user input or from importing
10158 # existing data, depending on the type of process.
10159 #
10160 # Advice on address input / editing:
10161 # - Use an i18n-ready address widget such as
Dan O'Mearadd494642020-05-01 07:42:23 -070010162 # https://github.com/google/libaddressinput)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010163 # - Users should not be presented with UI elements for input or editing of
10164 # fields outside countries where that field is used.
10165 #
10166 # For more guidance on how to use this schema, please see:
10167 # https://support.google.com/business/answer/6397478
Bu Sun Kim65020912020-05-20 12:08:20 -070010168 &quot;organization&quot;: &quot;A String&quot;, # Optional. The name of the organization at the address.
10169 &quot;regionCode&quot;: &quot;A String&quot;, # Required. CLDR region code of the country/region of the address. This
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010170 # is never inferred and it is up to the user to ensure the value is
10171 # correct. See http://cldr.unicode.org/ and
10172 # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
Bu Sun Kim65020912020-05-20 12:08:20 -070010173 # for details. Example: &quot;CH&quot; for Switzerland.
10174 &quot;addressLines&quot;: [ # Unstructured address lines describing the lower levels of an address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010175 #
10176 # Because values in address_lines do not have type information and may
10177 # sometimes contain multiple values in a single field (e.g.
Bu Sun Kim65020912020-05-20 12:08:20 -070010178 # &quot;Austin, TX&quot;), it is important that the line order is clear. The order of
10179 # address lines should be &quot;envelope order&quot; for the country/region of the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010180 # address. In places where this can vary (e.g. Japan), address_language is
Bu Sun Kim65020912020-05-20 12:08:20 -070010181 # used to make it explicit (e.g. &quot;ja&quot; for large-to-small ordering and
10182 # &quot;ja-Latn&quot; or &quot;en&quot; for small-to-large). This way, the most specific line of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010183 # an address can be selected based on the language.
10184 #
10185 # The minimum permitted structural representation of an address consists
10186 # of a region_code with all remaining information placed in the
10187 # address_lines. It would be possible to format such an address very
10188 # approximately without geocoding, but no semantic reasoning could be
10189 # made about any of the address components until it was at least
10190 # partially resolved.
10191 #
10192 # Creating an address only containing a region_code and address_lines, and
10193 # then geocoding is the recommended way to handle completely unstructured
10194 # addresses (as opposed to guessing which parts of the address should be
10195 # localities or administrative areas).
Bu Sun Kim65020912020-05-20 12:08:20 -070010196 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010197 ],
Bu Sun Kim65020912020-05-20 12:08:20 -070010198 &quot;postalCode&quot;: &quot;A String&quot;, # Optional. Postal code of the address. Not all countries use or require
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010199 # postal codes to be present, but where they are used, they may trigger
10200 # additional validation with other parts of the address (e.g. state/zip
10201 # validation in the U.S.A.).
Bu Sun Kim65020912020-05-20 12:08:20 -070010202 &quot;sortingCode&quot;: &quot;A String&quot;, # Optional. Additional, country-specific, sorting code. This is not used
10203 # in most regions. Where it is used, the value is either a string like
10204 # &quot;CEDEX&quot;, optionally followed by a number (e.g. &quot;CEDEX 7&quot;), or just a number
10205 # alone, representing the &quot;sector code&quot; (Jamaica), &quot;delivery area indicator&quot;
10206 # (Malawi) or &quot;post office indicator&quot; (e.g. Côte d&#x27;Ivoire).
10207 &quot;languageCode&quot;: &quot;A String&quot;, # Optional. BCP-47 language code of the contents of this address (if
10208 # known). This is often the UI language of the input form or is expected
10209 # to match one of the languages used in the address&#x27; country/region, or their
10210 # transliterated equivalents.
10211 # This can affect formatting in certain countries, but is not critical
10212 # to the correctness of the data and will never affect any validation or
10213 # other non-formatting related operations.
10214 #
10215 # If this value is not known, it should be omitted (rather than specifying a
10216 # possibly incorrect default).
10217 #
10218 # Examples: &quot;zh-Hant&quot;, &quot;ja&quot;, &quot;ja-Latn&quot;, &quot;en&quot;.
10219 &quot;recipients&quot;: [ # Optional. The recipient at the address.
10220 # This field may, under certain circumstances, contain multiline information.
10221 # For example, it might contain &quot;care of&quot; information.
10222 &quot;A String&quot;,
10223 ],
10224 &quot;sublocality&quot;: &quot;A String&quot;, # Optional. Sublocality of the address.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010225 # For example, this can be neighborhoods, boroughs, districts.
Bu Sun Kim65020912020-05-20 12:08:20 -070010226 &quot;revision&quot;: 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010227 # the latest revision.
10228 #
10229 # All new revisions **must** be backward compatible with old revisions.
Bu Sun Kim65020912020-05-20 12:08:20 -070010230 &quot;administrativeArea&quot;: &quot;A String&quot;, # Optional. Highest administrative subdivision which is used for postal
10231 # addresses of a country or region.
10232 # For example, this can be a state, a province, an oblast, or a prefecture.
10233 # Specifically, for Spain this is the province and not the autonomous
10234 # community (e.g. &quot;Barcelona&quot; and not &quot;Catalonia&quot;).
10235 # Many countries don&#x27;t use an administrative area in postal addresses. E.g.
10236 # in Switzerland this should be left unpopulated.
10237 &quot;locality&quot;: &quot;A String&quot;, # Optional. Generally refers to the city/town portion of the address.
10238 # Examples: US city, IT comune, UK post town.
10239 # In regions of the world where localities are not well defined or do not fit
10240 # into this structure well, leave locality empty and use address_lines.
10241 },
10242 &quot;locationType&quot;: &quot;A String&quot;, # The type of a location, which corresponds to the address lines field of
10243 # PostalAddress. For example, &quot;Downtown, Atlanta, GA, USA&quot; has a type of
10244 # LocationType#NEIGHBORHOOD, and &quot;Kansas City, KS, USA&quot; has a type of
10245 # LocationType#LOCALITY.
10246 &quot;radiusMeters&quot;: 3.14, # Radius in meters of the job location. This value is derived from the
10247 # location bounding box in which a circle with the specified radius
10248 # centered from LatLng coves the area associated with the job location.
10249 # For example, currently, &quot;Mountain View, CA, USA&quot; has a radius of
10250 # 7885.79 meters.
10251 &quot;latLng&quot;: { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
10252 # of doubles representing degrees latitude and degrees longitude. Unless
10253 # specified otherwise, this must conform to the
10254 # &lt;a href=&quot;http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf&quot;&gt;WGS84
10255 # standard&lt;/a&gt;. Values must be within normalized ranges.
10256 &quot;latitude&quot;: 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
10257 &quot;longitude&quot;: 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010258 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010259 },
10260 ],
Bu Sun Kim65020912020-05-20 12:08:20 -070010261 &quot;totalSize&quot;: &quot;A String&quot;, # The precise result count, which is available only if the client set
10262 # enable_precise_result_size to `true` or if the response
10263 # is the last page of results. Otherwise, the value will be `-1`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010264 }</pre>
10265</div>
10266
10267<div class="method">
10268 <code class="details" id="searchForAlert_next">searchForAlert_next(previous_request, previous_response)</code>
10269 <pre>Retrieves the next page of results.
10270
10271Args:
10272 previous_request: The request for the previous page. (required)
10273 previous_response: The response from the request for the previous page. (required)
10274
10275Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -070010276 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010277 page. Returns None if there are no more items in the collection.
10278 </pre>
10279</div>
10280
10281<div class="method">
10282 <code class="details" id="search_next">search_next(previous_request, previous_response)</code>
10283 <pre>Retrieves the next page of results.
10284
10285Args:
10286 previous_request: The request for the previous page. (required)
10287 previous_response: The response from the request for the previous page. (required)
10288
10289Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -070010290 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010291 page. Returns None if there are no more items in the collection.
10292 </pre>
10293</div>
10294
10295</body></html>