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
@@ -22,10 +22,13 @@ module Google
22
22
  # @return [String]
23
23
  # Required.
24
24
  #
25
- # Resource name of the project under which the company is created.
25
+ # Resource name of the tenant under which the company is created.
26
26
  #
27
- # The format is "projects/{project_id}", for example,
28
- # "projects/api-test-project".
27
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
28
+ # "projects/api-test-project/tenant/foo".
29
+ #
30
+ # Tenant id is optional and a default tenant is created if unspecified, for
31
+ # example, "projects/api-test-project".
29
32
  # @!attribute [rw] company
30
33
  # @return [Google::Cloud::Talent::V4beta1::Company]
31
34
  # Required.
@@ -40,8 +43,12 @@ module Google
40
43
  #
41
44
  # The resource name of the company to be retrieved.
42
45
  #
43
- # The format is "projects/{project_id}/companies/{company_id}", for example,
44
- # "projects/api-test-project/companies/foo".
46
+ # The format is
47
+ # "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
48
+ # example, "projects/api-test-project/tenants/foo/companies/bar".
49
+ #
50
+ # Tenant id is optional and the default tenant is used if unspecified, for
51
+ # example, "projects/api-test-project/companies/bar".
45
52
  class GetCompanyRequest; end
46
53
 
47
54
  # Request for updating a specified company.
@@ -55,15 +62,11 @@ module Google
55
62
  # Optional but strongly recommended for the best service
56
63
  # experience.
57
64
  #
58
- # If
59
- # {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask}
60
- # is provided, only the specified fields in
61
- # {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#company company} are
62
- # updated. Otherwise all the fields are updated.
65
+ # If {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask} is provided, only the specified fields in
66
+ # {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#company company} are updated. Otherwise all the fields are updated.
63
67
  #
64
68
  # A field mask to specify the company fields to be updated. Only
65
- # top level fields of {Google::Cloud::Talent::V4beta1::Company Company} are
66
- # supported.
69
+ # top level fields of {Google::Cloud::Talent::V4beta1::Company Company} are supported.
67
70
  class UpdateCompanyRequest; end
68
71
 
69
72
  # Request to delete a company.
@@ -73,8 +76,12 @@ module Google
73
76
  #
74
77
  # The resource name of the company to be deleted.
75
78
  #
76
- # The format is "projects/{project_id}/companies/{company_id}", for example,
77
- # "projects/api-test-project/companies/foo".
79
+ # The format is
80
+ # "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
81
+ # example, "projects/api-test-project/tenants/foo/companies/bar".
82
+ #
83
+ # Tenant id is optional and the default tenant is used if unspecified, for
84
+ # example, "projects/api-test-project/companies/bar".
78
85
  class DeleteCompanyRequest; end
79
86
 
80
87
  # List companies for which the client has ACL visibility.
@@ -82,10 +89,13 @@ module Google
82
89
  # @return [String]
83
90
  # Required.
84
91
  #
85
- # Resource name of the project under which the company is created.
92
+ # Resource name of the tenant under which the company is created.
93
+ #
94
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
95
+ # "projects/api-test-project/tenant/foo".
86
96
  #
87
- # The format is "projects/{project_id}", for example,
88
- # "projects/api-test-project".
97
+ # Tenant id is optional and the default tenant is used if unspecified, for
98
+ # example, "projects/api-test-project".
89
99
  # @!attribute [rw] page_token
90
100
  # @return [String]
91
101
  # Optional.
@@ -105,9 +115,8 @@ module Google
105
115
  #
106
116
  # Defaults to false.
107
117
  #
108
- # If true, at most
109
- # {Google::Cloud::Talent::V4beta1::ListCompaniesRequest#page_size page_size} of
110
- # companies are fetched, among which only those with open jobs are returned.
118
+ # If true, at most {Google::Cloud::Talent::V4beta1::ListCompaniesRequest#page_size page_size} of companies are fetched, among which
119
+ # only those with open jobs are returned.
111
120
  class ListCompaniesRequest; end
112
121
 
113
122
  # Output only.
@@ -20,14 +20,17 @@ module Google
20
20
  # Input only.
21
21
  #
22
22
  # Auto-complete parameters.
23
- # @!attribute [rw] name
23
+ # @!attribute [rw] parent
24
24
  # @return [String]
25
25
  # Required.
26
26
  #
27
- # Resource name of project the completion is performed within.
27
+ # Resource name of tenant the completion is performed within.
28
28
  #
29
- # The format is "projects/{project_id}", for example,
30
- # "projects/api-test-project".
29
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
30
+ # "projects/api-test-project/tenant/foo".
31
+ #
32
+ # Tenant id is optional and the default tenant is used if unspecified, for
33
+ # example, "projects/api-test-project".
31
34
  # @!attribute [rw] query
32
35
  # @return [String]
33
36
  # Required.
@@ -44,25 +47,16 @@ module Google
44
47
  # For more information, see
45
48
  # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
46
49
  #
47
- # For
48
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::JOB_TITLE CompletionType::JOB_TITLE}
49
- # type, only open jobs with the same
50
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
51
- # are returned.
52
- #
53
- # For
54
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMPANY_NAME CompletionType::COMPANY_NAME}
55
- # type, only companies having open jobs with the same
56
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
57
- # are returned.
58
- #
59
- # For
60
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}
61
- # type, only open jobs with the same
62
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
63
- # or companies having open jobs with the same
64
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
65
- # are returned.
50
+ # For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::JOB_TITLE CompletionType::JOB_TITLE} type, only open jobs with the same
51
+ # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are returned.
52
+ #
53
+ # For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMPANY_NAME CompletionType::COMPANY_NAME} type,
54
+ # only companies having open jobs with the same {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are
55
+ # returned.
56
+ #
57
+ # For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED} type, only open jobs with the same
58
+ # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} or companies having open jobs with the same
59
+ # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are returned.
66
60
  #
67
61
  # The maximum number of allowed characters is 255.
68
62
  # @!attribute [rw] page_size
@@ -72,26 +66,28 @@ module Google
72
66
  # Completion result count.
73
67
  #
74
68
  # The maximum allowed page size is 10.
75
- # @!attribute [rw] company_name
69
+ # @!attribute [rw] company
76
70
  # @return [String]
77
71
  # Optional.
78
72
  #
79
73
  # If provided, restricts completion to specified company.
80
74
  #
81
- # The format is "projects/{project_id}/companies/{company_id}", for example,
82
- # "projects/api-test-project/companies/foo".
75
+ # The format is
76
+ # "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
77
+ # example, "projects/api-test-project/tenants/foo/companies/bar".
78
+ #
79
+ # Tenant id is optional and the default tenant is used if unspecified, for
80
+ # example, "projects/api-test-project/companies/bar".
83
81
  # @!attribute [rw] scope
84
82
  # @return [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope]
85
83
  # Optional.
86
84
  #
87
- # The scope of the completion. The defaults is
88
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope::PUBLIC CompletionScope::PUBLIC}.
85
+ # The scope of the completion. The defaults is {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope::PUBLIC CompletionScope::PUBLIC}.
89
86
  # @!attribute [rw] type
90
87
  # @return [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType]
91
88
  # Optional.
92
89
  #
93
- # The completion topic. The default is
94
- # {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}.
90
+ # The completion topic. The default is {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}.
95
91
  class CompleteQueryRequest
96
92
  # Enum to specify the scope of completion.
97
93
  module CompletionScope
@@ -46,16 +46,12 @@ module Google
46
46
  # @return [Google::Cloud::Talent::V4beta1::ProfileEvent]
47
47
  # An event issued when a profile searcher interacts with the application
48
48
  # that implements Cloud Talent Solution.
49
- # @!attribute [rw] extra_info
50
- # @return [Hash{String => String}]
49
+ # @!attribute [rw] event_notes
50
+ # @return [String]
51
51
  # Optional.
52
52
  #
53
- # Extra information about this event. Used for storing information with no
54
- # matching field in {Google::Cloud::Talent::V4beta1::Event event} payload, for
55
- # example, user application specific context or details.
56
- #
57
- # At most 20 keys are supported. The maximum total size of all keys and
58
- # values is 2 KB.
53
+ # Notes about the event provided by recruiters or other users, for example,
54
+ # feedback on why a profile was bookmarked.
59
55
  class ClientEvent; end
60
56
 
61
57
  # An event issued when a job seeker interacts with the application that
@@ -64,19 +60,16 @@ module Google
64
60
  # @return [Google::Cloud::Talent::V4beta1::JobEvent::JobEventType]
65
61
  # Required.
66
62
  #
67
- # The type of the event (see
68
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType JobEventType}).
63
+ # The type of the event (see {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType JobEventType}).
69
64
  # @!attribute [rw] jobs
70
65
  # @return [Array<String>]
71
66
  # Required.
72
67
  #
73
- # The {Google::Cloud::Talent::V4beta1::Job#name job name(s)} associated with
74
- # this event. For example, if this is an
75
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::IMPRESSION impression}
76
- # event, this field contains the identifiers of all jobs shown to the job
77
- # seeker. If this was a
78
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::VIEW view} event, this
79
- # field contains the identifier of the viewed job.
68
+ # The {Google::Cloud::Talent::V4beta1::Job#name job name(s)} associated with this event.
69
+ # For example, if this is an {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::IMPRESSION impression} event,
70
+ # this field contains the identifiers of all jobs shown to the job seeker.
71
+ # If this was a {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::VIEW view} event, this field contains the
72
+ # identifier of the viewed job.
80
73
  class JobEvent
81
74
  # An enumeration of an event attributed to the behavior of the end user,
82
75
  # such as a job seeker.
@@ -114,9 +107,7 @@ module Google
114
107
  # submitted an application for a job with a single click without
115
108
  # entering information. If a job seeker performs this action, send only
116
109
  # this event to the service. Do not also send
117
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_START JobEventType::APPLICATION_START}
118
- # or
119
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_FINISH JobEventType::APPLICATION_FINISH}
110
+ # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_START JobEventType::APPLICATION_START} or {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_FINISH JobEventType::APPLICATION_FINISH}
120
111
  # events.
121
112
  APPLICATION_QUICK_SUBMISSION = 6
122
113
 
@@ -136,12 +127,8 @@ module Google
136
127
  # (without viewing the details of the job posting), and is redirected
137
128
  # to a different website to complete the application. If a candidate
138
129
  # performs this action, send only this event to the service. Do not also
139
- # send
140
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_START JobEventType::APPLICATION_START},
141
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_FINISH JobEventType::APPLICATION_FINISH}
142
- # or
143
- # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::VIEW JobEventType::VIEW}
144
- # events.
130
+ # send {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_START JobEventType::APPLICATION_START},
131
+ # {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::APPLICATION_FINISH JobEventType::APPLICATION_FINISH} or {Google::Cloud::Talent::V4beta1::JobEvent::JobEventType::VIEW JobEventType::VIEW} events.
145
132
  APPLICATION_REDIRECT_FROM_SEARCH = 9
146
133
 
147
134
  # This event should be used when a company submits an application
@@ -194,10 +181,9 @@ module Google
194
181
  # @return [Array<String>]
195
182
  # Required.
196
183
  #
197
- # The {Google::Cloud::Talent::V4beta1::Profile#name profile name(s)} associated
198
- # with this client event.
199
- # @!attribute [rw] job_id
200
- # @return [String]
184
+ # The {Google::Cloud::Talent::V4beta1::Profile#name profile name(s)} associated with this client event.
185
+ # @!attribute [rw] jobs
186
+ # @return [Array<String>]
201
187
  # Optional.
202
188
  #
203
189
  # The job ID associated with this client event if there is one. Leave it
@@ -219,31 +205,6 @@ module Google
219
205
 
220
206
  # The profile is bookmarked.
221
207
  BOOKMARK = 3
222
-
223
- # Comment added to the profile.
224
- COMMENT_ADDED = 4
225
-
226
- # Email sent regarding the profile.
227
- EMAIL_SENT = 5
228
-
229
- # The resume of the profile is viewed.
230
- RESUME_VIEWED = 6
231
-
232
- # The profile is added to a job.
233
- ADD_TO_JOB = 7
234
-
235
- # The recruiter explicitly highlights that a given profile is interesting
236
- # enough for later review or is a good result for the search.
237
- POSITIVE_REACTION_TO_PROFILE = 8
238
-
239
- # The recruiter explicitly highlights that a given profile is not
240
- # interesting enough for later review or is not a good result for the
241
- # search.
242
- NEGATIVE_REACTION_TO_PROFILE = 9
243
-
244
- # The candidate is interesting enough to set up an initial screen with the
245
- # recruiter. This step may be skipped based on the interview process.
246
- SCREEN = 10
247
208
  end
248
209
  end
249
210
  end
@@ -20,7 +20,15 @@ module Google
20
20
  # The report event request.
21
21
  # @!attribute [rw] parent
22
22
  # @return [String]
23
- # Parent project name.
23
+ # Required.
24
+ #
25
+ # Resource name of the tenant under which the event is created.
26
+ #
27
+ # The format is "projects/{project_id}/tenants/{tenant_id}", for example,
28
+ # "projects/api-test-project/tenant/foo".
29
+ #
30
+ # Tenant id is optional and a default tenant is created if unspecified, for
31
+ # example, "projects/api-test-project".
24
32
  # @!attribute [rw] client_event
25
33
  # @return [Google::Cloud::Talent::V4beta1::ClientEvent]
26
34
  # Required.
@@ -28,7 +28,7 @@ module Google
28
28
  # location fields.
29
29
  #
30
30
  # The maximum number of allowed characters is 255.
31
- # @!attribute [rw] company_names
31
+ # @!attribute [rw] companies
32
32
  # @return [Array<String>]
33
33
  # Optional.
34
34
  #
@@ -40,8 +40,12 @@ module Google
40
40
  # If multiple values are specified, jobs are searched against the
41
41
  # companies specified.
42
42
  #
43
- # The format is "projects/{project_id}/companies/{company_id}", for example,
44
- # "projects/api-test-project/companies/foo".
43
+ # The format is
44
+ # "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
45
+ # example, "projects/api-test-project/tenants/foo/companies/bar".
46
+ #
47
+ # Tenant id is optional and the default tenant is used if unspecified, for
48
+ # example, "projects/api-test-project/companies/bar".
45
49
  #
46
50
  # At most 20 company filters are allowed.
47
51
  # @!attribute [rw] location_filters
@@ -49,17 +53,15 @@ module Google
49
53
  # Optional.
50
54
  #
51
55
  # The location filter specifies geo-regions containing the jobs to
52
- # search against. See
53
- # {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more
54
- # information.
56
+ # search against. See {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} for more information.
55
57
  #
56
58
  # If a location value isn't specified, jobs fitting the other search
57
59
  # criteria are retrieved regardless of where they're located.
58
60
  #
59
61
  # If multiple values are specified, jobs are retrieved from any of the
60
62
  # specified locations. If different values are specified for the
61
- # {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles}
62
- # parameter, the maximum provided distance is used for all locations.
63
+ # {Google::Cloud::Talent::V4beta1::LocationFilter#distance_in_miles LocationFilter#distance_in_miles} parameter, the maximum provided
64
+ # distance is used for all locations.
63
65
  #
64
66
  # At most 5 location filters are allowed.
65
67
  # @!attribute [rw] job_categories
@@ -102,17 +104,16 @@ module Google
102
104
  # Optional.
103
105
  #
104
106
  # This search filter is applied only to
105
- # {Google::Cloud::Talent::V4beta1::Job#compensation_info Job#compensation_info}.
106
- # For example, if the filter is specified as "Hourly job with per-hour
107
- # compensation > $15", only jobs meeting these criteria are searched. If a
108
- # filter isn't defined, all open jobs are searched.
107
+ # {Google::Cloud::Talent::V4beta1::Job#compensation_info Job#compensation_info}. For example, if the filter is specified
108
+ # as "Hourly job with per-hour compensation > $15", only jobs meeting
109
+ # these criteria are searched. If a filter isn't defined, all open jobs
110
+ # are searched.
109
111
  # @!attribute [rw] custom_attribute_filter
110
112
  # @return [String]
111
113
  # Optional.
112
114
  #
113
115
  # This filter specifies a structured syntax to match against the
114
- # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}
115
- # marked as `filterable`.
116
+ # {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes} marked as `filterable`.
116
117
  #
117
118
  # The syntax for this expression is a subset of SQL syntax.
118
119
  #
@@ -147,8 +148,7 @@ module Google
147
148
  # Optional.
148
149
  #
149
150
  # The employment type filter specifies the employment type of jobs to
150
- # search against, such as
151
- # {Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType::FULL_TIME}.
151
+ # search against, such as {Google::Cloud::Talent::V4beta1::EmploymentType::FULL_TIME EmploymentType::FULL_TIME}.
152
152
  #
153
153
  # If a value isn't specified, jobs in the search results includes any
154
154
  # employment type.
@@ -204,9 +204,8 @@ module Google
204
204
  # If a location filter isn't specified, profiles fitting the other search
205
205
  # criteria are retrieved regardless of where they're located.
206
206
  #
207
- # If
208
- # {Google::Cloud::Talent::V4beta1::LocationFilter#negated LocationFilter#negated}
209
- # is specified, the result doesn't contain profiles from that location.
207
+ # If {Google::Cloud::Talent::V4beta1::LocationFilter#negated LocationFilter#negated} is specified, the result doesn't contain
208
+ # profiles from that location.
210
209
  #
211
210
  # For example, search for profiles with addresses in "New York City".
212
211
  # @!attribute [rw] job_title_filters
@@ -220,9 +219,8 @@ module Google
220
219
  # If multiple values are specified, profiles are retrieved with any of the
221
220
  # specified job titles.
222
221
  #
223
- # If
224
- # {Google::Cloud::Talent::V4beta1::JobTitleFilter#negated JobTitleFilter#negated}
225
- # is specified, the result won't contain profiles with the job titles.
222
+ # If {Google::Cloud::Talent::V4beta1::JobTitleFilter#negated JobTitleFilter#negated} is specified, the result won't contain
223
+ # profiles with the job titles.
226
224
  #
227
225
  # For example, search for profiles with a job title "Product Manager".
228
226
  # @!attribute [rw] employer_filters
@@ -237,9 +235,8 @@ module Google
237
235
  # If multiple employer filters are specified, profiles with any matching
238
236
  # employers are retrieved.
239
237
  #
240
- # If
241
- # {Google::Cloud::Talent::V4beta1::EmployerFilter#negated EmployerFilter#negated}
242
- # is specified, the result won't contain profiles that match the employers.
238
+ # If {Google::Cloud::Talent::V4beta1::EmployerFilter#negated EmployerFilter#negated} is specified, the result won't contain
239
+ # profiles that match the employers.
243
240
  #
244
241
  # For example, search for profiles that have working experience at "Google
245
242
  # LLC".
@@ -255,9 +252,8 @@ module Google
255
252
  # If multiple education filters are specified, profiles that match any
256
253
  # education filters are retrieved.
257
254
  #
258
- # If
259
- # {Google::Cloud::Talent::V4beta1::EducationFilter#negated EducationFilter#negated}
260
- # is specified, the result won't contain profiles that match the educations.
255
+ # If {Google::Cloud::Talent::V4beta1::EducationFilter#negated EducationFilter#negated} is specified, the result won't contain
256
+ # profiles that match the educations.
261
257
  #
262
258
  # For example, search for profiles with a master degree.
263
259
  # @!attribute [rw] skill_filters
@@ -271,8 +267,8 @@ module Google
271
267
  # If multiple skill filters are specified, profiles that match any skill
272
268
  # filters are retrieved.
273
269
  #
274
- # If {Google::Cloud::Talent::V4beta1::SkillFilter#negated SkillFilter#negated}
275
- # is specified, the result won't contain profiles that match the skills.
270
+ # If {Google::Cloud::Talent::V4beta1::SkillFilter#negated SkillFilter#negated} is specified, the result won't contain profiles
271
+ # that match the skills.
276
272
  #
277
273
  # For example, search for profiles that have "Java" and "Python" in skill
278
274
  # list.
@@ -308,41 +304,33 @@ module Google
308
304
  # Optional.
309
305
  #
310
306
  # The application date filters specify application date ranges to match on.
311
- # @!attribute [rw] application_outcome_reason_filters
312
- # @return [Array<Google::Cloud::Talent::V4beta1::ApplicationOutcomeReasonFilter>]
307
+ # @!attribute [rw] application_outcome_notes_filters
308
+ # @return [Array<Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter>]
313
309
  # Optional.
314
310
  #
315
- # The application outcome reason filters specify the reasons for outcome of
311
+ # The application outcome notes filters specify the notes for the outcome of
316
312
  # the job application.
317
- # @!attribute [rw] application_last_stage_filters
318
- # @return [Array<Google::Cloud::Talent::V4beta1::ApplicationLastStageFilter>]
319
- # Optional.
320
- #
321
- # The application last stage filters specify the last stage of job
322
- # application.
323
313
  # @!attribute [rw] application_job_filters
324
314
  # @return [Array<Google::Cloud::Talent::V4beta1::ApplicationJobFilter>]
325
315
  # Optional.
326
316
  #
327
317
  # The application job filters specify the job applied for in the application.
328
- # @!attribute [rw] application_status_filters
329
- # @return [Array<Google::Cloud::Talent::V4beta1::ApplicationStatusFilter>]
330
- # Optional.
331
- #
332
- # The application status filters specify the status of job application.
333
- # @!attribute [rw] custom_field_filter
318
+ # @!attribute [rw] custom_attribute_filter
334
319
  # @return [String]
335
320
  # Optional.
336
321
  #
337
322
  # This filter specifies a structured syntax to match against the
338
- # {Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile#custom_attributes}
339
- # that are marked as `filterable`.
323
+ # {Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile#custom_attributes} that are marked as `filterable`.
340
324
  #
341
325
  # The syntax for this expression is a subset of Google SQL syntax.
342
326
  #
343
- # Supported operators are: =, != where the left of the operator is a custom
344
- # field key and the right of the operator is a string (surrounded by quotes)
345
- # value.
327
+ # String custom attributes: supported operators are =, != where the left of
328
+ # the operator is a custom field key and the right of the operator is a
329
+ # string (surrounded by quotes) value.
330
+ #
331
+ # Numeric custom attributes: Supported operators are '>', '<' or '='
332
+ # operators where the left of the operator is a custom field key and the
333
+ # right of the operator is a numeric value.
346
334
  #
347
335
  # Supported functions are LOWER(<field_name>) to
348
336
  # perform case insensitive match and EMPTY(<field_name>) to filter on the
@@ -400,15 +388,12 @@ module Google
400
388
  # Allows the client to return jobs without a
401
389
  # set location, specifically, telecommuting jobs (telecomuting is considered
402
390
  # by the service as a special location.
403
- # {Google::Cloud::Talent::V4beta1::Job#posting_region Job#posting_region}
404
- # indicates if a job permits telecommuting. If this field is set to
405
- # {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference::TELECOMMUTE_ALLOWED},
406
- # telecommuting jobs are searched, and
407
- # {Google::Cloud::Talent::V4beta1::LocationFilter#address address} and
408
- # {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are ignored.
409
- # If not set or set to
410
- # {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference::TELECOMMUTE_EXCLUDED},
411
- # telecommute job are not searched.
391
+ # {Google::Cloud::Talent::V4beta1::Job#posting_region Job#posting_region} indicates if a job permits telecommuting.
392
+ # If this field is set to {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_ALLOWED TelecommutePreference::TELECOMMUTE_ALLOWED},
393
+ # telecommuting jobs are searched, and {Google::Cloud::Talent::V4beta1::LocationFilter#address address} and {Google::Cloud::Talent::V4beta1::LocationFilter#lat_lng lat_lng} are
394
+ # ignored. If not set or set to
395
+ # {Google::Cloud::Talent::V4beta1::LocationFilter::TelecommutePreference::TELECOMMUTE_EXCLUDED TelecommutePreference::TELECOMMUTE_EXCLUDED}, telecommute job are not
396
+ # searched.
412
397
  #
413
398
  # This filter can be used by itself to search exclusively for telecommuting
414
399
  # jobs, or it can be combined with another location
@@ -470,14 +455,11 @@ module Google
470
455
 
471
456
  # Filter by `base compensation entry's` unit. A job is a match if and
472
457
  # only if the job contains a base CompensationEntry and the base
473
- # CompensationEntry's unit matches provided
474
- # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}. Populate
475
- # one or more
476
- # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
458
+ # CompensationEntry's unit matches provided {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
459
+ # Populate one or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
477
460
  #
478
- # See
479
- # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry}
480
- # for definition of base compensation entry.
461
+ # See {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry} for definition of
462
+ # base compensation entry.
481
463
  UNIT_ONLY = 1
482
464
 
483
465
  # Filter by `base compensation entry's` unit and amount / range. A job
@@ -485,25 +467,18 @@ module Google
485
467
  # the base entry's unit matches provided {Compensation_units} and amount
486
468
  # or range overlaps with provided {Compensation_range}.
487
469
  #
488
- # See
489
- # {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry}
490
- # for definition of base compensation entry.
470
+ # See {Google::Cloud::Talent::V4beta1::CompensationInfo::CompensationEntry CompensationInfo::CompensationEntry} for definition of
471
+ # base compensation entry.
491
472
  #
492
- # Set exactly one
493
- # {Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and
494
- # populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
473
+ # Set exactly one {Google::Cloud::Talent::V4beta1::CompensationFilter#units units} and populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range}.
495
474
  UNIT_AND_AMOUNT = 2
496
475
 
497
476
  # Filter by annualized base compensation amount and `base compensation
498
- # entry's` unit. Populate
499
- # {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
500
- # more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
477
+ # entry's` unit. Populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
501
478
  ANNUALIZED_BASE_AMOUNT = 3
502
479
 
503
480
  # Filter by annualized total compensation amount and `base compensation
504
- # entry's` unit . Populate
505
- # {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or
506
- # more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
481
+ # entry's` unit . Populate {Google::Cloud::Talent::V4beta1::CompensationFilter#range range} and zero or more {Google::Cloud::Talent::V4beta1::CompensationFilter#units units}.
507
482
  ANNUALIZED_TOTAL_AMOUNT = 4
508
483
  end
509
484
  end
@@ -586,7 +561,7 @@ module Google
586
561
  # @return [String]
587
562
  # Required.
588
563
  #
589
- # The skill name. For example, "java", "j2ee", etc.
564
+ # The skill name. For example, "java", "j2ee", and so on.
590
565
  # @!attribute [rw] negated
591
566
  # @return [true, false]
592
567
  # Optional.
@@ -607,12 +582,9 @@ module Google
607
582
  # @return [Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode]
608
583
  # Optional.
609
584
  #
610
- # Define set of
611
- # {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search
612
- # against.
585
+ # Define set of {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord}s to search against.
613
586
  #
614
- # Defaults to
615
- # {Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode::ALL_EMPLOYMENT_RECORDS EmployerFilterMode::ALL_EMPLOYMENT_RECORDS}.
587
+ # Defaults to {Google::Cloud::Talent::V4beta1::EmployerFilter::EmployerFilterMode::ALL_EMPLOYMENT_RECORDS EmployerFilterMode::ALL_EMPLOYMENT_RECORDS}.
616
588
  # @!attribute [rw] negated
617
589
  # @return [true, false]
618
590
  # Optional.
@@ -620,19 +592,16 @@ module Google
620
592
  # Whether to apply negation to the filter so profiles matching the filter
621
593
  # is excluded.
622
594
  class EmployerFilter
623
- # Enum indicating which set of
624
- # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}
625
- # to search against.
595
+ # Enum indicating which set of {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records} to search
596
+ # against.
626
597
  module EmployerFilterMode
627
598
  # Default value.
628
599
  EMPLOYER_FILTER_MODE_UNSPECIFIED = 0
629
600
 
630
- # Apply to all employers in
631
- # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
601
+ # Apply to all employers in {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
632
602
  ALL_EMPLOYMENT_RECORDS = 1
633
603
 
634
- # Apply only to current employer in
635
- # {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
604
+ # Apply only to current employer in {Google::Cloud::Talent::V4beta1::Profile#employment_records Profile#employment_records}.
636
605
  CURRENT_EMPLOYMENT_RECORDS_ONLY = 2
637
606
 
638
607
  # Apply only to past (not current) employers in
@@ -676,10 +645,7 @@ module Google
676
645
  # Work experience filter.
677
646
  #
678
647
  # This filter is used to search for profiles with working experience length
679
- # between
680
- # {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#min_experience min_experience}
681
- # and
682
- # {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#max_experience max_experience}.
648
+ # between {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#min_experience min_experience} and {Google::Cloud::Talent::V4beta1::WorkExperienceFilter#max_experience max_experience}.
683
649
  # @!attribute [rw] min_experience
684
650
  # @return [Google::Protobuf::Duration]
685
651
  # Optional.
@@ -696,13 +662,9 @@ module Google
696
662
  #
697
663
  # Application Date Range Filter.
698
664
  #
699
- # The API matches profiles with
700
- # {Google::Cloud::Talent::V4beta1::JobApplication#application_date JobApplication#application_date}
701
- # between start date and end date (both boundaries are inclusive). The filter
702
- # is ignored if both
703
- # {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#start_date start_date}
704
- # and {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#end_date end_date}
705
- # are missing.
665
+ # The API matches profiles with {Google::Cloud::Talent::V4beta1::Application#application_date Application#application_date} between
666
+ # start date and end date (both boundaries are inclusive). The filter is
667
+ # ignored if both {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#start_date start_date} and {Google::Cloud::Talent::V4beta1::ApplicationDateFilter#end_date end_date} are missing.
706
668
  # @!attribute [rw] start_date
707
669
  # @return [Google::Type::Date]
708
670
  # Optional.
@@ -719,96 +681,45 @@ module Google
719
681
 
720
682
  # Input only.
721
683
  #
722
- # Outcome Reason Filter.
723
- # @!attribute [rw] outcome_reason
684
+ # Outcome Notes Filter.
685
+ # @!attribute [rw] outcome_notes
724
686
  # @return [String]
725
687
  # Required.
726
688
  #
727
689
  # User entered or selected outcome reason. The API does an exact match on the
728
- # {Google::Cloud::Talent::V4beta1::JobApplication#outcome_reason JobApplication#outcome_reason}
729
- # in profiles.
690
+ # {Google::Cloud::Talent::V4beta1::Application#outcome_notes Application#outcome_notes} in profiles.
730
691
  # @!attribute [rw] negated
731
692
  # @return [true, false]
732
693
  # Optional.
733
694
  #
734
695
  # If true, The API excludes all candidates with any
735
- # {Google::Cloud::Talent::V4beta1::JobApplication#outcome_reason JobApplication#outcome_reason}
736
- # matching the outcome reason specified in the filter.
737
- class ApplicationOutcomeReasonFilter; end
738
-
739
- # Input only.
740
- #
741
- # Filter on Last Stage of Application.
742
- # @!attribute [rw] last_stage
743
- # @return [String]
744
- # Required.
745
- #
746
- # User entered or selected last stage the candidate reached in the
747
- # application. The API does an exact match on the
748
- # {Google::Cloud::Talent::V4beta1::JobApplication#last_stage JobApplication#last_stage}
749
- # in profiles.
750
- # @!attribute [rw] negated
751
- # @return [true, false]
752
- # Optional.
753
- # If true, The API excludes all candidates with any
754
- # {Google::Cloud::Talent::V4beta1::JobApplication#last_stage JobApplication#last_stage}
755
- # matching the last stage specified in the filter.
756
- class ApplicationLastStageFilter; end
696
+ # {Google::Cloud::Talent::V4beta1::Application#outcome_notes Application#outcome_notes} matching the outcome reason specified in
697
+ # the filter.
698
+ class ApplicationOutcomeNotesFilter; end
757
699
 
758
700
  # Input only.
759
701
  #
760
702
  # Filter on the job information of Application.
761
- # @!attribute [rw] job_name
762
- # @return [String]
763
- # Optional.
764
- #
765
- # The job resource name in the application. The API does an exact match on
766
- # the {Google::Cloud::Talent::V4beta1::Job#name Job#name} of
767
- # {Google::Cloud::Talent::V4beta1::JobApplication#job JobApplication#job} in
768
- # profiles.
769
703
  # @!attribute [rw] job_requisition_id
770
704
  # @return [String]
771
705
  # Optional.
772
706
  #
773
707
  # The job requisition id in the application. The API does an exact match on
774
- # the {Job#requisistion_id} of
775
- # {Google::Cloud::Talent::V4beta1::JobApplication#job JobApplication#job} in
776
- # profiles.
708
+ # the {Job#requisistion_id} of {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
777
709
  # @!attribute [rw] job_title
778
710
  # @return [String]
779
711
  # Optional.
780
712
  #
781
713
  # The job title in the application. The API does an exact match on the
782
- # {Google::Cloud::Talent::V4beta1::Job#title Job#title} of
783
- # {Google::Cloud::Talent::V4beta1::JobApplication#job JobApplication#job} in
784
- # profiles.
714
+ # {Google::Cloud::Talent::V4beta1::Job#title Job#title} of {Google::Cloud::Talent::V4beta1::Application#job Application#job} in profiles.
785
715
  # @!attribute [rw] negated
786
716
  # @return [true, false]
787
717
  # Optional.
788
718
  #
789
- # If true, the API excludes all profiles with any
790
- # {Google::Cloud::Talent::V4beta1::JobApplication#job JobApplication#job}
719
+ # If true, the API excludes all profiles with any {Google::Cloud::Talent::V4beta1::Application#job Application#job}
791
720
  # matching the filters.
792
721
  class ApplicationJobFilter; end
793
722
 
794
- # Input only.
795
- #
796
- # Filter on status of Application.
797
- # @!attribute [rw] application_status
798
- # @return [Google::Cloud::Talent::V4beta1::JobApplication::ApplicationStatus]
799
- # Required.
800
- #
801
- # User entered or selected application status. The API does an exact match
802
- # between the application status specified in this filter and the
803
- # {JobApplication#status} in profiles.
804
- # @!attribute [rw] negated
805
- # @return [true, false]
806
- # Optional.
807
- #
808
- # If true, The API excludes all candidates with any {JobApplication#status}
809
- # matching the status specified in the filter.
810
- class ApplicationStatusFilter; end
811
-
812
723
  # Input only.
813
724
  #
814
725
  # Filter on create timestamp or update timestamp of profiles.
@@ -832,8 +743,7 @@ module Google
832
743
  #
833
744
  # Specifies which time field to filter profiles.
834
745
  #
835
- # Defaults to
836
- # {Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField::CREATE_TIME}.
746
+ # Defaults to {Google::Cloud::Talent::V4beta1::TimeFilter::TimeField::CREATE_TIME TimeField::CREATE_TIME}.
837
747
  class TimeFilter
838
748
  # Time fields can be used in TimeFilter.
839
749
  module TimeField