google-cloud-talent 0.10.0 → 1.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (80) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +2 -1
  3. data/AUTHENTICATION.md +51 -59
  4. data/LICENSE.md +201 -0
  5. data/MIGRATING.md +347 -0
  6. data/README.md +97 -27
  7. data/lib/{google/cloud/talent/v4beta1/doc/google/protobuf/empty.rb → google-cloud-talent.rb} +4 -14
  8. data/lib/google/cloud/talent.rb +203 -453
  9. data/lib/google/cloud/talent/version.rb +6 -2
  10. metadata +76 -111
  11. data/LICENSE +0 -201
  12. data/lib/google/cloud/talent/v4beta1.rb +0 -543
  13. data/lib/google/cloud/talent/v4beta1/application_pb.rb +0 -63
  14. data/lib/google/cloud/talent/v4beta1/application_service_client.rb +0 -527
  15. data/lib/google/cloud/talent/v4beta1/application_service_client_config.json +0 -51
  16. data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +0 -55
  17. data/lib/google/cloud/talent/v4beta1/application_service_services_pb.rb +0 -55
  18. data/lib/google/cloud/talent/v4beta1/batch_pb.rb +0 -18
  19. data/lib/google/cloud/talent/v4beta1/common_pb.rb +0 -341
  20. data/lib/google/cloud/talent/v4beta1/company_pb.rb +0 -41
  21. data/lib/google/cloud/talent/v4beta1/company_service_client.rb +0 -536
  22. data/lib/google/cloud/talent/v4beta1/company_service_client_config.json +0 -51
  23. data/lib/google/cloud/talent/v4beta1/company_service_pb.rb +0 -56
  24. data/lib/google/cloud/talent/v4beta1/company_service_services_pb.rb +0 -55
  25. data/lib/google/cloud/talent/v4beta1/completion_client.rb +0 -344
  26. data/lib/google/cloud/talent/v4beta1/completion_client_config.json +0 -31
  27. data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +0 -56
  28. data/lib/google/cloud/talent/v4beta1/completion_service_services_pb.rb +0 -47
  29. data/lib/google/cloud/talent/v4beta1/credentials.rb +0 -42
  30. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb +0 -162
  31. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb +0 -100
  32. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb +0 -1057
  33. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb +0 -107
  34. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company_service.rb +0 -116
  35. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/completion_service.rb +0 -130
  36. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb +0 -224
  37. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event_service.rb +0 -36
  38. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb +0 -763
  39. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/histogram.rb +0 -50
  40. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job.rb +0 -331
  41. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job_service.rb +0 -694
  42. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb +0 -750
  43. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile_service.rb +0 -361
  44. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant.rb +0 -70
  45. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant_service.rb +0 -96
  46. data/lib/google/cloud/talent/v4beta1/doc/google/longrunning/operations.rb +0 -51
  47. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/any.rb +0 -131
  48. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/duration.rb +0 -91
  49. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/field_mask.rb +0 -222
  50. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/timestamp.rb +0 -113
  51. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/wrappers.rb +0 -34
  52. data/lib/google/cloud/talent/v4beta1/doc/google/rpc/status.rb +0 -39
  53. data/lib/google/cloud/talent/v4beta1/doc/google/type/date.rb +0 -43
  54. data/lib/google/cloud/talent/v4beta1/doc/google/type/latlng.rb +0 -31
  55. data/lib/google/cloud/talent/v4beta1/doc/google/type/money.rb +0 -36
  56. data/lib/google/cloud/talent/v4beta1/doc/google/type/postal_address.rb +0 -128
  57. data/lib/google/cloud/talent/v4beta1/doc/google/type/timeofday.rb +0 -37
  58. data/lib/google/cloud/talent/v4beta1/event_pb.rb +0 -69
  59. data/lib/google/cloud/talent/v4beta1/event_service_client.rb +0 -271
  60. data/lib/google/cloud/talent/v4beta1/event_service_client_config.json +0 -31
  61. data/lib/google/cloud/talent/v4beta1/event_service_pb.rb +0 -27
  62. data/lib/google/cloud/talent/v4beta1/event_service_services_pb.rb +0 -52
  63. data/lib/google/cloud/talent/v4beta1/filters_pb.rb +0 -187
  64. data/lib/google/cloud/talent/v4beta1/helpers.rb +0 -179
  65. data/lib/google/cloud/talent/v4beta1/histogram_pb.rb +0 -27
  66. data/lib/google/cloud/talent/v4beta1/job_pb.rb +0 -72
  67. data/lib/google/cloud/talent/v4beta1/job_service_client.rb +0 -1521
  68. data/lib/google/cloud/talent/v4beta1/job_service_client_config.json +0 -76
  69. data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +0 -166
  70. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +0 -87
  71. data/lib/google/cloud/talent/v4beta1/profile_pb.rb +0 -213
  72. data/lib/google/cloud/talent/v4beta1/profile_service_client.rb +0 -765
  73. data/lib/google/cloud/talent/v4beta1/profile_service_client_config.json +0 -56
  74. data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +0 -91
  75. data/lib/google/cloud/talent/v4beta1/profile_service_services_pb.rb +0 -64
  76. data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +0 -34
  77. data/lib/google/cloud/talent/v4beta1/tenant_service_client.rb +0 -474
  78. data/lib/google/cloud/talent/v4beta1/tenant_service_client_config.json +0 -51
  79. data/lib/google/cloud/talent/v4beta1/tenant_service_pb.rb +0 -55
  80. data/lib/google/cloud/talent/v4beta1/tenant_service_services_pb.rb +0 -54
@@ -1,750 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Cloud
18
- module Talent
19
- module V4beta1
20
- # A resource that represents the profile for a job candidate (also referred to
21
- # as a "single-source profile").
22
- # @!attribute [rw] name
23
- # @return [String]
24
- # Required during profile update.
25
- #
26
- # Resource name assigned to a profile by the API.
27
- #
28
- # The format is
29
- # "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
30
- # for example, "projects/foo/tenants/bar/profiles/baz".
31
- # @!attribute [rw] external_id
32
- # @return [String]
33
- # Profile's id in client system, if available. This value is unique for each
34
- # profile inside a tenant. An error is thrown if another profile with the
35
- # same external_id is created.
36
- #
37
- # The maximum number of bytes allowed is 100.
38
- # @!attribute [rw] source
39
- # @return [String]
40
- # The source description indicating where the profile is acquired.
41
- #
42
- # For example, if a candidate profile is acquired from a resume, the user can
43
- # input "resume" here to indicate the source.
44
- #
45
- # The maximum number of bytes allowed is 100.
46
- # @!attribute [rw] uri
47
- # @return [String]
48
- # The URI set by clients that links to this profile's client-side copy.
49
- #
50
- # The maximum number of bytes allowed is 4000.
51
- # @!attribute [rw] group_id
52
- # @return [String]
53
- # The cluster id of the profile to associate with other profile(s) for the
54
- # same candidate.
55
- #
56
- # This field should be generated by the customer. If a value is not provided,
57
- # a random UUID is assigned to this field of the profile.
58
- #
59
- # This is used to link multiple profiles to the same candidate. For example,
60
- # a client has a candidate with two profiles, where one was created recently
61
- # and the other one was created 5 years ago. These two profiles may be very
62
- # different. The clients can create the first profile and get a generated
63
- # {Google::Cloud::Talent::V4beta1::Profile#group_id group_id}, and assign it when the second profile is created,
64
- # indicating these two profiles are referring to the same candidate.
65
- # @!attribute [rw] is_hirable
66
- # @return [Google::Protobuf::BoolValue]
67
- # Indicates the hirable status of the candidate.
68
- # @!attribute [rw] create_time
69
- # @return [Google::Protobuf::Timestamp]
70
- # The timestamp when the profile was first created at this source.
71
- # @!attribute [rw] update_time
72
- # @return [Google::Protobuf::Timestamp]
73
- # The timestamp when the profile was last updated at this source.
74
- # @!attribute [rw] candidate_update_time
75
- # @return [Google::Protobuf::Timestamp]
76
- # The timestamp when the profile was last updated as a result of a direct or
77
- # indirect action by a candidate.
78
- #
79
- # These actions include:
80
- #
81
- # * Direct actions such as the candidate submitting a new resume as part of a
82
- # job application to the agency, using a self-service tool such as a website
83
- # to update their profile, and so on.
84
- # * Indirect actions by the candidate such as uploading a resume to a job
85
- # board that is collected by the agency through a feed, providing a resume to
86
- # a recruiter who then uploads it into the ATS, and so on.
87
- # * Updates made to the candidate's profile by the recruiter as a result of
88
- # interacting with the candidate (for example adding a skill or work
89
- # preference, and so on). Changes to {Google::Cloud::Talent::V4beta1::Profile#recruiting_notes recruiting_notes} are specifically
90
- # excluded from this action type.
91
- #
92
- # Note: {Google::Cloud::Talent::V4beta1::Profile#candidate_update_time candidate_update_time} must be greater than or equal to
93
- # {Google::Cloud::Talent::V4beta1::Profile#resume_update_time resume_update_time} or an error is thrown.
94
- # @!attribute [rw] resume_update_time
95
- # @return [Google::Protobuf::Timestamp]
96
- # The timestamp when the candidate's resume was added or updated on the
97
- # candidate's profile. Whether that resume was directly uploaded by a
98
- # candidate, pulled from a 3rd party job board feed, added by a recruiter,
99
- # and so on.
100
- #
101
- # If this field is updated, it's expected that {Google::Cloud::Talent::V4beta1::Profile#resume resume} is provided in
102
- # the create or update calls.
103
- # @!attribute [rw] resume
104
- # @return [Google::Cloud::Talent::V4beta1::Resume]
105
- # The resume representing this profile.
106
- # @!attribute [rw] person_names
107
- # @return [Array<Google::Cloud::Talent::V4beta1::PersonName>]
108
- # The names of the candidate this profile references.
109
- #
110
- # Currently only one person name is supported.
111
- # @!attribute [rw] addresses
112
- # @return [Array<Google::Cloud::Talent::V4beta1::Address>]
113
- # The candidate's postal addresses. It's highly recommended to
114
- # input this information as accurately as possible to help improve search
115
- # quality. Here are some recommendations:
116
- #
117
- # * Provide {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} if possible, especially if the address is
118
- # PERSONAL. During a search only personal addresses are considered. If there
119
- # is no such address, all addresses with unspecified usage are assumed to be
120
- # personal.
121
- # * Provide {Google::Cloud::Talent::V4beta1::Address#current Address#current} for the current address if possible. During
122
- # a search, only current addresses are considered. If there is no such
123
- # address, all addresses are assumed to be current.
124
- #
125
- # When displaying a candidate's addresses, it is sometimes desirable to limit
126
- # the number of addresses shown. In these cases we recommend that you display
127
- # the addresses in the following order of priority:
128
- # 1. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is PERSONAL and {Google::Cloud::Talent::V4beta1::Address#current Address#current} is true.
129
- # 2. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is PERSONAL and {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false or not
130
- # set.
131
- # 3. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is CONTACT_INFO_USAGE_UNSPECIFIED and
132
- # {Google::Cloud::Talent::V4beta1::Address#current Address#current} is true.
133
- # 4. {Google::Cloud::Talent::V4beta1::Address#usage Address#usage} is CONTACT_INFO_USAGE_UNSPECIFIED and
134
- # {Google::Cloud::Talent::V4beta1::Address#current Address#current} is false or not set.
135
- # @!attribute [rw] email_addresses
136
- # @return [Array<Google::Cloud::Talent::V4beta1::Email>]
137
- # The candidate's email addresses.
138
- # @!attribute [rw] phone_numbers
139
- # @return [Array<Google::Cloud::Talent::V4beta1::Phone>]
140
- # The candidate's phone number(s).
141
- # @!attribute [rw] personal_uris
142
- # @return [Array<Google::Cloud::Talent::V4beta1::PersonalUri>]
143
- # The candidate's personal URIs.
144
- # @!attribute [rw] additional_contact_info
145
- # @return [Array<Google::Cloud::Talent::V4beta1::AdditionalContactInfo>]
146
- # Available contact information besides {Google::Cloud::Talent::V4beta1::Profile#addresses addresses}, {Google::Cloud::Talent::V4beta1::Profile#email_addresses email_addresses},
147
- # {Google::Cloud::Talent::V4beta1::Profile#phone_numbers phone_numbers} and {Google::Cloud::Talent::V4beta1::Profile#personal_uris personal_uris}. For example, Hang-out, Skype.
148
- # @!attribute [rw] employment_records
149
- # @return [Array<Google::Cloud::Talent::V4beta1::EmploymentRecord>]
150
- # The employment history records of the candidate. It's highly recommended
151
- # to input this information as accurately as possible to help improve search
152
- # quality. Here are some recommendations:
153
- #
154
- # * Specify the start and end dates of the employment records.
155
- # * List different employment types separately, no matter how minor the
156
- # change is.
157
- # For example, only job title is changed from "software engineer" to "senior
158
- # software engineer".
159
- # * Provide {Google::Cloud::Talent::V4beta1::EmploymentRecord#is_current EmploymentRecord#is_current} for the current employment if
160
- # possible. If not, it's inferred from user inputs.
161
- #
162
- # The limitation for max number of employment records is 100.
163
- # @!attribute [rw] education_records
164
- # @return [Array<Google::Cloud::Talent::V4beta1::EducationRecord>]
165
- # The education history record of the candidate. It's highly recommended to
166
- # input this information as accurately as possible to help improve search
167
- # quality. Here are some recommendations:
168
- #
169
- # * Specify the start and end dates of the education records.
170
- # * List each education type separately, no matter how minor the change is.
171
- # For example, the profile contains the education experience from the same
172
- # school but different degrees.
173
- # * Provide {Google::Cloud::Talent::V4beta1::EducationRecord#is_current EducationRecord#is_current} for the current education if
174
- # possible. If not, it's inferred from user inputs.
175
- #
176
- # The limitation for max number of education records is 100.
177
- # @!attribute [rw] skills
178
- # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
179
- # The skill set of the candidate. It's highly recommended to provide as
180
- # much information as possible to help improve the search quality.
181
- #
182
- # The limitation for max number of skills is 500.
183
- # @!attribute [rw] activities
184
- # @return [Array<Google::Cloud::Talent::V4beta1::Activity>]
185
- # The individual or collaborative activities which the candidate has
186
- # participated in, for example, open-source projects, class assignments that
187
- # aren't listed in {Google::Cloud::Talent::V4beta1::Profile#employment_records employment_records}.
188
- #
189
- # The limitation for max number of activities is 50.
190
- # @!attribute [rw] publications
191
- # @return [Array<Google::Cloud::Talent::V4beta1::Publication>]
192
- # The publications published by the candidate.
193
- #
194
- # The limitation for max number of publications is 50.
195
- # @!attribute [rw] patents
196
- # @return [Array<Google::Cloud::Talent::V4beta1::Patent>]
197
- # The patents acquired by the candidate.
198
- # @!attribute [rw] certifications
199
- # @return [Array<Google::Cloud::Talent::V4beta1::Certification>]
200
- # The certifications acquired by the candidate.
201
- # @!attribute [rw] applications
202
- # @return [Array<String>]
203
- # Output only. The resource names of the candidate's applications.
204
- # @!attribute [rw] assignments
205
- # @return [Array<String>]
206
- # Output only. The resource names of the candidate's assignments.
207
- # @!attribute [rw] custom_attributes
208
- # @return [Hash{String => Google::Cloud::Talent::V4beta1::CustomAttribute}]
209
- # A map of fields to hold both filterable and non-filterable custom profile
210
- # attributes that aren't covered by the provided structured fields. See
211
- # {Google::Cloud::Talent::V4beta1::CustomAttribute CustomAttribute} for more details.
212
- #
213
- # At most 100 filterable and at most 100 unfilterable keys are supported. If
214
- # limit is exceeded, an error is thrown. Custom attributes are `unfilterable`
215
- # by default. These are filterable when the `filterable` flag is set to
216
- # `true`.
217
- #
218
- # Numeric custom attributes: each key can only map to one numeric value,
219
- # otherwise an error is thrown. Client can also filter on numeric custom
220
- # attributes using '>', '<' or '=' operators.
221
- #
222
- # String custom attributes: each key can map up to 50 string values. For
223
- # filterable string value, each value has a byte size of no more than 256B.
224
- # For unfilterable string values, the maximum byte size of a single key is
225
- # 64B. An error is thrown for any request exceeding the limit.
226
- # The maximum total byte size is 10KB.
227
- # @!attribute [rw] processed
228
- # @return [true, false]
229
- # Output only. Indicates if a summarized profile was created as part of the
230
- # profile creation API call. This flag does not indicate whether a profile is
231
- # searchable or not.
232
- # @!attribute [rw] keyword_snippet
233
- # @return [String]
234
- # Output only. Keyword snippet shows how the search result is related to a
235
- # search query. This is only returned in {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}.
236
- # @!attribute [rw] availability_signals
237
- # @return [Array<Google::Cloud::Talent::V4beta1::AvailabilitySignal>]
238
- # Output only. Candidate's availability signals.
239
- # @!attribute [rw] derived_addresses
240
- # @return [Array<Google::Cloud::Talent::V4beta1::Location>]
241
- # Output only. Derived locations of the profile, resolved from {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses}.
242
- #
243
- # {Google::Cloud::Talent::V4beta1::Profile#derived_addresses derived_addresses} are exactly matched to {Google::Cloud::Talent::V4beta1::Profile#addresses Profile#addresses} in the
244
- # same order.
245
- class Profile; end
246
-
247
- # Candidate availability signal.
248
- # @!attribute [rw] type
249
- # @return [Google::Cloud::Talent::V4beta1::AvailabilitySignalType]
250
- # Type of signal.
251
- # @!attribute [rw] last_update_time
252
- # @return [Google::Protobuf::Timestamp]
253
- # Timestamp of when the given availability activity last happened.
254
- # @!attribute [rw] filter_satisfied
255
- # @return [Google::Protobuf::BoolValue]
256
- # Indicates if the {Google::Cloud::Talent::V4beta1::AvailabilitySignal#last_update_time last_update_time} is within
257
- # {Google::Cloud::Talent::V4beta1::AvailabilityFilter#range AvailabilityFilter#range}.
258
- #
259
- # Returned only in a search response when there is an {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter}
260
- # in {Google::Cloud::Talent::V4beta1::ProfileQuery#availability_filters ProfileQuery#availability_filters} where
261
- # {Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type} matches {Google::Cloud::Talent::V4beta1::AvailabilitySignal#type type}.
262
- class AvailabilitySignal; end
263
-
264
- # Resource that represents a resume.
265
- # @!attribute [rw] structured_resume
266
- # @return [String]
267
- # Users can create a profile with only this field field, if {Google::Cloud::Talent::V4beta1::Resume#resume_type resume_type}
268
- # is {Google::Cloud::Talent::V4beta1::Resume::ResumeType::HRXML HRXML}. For example, the API parses this field and
269
- # creates a profile
270
- # with all structured fields populated. {Google::Cloud::Talent::V4beta1::EmploymentRecord EmploymentRecord},
271
- # {Google::Cloud::Talent::V4beta1::EducationRecord EducationRecord}, and so on. An error is thrown if this field cannot be
272
- # parsed.
273
- #
274
- # Note that the use of the functionality offered by this field to extract
275
- # data from resumes is an Alpha feature and as such is not covered by any
276
- # SLA.
277
- # @!attribute [rw] resume_type
278
- # @return [Google::Cloud::Talent::V4beta1::Resume::ResumeType]
279
- # The format of {Google::Cloud::Talent::V4beta1::Resume#structured_resume structured_resume}.
280
- class Resume
281
- # The format of a structured resume.
282
- module ResumeType
283
- # Default value.
284
- RESUME_TYPE_UNSPECIFIED = 0
285
-
286
- # The profile contents in HR-XML format.
287
- # See https://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
288
- # information about Human Resources XML.
289
- HRXML = 1
290
-
291
- # Resume type not specified.
292
- OTHER_RESUME_TYPE = 2
293
- end
294
- end
295
-
296
- # Resource that represents the name of a person.
297
- # @!attribute [rw] formatted_name
298
- # @return [String]
299
- # A string represents a person's full name. For example, "Dr. John Smith".
300
- #
301
- # Number of characters allowed is 100.
302
- # @!attribute [rw] structured_name
303
- # @return [Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName]
304
- # A person's name in a structured way (last name, first name, suffix, and
305
- # so on.)
306
- # @!attribute [rw] preferred_name
307
- # @return [String]
308
- # Preferred name for the person. This field is ignored if {Google::Cloud::Talent::V4beta1::PersonName#structured_name structured_name}
309
- # is provided.
310
- #
311
- # Number of characters allowed is 100.
312
- class PersonName
313
- # Resource that represents a person's structured name.
314
- # @!attribute [rw] given_name
315
- # @return [String]
316
- # Given/first name.
317
- #
318
- # It's derived from {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name} if not provided.
319
- #
320
- # Number of characters allowed is 100.
321
- # @!attribute [rw] preferred_name
322
- # @return [String]
323
- # Preferred given/first name or nickname.
324
- #
325
- # Number of characters allowed is 100.
326
- # @!attribute [rw] middle_initial
327
- # @return [String]
328
- # Middle initial.
329
- #
330
- # It's derived from {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name} if not provided.
331
- #
332
- # Number of characters allowed is 20.
333
- # @!attribute [rw] family_name
334
- # @return [String]
335
- # Family/last name.
336
- #
337
- # It's derived from {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name} if not provided.
338
- #
339
- # Number of characters allowed is 100.
340
- # @!attribute [rw] suffixes
341
- # @return [Array<String>]
342
- # Suffixes.
343
- #
344
- # Number of characters allowed is 20.
345
- # @!attribute [rw] prefixes
346
- # @return [Array<String>]
347
- # Prefixes.
348
- #
349
- # Number of characters allowed is 20.
350
- class PersonStructuredName; end
351
- end
352
-
353
- # Resource that represents a address.
354
- # @!attribute [rw] usage
355
- # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
356
- # The usage of the address. For example, SCHOOL, WORK, PERSONAL.
357
- # @!attribute [rw] unstructured_address
358
- # @return [String]
359
- # Unstructured address.
360
- #
361
- # For example, "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
362
- # "Sunnyvale, California".
363
- #
364
- # Number of characters allowed is 100.
365
- # @!attribute [rw] structured_address
366
- # @return [Google::Type::PostalAddress]
367
- # Structured address that contains street address, city, state, country,
368
- # and so on.
369
- # @!attribute [rw] current
370
- # @return [Google::Protobuf::BoolValue]
371
- # Indicates if it's the person's current address.
372
- class Address; end
373
-
374
- # Resource that represents a person's email address.
375
- # @!attribute [rw] usage
376
- # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
377
- # The usage of the email address. For example, SCHOOL, WORK, PERSONAL.
378
- # @!attribute [rw] email_address
379
- # @return [String]
380
- # Email address.
381
- #
382
- # Number of characters allowed is 4,000.
383
- class Email; end
384
-
385
- # Resource that represents a person's telephone number.
386
- # @!attribute [rw] usage
387
- # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
388
- # The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
389
- # @!attribute [rw] type
390
- # @return [Google::Cloud::Talent::V4beta1::Phone::PhoneType]
391
- # The phone type. For example, LANDLINE, MOBILE, FAX.
392
- # @!attribute [rw] number
393
- # @return [String]
394
- # Phone number.
395
- #
396
- # Any phone formats are supported and only exact matches are performed on
397
- # searches. For example, if a phone number in profile is provided in the
398
- # format of "(xxx)xxx-xxxx", in profile searches the same phone format
399
- # has to be provided.
400
- #
401
- # Number of characters allowed is 20.
402
- # @!attribute [rw] when_available
403
- # @return [String]
404
- # When this number is available. Any descriptive string is expected.
405
- #
406
- # Number of characters allowed is 100.
407
- class Phone
408
- # Enum that represents the type of the telephone.
409
- module PhoneType
410
- # Default value.
411
- PHONE_TYPE_UNSPECIFIED = 0
412
-
413
- # A landline.
414
- LANDLINE = 1
415
-
416
- # A mobile.
417
- MOBILE = 2
418
-
419
- # A fax.
420
- FAX = 3
421
-
422
- # A pager.
423
- PAGER = 4
424
-
425
- # A TTY (test telephone) or TDD (telecommunication device for the deaf).
426
- TTY_OR_TDD = 5
427
-
428
- # A voicemail.
429
- VOICEMAIL = 6
430
-
431
- # A virtual telephone number is a number that can be routed to another
432
- # number and managed by the user via Web, SMS, IVR, and so on. It is
433
- # associated with a particular person, and may be routed to either a MOBILE
434
- # or LANDLINE number. The {Google::Cloud::Talent::V4beta1::ContactInfoUsage phone usage} should
435
- # be set to PERSONAL for these phone types. Some more information can be
436
- # found here: https://en.wikipedia.org/wiki/Personal_Numbers
437
- VIRTUAL = 7
438
-
439
- # Voice over IP numbers. This includes TSoIP (Telephony Service over IP).
440
- VOIP = 8
441
-
442
- # In some regions (e.g. the USA), it is impossible to distinguish between
443
- # fixed-line and mobile numbers by looking at the phone number itself.
444
- MOBILE_OR_LANDLINE = 9
445
- end
446
- end
447
-
448
- # Resource that represents a valid URI for a personal use.
449
- # @!attribute [rw] uri
450
- # @return [String]
451
- # The personal URI.
452
- #
453
- # Number of characters allowed is 4,000.
454
- class PersonalUri; end
455
-
456
- # Resource that represents contact information other than phone, email,
457
- # URI and addresses.
458
- # @!attribute [rw] usage
459
- # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
460
- # The usage of this contact method. For example, SCHOOL, WORK, PERSONAL.
461
- # @!attribute [rw] name
462
- # @return [String]
463
- # The name of the contact method.
464
- #
465
- # For example, "hangout", "skype".
466
- #
467
- # Number of characters allowed is 100.
468
- # @!attribute [rw] contact_id
469
- # @return [String]
470
- # The contact id.
471
- #
472
- # Number of characters allowed is 100.
473
- class AdditionalContactInfo; end
474
-
475
- # Resource that represents an employment record of a candidate.
476
- # @!attribute [rw] start_date
477
- # @return [Google::Type::Date]
478
- # Start date of the employment.
479
- # @!attribute [rw] end_date
480
- # @return [Google::Type::Date]
481
- # End date of the employment.
482
- # @!attribute [rw] employer_name
483
- # @return [String]
484
- # The name of the employer company/organization.
485
- #
486
- # For example, "Google", "Alphabet", and so on.
487
- #
488
- # Number of characters allowed is 250.
489
- # @!attribute [rw] division_name
490
- # @return [String]
491
- # The division name of the employment.
492
- #
493
- # For example, division, department, client, and so on.
494
- #
495
- # Number of characters allowed is 100.
496
- # @!attribute [rw] address
497
- # @return [Google::Cloud::Talent::V4beta1::Address]
498
- # The physical address of the employer.
499
- # @!attribute [rw] job_title
500
- # @return [String]
501
- # The job title of the employment.
502
- #
503
- # For example, "Software Engineer", "Data Scientist", and so on.
504
- #
505
- # Number of characters allowed is 250.
506
- # @!attribute [rw] job_description
507
- # @return [String]
508
- # The description of job content.
509
- #
510
- # Number of characters allowed is 100,000.
511
- # @!attribute [rw] is_supervisor
512
- # @return [Google::Protobuf::BoolValue]
513
- # If the jobs is a supervisor position.
514
- # @!attribute [rw] is_self_employed
515
- # @return [Google::Protobuf::BoolValue]
516
- # If this employment is self-employed.
517
- # @!attribute [rw] is_current
518
- # @return [Google::Protobuf::BoolValue]
519
- # If this employment is current.
520
- # @!attribute [rw] job_title_snippet
521
- # @return [String]
522
- # Output only. The job title snippet shows how the {Google::Cloud::Talent::V4beta1::EmploymentRecord#job_title job_title} is related
523
- # to a search query. It's empty if the {Google::Cloud::Talent::V4beta1::EmploymentRecord#job_title job_title} isn't related to the
524
- # search query.
525
- # @!attribute [rw] job_description_snippet
526
- # @return [String]
527
- # Output only. The job description snippet shows how the {Google::Cloud::Talent::V4beta1::EmploymentRecord#job_description job_description}
528
- # is related to a search query. It's empty if the {Google::Cloud::Talent::V4beta1::EmploymentRecord#job_description job_description} isn't
529
- # related to the search query.
530
- # @!attribute [rw] employer_name_snippet
531
- # @return [String]
532
- # Output only. The employer name snippet shows how the {Google::Cloud::Talent::V4beta1::EmploymentRecord#employer_name employer_name} is
533
- # related to a search query. It's empty if the {Google::Cloud::Talent::V4beta1::EmploymentRecord#employer_name employer_name} isn't
534
- # related to the search query.
535
- class EmploymentRecord; end
536
-
537
- # Resource that represents an education record of a candidate.
538
- # @!attribute [rw] start_date
539
- # @return [Google::Type::Date]
540
- # The start date of the education.
541
- # @!attribute [rw] end_date
542
- # @return [Google::Type::Date]
543
- # The end date of the education.
544
- # @!attribute [rw] expected_graduation_date
545
- # @return [Google::Type::Date]
546
- # The expected graduation date if currently pursuing a degree.
547
- # @!attribute [rw] school_name
548
- # @return [String]
549
- # The name of the school or institution.
550
- #
551
- # For example, "Stanford University", "UC Berkeley", and so on.
552
- #
553
- # Number of characters allowed is 250.
554
- # @!attribute [rw] address
555
- # @return [Google::Cloud::Talent::V4beta1::Address]
556
- # The physical address of the education institution.
557
- # @!attribute [rw] degree_description
558
- # @return [String]
559
- # The full description of the degree.
560
- #
561
- # For example, "Master of Science in Computer Science", "B.S in Math".
562
- #
563
- # Number of characters allowed is 100.
564
- # @!attribute [rw] structured_degree
565
- # @return [Google::Cloud::Talent::V4beta1::Degree]
566
- # The structured notation of the degree.
567
- # @!attribute [rw] description
568
- # @return [String]
569
- # The description of the education.
570
- #
571
- # Number of characters allowed is 100,000.
572
- # @!attribute [rw] is_current
573
- # @return [Google::Protobuf::BoolValue]
574
- # If this education is current.
575
- # @!attribute [rw] school_name_snippet
576
- # @return [String]
577
- # Output only. The school name snippet shows how the {Google::Cloud::Talent::V4beta1::EducationRecord#school_name school_name} is related to a
578
- # search query in search result. It's empty if the {Google::Cloud::Talent::V4beta1::EducationRecord#school_name school_name} isn't
579
- # related to the search query.
580
- # @!attribute [rw] degree_snippet
581
- # @return [String]
582
- # Output only. The job description snippet shows how the {Google::Cloud::Talent::V4beta1::Degree Degree} is related to a search
583
- # query in search result. It's empty if the {Google::Cloud::Talent::V4beta1::Degree Degree} isn't related to the
584
- # search query.
585
- class EducationRecord; end
586
-
587
- # Resource that represents a degree pursuing or acquired by a candidate.
588
- # @!attribute [rw] degree_type
589
- # @return [Google::Cloud::Talent::V4beta1::DegreeType]
590
- # ISCED degree type.
591
- # @!attribute [rw] degree_name
592
- # @return [String]
593
- # Full Degree name.
594
- #
595
- # For example, "B.S.", "Master of Arts", and so on.
596
- #
597
- # Number of characters allowed is 100.
598
- # @!attribute [rw] fields_of_study
599
- # @return [Array<String>]
600
- # Fields of study for the degree.
601
- #
602
- # For example, "Computer science", "engineering".
603
- #
604
- # Number of characters allowed is 100.
605
- class Degree; end
606
-
607
- # Resource that represents an individual or collaborative activity participated
608
- # in by a candidate, for example, an open-source project, a class assignment,
609
- # and so on.
610
- # @!attribute [rw] display_name
611
- # @return [String]
612
- # Activity display name.
613
- #
614
- # Number of characters allowed is 100.
615
- # @!attribute [rw] description
616
- # @return [String]
617
- # Activity description.
618
- #
619
- # Number of characters allowed is 100,000.
620
- # @!attribute [rw] uri
621
- # @return [String]
622
- # Activity URI.
623
- #
624
- # Number of characters allowed is 4,000.
625
- # @!attribute [rw] create_date
626
- # @return [Google::Type::Date]
627
- # The first creation date of the activity.
628
- # @!attribute [rw] update_date
629
- # @return [Google::Type::Date]
630
- # The last update date of the activity.
631
- # @!attribute [rw] team_members
632
- # @return [Array<String>]
633
- # A list of team members involved in this activity.
634
- #
635
- # Number of characters allowed is 100.
636
- #
637
- # The limitation for max number of team members is 50.
638
- # @!attribute [rw] skills_used
639
- # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
640
- # A list of skills used in this activity.
641
- #
642
- # The limitation for max number of skills used is 50.
643
- # @!attribute [rw] activity_name_snippet
644
- # @return [String]
645
- # Output only. Activity name snippet shows how the {Google::Cloud::Talent::V4beta1::Activity#display_name display_name} is related to a search
646
- # query. It's empty if the {Google::Cloud::Talent::V4beta1::Activity#display_name display_name} isn't related to the search
647
- # query.
648
- # @!attribute [rw] activity_description_snippet
649
- # @return [String]
650
- # Output only. Activity description snippet shows how the
651
- # {Google::Cloud::Talent::V4beta1::Activity#description description} is related to a search query. It's empty if the
652
- # {Google::Cloud::Talent::V4beta1::Activity#description description} isn't related to the search query.
653
- # @!attribute [rw] skills_used_snippet
654
- # @return [Array<String>]
655
- # Output only. Skill used snippet shows how the corresponding
656
- # {Google::Cloud::Talent::V4beta1::Activity#skills_used skills_used} are related to a search query. It's empty if the
657
- # corresponding {Google::Cloud::Talent::V4beta1::Activity#skills_used skills_used} are not related to the search query.
658
- class Activity; end
659
-
660
- # Resource that represents a publication resource of a candidate.
661
- # @!attribute [rw] authors
662
- # @return [Array<String>]
663
- # A list of author names.
664
- #
665
- # Number of characters allowed is 100.
666
- # @!attribute [rw] title
667
- # @return [String]
668
- # The title of the publication.
669
- #
670
- # Number of characters allowed is 100.
671
- # @!attribute [rw] description
672
- # @return [String]
673
- # The description of the publication.
674
- #
675
- # Number of characters allowed is 100,000.
676
- # @!attribute [rw] journal
677
- # @return [String]
678
- # The journal name of the publication.
679
- #
680
- # Number of characters allowed is 100.
681
- # @!attribute [rw] volume
682
- # @return [String]
683
- # Volume number.
684
- #
685
- # Number of characters allowed is 100.
686
- # @!attribute [rw] publisher
687
- # @return [String]
688
- # The publisher of the journal.
689
- #
690
- # Number of characters allowed is 100.
691
- # @!attribute [rw] publication_date
692
- # @return [Google::Type::Date]
693
- # The publication date.
694
- # @!attribute [rw] publication_type
695
- # @return [String]
696
- # The publication type.
697
- #
698
- # Number of characters allowed is 100.
699
- # @!attribute [rw] isbn
700
- # @return [String]
701
- # ISBN number.
702
- #
703
- # Number of characters allowed is 100.
704
- class Publication; end
705
-
706
- # Resource that represents the patent acquired by a candidate.
707
- # @!attribute [rw] display_name
708
- # @return [String]
709
- # Name of the patent.
710
- #
711
- # Number of characters allowed is 100.
712
- # @!attribute [rw] inventors
713
- # @return [Array<String>]
714
- # A list of inventors' names.
715
- #
716
- # Number of characters allowed for each is 100.
717
- # @!attribute [rw] patent_status
718
- # @return [String]
719
- # The status of the patent.
720
- #
721
- # Number of characters allowed is 100.
722
- # @!attribute [rw] patent_status_date
723
- # @return [Google::Type::Date]
724
- # The date the last time the status of the patent was checked.
725
- # @!attribute [rw] patent_filing_date
726
- # @return [Google::Type::Date]
727
- # The date that the patent was filed.
728
- # @!attribute [rw] patent_office
729
- # @return [String]
730
- # The name of the patent office.
731
- #
732
- # Number of characters allowed is 100.
733
- # @!attribute [rw] patent_number
734
- # @return [String]
735
- # The number of the patent.
736
- #
737
- # Number of characters allowed is 100.
738
- # @!attribute [rw] patent_description
739
- # @return [String]
740
- # The description of the patent.
741
- #
742
- # Number of characters allowed is 100,000.
743
- # @!attribute [rw] skills_used
744
- # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
745
- # The skills used in this patent.
746
- class Patent; end
747
- end
748
- end
749
- end
750
- end