google-cloud-talent 0.1.0 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +2 -0
  3. data/AUTHENTICATION.md +199 -0
  4. data/lib/google/cloud/talent.rb +20 -19
  5. data/lib/google/cloud/talent/v4beta1.rb +22 -21
  6. data/lib/google/cloud/talent/v4beta1/application_pb.rb +62 -0
  7. data/lib/google/cloud/talent/v4beta1/application_service_client.rb +492 -0
  8. data/lib/google/cloud/talent/v4beta1/application_service_client_config.json +51 -0
  9. data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +52 -0
  10. data/lib/google/cloud/talent/v4beta1/application_service_services_pb.rb +56 -0
  11. data/lib/google/cloud/talent/v4beta1/common_pb.rb +47 -1
  12. data/lib/google/cloud/talent/v4beta1/company_pb.rb +1 -1
  13. data/lib/google/cloud/talent/v4beta1/company_service_client.rb +83 -55
  14. data/lib/google/cloud/talent/v4beta1/completion_client.rb +62 -42
  15. data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +2 -2
  16. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb +189 -0
  17. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb +121 -0
  18. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb +189 -94
  19. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb +12 -10
  20. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company_service.rb +29 -20
  21. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/completion_service.rb +26 -30
  22. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb +16 -55
  23. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event_service.rb +9 -1
  24. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb +74 -164
  25. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/histogram.rb +2 -5
  26. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job.rb +58 -86
  27. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job_service.rb +109 -137
  28. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb +76 -375
  29. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile_service.rb +21 -38
  30. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant.rb +1 -3
  31. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant_service.rb +3 -7
  32. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/field_mask.rb +18 -26
  33. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/timestamp.rb +15 -13
  34. data/lib/google/cloud/talent/v4beta1/doc/google/type/date.rb +14 -10
  35. data/lib/google/cloud/talent/v4beta1/doc/google/type/latlng.rb +0 -34
  36. data/lib/google/cloud/talent/v4beta1/doc/google/type/timeofday.rb +2 -3
  37. data/lib/google/cloud/talent/v4beta1/event_pb.rb +2 -9
  38. data/lib/google/cloud/talent/v4beta1/event_service_client.rb +26 -13
  39. data/lib/google/cloud/talent/v4beta1/event_service_services_pb.rb +1 -1
  40. data/lib/google/cloud/talent/v4beta1/filters_pb.rb +8 -20
  41. data/lib/google/cloud/talent/v4beta1/helpers.rb +44 -10
  42. data/lib/google/cloud/talent/v4beta1/histogram_pb.rb +1 -1
  43. data/lib/google/cloud/talent/v4beta1/job_pb.rb +3 -2
  44. data/lib/google/cloud/talent/v4beta1/job_service_client.rb +229 -204
  45. data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +0 -1
  46. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +8 -12
  47. data/lib/google/cloud/talent/v4beta1/profile_pb.rb +6 -64
  48. data/lib/google/cloud/talent/v4beta1/profile_service_client.rb +72 -68
  49. data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +1 -1
  50. data/lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb +3 -3
  51. data/lib/google/cloud/talent/v4beta1/resume_service_client.rb +2 -2
  52. data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +1 -1
  53. data/lib/google/cloud/talent/v4beta1/tenant_service_client.rb +34 -23
  54. metadata +11 -4
data/lib/google/cloud/talent/v4beta1/event_service_services_pb.rb CHANGED
@@ -40,7 +40,7 @@ module Google
40
40
  # [self service
41
41
  # tools](https://console.cloud.google.com/talent-solution/overview).
42
42
  # [Learn
43
- # more](https://cloud.google.com/talent-solution/job-search/docs/management-tools)
43
+ # more](https://cloud.google.com/talent-solution/docs/management-tools)
44
44
  # about self service tools.
45
45
  rpc :CreateClientEvent, CreateClientEventRequest, ClientEvent
46
46
  end
data/lib/google/cloud/talent/v4beta1/filters_pb.rb CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
7
+ require 'google/cloud/talent/v4beta1/application_pb'
8
8
  require 'google/cloud/talent/v4beta1/common_pb'
9
9
  require 'google/cloud/talent/v4beta1/job_pb'
10
10
  require 'google/cloud/talent/v4beta1/profile_pb'
@@ -14,10 +14,11 @@ require 'google/protobuf/wrappers_pb'
14
14
  require 'google/type/date_pb'
15
15
  require 'google/type/latlng_pb'
16
16
  require 'google/type/timeofday_pb'
17
+ require 'google/api/annotations_pb'
17
18
  Google::Protobuf::DescriptorPool.generated_pool.build do
18
19
  add_message "google.cloud.talent.v4beta1.JobQuery" do
19
20
  optional :query, :string, 1
20
- repeated :company_names, :string, 2
21
+ repeated :companies, :string, 2
21
22
  repeated :location_filters, :message, 3, "google.cloud.talent.v4beta1.LocationFilter"
22
23
  repeated :job_categories, :enum, 4, "google.cloud.talent.v4beta1.JobCategory"
23
24
  optional :commute_filter, :message, 5, "google.cloud.talent.v4beta1.CommuteFilter"
@@ -41,11 +42,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
41
42
  repeated :time_filters, :message, 8, "google.cloud.talent.v4beta1.TimeFilter"
42
43
  optional :hirable_filter, :message, 9, "google.protobuf.BoolValue"
43
44
  repeated :application_date_filters, :message, 10, "google.cloud.talent.v4beta1.ApplicationDateFilter"
44
- repeated :application_outcome_reason_filters, :message, 11, "google.cloud.talent.v4beta1.ApplicationOutcomeReasonFilter"
45
- repeated :application_last_stage_filters, :message, 12, "google.cloud.talent.v4beta1.ApplicationLastStageFilter"
45
+ repeated :application_outcome_notes_filters, :message, 11, "google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter"
46
46
  repeated :application_job_filters, :message, 13, "google.cloud.talent.v4beta1.ApplicationJobFilter"
47
- repeated :application_status_filters, :message, 14, "google.cloud.talent.v4beta1.ApplicationStatusFilter"
48
- optional :custom_field_filter, :string, 15
47
+ optional :custom_attribute_filter, :string, 15
49
48
  end
50
49
  add_message "google.cloud.talent.v4beta1.LocationFilter" do
51
50
  optional :address, :string, 1
@@ -121,24 +120,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
121
120
  optional :start_date, :message, 1, "google.type.Date"
122
121
  optional :end_date, :message, 2, "google.type.Date"
123
122
  end
124
- add_message "google.cloud.talent.v4beta1.ApplicationOutcomeReasonFilter" do
125
- optional :outcome_reason, :string, 1
126
- optional :negated, :bool, 2
127
- end
128
- add_message "google.cloud.talent.v4beta1.ApplicationLastStageFilter" do
129
- optional :last_stage, :string, 1
123
+ add_message "google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter" do
124
+ optional :outcome_notes, :string, 1
130
125
  optional :negated, :bool, 2
131
126
  end
132
127
  add_message "google.cloud.talent.v4beta1.ApplicationJobFilter" do
133
- optional :job_name, :string, 1
134
128
  optional :job_requisition_id, :string, 2
135
129
  optional :job_title, :string, 3
136
130
  optional :negated, :bool, 4
137
131
  end
138
- add_message "google.cloud.talent.v4beta1.ApplicationStatusFilter" do
139
- optional :application_status, :enum, 1, "google.cloud.talent.v4beta1.JobApplication.ApplicationStatus"
140
- optional :negated, :bool, 2
141
- end
142
132
  add_message "google.cloud.talent.v4beta1.TimeFilter" do
143
133
  optional :start_time, :message, 1, "google.protobuf.Timestamp"
144
134
  optional :end_time, :message, 2, "google.protobuf.Timestamp"
@@ -170,10 +160,8 @@ module Google
170
160
  EducationFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EducationFilter").msgclass
171
161
  WorkExperienceFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.WorkExperienceFilter").msgclass
172
162
  ApplicationDateFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationDateFilter").msgclass
173
- ApplicationOutcomeReasonFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationOutcomeReasonFilter").msgclass
174
- ApplicationLastStageFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationLastStageFilter").msgclass
163
+ ApplicationOutcomeNotesFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter").msgclass
175
164
  ApplicationJobFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationJobFilter").msgclass
176
- ApplicationStatusFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.ApplicationStatusFilter").msgclass
177
165
  TimeFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter").msgclass
178
166
  TimeFilter::TimeField = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter.TimeField").enummodule
179
167
  end
data/lib/google/cloud/talent/v4beta1/helpers.rb CHANGED
@@ -15,37 +15,71 @@ module Google
15
15
  module Cloud
16
16
  module Talent
17
17
  module V4beta1
18
+ class ApplicationServiceClient
19
+ # Alias for Google::Cloud::Talent::V4beta1::ApplicationServiceClient.application_path.
20
+ # @param project [String]
21
+ # @param tenant [String]
22
+ # @param profile [String]
23
+ # @param application [String]
24
+ # @return [String]
25
+ def application_path project, tenant, profile, application
26
+ self.class.application_path project, tenant, profile, application
27
+ end
28
+
29
+ # Alias for Google::Cloud::Talent::V4beta1::ApplicationServiceClient.profile_path.
30
+ # @param project [String]
31
+ # @param tenant [String]
32
+ # @param profile [String]
33
+ # @return [String]
34
+ def profile_path project, tenant, profile
35
+ self.class.profile_path project, tenant, profile
36
+ end
37
+ end
38
+
18
39
  class CompanyServiceClient
19
40
  # Alias for Google::Cloud::Talent::V4beta1::CompanyServiceClient.company_path.
20
41
  # @param project [String]
42
+ # @param tenant [String]
21
43
  # @param company [String]
22
44
  # @return [String]
23
- def company_path project, company
24
- self.class.company_path project, company
45
+ def company_path project, tenant, company
46
+ self.class.company_path project, tenant, company
25
47
  end
26
48
 
27
- # Alias for Google::Cloud::Talent::V4beta1::CompanyServiceClient.project_path.
49
+ # Alias for Google::Cloud::Talent::V4beta1::CompanyServiceClient.tenant_path.
28
50
  # @param project [String]
51
+ # @param tenant [String]
29
52
  # @return [String]
30
- def project_path project
31
- self.class.project_path project
53
+ def tenant_path project, tenant
54
+ self.class.tenant_path project, tenant
32
55
  end
33
56
  end
34
57
 
35
58
  class JobServiceClient
59
+ # Alias for Google::Cloud::Talent::V4beta1::JobServiceClient.company_path.
60
+ # @param project [String]
61
+ # @param tenant [String]
62
+ # @param company [String]
63
+ # @return [String]
64
+ def company_path project, tenant, company
65
+ self.class.company_path project, tenant, company
66
+ end
67
+
36
68
  # Alias for Google::Cloud::Talent::V4beta1::JobServiceClient.job_path.
37
69
  # @param project [String]
70
+ # @param tenant [String]
38
71
  # @param jobs [String]
39
72
  # @return [String]
40
- def job_path project, jobs
41
- self.class.job_path project, jobs
73
+ def job_path project, tenant, jobs
74
+ self.class.job_path project, tenant, jobs
42
75
  end
43
76
 
44
- # Alias for Google::Cloud::Talent::V4beta1::JobServiceClient.project_path.
77
+ # Alias for Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path.
45
78
  # @param project [String]
79
+ # @param tenant [String]
46
80
  # @return [String]
47
- def project_path project
48
- self.class.project_path project
81
+ def tenant_path project, tenant
82
+ self.class.tenant_path project, tenant
49
83
  end
50
84
  end
51
85
 
data/lib/google/cloud/talent/v4beta1/histogram_pb.rb CHANGED
@@ -4,8 +4,8 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
8
7
  require 'google/protobuf/wrappers_pb'
8
+ require 'google/api/annotations_pb'
9
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
10
10
  add_message "google.cloud.talent.v4beta1.HistogramQuery" do
11
11
  optional :histogram_query, :string, 1
data/lib/google/cloud/talent/v4beta1/job_pb.rb CHANGED
@@ -4,13 +4,14 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
8
7
  require 'google/cloud/talent/v4beta1/common_pb'
9
8
  require 'google/protobuf/timestamp_pb'
9
+ require 'google/protobuf/wrappers_pb'
10
+ require 'google/api/annotations_pb'
10
11
  Google::Protobuf::DescriptorPool.generated_pool.build do
11
12
  add_message "google.cloud.talent.v4beta1.Job" do
12
13
  optional :name, :string, 1
13
- optional :company_name, :string, 2
14
+ optional :company, :string, 2
14
15
  optional :requisition_id, :string, 3
15
16
  optional :title, :string, 4
16
17
  optional :description, :string, 5
data/lib/google/cloud/talent/v4beta1/job_service_client.rb CHANGED
@@ -76,38 +76,61 @@ module Google
76
76
  ].freeze
77
77
 
78
78
 
79
- PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
80
- "projects/{project}"
79
+ COMPANY_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
80
+ "projects/{project}/tenants/{tenant}/companies/{company}"
81
81
  )
82
82
 
83
- private_constant :PROJECT_PATH_TEMPLATE
83
+ private_constant :COMPANY_PATH_TEMPLATE
84
84
 
85
85
  JOB_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
86
- "projects/{project}/jobs/{jobs}"
86
+ "projects/{project}/tenants/{tenant}/jobs/{jobs}"
87
87
  )
88
88
 
89
89
  private_constant :JOB_PATH_TEMPLATE
90
90
 
91
- # Returns a fully-qualified project resource name string.
91
+ TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
92
+ "projects/{project}/tenants/{tenant}"
93
+ )
94
+
95
+ private_constant :TENANT_PATH_TEMPLATE
96
+
97
+ # Returns a fully-qualified company resource name string.
92
98
  # @param project [String]
99
+ # @param tenant [String]
100
+ # @param company [String]
93
101
  # @return [String]
94
- def self.project_path project
95
- PROJECT_PATH_TEMPLATE.render(
96
- :"project" => project
102
+ def self.company_path project, tenant, company
103
+ COMPANY_PATH_TEMPLATE.render(
104
+ :"project" => project,
105
+ :"tenant" => tenant,
106
+ :"company" => company
97
107
  )
98
108
  end
99
109
 
100
110
  # Returns a fully-qualified job resource name string.
101
111
  # @param project [String]
112
+ # @param tenant [String]
102
113
  # @param jobs [String]
103
114
  # @return [String]
104
- def self.job_path project, jobs
115
+ def self.job_path project, tenant, jobs
105
116
  JOB_PATH_TEMPLATE.render(
106
117
  :"project" => project,
118
+ :"tenant" => tenant,
107
119
  :"jobs" => jobs
108
120
  )
109
121
  end
110
122
 
123
+ # Returns a fully-qualified tenant resource name string.
124
+ # @param project [String]
125
+ # @param tenant [String]
126
+ # @return [String]
127
+ def self.tenant_path project, tenant
128
+ TENANT_PATH_TEMPLATE.render(
129
+ :"project" => project,
130
+ :"tenant" => tenant
131
+ )
132
+ end
133
+
111
134
  # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
112
135
  # Provides the means for authenticating requests made by the client. This parameter can
113
136
  # be many types.
@@ -214,42 +237,66 @@ module Google
214
237
  @create_job = Google::Gax.create_api_call(
215
238
  @job_service_stub.method(:create_job),
216
239
  defaults["create_job"],
217
- exception_transformer: exception_transformer
240
+ exception_transformer: exception_transformer,
241
+ params_extractor: proc do |request|
242
+ {'parent' => request.parent}
243
+ end
218
244
  )
219
245
  @get_job = Google::Gax.create_api_call(
220
246
  @job_service_stub.method(:get_job),
221
247
  defaults["get_job"],
222
- exception_transformer: exception_transformer
248
+ exception_transformer: exception_transformer,
249
+ params_extractor: proc do |request|
250
+ {'name' => request.name}
251
+ end
223
252
  )
224
253
  @update_job = Google::Gax.create_api_call(
225
254
  @job_service_stub.method(:update_job),
226
255
  defaults["update_job"],
227
- exception_transformer: exception_transformer
256
+ exception_transformer: exception_transformer,
257
+ params_extractor: proc do |request|
258
+ {'job.name' => request.job.name}
259
+ end
228
260
  )
229
261
  @delete_job = Google::Gax.create_api_call(
230
262
  @job_service_stub.method(:delete_job),
231
263
  defaults["delete_job"],
232
- exception_transformer: exception_transformer
264
+ exception_transformer: exception_transformer,
265
+ params_extractor: proc do |request|
266
+ {'name' => request.name}
267
+ end
233
268
  )
234
269
  @list_jobs = Google::Gax.create_api_call(
235
270
  @job_service_stub.method(:list_jobs),
236
271
  defaults["list_jobs"],
237
- exception_transformer: exception_transformer
272
+ exception_transformer: exception_transformer,
273
+ params_extractor: proc do |request|
274
+ {'parent' => request.parent}
275
+ end
238
276
  )
239
277
  @batch_delete_jobs = Google::Gax.create_api_call(
240
278
  @job_service_stub.method(:batch_delete_jobs),
241
279
  defaults["batch_delete_jobs"],
242
- exception_transformer: exception_transformer
280
+ exception_transformer: exception_transformer,
281
+ params_extractor: proc do |request|
282
+ {'parent' => request.parent}
283
+ end
243
284
  )
244
285
  @search_jobs = Google::Gax.create_api_call(
245
286
  @job_service_stub.method(:search_jobs),
246
287
  defaults["search_jobs"],
247
- exception_transformer: exception_transformer
288
+ exception_transformer: exception_transformer,
289
+ params_extractor: proc do |request|
290
+ {'parent' => request.parent}
291
+ end
248
292
  )
249
293
  @search_jobs_for_alert = Google::Gax.create_api_call(
250
294
  @job_service_stub.method(:search_jobs_for_alert),
251
295
  defaults["search_jobs_for_alert"],
252
- exception_transformer: exception_transformer
296
+ exception_transformer: exception_transformer,
297
+ params_extractor: proc do |request|
298
+ {'parent' => request.parent}
299
+ end
253
300
  )
254
301
  end
255
302
 
@@ -263,10 +310,13 @@ module Google
263
310
  # @param parent [String]
264
311
  # Required.
265
312
  #
266
- # The resource name of the project under which the job is created.
313
+ # The resource name of the tenant under which the job is created.
267
314
  #
268
- # The format is "projects/{project_id}", for example,
269
- # "projects/api-test-project".
315
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
316
+ # "projects/api-test-project/tenant/foo".
317
+ #
318
+ # Tenant id is optional and a default tenant is created if unspecified, for
319
+ # example, "projects/api-test-project".
270
320
  # @param job [Google::Cloud::Talent::V4beta1::Job | Hash]
271
321
  # Required.
272
322
  #
@@ -284,12 +334,12 @@ module Google
284
334
  # @example
285
335
  # require "google/cloud/talent"
286
336
  #
287
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
288
- # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.project_path("[PROJECT]")
337
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
338
+ # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path("[PROJECT]", "[TENANT]")
289
339
  #
290
340
  # # TODO: Initialize `job`:
291
341
  # job = {}
292
- # response = job_service_client.create_job(formatted_parent, job)
342
+ # response = job_client.create_job(formatted_parent, job)
293
343
 
294
344
  def create_job \
295
345
  parent,
@@ -312,8 +362,12 @@ module Google
312
362
  #
313
363
  # The resource name of the job to retrieve.
314
364
  #
315
- # The format is "projects/{project_id}/jobs/{job_id}",
316
- # for example, "projects/api-test-project/jobs/1234".
365
+ # The format is
366
+ # "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
367
+ # example, "projects/api-test-project/tenants/foo/jobs/1234".
368
+ #
369
+ # Tenant id is optional and the default tenant is used if unspecified, for
370
+ # example, "projects/api-test-project/jobs/1234".
317
371
  # @param options [Google::Gax::CallOptions]
318
372
  # Overrides the default settings for this call, e.g, timeout,
319
373
  # retries, etc.
@@ -325,9 +379,9 @@ module Google
325
379
  # @example
326
380
  # require "google/cloud/talent"
327
381
  #
328
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
329
- # formatted_name = Google::Cloud::Talent::V4beta1::JobServiceClient.job_path("[PROJECT]", "[JOBS]")
330
- # response = job_service_client.get_job(formatted_name)
382
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
383
+ # formatted_name = Google::Cloud::Talent::V4beta1::JobServiceClient.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
384
+ # response = job_client.get_job(formatted_name)
331
385
 
332
386
  def get_job \
333
387
  name,
@@ -355,10 +409,8 @@ module Google
355
409
  # Optional but strongly recommended to be provided for the best service
356
410
  # experience.
357
411
  #
358
- # If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
359
- # is provided, only the specified fields in
360
- # {Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated.
361
- # Otherwise all the fields are updated.
412
+ # If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
413
+ # {Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
362
414
  #
363
415
  # A field mask to restrict the fields that are updated. Only
364
416
  # top level fields of {Google::Cloud::Talent::V4beta1::Job Job} are supported.
@@ -375,11 +427,11 @@ module Google
375
427
  # @example
376
428
  # require "google/cloud/talent"
377
429
  #
378
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
430
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
379
431
  #
380
432
  # # TODO: Initialize `job`:
381
433
  # job = {}
382
- # response = job_service_client.update_job(job)
434
+ # response = job_client.update_job(job)
383
435
 
384
436
  def update_job \
385
437
  job,
@@ -404,8 +456,12 @@ module Google
404
456
  #
405
457
  # The resource name of the job to be deleted.
406
458
  #
407
- # The format is "projects/{project_id}/jobs/{job_id}",
408
- # for example, "projects/api-test-project/jobs/1234".
459
+ # The format is
460
+ # "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
461
+ # example, "projects/api-test-project/tenants/foo/jobs/1234".
462
+ #
463
+ # Tenant id is optional and the default tenant is used if unspecified, for
464
+ # example, "projects/api-test-project/jobs/1234".
409
465
  # @param options [Google::Gax::CallOptions]
410
466
  # Overrides the default settings for this call, e.g, timeout,
411
467
  # retries, etc.
@@ -416,9 +472,9 @@ module Google
416
472
  # @example
417
473
  # require "google/cloud/talent"
418
474
  #
419
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
420
- # formatted_name = Google::Cloud::Talent::V4beta1::JobServiceClient.job_path("[PROJECT]", "[JOBS]")
421
- # job_service_client.delete_job(formatted_name)
475
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
476
+ # formatted_name = Google::Cloud::Talent::V4beta1::JobServiceClient.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
477
+ # job_client.delete_job(formatted_name)
422
478
 
423
479
  def delete_job \
424
480
  name,
@@ -437,10 +493,13 @@ module Google
437
493
  # @param parent [String]
438
494
  # Required.
439
495
  #
440
- # The resource name of the project under which the job is created.
496
+ # The resource name of the tenant under which the job is created.
441
497
  #
442
- # The format is "projects/{project_id}", for example,
443
- # "projects/api-test-project".
498
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
499
+ # "projects/api-test-project/tenant/foo".
500
+ #
501
+ # Tenant id is optional and the default tenant is used if unspecified, for
502
+ # example, "projects/api-test-project".
444
503
  # @param filter [String]
445
504
  # Required.
446
505
  #
@@ -457,11 +516,11 @@ module Google
457
516
  #
458
517
  # Sample Query:
459
518
  #
460
- # * companyName = "projects/api-test-project/companies/123"
461
- # * companyName = "projects/api-test-project/companies/123" AND requisitionId
462
- # = "req-1"
463
- # * companyName = "projects/api-test-project/companies/123" AND status =
464
- # "EXPIRED"
519
+ # * companyName = "projects/api-test-project/tenants/foo/companies/bar"
520
+ # * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
521
+ # requisitionId = "req-1"
522
+ # * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
523
+ # status = "EXPIRED"
465
524
  # @param page_size [Integer]
466
525
  # The maximum number of resources contained in the underlying API
467
526
  # response. If page streaming is performed per-resource, this
@@ -472,9 +531,8 @@ module Google
472
531
  # Optional.
473
532
  #
474
533
  # The desired job attributes returned for jobs in the
475
- # search response. Defaults to
476
- # {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView::JOB_VIEW_FULL}
477
- # if no value is specified.
534
+ # search response. Defaults to {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView::JOB_VIEW_FULL} if no value is
535
+ # specified.
478
536
  # @param options [Google::Gax::CallOptions]
479
537
  # Overrides the default settings for this call, e.g, timeout,
480
538
  # retries, etc.
@@ -490,19 +548,19 @@ module Google
490
548
  # @example
491
549
  # require "google/cloud/talent"
492
550
  #
493
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
494
- # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.project_path("[PROJECT]")
551
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
552
+ # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path("[PROJECT]", "[TENANT]")
495
553
  #
496
554
  # # TODO: Initialize `filter`:
497
555
  # filter = ''
498
556
  #
499
557
  # # Iterate over all results.
500
- # job_service_client.list_jobs(formatted_parent, filter).each do |element|
558
+ # job_client.list_jobs(formatted_parent, filter).each do |element|
501
559
  # # Process element.
502
560
  # end
503
561
  #
504
562
  # # Or iterate over results one page at a time.
505
- # job_service_client.list_jobs(formatted_parent, filter).each_page do |page|
563
+ # job_client.list_jobs(formatted_parent, filter).each_page do |page|
506
564
  # # Process each page at a time.
507
565
  # page.each do |element|
508
566
  # # Process element.
@@ -531,10 +589,13 @@ module Google
531
589
  # @param parent [String]
532
590
  # Required.
533
591
  #
534
- # The resource name of the project under which the job is created.
592
+ # The resource name of the tenant under which the job is created.
593
+ #
594
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
595
+ # "projects/api-test-project/tenant/foo".
535
596
  #
536
- # The format is "projects/{project_id}", for example,
537
- # "projects/api-test-project".
597
+ # Tenant id is optional and the default tenant is used if unspecified, for
598
+ # example, "projects/api-test-project".
538
599
  # @param filter [String]
539
600
  # Required.
540
601
  #
@@ -559,12 +620,12 @@ module Google
559
620
  # @example
560
621
  # require "google/cloud/talent"
561
622
  #
562
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
563
- # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.project_path("[PROJECT]")
623
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
624
+ # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path("[PROJECT]", "[TENANT]")
564
625
  #
565
626
  # # TODO: Initialize `filter`:
566
627
  # filter = ''
567
- # job_service_client.batch_delete_jobs(formatted_parent, filter)
628
+ # job_client.batch_delete_jobs(formatted_parent, filter)
568
629
 
569
630
  def batch_delete_jobs \
570
631
  parent,
@@ -580,21 +641,22 @@ module Google
580
641
  nil
581
642
  end
582
643
 
583
- # Searches for jobs using the provided
584
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
644
+ # Searches for jobs using the provided {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
585
645
  #
586
- # This call constrains the
587
- # {Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs present in
588
- # the database, and only returns jobs that the caller has permission to
589
- # search against.
646
+ # This call constrains the {Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs
647
+ # present in the database, and only returns jobs that the caller has
648
+ # permission to search against.
590
649
  #
591
650
  # @param parent [String]
592
651
  # Required.
593
652
  #
594
- # The resource name of the project to search within.
653
+ # The resource name of the tenant to search within.
595
654
  #
596
- # The format is "projects/{project_id}", for example,
597
- # "projects/api-test-project".
655
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
656
+ # "projects/api-test-project/tenant/foo".
657
+ #
658
+ # Tenant id is optional and the default tenant is used if unspecified, for
659
+ # example, "projects/api-test-project".
598
660
  # @param request_metadata [Google::Cloud::Talent::V4beta1::RequestMetadata | Hash]
599
661
  # Required.
600
662
  #
@@ -608,8 +670,7 @@ module Google
608
670
  #
609
671
  # Mode of a search.
610
672
  #
611
- # Defaults to
612
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
673
+ # Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
613
674
  # @param job_query [Google::Cloud::Talent::V4beta1::JobQuery | Hash]
614
675
  # Optional.
615
676
  #
@@ -672,23 +733,19 @@ module Google
672
733
  # Job histogram facets:
673
734
  #
674
735
  # * company_id: histogram by {Job#distributor_company_id}.
675
- # * company_display_name: histogram by
676
- # {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
677
- # * employment_type: histogram by
678
- # {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types},
679
- # for example, "FULL_TIME", "PART_TIME".
680
- # * company_size: histogram by
681
- # {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
682
- # "SMALL", "MEDIUM", "BIG".
736
+ # * company_display_name: histogram by {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
737
+ # * employment_type: histogram by {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types}, for example,
738
+ # "FULL_TIME", "PART_TIME".
739
+ # * company_size: histogram by {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
740
+ # "MEDIUM", "BIG".
683
741
  # * publish_time_in_month: histogram by the {Job#publish_time} in months.
684
742
  # Must specify list of numeric buckets in spec.
685
743
  # * publish_time_in_year: histogram by the {Job#publish_time} in years.
686
744
  # Must specify list of numeric buckets in spec.
687
745
  # * degree_type: histogram by the {Job#degree_type}, for example,
688
746
  # "Bachelors", "Masters".
689
- # * job_level: histogram by the
690
- # {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example,
691
- # "Entry Level".
747
+ # * job_level: histogram by the {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example, "Entry
748
+ # Level".
692
749
  # * country: histogram by the country code of jobs, for example, "US", "FR".
693
750
  # * admin1: histogram by the admin1 code of jobs, which is a global
694
751
  # placeholder referring to the state, province, or the particular term a
@@ -702,14 +759,11 @@ module Google
702
759
  # and longitude), for example, 37.4038522,-122.0987765. Since the coordinates
703
760
  # of a city center can change, customers may need to refresh them
704
761
  # periodically.
705
- # * locale: histogram by the
706
- # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
707
- # example, "en-US", "fr-FR".
708
- # * language: histogram by the language subtag of the
709
- # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
710
- # example, "en", "fr".
711
- # * category: histogram by the
712
- # {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
762
+ # * locale: histogram by the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for example, "en-US",
763
+ # "fr-FR".
764
+ # * language: histogram by the language subtag of the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
765
+ # for example, "en", "fr".
766
+ # * category: histogram by the {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
713
767
  # "COMPUTER_AND_IT", "HEALTHCARE".
714
768
  # * base_compensation_unit: histogram by the {CompensationUnit} of base
715
769
  # salary, for example, "WEEKLY", "MONTHLY".
@@ -719,12 +773,10 @@ module Google
719
773
  # Must specify list of numeric buckets to group results by.
720
774
  # * annualized_total_compensation: histogram by the total annualized salary.
721
775
  # Must specify list of numeric buckets to group results by.
722
- # * string_custom_attribute: histogram by string
723
- # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
776
+ # * string_custom_attribute: histogram by string {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
724
777
  # Values can be accessed via square bracket notations like
725
778
  # string_custom_attribute["key1"].
726
- # * numeric_custom_attribute: histogram by numeric
727
- # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
779
+ # * numeric_custom_attribute: histogram by numeric {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
728
780
  # Values can be accessed via square bracket notations like
729
781
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
730
782
  # group results by.
@@ -748,9 +800,7 @@ module Google
748
800
  #
749
801
  # An integer that specifies the current offset (that is, starting result
750
802
  # location, amongst the jobs deemed by the API as relevant) in search
751
- # results. This field is only considered if
752
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
753
- # unset.
803
+ # results. This field is only considered if {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
754
804
  #
755
805
  # For example, 0 means to return results starting from the first matching
756
806
  # job, and 10 means to return from the 11th job. This can be used for
@@ -773,31 +823,28 @@ module Google
773
823
  # * "relevance desc": By relevance descending, as determined by the API
774
824
  # algorithms. Relevance thresholding of query results is only available
775
825
  # with this ordering.
776
- # * "posting`_`publish`_`time desc": By
777
- # {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
826
+ # * "posting`_`publish`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
778
827
  # descending.
779
- # * "posting`_`update`_`time desc": By
780
- # {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
828
+ # * "posting`_`update`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
781
829
  # descending.
782
830
  # * "title": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} ascending.
783
- # * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title}
784
- # descending.
831
+ # * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} descending.
785
832
  # * "annualized`_`base`_`compensation": By job's
786
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
787
- # ascending. Jobs whose annualized base compensation is unspecified are put
788
- # at the end of search results.
833
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} ascending. Jobs
834
+ # whose annualized base compensation is unspecified are put at the end of
835
+ # search results.
789
836
  # * "annualized`_`base`_`compensation desc": By job's
790
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
791
- # descending. Jobs whose annualized base compensation is unspecified are put
792
- # at the end of search results.
837
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} descending. Jobs
838
+ # whose annualized base compensation is unspecified are put at the end of
839
+ # search results.
793
840
  # * "annualized`_`total`_`compensation": By job's
794
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
795
- # ascending. Jobs whose annualized base compensation is unspecified are put
796
- # at the end of search results.
841
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} ascending. Jobs
842
+ # whose annualized base compensation is unspecified are put at the end of
843
+ # search results.
797
844
  # * "annualized`_`total`_`compensation desc": By job's
798
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
799
- # descending. Jobs whose annualized base compensation is unspecified are put
800
- # at the end of search results.
845
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} descending. Jobs
846
+ # whose annualized base compensation is unspecified are put at the end of
847
+ # search results.
801
848
  # * "custom`_`ranking desc": By the relevance score adjusted to the
802
849
  # {SearchJobsRequest#custom_ranking_info#ranking_expression} with weight
803
850
  # factor assigned by
@@ -826,9 +873,8 @@ module Google
826
873
  # displayed to the job seeker higher up in the results, with the other jobs
827
874
  # being displayed lower down in the results.
828
875
  #
829
- # Defaults to
830
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
831
- # if no value is specified.
876
+ # Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE} if no value
877
+ # is specified.
832
878
  # @param custom_ranking_info [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo | Hash]
833
879
  # Optional.
834
880
  #
@@ -840,16 +886,13 @@ module Google
840
886
  # Optional.
841
887
  #
842
888
  # Controls whether to disable exact keyword match on {Job#job_title},
843
- # {Google::Cloud::Talent::V4beta1::Job#description Job#description},
844
- # {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
845
- # [Job.locations][0],
846
- # {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When
847
- # disable keyword match is turned off, a keyword match returns jobs that do
848
- # not match given category filters when there are matching keywords. For
849
- # example, for the query "program manager," a result is returned even if the
850
- # job posting has the title "software developer," which doesn't fall into
851
- # "program manager" ontology, but does have "program manager" appearing in
852
- # its description.
889
+ # {Google::Cloud::Talent::V4beta1::Job#description Job#description}, {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}, [Job.locations][0],
890
+ # {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When disable keyword match is turned off, a
891
+ # keyword match returns jobs that do not match given category filters when
892
+ # there are matching keywords. For example, for the query "program manager,"
893
+ # a result is returned even if the job posting has the title "software
894
+ # developer," which doesn't fall into "program manager" ontology, but does
895
+ # have "program manager" appearing in its description.
853
896
  #
854
897
  # For queries like "cloud" that don't contain title or
855
898
  # location specific ontology, jobs with "cloud" keyword matches are returned
@@ -876,19 +919,19 @@ module Google
876
919
  # @example
877
920
  # require "google/cloud/talent"
878
921
  #
879
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
880
- # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.project_path("[PROJECT]")
922
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
923
+ # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path("[PROJECT]", "[TENANT]")
881
924
  #
882
925
  # # TODO: Initialize `request_metadata`:
883
926
  # request_metadata = {}
884
927
  #
885
928
  # # Iterate over all results.
886
- # job_service_client.search_jobs(formatted_parent, request_metadata).each do |element|
929
+ # job_client.search_jobs(formatted_parent, request_metadata).each do |element|
887
930
  # # Process element.
888
931
  # end
889
932
  #
890
933
  # # Or iterate over results one page at a time.
891
- # job_service_client.search_jobs(formatted_parent, request_metadata).each_page do |page|
934
+ # job_client.search_jobs(formatted_parent, request_metadata).each_page do |page|
892
935
  # # Process each page at a time.
893
936
  # page.each do |element|
894
937
  # # Process element.
@@ -932,26 +975,27 @@ module Google
932
975
  @search_jobs.call(req, options, &block)
933
976
  end
934
977
 
935
- # Searches for jobs using the provided
936
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
978
+ # Searches for jobs using the provided {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
937
979
  #
938
980
  # This API call is intended for the use case of targeting passive job
939
981
  # seekers (for example, job seekers who have signed up to receive email
940
982
  # alerts about potential job opportunities), and has different algorithmic
941
983
  # adjustments that are targeted to passive job seekers.
942
984
  #
943
- # This call constrains the
944
- # {Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs present in
945
- # the database, and only returns jobs the caller has permission to search
946
- # against.
985
+ # This call constrains the {Google::Cloud::Talent::V4beta1::Job#visibility visibility} of jobs
986
+ # present in the database, and only returns jobs the caller has
987
+ # permission to search against.
947
988
  #
948
989
  # @param parent [String]
949
990
  # Required.
950
991
  #
951
- # The resource name of the project to search within.
992
+ # The resource name of the tenant to search within.
952
993
  #
953
- # The format is "projects/{project_id}", for example,
954
- # "projects/api-test-project".
994
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
995
+ # "projects/api-test-project/tenant/foo".
996
+ #
997
+ # Tenant id is optional and the default tenant is used if unspecified, for
998
+ # example, "projects/api-test-project".
955
999
  # @param request_metadata [Google::Cloud::Talent::V4beta1::RequestMetadata | Hash]
956
1000
  # Required.
957
1001
  #
@@ -965,8 +1009,7 @@ module Google
965
1009
  #
966
1010
  # Mode of a search.
967
1011
  #
968
- # Defaults to
969
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
1012
+ # Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
970
1013
  # @param job_query [Google::Cloud::Talent::V4beta1::JobQuery | Hash]
971
1014
  # Optional.
972
1015
  #
@@ -1029,23 +1072,19 @@ module Google
1029
1072
  # Job histogram facets:
1030
1073
  #
1031
1074
  # * company_id: histogram by {Job#distributor_company_id}.
1032
- # * company_display_name: histogram by
1033
- # {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
1034
- # * employment_type: histogram by
1035
- # {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types},
1036
- # for example, "FULL_TIME", "PART_TIME".
1037
- # * company_size: histogram by
1038
- # {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
1039
- # "SMALL", "MEDIUM", "BIG".
1075
+ # * company_display_name: histogram by {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
1076
+ # * employment_type: histogram by {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types}, for example,
1077
+ # "FULL_TIME", "PART_TIME".
1078
+ # * company_size: histogram by {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
1079
+ # "MEDIUM", "BIG".
1040
1080
  # * publish_time_in_month: histogram by the {Job#publish_time} in months.
1041
1081
  # Must specify list of numeric buckets in spec.
1042
1082
  # * publish_time_in_year: histogram by the {Job#publish_time} in years.
1043
1083
  # Must specify list of numeric buckets in spec.
1044
1084
  # * degree_type: histogram by the {Job#degree_type}, for example,
1045
1085
  # "Bachelors", "Masters".
1046
- # * job_level: histogram by the
1047
- # {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example,
1048
- # "Entry Level".
1086
+ # * job_level: histogram by the {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example, "Entry
1087
+ # Level".
1049
1088
  # * country: histogram by the country code of jobs, for example, "US", "FR".
1050
1089
  # * admin1: histogram by the admin1 code of jobs, which is a global
1051
1090
  # placeholder referring to the state, province, or the particular term a
@@ -1059,14 +1098,11 @@ module Google
1059
1098
  # and longitude), for example, 37.4038522,-122.0987765. Since the coordinates
1060
1099
  # of a city center can change, customers may need to refresh them
1061
1100
  # periodically.
1062
- # * locale: histogram by the
1063
- # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
1064
- # example, "en-US", "fr-FR".
1065
- # * language: histogram by the language subtag of the
1066
- # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
1067
- # example, "en", "fr".
1068
- # * category: histogram by the
1069
- # {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1101
+ # * locale: histogram by the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for example, "en-US",
1102
+ # "fr-FR".
1103
+ # * language: histogram by the language subtag of the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
1104
+ # for example, "en", "fr".
1105
+ # * category: histogram by the {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
1070
1106
  # "COMPUTER_AND_IT", "HEALTHCARE".
1071
1107
  # * base_compensation_unit: histogram by the {CompensationUnit} of base
1072
1108
  # salary, for example, "WEEKLY", "MONTHLY".
@@ -1076,12 +1112,10 @@ module Google
1076
1112
  # Must specify list of numeric buckets to group results by.
1077
1113
  # * annualized_total_compensation: histogram by the total annualized salary.
1078
1114
  # Must specify list of numeric buckets to group results by.
1079
- # * string_custom_attribute: histogram by string
1080
- # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
1115
+ # * string_custom_attribute: histogram by string {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
1081
1116
  # Values can be accessed via square bracket notations like
1082
1117
  # string_custom_attribute["key1"].
1083
- # * numeric_custom_attribute: histogram by numeric
1084
- # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
1118
+ # * numeric_custom_attribute: histogram by numeric {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
1085
1119
  # Values can be accessed via square bracket notations like
1086
1120
  # numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
1087
1121
  # group results by.
@@ -1105,9 +1139,7 @@ module Google
1105
1139
  #
1106
1140
  # An integer that specifies the current offset (that is, starting result
1107
1141
  # location, amongst the jobs deemed by the API as relevant) in search
1108
- # results. This field is only considered if
1109
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
1110
- # unset.
1142
+ # results. This field is only considered if {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
1111
1143
  #
1112
1144
  # For example, 0 means to return results starting from the first matching
1113
1145
  # job, and 10 means to return from the 11th job. This can be used for
@@ -1130,31 +1162,28 @@ module Google
1130
1162
  # * "relevance desc": By relevance descending, as determined by the API
1131
1163
  # algorithms. Relevance thresholding of query results is only available
1132
1164
  # with this ordering.
1133
- # * "posting`_`publish`_`time desc": By
1134
- # {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
1165
+ # * "posting`_`publish`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
1135
1166
  # descending.
1136
- # * "posting`_`update`_`time desc": By
1137
- # {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
1167
+ # * "posting`_`update`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
1138
1168
  # descending.
1139
1169
  # * "title": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} ascending.
1140
- # * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title}
1141
- # descending.
1170
+ # * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} descending.
1142
1171
  # * "annualized`_`base`_`compensation": By job's
1143
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
1144
- # ascending. Jobs whose annualized base compensation is unspecified are put
1145
- # at the end of search results.
1172
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} ascending. Jobs
1173
+ # whose annualized base compensation is unspecified are put at the end of
1174
+ # search results.
1146
1175
  # * "annualized`_`base`_`compensation desc": By job's
1147
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
1148
- # descending. Jobs whose annualized base compensation is unspecified are put
1149
- # at the end of search results.
1176
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} descending. Jobs
1177
+ # whose annualized base compensation is unspecified are put at the end of
1178
+ # search results.
1150
1179
  # * "annualized`_`total`_`compensation": By job's
1151
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
1152
- # ascending. Jobs whose annualized base compensation is unspecified are put
1153
- # at the end of search results.
1180
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} ascending. Jobs
1181
+ # whose annualized base compensation is unspecified are put at the end of
1182
+ # search results.
1154
1183
  # * "annualized`_`total`_`compensation desc": By job's
1155
- # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
1156
- # descending. Jobs whose annualized base compensation is unspecified are put
1157
- # at the end of search results.
1184
+ # {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} descending. Jobs
1185
+ # whose annualized base compensation is unspecified are put at the end of
1186
+ # search results.
1158
1187
  # * "custom`_`ranking desc": By the relevance score adjusted to the
1159
1188
  # {SearchJobsRequest#custom_ranking_info#ranking_expression} with weight
1160
1189
  # factor assigned by
@@ -1183,9 +1212,8 @@ module Google
1183
1212
  # displayed to the job seeker higher up in the results, with the other jobs
1184
1213
  # being displayed lower down in the results.
1185
1214
  #
1186
- # Defaults to
1187
- # {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
1188
- # if no value is specified.
1215
+ # Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE} if no value
1216
+ # is specified.
1189
1217
  # @param custom_ranking_info [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo | Hash]
1190
1218
  # Optional.
1191
1219
  #
@@ -1197,16 +1225,13 @@ module Google
1197
1225
  # Optional.
1198
1226
  #
1199
1227
  # Controls whether to disable exact keyword match on {Job#job_title},
1200
- # {Google::Cloud::Talent::V4beta1::Job#description Job#description},
1201
- # {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
1202
- # [Job.locations][0],
1203
- # {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When
1204
- # disable keyword match is turned off, a keyword match returns jobs that do
1205
- # not match given category filters when there are matching keywords. For
1206
- # example, for the query "program manager," a result is returned even if the
1207
- # job posting has the title "software developer," which doesn't fall into
1208
- # "program manager" ontology, but does have "program manager" appearing in
1209
- # its description.
1228
+ # {Google::Cloud::Talent::V4beta1::Job#description Job#description}, {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}, [Job.locations][0],
1229
+ # {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When disable keyword match is turned off, a
1230
+ # keyword match returns jobs that do not match given category filters when
1231
+ # there are matching keywords. For example, for the query "program manager,"
1232
+ # a result is returned even if the job posting has the title "software
1233
+ # developer," which doesn't fall into "program manager" ontology, but does
1234
+ # have "program manager" appearing in its description.
1210
1235
  #
1211
1236
  # For queries like "cloud" that don't contain title or
1212
1237
  # location specific ontology, jobs with "cloud" keyword matches are returned
@@ -1233,19 +1258,19 @@ module Google
1233
1258
  # @example
1234
1259
  # require "google/cloud/talent"
1235
1260
  #
1236
- # job_service_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
1237
- # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.project_path("[PROJECT]")
1261
+ # job_client = Google::Cloud::Talent::JobService.new(version: :v4beta1)
1262
+ # formatted_parent = Google::Cloud::Talent::V4beta1::JobServiceClient.tenant_path("[PROJECT]", "[TENANT]")
1238
1263
  #
1239
1264
  # # TODO: Initialize `request_metadata`:
1240
1265
  # request_metadata = {}
1241
1266
  #
1242
1267
  # # Iterate over all results.
1243
- # job_service_client.search_jobs_for_alert(formatted_parent, request_metadata).each do |element|
1268
+ # job_client.search_jobs_for_alert(formatted_parent, request_metadata).each do |element|
1244
1269
  # # Process element.
1245
1270
  # end
1246
1271
  #
1247
1272
  # # Or iterate over results one page at a time.
1248
- # job_service_client.search_jobs_for_alert(formatted_parent, request_metadata).each_page do |page|
1273
+ # job_client.search_jobs_for_alert(formatted_parent, request_metadata).each_page do |page|
1249
1274
  # # Process each page at a time.
1250
1275
  # page.each do |element|
1251
1276
  # # Process element.