google-api-client 0.23.5 → 0.23.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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