google-cloud-talent 0.1.0 → 0.2.0

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 (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.