google-api-client 0.23.5 → 0.23.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (50) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +21 -0
  3. data/generated/google/apis/adexperiencereport_v1.rb +1 -1
  4. data/generated/google/apis/cloudtrace_v1.rb +4 -2
  5. data/generated/google/apis/cloudtrace_v1/service.rb +3 -1
  6. data/generated/google/apis/cloudtrace_v2.rb +4 -2
  7. data/generated/google/apis/cloudtrace_v2/service.rb +3 -1
  8. data/generated/google/apis/container_v1.rb +1 -1
  9. data/generated/google/apis/container_v1/classes.rb +6 -3
  10. data/generated/google/apis/container_v1beta1.rb +1 -1
  11. data/generated/google/apis/container_v1beta1/classes.rb +51 -1
  12. data/generated/google/apis/container_v1beta1/representations.rb +18 -0
  13. data/generated/google/apis/content_v2.rb +1 -1
  14. data/generated/google/apis/content_v2/classes.rb +174 -0
  15. data/generated/google/apis/content_v2/representations.rb +73 -0
  16. data/generated/google/apis/content_v2/service.rb +100 -1
  17. data/generated/google/apis/content_v2sandbox.rb +1 -1
  18. data/generated/google/apis/content_v2sandbox/service.rb +2 -1
  19. data/generated/google/apis/dlp_v2.rb +1 -1
  20. data/generated/google/apis/dlp_v2/classes.rb +9 -7
  21. data/generated/google/apis/dlp_v2/service.rb +2 -0
  22. data/generated/google/apis/drive_v2.rb +1 -1
  23. data/generated/google/apis/drive_v2/classes.rb +72 -6
  24. data/generated/google/apis/drive_v2/representations.rb +8 -0
  25. data/generated/google/apis/drive_v3.rb +1 -1
  26. data/generated/google/apis/drive_v3/classes.rb +72 -6
  27. data/generated/google/apis/drive_v3/representations.rb +8 -0
  28. data/generated/google/apis/firestore_v1.rb +3 -2
  29. data/generated/google/apis/firestore_v1/service.rb +2 -1
  30. data/generated/google/apis/firestore_v1beta1.rb +3 -2
  31. data/generated/google/apis/firestore_v1beta1/service.rb +2 -1
  32. data/generated/google/apis/firestore_v1beta2.rb +3 -2
  33. data/generated/google/apis/firestore_v1beta2/service.rb +2 -1
  34. data/generated/google/apis/gmail_v1.rb +1 -1
  35. data/generated/google/apis/gmail_v1/classes.rb +47 -0
  36. data/generated/google/apis/gmail_v1/representations.rb +28 -0
  37. data/generated/google/apis/gmail_v1/service.rb +165 -0
  38. data/generated/google/apis/jobs_v2.rb +2 -2
  39. data/generated/google/apis/jobs_v2/classes.rb +4 -1
  40. data/generated/google/apis/jobs_v2/service.rb +1 -1
  41. data/generated/google/apis/jobs_v3.rb +38 -0
  42. data/generated/google/apis/jobs_v3/classes.rb +2587 -0
  43. data/generated/google/apis/jobs_v3/representations.rb +872 -0
  44. data/generated/google/apis/jobs_v3/service.rb +652 -0
  45. data/generated/google/apis/testing_v1.rb +1 -1
  46. data/generated/google/apis/testing_v1/classes.rb +7 -0
  47. data/generated/google/apis/testing_v1/representations.rb +1 -0
  48. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  49. data/lib/google/apis/version.rb +1 -1
  50. metadata +6 -2
@@ -0,0 +1,652 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module JobsV3
23
+ # Cloud Talent Solution API
24
+ #
25
+ # Cloud Talent Solution provides the capability to create, read, update, and
26
+ # delete job postings, as well as search jobs based on keywords and filters.
27
+ #
28
+ # @example
29
+ # require 'google/apis/jobs_v3'
30
+ #
31
+ # Jobs = Google::Apis::JobsV3 # Alias the module
32
+ # service = Jobs::CloudTalentSolutionService.new
33
+ #
34
+ # @see https://cloud.google.com/talent-solution/job-search/docs/
35
+ class CloudTalentSolutionService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ attr_accessor :quota_user
45
+
46
+ def initialize
47
+ super('https://jobs.googleapis.com/', '')
48
+ @batch_path = 'batch'
49
+ end
50
+
51
+ # Completes the specified prefix with keyword suggestions.
52
+ # Intended for use by a job search auto-complete search box.
53
+ # @param [String] name
54
+ # Required.
55
+ # Resource name of project the completion is performed within.
56
+ # The format is "projects/`project_id`", for example,
57
+ # "projects/api-test-project".
58
+ # @param [String] company_name
59
+ # Optional.
60
+ # If provided, restricts completion to specified company.
61
+ # The format is "projects/`project_id`/companies/`company_id`", for example,
62
+ # "projects/api-test-project/companies/foo".
63
+ # @param [String] language_code
64
+ # Required.
65
+ # The language of the query. This is
66
+ # the BCP-47 language code, such as "en-US" or "sr-Latn".
67
+ # For more information, see
68
+ # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
69
+ # For CompletionType.JOB_TITLE type, only open jobs with same
70
+ # language_code are returned.
71
+ # For CompletionType.COMPANY_NAME type,
72
+ # only companies having open jobs with same language_code are
73
+ # returned.
74
+ # For CompletionType.COMBINED type, only open jobs with same
75
+ # language_code or companies having open jobs with same
76
+ # language_code are returned.
77
+ # The maximum number of allowed characters is 255.
78
+ # @param [Fixnum] page_size
79
+ # Required.
80
+ # Completion result count.
81
+ # The maximum allowed page size is 10.
82
+ # @param [String] query
83
+ # Required.
84
+ # The query used to generate suggestions.
85
+ # The maximum number of allowed characters is 255.
86
+ # @param [String] scope
87
+ # Optional.
88
+ # The scope of the completion. The defaults is CompletionScope.PUBLIC.
89
+ # @param [String] type
90
+ # Optional.
91
+ # The completion topic. The default is CompletionType.COMBINED.
92
+ # @param [String] fields
93
+ # Selector specifying which fields to include in a partial response.
94
+ # @param [String] quota_user
95
+ # Available to use for quota purposes for server-side applications. Can be any
96
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
97
+ # @param [Google::Apis::RequestOptions] options
98
+ # Request-specific options
99
+ #
100
+ # @yield [result, err] Result & error if block supplied
101
+ # @yieldparam result [Google::Apis::JobsV3::CompleteQueryResponse] parsed result object
102
+ # @yieldparam err [StandardError] error object if request failed
103
+ #
104
+ # @return [Google::Apis::JobsV3::CompleteQueryResponse]
105
+ #
106
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
107
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
108
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
109
+ def complete_project(name, company_name: nil, language_code: nil, page_size: nil, query: nil, scope: nil, type: nil, fields: nil, quota_user: nil, options: nil, &block)
110
+ command = make_simple_command(:get, 'v3/{+name}:complete', options)
111
+ command.response_representation = Google::Apis::JobsV3::CompleteQueryResponse::Representation
112
+ command.response_class = Google::Apis::JobsV3::CompleteQueryResponse
113
+ command.params['name'] = name unless name.nil?
114
+ command.query['companyName'] = company_name unless company_name.nil?
115
+ command.query['languageCode'] = language_code unless language_code.nil?
116
+ command.query['pageSize'] = page_size unless page_size.nil?
117
+ command.query['query'] = query unless query.nil?
118
+ command.query['scope'] = scope unless scope.nil?
119
+ command.query['type'] = type unless type.nil?
120
+ command.query['fields'] = fields unless fields.nil?
121
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
122
+ execute_or_queue_command(command, &block)
123
+ end
124
+
125
+ # Creates a new company entity.
126
+ # @param [String] parent
127
+ # Required.
128
+ # Resource name of the project under which the company is created.
129
+ # The format is "projects/`project_id`", for example,
130
+ # "projects/api-test-project".
131
+ # @param [Google::Apis::JobsV3::CreateCompanyRequest] create_company_request_object
132
+ # @param [String] fields
133
+ # Selector specifying which fields to include in a partial response.
134
+ # @param [String] quota_user
135
+ # Available to use for quota purposes for server-side applications. Can be any
136
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
137
+ # @param [Google::Apis::RequestOptions] options
138
+ # Request-specific options
139
+ #
140
+ # @yield [result, err] Result & error if block supplied
141
+ # @yieldparam result [Google::Apis::JobsV3::Company] parsed result object
142
+ # @yieldparam err [StandardError] error object if request failed
143
+ #
144
+ # @return [Google::Apis::JobsV3::Company]
145
+ #
146
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
147
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
148
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
149
+ def create_company(parent, create_company_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
150
+ command = make_simple_command(:post, 'v3/{+parent}/companies', options)
151
+ command.request_representation = Google::Apis::JobsV3::CreateCompanyRequest::Representation
152
+ command.request_object = create_company_request_object
153
+ command.response_representation = Google::Apis::JobsV3::Company::Representation
154
+ command.response_class = Google::Apis::JobsV3::Company
155
+ command.params['parent'] = parent unless parent.nil?
156
+ command.query['fields'] = fields unless fields.nil?
157
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
158
+ execute_or_queue_command(command, &block)
159
+ end
160
+
161
+ # Deletes specified company.
162
+ # @param [String] name
163
+ # Required.
164
+ # The resource name of the company to be deleted.
165
+ # The format is "projects/`project_id`/companies/`company_id`", for example,
166
+ # "projects/api-test-project/companies/foo".
167
+ # @param [String] fields
168
+ # Selector specifying which fields to include in a partial response.
169
+ # @param [String] quota_user
170
+ # Available to use for quota purposes for server-side applications. Can be any
171
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
172
+ # @param [Google::Apis::RequestOptions] options
173
+ # Request-specific options
174
+ #
175
+ # @yield [result, err] Result & error if block supplied
176
+ # @yieldparam result [Google::Apis::JobsV3::Empty] parsed result object
177
+ # @yieldparam err [StandardError] error object if request failed
178
+ #
179
+ # @return [Google::Apis::JobsV3::Empty]
180
+ #
181
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
182
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
183
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
184
+ def delete_project_company(name, fields: nil, quota_user: nil, options: nil, &block)
185
+ command = make_simple_command(:delete, 'v3/{+name}', options)
186
+ command.response_representation = Google::Apis::JobsV3::Empty::Representation
187
+ command.response_class = Google::Apis::JobsV3::Empty
188
+ command.params['name'] = name unless name.nil?
189
+ command.query['fields'] = fields unless fields.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ execute_or_queue_command(command, &block)
192
+ end
193
+
194
+ # Retrieves specified company.
195
+ # @param [String] name
196
+ # Required.
197
+ # The resource name of the company to be retrieved.
198
+ # The format is "projects/`project_id`/companies/`company_id`", for example,
199
+ # "projects/api-test-project/companies/foo".
200
+ # @param [String] fields
201
+ # Selector specifying which fields to include in a partial response.
202
+ # @param [String] quota_user
203
+ # Available to use for quota purposes for server-side applications. Can be any
204
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
205
+ # @param [Google::Apis::RequestOptions] options
206
+ # Request-specific options
207
+ #
208
+ # @yield [result, err] Result & error if block supplied
209
+ # @yieldparam result [Google::Apis::JobsV3::Company] parsed result object
210
+ # @yieldparam err [StandardError] error object if request failed
211
+ #
212
+ # @return [Google::Apis::JobsV3::Company]
213
+ #
214
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
215
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
216
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
217
+ def get_project_company(name, fields: nil, quota_user: nil, options: nil, &block)
218
+ command = make_simple_command(:get, 'v3/{+name}', options)
219
+ command.response_representation = Google::Apis::JobsV3::Company::Representation
220
+ command.response_class = Google::Apis::JobsV3::Company
221
+ command.params['name'] = name unless name.nil?
222
+ command.query['fields'] = fields unless fields.nil?
223
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
224
+ execute_or_queue_command(command, &block)
225
+ end
226
+
227
+ # Lists all companies associated with the service account.
228
+ # @param [String] parent
229
+ # Required.
230
+ # Resource name of the project under which the company is created.
231
+ # The format is "projects/`project_id`", for example,
232
+ # "projects/api-test-project".
233
+ # @param [Fixnum] page_size
234
+ # Optional.
235
+ # The maximum number of companies to be returned, at most 100.
236
+ # Default is 100 if a non-positive number is provided.
237
+ # @param [String] page_token
238
+ # Optional.
239
+ # The starting indicator from which to return results.
240
+ # @param [Boolean] require_open_jobs
241
+ # Optional.
242
+ # Set to true if the companies requested must have open jobs.
243
+ # Defaults to false.
244
+ # If true, at most page_size of companies are fetched, among which
245
+ # only those with open jobs are returned.
246
+ # @param [String] fields
247
+ # Selector specifying which fields to include in a partial response.
248
+ # @param [String] quota_user
249
+ # Available to use for quota purposes for server-side applications. Can be any
250
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
251
+ # @param [Google::Apis::RequestOptions] options
252
+ # Request-specific options
253
+ #
254
+ # @yield [result, err] Result & error if block supplied
255
+ # @yieldparam result [Google::Apis::JobsV3::ListCompaniesResponse] parsed result object
256
+ # @yieldparam err [StandardError] error object if request failed
257
+ #
258
+ # @return [Google::Apis::JobsV3::ListCompaniesResponse]
259
+ #
260
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
261
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
262
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
263
+ def list_project_companies(parent, page_size: nil, page_token: nil, require_open_jobs: nil, fields: nil, quota_user: nil, options: nil, &block)
264
+ command = make_simple_command(:get, 'v3/{+parent}/companies', options)
265
+ command.response_representation = Google::Apis::JobsV3::ListCompaniesResponse::Representation
266
+ command.response_class = Google::Apis::JobsV3::ListCompaniesResponse
267
+ command.params['parent'] = parent unless parent.nil?
268
+ command.query['pageSize'] = page_size unless page_size.nil?
269
+ command.query['pageToken'] = page_token unless page_token.nil?
270
+ command.query['requireOpenJobs'] = require_open_jobs unless require_open_jobs.nil?
271
+ command.query['fields'] = fields unless fields.nil?
272
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
273
+ execute_or_queue_command(command, &block)
274
+ end
275
+
276
+ # Updates specified company. Company names can't be updated. To update a
277
+ # company name, delete the company and all jobs associated with it, and only
278
+ # then re-create them.
279
+ # @param [String] name
280
+ # Required during company update.
281
+ # The resource name for a company. This is generated by the service when a
282
+ # company is created.
283
+ # The format is "projects/`project_id`/companies/`company_id`", for example,
284
+ # "projects/api-test-project/companies/foo".
285
+ # @param [Google::Apis::JobsV3::UpdateCompanyRequest] update_company_request_object
286
+ # @param [String] fields
287
+ # Selector specifying which fields to include in a partial response.
288
+ # @param [String] quota_user
289
+ # Available to use for quota purposes for server-side applications. Can be any
290
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
291
+ # @param [Google::Apis::RequestOptions] options
292
+ # Request-specific options
293
+ #
294
+ # @yield [result, err] Result & error if block supplied
295
+ # @yieldparam result [Google::Apis::JobsV3::Company] parsed result object
296
+ # @yieldparam err [StandardError] error object if request failed
297
+ #
298
+ # @return [Google::Apis::JobsV3::Company]
299
+ #
300
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
301
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
302
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
303
+ def patch_project_company(name, update_company_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
304
+ command = make_simple_command(:patch, 'v3/{+name}', options)
305
+ command.request_representation = Google::Apis::JobsV3::UpdateCompanyRequest::Representation
306
+ command.request_object = update_company_request_object
307
+ command.response_representation = Google::Apis::JobsV3::Company::Representation
308
+ command.response_class = Google::Apis::JobsV3::Company
309
+ command.params['name'] = name unless name.nil?
310
+ command.query['fields'] = fields unless fields.nil?
311
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
312
+ execute_or_queue_command(command, &block)
313
+ end
314
+
315
+ # Deletes a list of Jobs by filter.
316
+ # @param [String] parent
317
+ # Required.
318
+ # The resource name of the project under which the job is created.
319
+ # The format is "projects/`project_id`", for example,
320
+ # "projects/api-test-project".
321
+ # @param [Google::Apis::JobsV3::BatchDeleteJobsRequest] batch_delete_jobs_request_object
322
+ # @param [String] fields
323
+ # Selector specifying which fields to include in a partial response.
324
+ # @param [String] quota_user
325
+ # Available to use for quota purposes for server-side applications. Can be any
326
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
327
+ # @param [Google::Apis::RequestOptions] options
328
+ # Request-specific options
329
+ #
330
+ # @yield [result, err] Result & error if block supplied
331
+ # @yieldparam result [Google::Apis::JobsV3::Empty] parsed result object
332
+ # @yieldparam err [StandardError] error object if request failed
333
+ #
334
+ # @return [Google::Apis::JobsV3::Empty]
335
+ #
336
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
337
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
338
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
339
+ def batch_delete_jobs(parent, batch_delete_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
340
+ command = make_simple_command(:post, 'v3/{+parent}/jobs:batchDelete', options)
341
+ command.request_representation = Google::Apis::JobsV3::BatchDeleteJobsRequest::Representation
342
+ command.request_object = batch_delete_jobs_request_object
343
+ command.response_representation = Google::Apis::JobsV3::Empty::Representation
344
+ command.response_class = Google::Apis::JobsV3::Empty
345
+ command.params['parent'] = parent unless parent.nil?
346
+ command.query['fields'] = fields unless fields.nil?
347
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
348
+ execute_or_queue_command(command, &block)
349
+ end
350
+
351
+ # Creates a new job.
352
+ # Typically, the job becomes searchable within 10 seconds, but it may take
353
+ # up to 5 minutes.
354
+ # @param [String] parent
355
+ # Required.
356
+ # The resource name of the project under which the job is created.
357
+ # The format is "projects/`project_id`", for example,
358
+ # "projects/api-test-project".
359
+ # @param [Google::Apis::JobsV3::CreateJobRequest] create_job_request_object
360
+ # @param [String] fields
361
+ # Selector specifying which fields to include in a partial response.
362
+ # @param [String] quota_user
363
+ # Available to use for quota purposes for server-side applications. Can be any
364
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
365
+ # @param [Google::Apis::RequestOptions] options
366
+ # Request-specific options
367
+ #
368
+ # @yield [result, err] Result & error if block supplied
369
+ # @yieldparam result [Google::Apis::JobsV3::Job] parsed result object
370
+ # @yieldparam err [StandardError] error object if request failed
371
+ #
372
+ # @return [Google::Apis::JobsV3::Job]
373
+ #
374
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
375
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
376
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
377
+ def create_job(parent, create_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
378
+ command = make_simple_command(:post, 'v3/{+parent}/jobs', options)
379
+ command.request_representation = Google::Apis::JobsV3::CreateJobRequest::Representation
380
+ command.request_object = create_job_request_object
381
+ command.response_representation = Google::Apis::JobsV3::Job::Representation
382
+ command.response_class = Google::Apis::JobsV3::Job
383
+ command.params['parent'] = parent unless parent.nil?
384
+ command.query['fields'] = fields unless fields.nil?
385
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
386
+ execute_or_queue_command(command, &block)
387
+ end
388
+
389
+ # Deletes the specified job.
390
+ # Typically, the job becomes unsearchable within 10 seconds, but it may take
391
+ # up to 5 minutes.
392
+ # @param [String] name
393
+ # Required.
394
+ # The resource name of the job to be deleted.
395
+ # The format is "projects/`project_id`/jobs/`job_id`",
396
+ # for example, "projects/api-test-project/jobs/1234".
397
+ # @param [String] fields
398
+ # Selector specifying which fields to include in a partial response.
399
+ # @param [String] quota_user
400
+ # Available to use for quota purposes for server-side applications. Can be any
401
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
402
+ # @param [Google::Apis::RequestOptions] options
403
+ # Request-specific options
404
+ #
405
+ # @yield [result, err] Result & error if block supplied
406
+ # @yieldparam result [Google::Apis::JobsV3::Empty] parsed result object
407
+ # @yieldparam err [StandardError] error object if request failed
408
+ #
409
+ # @return [Google::Apis::JobsV3::Empty]
410
+ #
411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
414
+ def delete_project_job(name, fields: nil, quota_user: nil, options: nil, &block)
415
+ command = make_simple_command(:delete, 'v3/{+name}', options)
416
+ command.response_representation = Google::Apis::JobsV3::Empty::Representation
417
+ command.response_class = Google::Apis::JobsV3::Empty
418
+ command.params['name'] = name unless name.nil?
419
+ command.query['fields'] = fields unless fields.nil?
420
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
421
+ execute_or_queue_command(command, &block)
422
+ end
423
+
424
+ # Retrieves the specified job, whose status is OPEN or recently EXPIRED
425
+ # within the last 90 days.
426
+ # @param [String] name
427
+ # Required.
428
+ # The resource name of the job to retrieve.
429
+ # The format is "projects/`project_id`/jobs/`job_id`",
430
+ # for example, "projects/api-test-project/jobs/1234".
431
+ # @param [String] fields
432
+ # Selector specifying which fields to include in a partial response.
433
+ # @param [String] quota_user
434
+ # Available to use for quota purposes for server-side applications. Can be any
435
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
436
+ # @param [Google::Apis::RequestOptions] options
437
+ # Request-specific options
438
+ #
439
+ # @yield [result, err] Result & error if block supplied
440
+ # @yieldparam result [Google::Apis::JobsV3::Job] parsed result object
441
+ # @yieldparam err [StandardError] error object if request failed
442
+ #
443
+ # @return [Google::Apis::JobsV3::Job]
444
+ #
445
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
446
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
447
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
448
+ def get_project_job(name, fields: nil, quota_user: nil, options: nil, &block)
449
+ command = make_simple_command(:get, 'v3/{+name}', options)
450
+ command.response_representation = Google::Apis::JobsV3::Job::Representation
451
+ command.response_class = Google::Apis::JobsV3::Job
452
+ command.params['name'] = name unless name.nil?
453
+ command.query['fields'] = fields unless fields.nil?
454
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
455
+ execute_or_queue_command(command, &block)
456
+ end
457
+
458
+ # Lists jobs by filter.
459
+ # @param [String] parent
460
+ # Required.
461
+ # The resource name of the project under which the job is created.
462
+ # The format is "projects/`project_id`", for example,
463
+ # "projects/api-test-project".
464
+ # @param [String] filter
465
+ # Required.
466
+ # The filter string specifies the jobs to be enumerated.
467
+ # Supported operator: =, AND
468
+ # The fields eligible for filtering are:
469
+ # * `companyName` (Required)
470
+ # * `requisitionId` (Optional)
471
+ # Sample Query:
472
+ # * companyName = "projects/api-test-project/companies/123"
473
+ # * companyName = "projects/api-test-project/companies/123" AND requisitionId
474
+ # = "req-1"
475
+ # @param [String] job_view
476
+ # Optional.
477
+ # The desired job attributes returned for jobs in the
478
+ # search response. Defaults to JobView.JOB_VIEW_FULL if no value is
479
+ # specified.
480
+ # @param [Fixnum] page_size
481
+ # Optional.
482
+ # The maximum number of jobs to be returned per page of results.
483
+ # If job_view is set to JobView.JOB_VIEW_ID_ONLY, the maximum allowed
484
+ # page size is 1000. Otherwise, the maximum allowed page size is 100.
485
+ # Default is 100 if empty or a number < 1 is specified.
486
+ # @param [String] page_token
487
+ # Optional.
488
+ # The starting point of a query result.
489
+ # @param [String] fields
490
+ # Selector specifying which fields to include in a partial response.
491
+ # @param [String] quota_user
492
+ # Available to use for quota purposes for server-side applications. Can be any
493
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
494
+ # @param [Google::Apis::RequestOptions] options
495
+ # Request-specific options
496
+ #
497
+ # @yield [result, err] Result & error if block supplied
498
+ # @yieldparam result [Google::Apis::JobsV3::ListJobsResponse] parsed result object
499
+ # @yieldparam err [StandardError] error object if request failed
500
+ #
501
+ # @return [Google::Apis::JobsV3::ListJobsResponse]
502
+ #
503
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
504
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
505
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
506
+ def list_project_jobs(parent, filter: nil, job_view: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
507
+ command = make_simple_command(:get, 'v3/{+parent}/jobs', options)
508
+ command.response_representation = Google::Apis::JobsV3::ListJobsResponse::Representation
509
+ command.response_class = Google::Apis::JobsV3::ListJobsResponse
510
+ command.params['parent'] = parent unless parent.nil?
511
+ command.query['filter'] = filter unless filter.nil?
512
+ command.query['jobView'] = job_view unless job_view.nil?
513
+ command.query['pageSize'] = page_size unless page_size.nil?
514
+ command.query['pageToken'] = page_token unless page_token.nil?
515
+ command.query['fields'] = fields unless fields.nil?
516
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
517
+ execute_or_queue_command(command, &block)
518
+ end
519
+
520
+ # Updates specified job.
521
+ # Typically, updated contents become visible in search results within 10
522
+ # seconds, but it may take up to 5 minutes.
523
+ # @param [String] name
524
+ # Required during job update.
525
+ # The resource name for the job. This is generated by the service when a
526
+ # job is created.
527
+ # The format is "projects/`project_id`/jobs/`job_id`",
528
+ # for example, "projects/api-test-project/jobs/1234".
529
+ # Use of this field in job queries and API calls is preferred over the use of
530
+ # requisition_id since this value is unique.
531
+ # @param [Google::Apis::JobsV3::UpdateJobRequest] update_job_request_object
532
+ # @param [String] fields
533
+ # Selector specifying which fields to include in a partial response.
534
+ # @param [String] quota_user
535
+ # Available to use for quota purposes for server-side applications. Can be any
536
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
537
+ # @param [Google::Apis::RequestOptions] options
538
+ # Request-specific options
539
+ #
540
+ # @yield [result, err] Result & error if block supplied
541
+ # @yieldparam result [Google::Apis::JobsV3::Job] parsed result object
542
+ # @yieldparam err [StandardError] error object if request failed
543
+ #
544
+ # @return [Google::Apis::JobsV3::Job]
545
+ #
546
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
547
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
548
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
549
+ def patch_project_job(name, update_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
550
+ command = make_simple_command(:patch, 'v3/{+name}', options)
551
+ command.request_representation = Google::Apis::JobsV3::UpdateJobRequest::Representation
552
+ command.request_object = update_job_request_object
553
+ command.response_representation = Google::Apis::JobsV3::Job::Representation
554
+ command.response_class = Google::Apis::JobsV3::Job
555
+ command.params['name'] = name unless name.nil?
556
+ command.query['fields'] = fields unless fields.nil?
557
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
558
+ execute_or_queue_command(command, &block)
559
+ end
560
+
561
+ # Searches for jobs using the provided SearchJobsRequest.
562
+ # This call constrains the visibility of jobs
563
+ # present in the database, and only returns jobs that the caller has
564
+ # permission to search against.
565
+ # @param [String] parent
566
+ # Required.
567
+ # The resource name of the project to search within.
568
+ # The format is "projects/`project_id`", for example,
569
+ # "projects/api-test-project".
570
+ # @param [Google::Apis::JobsV3::SearchJobsRequest] search_jobs_request_object
571
+ # @param [String] fields
572
+ # Selector specifying which fields to include in a partial response.
573
+ # @param [String] quota_user
574
+ # Available to use for quota purposes for server-side applications. Can be any
575
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
576
+ # @param [Google::Apis::RequestOptions] options
577
+ # Request-specific options
578
+ #
579
+ # @yield [result, err] Result & error if block supplied
580
+ # @yieldparam result [Google::Apis::JobsV3::SearchJobsResponse] parsed result object
581
+ # @yieldparam err [StandardError] error object if request failed
582
+ #
583
+ # @return [Google::Apis::JobsV3::SearchJobsResponse]
584
+ #
585
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
586
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
587
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
588
+ def search_jobs(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
589
+ command = make_simple_command(:post, 'v3/{+parent}/jobs:search', options)
590
+ command.request_representation = Google::Apis::JobsV3::SearchJobsRequest::Representation
591
+ command.request_object = search_jobs_request_object
592
+ command.response_representation = Google::Apis::JobsV3::SearchJobsResponse::Representation
593
+ command.response_class = Google::Apis::JobsV3::SearchJobsResponse
594
+ command.params['parent'] = parent unless parent.nil?
595
+ command.query['fields'] = fields unless fields.nil?
596
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
597
+ execute_or_queue_command(command, &block)
598
+ end
599
+
600
+ # Searches for jobs using the provided SearchJobsRequest.
601
+ # This API call is intended for the use case of targeting passive job
602
+ # seekers (for example, job seekers who have signed up to receive email
603
+ # alerts about potential job opportunities), and has different algorithmic
604
+ # adjustments that are targeted to passive job seekers.
605
+ # This call constrains the visibility of jobs
606
+ # present in the database, and only returns jobs the caller has
607
+ # permission to search against.
608
+ # @param [String] parent
609
+ # Required.
610
+ # The resource name of the project to search within.
611
+ # The format is "projects/`project_id`", for example,
612
+ # "projects/api-test-project".
613
+ # @param [Google::Apis::JobsV3::SearchJobsRequest] search_jobs_request_object
614
+ # @param [String] fields
615
+ # Selector specifying which fields to include in a partial response.
616
+ # @param [String] quota_user
617
+ # Available to use for quota purposes for server-side applications. Can be any
618
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
619
+ # @param [Google::Apis::RequestOptions] options
620
+ # Request-specific options
621
+ #
622
+ # @yield [result, err] Result & error if block supplied
623
+ # @yieldparam result [Google::Apis::JobsV3::SearchJobsResponse] parsed result object
624
+ # @yieldparam err [StandardError] error object if request failed
625
+ #
626
+ # @return [Google::Apis::JobsV3::SearchJobsResponse]
627
+ #
628
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
629
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
630
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
631
+ def search_project_job_for_alert(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
632
+ command = make_simple_command(:post, 'v3/{+parent}/jobs:searchForAlert', options)
633
+ command.request_representation = Google::Apis::JobsV3::SearchJobsRequest::Representation
634
+ command.request_object = search_jobs_request_object
635
+ command.response_representation = Google::Apis::JobsV3::SearchJobsResponse::Representation
636
+ command.response_class = Google::Apis::JobsV3::SearchJobsResponse
637
+ command.params['parent'] = parent unless parent.nil?
638
+ command.query['fields'] = fields unless fields.nil?
639
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
640
+ execute_or_queue_command(command, &block)
641
+ end
642
+
643
+ protected
644
+
645
+ def apply_command_defaults(command)
646
+ command.query['key'] = key unless key.nil?
647
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
648
+ end
649
+ end
650
+ end
651
+ end
652
+ end