google-cloud-talent 0.5.0 → 0.6.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 (45) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/talent/v4beta1.rb +2 -1
  3. data/lib/google/cloud/talent/v4beta1/application_pb.rb +1 -0
  4. data/lib/google/cloud/talent/v4beta1/application_service_client.rb +8 -11
  5. data/lib/google/cloud/talent/v4beta1/application_service_pb.rb +1 -0
  6. data/lib/google/cloud/talent/v4beta1/batch_pb.rb +0 -33
  7. data/lib/google/cloud/talent/v4beta1/common_pb.rb +30 -0
  8. data/lib/google/cloud/talent/v4beta1/company_pb.rb +1 -0
  9. data/lib/google/cloud/talent/v4beta1/company_service_client.rb +11 -14
  10. data/lib/google/cloud/talent/v4beta1/company_service_pb.rb +1 -0
  11. data/lib/google/cloud/talent/v4beta1/completion_client.rb +10 -10
  12. data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb +1 -0
  13. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb +17 -19
  14. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb +10 -15
  15. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/common.rb +200 -49
  16. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company.rb +15 -15
  17. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/company_service.rb +13 -18
  18. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/completion_service.rb +10 -16
  19. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event.rb +11 -12
  20. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/event_service.rb +2 -4
  21. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/filters.rb +210 -177
  22. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/histogram.rb +0 -4
  23. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job.rb +47 -54
  24. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/job_service.rb +92 -100
  25. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb +168 -114
  26. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile_service.rb +55 -36
  27. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant.rb +4 -4
  28. data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/tenant_service.rb +7 -10
  29. data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/timestamp.rb +6 -4
  30. data/lib/google/cloud/talent/v4beta1/event_pb.rb +1 -0
  31. data/lib/google/cloud/talent/v4beta1/event_service_client.rb +2 -4
  32. data/lib/google/cloud/talent/v4beta1/event_service_pb.rb +1 -0
  33. data/lib/google/cloud/talent/v4beta1/filters_pb.rb +8 -0
  34. data/lib/google/cloud/talent/v4beta1/job_pb.rb +1 -0
  35. data/lib/google/cloud/talent/v4beta1/job_service_client.rb +76 -97
  36. data/lib/google/cloud/talent/v4beta1/job_service_pb.rb +11 -1
  37. data/lib/google/cloud/talent/v4beta1/job_service_services_pb.rb +6 -6
  38. data/lib/google/cloud/talent/v4beta1/profile_pb.rb +9 -0
  39. data/lib/google/cloud/talent/v4beta1/profile_service_client.rb +50 -27
  40. data/lib/google/cloud/talent/v4beta1/profile_service_pb.rb +3 -0
  41. data/lib/google/cloud/talent/v4beta1/tenant_pb.rb +1 -0
  42. data/lib/google/cloud/talent/v4beta1/tenant_service_client.rb +5 -6
  43. data/lib/google/cloud/talent/v4beta1/tenant_service_pb.rb +1 -0
  44. data/lib/google/cloud/talent/version.rb +1 -1
  45. metadata +22 -2
@@ -27,17 +27,17 @@ module Google
27
27
  #
28
28
  # The format is
29
29
  # "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
30
- # for example, "projects/api-test-project/tenants/foo/profiles/bar".
30
+ # for example, "projects/foo/tenants/bar/profiles/baz".
31
31
  # @!attribute [rw] external_id
32
32
  # @return [String]
33
- # Optional. Profile's id in client system if available. This value is not
34
- # required to be unique to each profile. However, providing unique values
35
- # makes it easier to specify individual profiles when filing support tickets.
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
36
  #
37
37
  # The maximum number of bytes allowed is 100.
38
38
  # @!attribute [rw] source
39
39
  # @return [String]
40
- # Optional. The source description indicating where the profile is acquired.
40
+ # The source description indicating where the profile is acquired.
41
41
  #
42
42
  # For example, if a candidate profile is acquired from a resume, the user can
43
43
  # input "resume" here to indicate the source.
@@ -45,14 +45,13 @@ module Google
45
45
  # The maximum number of bytes allowed is 100.
46
46
  # @!attribute [rw] uri
47
47
  # @return [String]
48
- # Optional. The URI set by clients that links to this profile's client-side
49
- # copy.
48
+ # The URI set by clients that links to this profile's client-side copy.
50
49
  #
51
50
  # The maximum number of bytes allowed is 4000.
52
51
  # @!attribute [rw] group_id
53
52
  # @return [String]
54
- # Optional. The cluster id of the profile to associate with other profile(s)
55
- # for the same candidate.
53
+ # The cluster id of the profile to associate with other profile(s) for the
54
+ # same candidate.
56
55
  #
57
56
  # This field should be generated by the customer. If a value is not provided,
58
57
  # a random UUID is assigned to this field of the profile.
@@ -66,24 +65,58 @@ module Google
66
65
  # referring to the same candidate.
67
66
  # @!attribute [rw] is_hirable
68
67
  # @return [Google::Protobuf::BoolValue]
69
- # Optional. Indicates the hirable status of the candidate.
68
+ # Indicates the hirable status of the candidate.
70
69
  # @!attribute [rw] create_time
71
70
  # @return [Google::Protobuf::Timestamp]
72
- # Optional. The timestamp when the profile was first created at this source.
71
+ # The timestamp when the profile was first created at this source.
73
72
  # @!attribute [rw] update_time
74
73
  # @return [Google::Protobuf::Timestamp]
75
- # Optional. The timestamp when the profile was last updated at this source.
74
+ # The timestamp when the profile was last updated at this source.
75
+ # @!attribute [rw] candidate_update_time
76
+ # @return [Google::Protobuf::Timestamp]
77
+ # The timestamp when the profile was last updated as a result of a direct or
78
+ # indirect action by a candidate.
79
+ #
80
+ # These actions include:
81
+ #
82
+ # * Direct actions such as the candidate submitting a new resume as part of a
83
+ # job application to the agency, using a self-service tool such as a website
84
+ # to update their profile, and so on.
85
+ # * Indirect actions by the candidate such as uploading a resume to a job
86
+ # board that is collected by the agency through a feed, providing a resume to
87
+ # a recruiter who then uploads it into the ATS, and so on.
88
+ # * Updates made to the candidate's profile by the recruiter as a result of
89
+ # interacting with the candidate (for example adding a skill or work
90
+ # preference, and so on). Changes to
91
+ # {Google::Cloud::Talent::V4beta1::Profile#recruiting_notes recruiting_notes}
92
+ # are specifically excluded from this action type.
93
+ #
94
+ # Note:
95
+ # {Google::Cloud::Talent::V4beta1::Profile#candidate_update_time candidate_update_time}
96
+ # must be greater than or equal to
97
+ # {Google::Cloud::Talent::V4beta1::Profile#resume_update_time resume_update_time}
98
+ # or an error is thrown.
99
+ # @!attribute [rw] resume_update_time
100
+ # @return [Google::Protobuf::Timestamp]
101
+ # The timestamp when the candidate's resume was added or updated on the
102
+ # candidate's profile. Whether that resume was directly uploaded by a
103
+ # candidate, pulled from a 3rd party job board feed, added by a recruiter,
104
+ # and so on.
105
+ #
106
+ # If this field is updated, it's expected that
107
+ # {Google::Cloud::Talent::V4beta1::Profile#resume resume} is provided in the
108
+ # create or update calls.
76
109
  # @!attribute [rw] resume
77
110
  # @return [Google::Cloud::Talent::V4beta1::Resume]
78
- # Optional. The resume representing this profile.
111
+ # The resume representing this profile.
79
112
  # @!attribute [rw] person_names
80
113
  # @return [Array<Google::Cloud::Talent::V4beta1::PersonName>]
81
- # Optional. The names of the candidate this profile references.
114
+ # The names of the candidate this profile references.
82
115
  #
83
116
  # Currently only one person name is supported.
84
117
  # @!attribute [rw] addresses
85
118
  # @return [Array<Google::Cloud::Talent::V4beta1::Address>]
86
- # Optional. The candidate's postal addresses. It's highly recommended to
119
+ # The candidate's postal addresses. It's highly recommended to
87
120
  # input this information as accurately as possible to help improve search
88
121
  # quality. Here are some recommendations:
89
122
  #
@@ -113,16 +146,16 @@ module Google
113
146
  # not set.
114
147
  # @!attribute [rw] email_addresses
115
148
  # @return [Array<Google::Cloud::Talent::V4beta1::Email>]
116
- # Optional. The candidate's email addresses.
149
+ # The candidate's email addresses.
117
150
  # @!attribute [rw] phone_numbers
118
151
  # @return [Array<Google::Cloud::Talent::V4beta1::Phone>]
119
- # Optional. The candidate's phone number(s).
152
+ # The candidate's phone number(s).
120
153
  # @!attribute [rw] personal_uris
121
154
  # @return [Array<Google::Cloud::Talent::V4beta1::PersonalUri>]
122
- # Optional. The candidate's personal URIs.
155
+ # The candidate's personal URIs.
123
156
  # @!attribute [rw] additional_contact_info
124
157
  # @return [Array<Google::Cloud::Talent::V4beta1::AdditionalContactInfo>]
125
- # Optional. Available contact information besides
158
+ # Available contact information besides
126
159
  # {Google::Cloud::Talent::V4beta1::Profile#addresses addresses},
127
160
  # {Google::Cloud::Talent::V4beta1::Profile#email_addresses email_addresses},
128
161
  # {Google::Cloud::Talent::V4beta1::Profile#phone_numbers phone_numbers} and
@@ -130,9 +163,9 @@ module Google
130
163
  # example, Hang-out, Skype.
131
164
  # @!attribute [rw] employment_records
132
165
  # @return [Array<Google::Cloud::Talent::V4beta1::EmploymentRecord>]
133
- # Optional. The employment history records of the candidate. It's highly
134
- # recommended to input this information as accurately as possible to help
135
- # improve search quality. Here are some recommendations:
166
+ # The employment history records of the candidate. It's highly recommended
167
+ # to input this information as accurately as possible to help improve search
168
+ # quality. Here are some recommendations:
136
169
  #
137
170
  # * Specify the start and end dates of the employment records.
138
171
  # * List different employment types separately, no matter how minor the
@@ -147,9 +180,9 @@ module Google
147
180
  # The limitation for max number of employment records is 100.
148
181
  # @!attribute [rw] education_records
149
182
  # @return [Array<Google::Cloud::Talent::V4beta1::EducationRecord>]
150
- # Optional. The education history record of the candidate. It's highly
151
- # recommended to input this information as accurately as possible to help
152
- # improve search quality. Here are some recommendations:
183
+ # The education history record of the candidate. It's highly recommended to
184
+ # input this information as accurately as possible to help improve search
185
+ # quality. Here are some recommendations:
153
186
  #
154
187
  # * Specify the start and end dates of the education records.
155
188
  # * List each education type separately, no matter how minor the change is.
@@ -163,29 +196,29 @@ module Google
163
196
  # The limitation for max number of education records is 100.
164
197
  # @!attribute [rw] skills
165
198
  # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
166
- # Optional. The skill set of the candidate. It's highly recommended to
167
- # provide as much information as possible to help improve the search quality.
199
+ # The skill set of the candidate. It's highly recommended to provide as
200
+ # much information as possible to help improve the search quality.
168
201
  #
169
202
  # The limitation for max number of skills is 500.
170
203
  # @!attribute [rw] activities
171
204
  # @return [Array<Google::Cloud::Talent::V4beta1::Activity>]
172
- # Optional. The individual or collaborative activities which the candidate
173
- # has participated in, for example, open-source projects, class assignments
174
- # that aren't listed in
205
+ # The individual or collaborative activities which the candidate has
206
+ # participated in, for example, open-source projects, class assignments that
207
+ # aren't listed in
175
208
  # {Google::Cloud::Talent::V4beta1::Profile#employment_records employment_records}.
176
209
  #
177
210
  # The limitation for max number of activities is 50.
178
211
  # @!attribute [rw] publications
179
212
  # @return [Array<Google::Cloud::Talent::V4beta1::Publication>]
180
- # Optional. The publications published by the candidate.
213
+ # The publications published by the candidate.
181
214
  #
182
215
  # The limitation for max number of publications is 50.
183
216
  # @!attribute [rw] patents
184
217
  # @return [Array<Google::Cloud::Talent::V4beta1::Patent>]
185
- # Optional. The patents acquired by the candidate.
218
+ # The patents acquired by the candidate.
186
219
  # @!attribute [rw] certifications
187
220
  # @return [Array<Google::Cloud::Talent::V4beta1::Certification>]
188
- # Optional. The certifications acquired by the candidate.
221
+ # The certifications acquired by the candidate.
189
222
  # @!attribute [rw] applications
190
223
  # @return [Array<String>]
191
224
  # Output only. The resource names of the candidate's applications.
@@ -194,9 +227,9 @@ module Google
194
227
  # Output only. The resource names of the candidate's assignments.
195
228
  # @!attribute [rw] custom_attributes
196
229
  # @return [Hash{String => Google::Cloud::Talent::V4beta1::CustomAttribute}]
197
- # Optional. A map of fields to hold both filterable and non-filterable custom
198
- # profile attributes that aren't covered by the provided structured fields.
199
- # See {Google::Cloud::Talent::V4beta1::CustomAttribute CustomAttribute} for more
230
+ # A map of fields to hold both filterable and non-filterable custom profile
231
+ # attributes that aren't covered by the provided structured fields. See
232
+ # {Google::Cloud::Talent::V4beta1::CustomAttribute CustomAttribute} for more
200
233
  # details.
201
234
  #
202
235
  # At most 100 filterable and at most 100 unfilterable keys are supported. If
@@ -223,6 +256,9 @@ module Google
223
256
  # Output only. Keyword snippet shows how the search result is related to a
224
257
  # search query. This is only returned in
225
258
  # {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}.
259
+ # @!attribute [rw] availability_signals
260
+ # @return [Array<Google::Cloud::Talent::V4beta1::AvailabilitySignal>]
261
+ # Output only. Candidate's availability signals.
226
262
  # @!attribute [rw] derived_addresses
227
263
  # @return [Array<Google::Cloud::Talent::V4beta1::Location>]
228
264
  # Output only. Derived locations of the profile, resolved from
@@ -234,10 +270,32 @@ module Google
234
270
  # same order.
235
271
  class Profile; end
236
272
 
273
+ # Candidate availability signal.
274
+ # @!attribute [rw] type
275
+ # @return [Google::Cloud::Talent::V4beta1::AvailabilitySignalType]
276
+ # Type of signal.
277
+ # @!attribute [rw] last_update_time
278
+ # @return [Google::Protobuf::Timestamp]
279
+ # Timestamp of when the given availability activity last happened.
280
+ # @!attribute [rw] filter_satisfied
281
+ # @return [Google::Protobuf::BoolValue]
282
+ # Indicates if the
283
+ # {Google::Cloud::Talent::V4beta1::AvailabilitySignal#last_update_time last_update_time}
284
+ # is within
285
+ # {Google::Cloud::Talent::V4beta1::AvailabilityFilter#range AvailabilityFilter#range}.
286
+ #
287
+ # Returned only in a search response when there is an
288
+ # {Google::Cloud::Talent::V4beta1::AvailabilityFilter AvailabilityFilter} in
289
+ # {Google::Cloud::Talent::V4beta1::ProfileQuery#availability_filters ProfileQuery#availability_filters}
290
+ # where
291
+ # {Google::Cloud::Talent::V4beta1::AvailabilityFilter#signal_type signal_type}
292
+ # matches {Google::Cloud::Talent::V4beta1::AvailabilitySignal#type type}.
293
+ class AvailabilitySignal; end
294
+
237
295
  # Resource that represents a resume.
238
296
  # @!attribute [rw] structured_resume
239
297
  # @return [String]
240
- # Optional. Users can create a profile with only this field field, if
298
+ # Users can create a profile with only this field field, if
241
299
  # {Google::Cloud::Talent::V4beta1::Resume#resume_type resume_type} is
242
300
  # {Google::Cloud::Talent::V4beta1::Resume::ResumeType::HRXML HRXML}. For example,
243
301
  # the API parses this field and creates a profile with all structured fields
@@ -251,7 +309,7 @@ module Google
251
309
  # SLA.
252
310
  # @!attribute [rw] resume_type
253
311
  # @return [Google::Cloud::Talent::V4beta1::Resume::ResumeType]
254
- # Optional. The format of
312
+ # The format of
255
313
  # {Google::Cloud::Talent::V4beta1::Resume#structured_resume structured_resume}.
256
314
  class Resume
257
315
  # The format of a structured resume.
@@ -272,17 +330,16 @@ module Google
272
330
  # Resource that represents the name of a person.
273
331
  # @!attribute [rw] formatted_name
274
332
  # @return [String]
275
- # Optional. A string represents a person's full name. For example, "Dr.
276
- # John Smith".
333
+ # A string represents a person's full name. For example, "Dr. John Smith".
277
334
  #
278
335
  # Number of characters allowed is 100.
279
336
  # @!attribute [rw] structured_name
280
337
  # @return [Google::Cloud::Talent::V4beta1::PersonName::PersonStructuredName]
281
- # Optional. A person's name in a structured way (last name, first name,
282
- # suffix, and so on.)
338
+ # A person's name in a structured way (last name, first name, suffix, and
339
+ # so on.)
283
340
  # @!attribute [rw] preferred_name
284
341
  # @return [String]
285
- # Optional. Preferred name for the person. This field is ignored if
342
+ # Preferred name for the person. This field is ignored if
286
343
  # {Google::Cloud::Talent::V4beta1::PersonName#structured_name structured_name}
287
344
  # is provided.
288
345
  #
@@ -291,7 +348,7 @@ module Google
291
348
  # Resource that represents a person's structured name.
292
349
  # @!attribute [rw] given_name
293
350
  # @return [String]
294
- # Optional. Given/first name.
351
+ # Given/first name.
295
352
  #
296
353
  # It's derived from
297
354
  # {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name}
@@ -300,12 +357,12 @@ module Google
300
357
  # Number of characters allowed is 100.
301
358
  # @!attribute [rw] preferred_name
302
359
  # @return [String]
303
- # Optional. Preferred given/first name or nickname.
360
+ # Preferred given/first name or nickname.
304
361
  #
305
362
  # Number of characters allowed is 100.
306
363
  # @!attribute [rw] middle_initial
307
364
  # @return [String]
308
- # Optional. Middle initial.
365
+ # Middle initial.
309
366
  #
310
367
  # It's derived from
311
368
  # {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name}
@@ -314,7 +371,7 @@ module Google
314
371
  # Number of characters allowed is 20.
315
372
  # @!attribute [rw] family_name
316
373
  # @return [String]
317
- # Optional. Family/last name.
374
+ # Family/last name.
318
375
  #
319
376
  # It's derived from
320
377
  # {Google::Cloud::Talent::V4beta1::PersonName#formatted_name formatted_name}
@@ -323,12 +380,12 @@ module Google
323
380
  # Number of characters allowed is 100.
324
381
  # @!attribute [rw] suffixes
325
382
  # @return [Array<String>]
326
- # Optional. Suffixes.
383
+ # Suffixes.
327
384
  #
328
385
  # Number of characters allowed is 20.
329
386
  # @!attribute [rw] prefixes
330
387
  # @return [Array<String>]
331
- # Optional. Prefixes.
388
+ # Prefixes.
332
389
  #
333
390
  # Number of characters allowed is 20.
334
391
  class PersonStructuredName; end
@@ -337,10 +394,10 @@ module Google
337
394
  # Resource that represents a address.
338
395
  # @!attribute [rw] usage
339
396
  # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
340
- # Optional. The usage of the address. For example, SCHOOL, WORK, PERSONAL.
397
+ # The usage of the address. For example, SCHOOL, WORK, PERSONAL.
341
398
  # @!attribute [rw] unstructured_address
342
399
  # @return [String]
343
- # Optional. Unstructured address.
400
+ # Unstructured address.
344
401
  #
345
402
  # For example, "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
346
403
  # "Sunnyvale, California".
@@ -348,21 +405,20 @@ module Google
348
405
  # Number of characters allowed is 100.
349
406
  # @!attribute [rw] structured_address
350
407
  # @return [Google::Type::PostalAddress]
351
- # Optional. Structured address that contains street address, city, state,
352
- # country, and so on.
408
+ # Structured address that contains street address, city, state, country,
409
+ # and so on.
353
410
  # @!attribute [rw] current
354
411
  # @return [Google::Protobuf::BoolValue]
355
- # Optional. Indicates if it's the person's current address.
412
+ # Indicates if it's the person's current address.
356
413
  class Address; end
357
414
 
358
415
  # Resource that represents a person's email address.
359
416
  # @!attribute [rw] usage
360
417
  # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
361
- # Optional. The usage of the email address. For example, SCHOOL, WORK,
362
- # PERSONAL.
418
+ # The usage of the email address. For example, SCHOOL, WORK, PERSONAL.
363
419
  # @!attribute [rw] email_address
364
420
  # @return [String]
365
- # Optional. Email address.
421
+ # Email address.
366
422
  #
367
423
  # Number of characters allowed is 4,000.
368
424
  class Email; end
@@ -370,13 +426,13 @@ module Google
370
426
  # Resource that represents a person's telephone number.
371
427
  # @!attribute [rw] usage
372
428
  # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
373
- # Optional. The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
429
+ # The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
374
430
  # @!attribute [rw] type
375
431
  # @return [Google::Cloud::Talent::V4beta1::Phone::PhoneType]
376
- # Optional. The phone type. For example, LANDLINE, MOBILE, FAX.
432
+ # The phone type. For example, LANDLINE, MOBILE, FAX.
377
433
  # @!attribute [rw] number
378
434
  # @return [String]
379
- # Optional. Phone number.
435
+ # Phone number.
380
436
  #
381
437
  # Any phone formats are supported and only exact matches are performed on
382
438
  # searches. For example, if a phone number in profile is provided in the
@@ -386,8 +442,7 @@ module Google
386
442
  # Number of characters allowed is 20.
387
443
  # @!attribute [rw] when_available
388
444
  # @return [String]
389
- # Optional. When this number is available. Any descriptive string is
390
- # expected.
445
+ # When this number is available. Any descriptive string is expected.
391
446
  #
392
447
  # Number of characters allowed is 100.
393
448
  class Phone
@@ -435,7 +490,7 @@ module Google
435
490
  # Resource that represents a valid URI for a personal use.
436
491
  # @!attribute [rw] uri
437
492
  # @return [String]
438
- # Optional. The personal URI.
493
+ # The personal URI.
439
494
  #
440
495
  # Number of characters allowed is 4,000.
441
496
  class PersonalUri; end
@@ -444,18 +499,17 @@ module Google
444
499
  # URI and addresses.
445
500
  # @!attribute [rw] usage
446
501
  # @return [Google::Cloud::Talent::V4beta1::ContactInfoUsage]
447
- # Optional. The usage of this contact method. For example, SCHOOL, WORK,
448
- # PERSONAL.
502
+ # The usage of this contact method. For example, SCHOOL, WORK, PERSONAL.
449
503
  # @!attribute [rw] name
450
504
  # @return [String]
451
- # Optional. The name of the contact method.
505
+ # The name of the contact method.
452
506
  #
453
507
  # For example, "hangout", "skype".
454
508
  #
455
509
  # Number of characters allowed is 100.
456
510
  # @!attribute [rw] contact_id
457
511
  # @return [String]
458
- # Optional. The contact id.
512
+ # The contact id.
459
513
  #
460
514
  # Number of characters allowed is 100.
461
515
  class AdditionalContactInfo; end
@@ -463,48 +517,48 @@ module Google
463
517
  # Resource that represents an employment record of a candidate.
464
518
  # @!attribute [rw] start_date
465
519
  # @return [Google::Type::Date]
466
- # Optional. Start date of the employment.
520
+ # Start date of the employment.
467
521
  # @!attribute [rw] end_date
468
522
  # @return [Google::Type::Date]
469
- # Optional. End date of the employment.
523
+ # End date of the employment.
470
524
  # @!attribute [rw] employer_name
471
525
  # @return [String]
472
- # Optional. The name of the employer company/organization.
526
+ # The name of the employer company/organization.
473
527
  #
474
528
  # For example, "Google", "Alphabet", and so on.
475
529
  #
476
530
  # Number of characters allowed is 250.
477
531
  # @!attribute [rw] division_name
478
532
  # @return [String]
479
- # Optional. The division name of the employment.
533
+ # The division name of the employment.
480
534
  #
481
535
  # For example, division, department, client, and so on.
482
536
  #
483
537
  # Number of characters allowed is 100.
484
538
  # @!attribute [rw] address
485
539
  # @return [Google::Cloud::Talent::V4beta1::Address]
486
- # Optional. The physical address of the employer.
540
+ # The physical address of the employer.
487
541
  # @!attribute [rw] job_title
488
542
  # @return [String]
489
- # Optional. The job title of the employment.
543
+ # The job title of the employment.
490
544
  #
491
545
  # For example, "Software Engineer", "Data Scientist", and so on.
492
546
  #
493
547
  # Number of characters allowed is 250.
494
548
  # @!attribute [rw] job_description
495
549
  # @return [String]
496
- # Optional. The description of job content.
550
+ # The description of job content.
497
551
  #
498
552
  # Number of characters allowed is 100,000.
499
553
  # @!attribute [rw] is_supervisor
500
554
  # @return [Google::Protobuf::BoolValue]
501
- # Optional. If the jobs is a supervisor position.
555
+ # If the jobs is a supervisor position.
502
556
  # @!attribute [rw] is_self_employed
503
557
  # @return [Google::Protobuf::BoolValue]
504
- # Optional. If this employment is self-employed.
558
+ # If this employment is self-employed.
505
559
  # @!attribute [rw] is_current
506
560
  # @return [Google::Protobuf::BoolValue]
507
- # Optional. If this employment is current.
561
+ # If this employment is current.
508
562
  # @!attribute [rw] job_title_snippet
509
563
  # @return [String]
510
564
  # Output only. The job title snippet shows how the
@@ -531,41 +585,41 @@ module Google
531
585
  # Resource that represents an education record of a candidate.
532
586
  # @!attribute [rw] start_date
533
587
  # @return [Google::Type::Date]
534
- # Optional. The start date of the education.
588
+ # The start date of the education.
535
589
  # @!attribute [rw] end_date
536
590
  # @return [Google::Type::Date]
537
- # Optional. The end date of the education.
591
+ # The end date of the education.
538
592
  # @!attribute [rw] expected_graduation_date
539
593
  # @return [Google::Type::Date]
540
- # Optional. The expected graduation date if currently pursuing a degree.
594
+ # The expected graduation date if currently pursuing a degree.
541
595
  # @!attribute [rw] school_name
542
596
  # @return [String]
543
- # Optional. The name of the school or institution.
597
+ # The name of the school or institution.
544
598
  #
545
599
  # For example, "Stanford University", "UC Berkeley", and so on.
546
600
  #
547
601
  # Number of characters allowed is 250.
548
602
  # @!attribute [rw] address
549
603
  # @return [Google::Cloud::Talent::V4beta1::Address]
550
- # Optional. The physical address of the education institution.
604
+ # The physical address of the education institution.
551
605
  # @!attribute [rw] degree_description
552
606
  # @return [String]
553
- # Optional. The full description of the degree.
607
+ # The full description of the degree.
554
608
  #
555
609
  # For example, "Master of Science in Computer Science", "B.S in Math".
556
610
  #
557
611
  # Number of characters allowed is 100.
558
612
  # @!attribute [rw] structured_degree
559
613
  # @return [Google::Cloud::Talent::V4beta1::Degree]
560
- # Optional. The structured notation of the degree.
614
+ # The structured notation of the degree.
561
615
  # @!attribute [rw] description
562
616
  # @return [String]
563
- # Optional. The description of the education.
617
+ # The description of the education.
564
618
  #
565
619
  # Number of characters allowed is 100,000.
566
620
  # @!attribute [rw] is_current
567
621
  # @return [Google::Protobuf::BoolValue]
568
- # Optional. If this education is current.
622
+ # If this education is current.
569
623
  # @!attribute [rw] school_name_snippet
570
624
  # @return [String]
571
625
  # Output only. The school name snippet shows how the
@@ -585,17 +639,17 @@ module Google
585
639
  # Resource that represents a degree pursuing or acquired by a candidate.
586
640
  # @!attribute [rw] degree_type
587
641
  # @return [Google::Cloud::Talent::V4beta1::DegreeType]
588
- # Optional. ISCED degree type.
642
+ # ISCED degree type.
589
643
  # @!attribute [rw] degree_name
590
644
  # @return [String]
591
- # Optional. Full Degree name.
645
+ # Full Degree name.
592
646
  #
593
647
  # For example, "B.S.", "Master of Arts", and so on.
594
648
  #
595
649
  # Number of characters allowed is 100.
596
650
  # @!attribute [rw] fields_of_study
597
651
  # @return [Array<String>]
598
- # Optional. Fields of study for the degree.
652
+ # Fields of study for the degree.
599
653
  #
600
654
  # For example, "Computer science", "engineering".
601
655
  #
@@ -607,35 +661,35 @@ module Google
607
661
  # and so on.
608
662
  # @!attribute [rw] display_name
609
663
  # @return [String]
610
- # Optional. Activity display name.
664
+ # Activity display name.
611
665
  #
612
666
  # Number of characters allowed is 100.
613
667
  # @!attribute [rw] description
614
668
  # @return [String]
615
- # Optional. Activity description.
669
+ # Activity description.
616
670
  #
617
671
  # Number of characters allowed is 100,000.
618
672
  # @!attribute [rw] uri
619
673
  # @return [String]
620
- # Optional. Activity URI.
674
+ # Activity URI.
621
675
  #
622
676
  # Number of characters allowed is 4,000.
623
677
  # @!attribute [rw] create_date
624
678
  # @return [Google::Type::Date]
625
- # Optional. The first creation date of the activity.
679
+ # The first creation date of the activity.
626
680
  # @!attribute [rw] update_date
627
681
  # @return [Google::Type::Date]
628
- # Optional. The last update date of the activity.
682
+ # The last update date of the activity.
629
683
  # @!attribute [rw] team_members
630
684
  # @return [Array<String>]
631
- # Optional. A list of team members involved in this activity.
685
+ # A list of team members involved in this activity.
632
686
  #
633
687
  # Number of characters allowed is 100.
634
688
  #
635
689
  # The limitation for max number of team members is 50.
636
690
  # @!attribute [rw] skills_used
637
691
  # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
638
- # Optional. A list of skills used in this activity.
692
+ # A list of skills used in this activity.
639
693
  #
640
694
  # The limitation for max number of skills used is 50.
641
695
  # @!attribute [rw] activity_name_snippet
@@ -664,45 +718,45 @@ module Google
664
718
  # Resource that represents a publication resource of a candidate.
665
719
  # @!attribute [rw] authors
666
720
  # @return [Array<String>]
667
- # Optional. A list of author names.
721
+ # A list of author names.
668
722
  #
669
723
  # Number of characters allowed is 100.
670
724
  # @!attribute [rw] title
671
725
  # @return [String]
672
- # Optional. The title of the publication.
726
+ # The title of the publication.
673
727
  #
674
728
  # Number of characters allowed is 100.
675
729
  # @!attribute [rw] description
676
730
  # @return [String]
677
- # Optional. The description of the publication.
731
+ # The description of the publication.
678
732
  #
679
733
  # Number of characters allowed is 100,000.
680
734
  # @!attribute [rw] journal
681
735
  # @return [String]
682
- # Optional. The journal name of the publication.
736
+ # The journal name of the publication.
683
737
  #
684
738
  # Number of characters allowed is 100.
685
739
  # @!attribute [rw] volume
686
740
  # @return [String]
687
- # Optional. Volume number.
741
+ # Volume number.
688
742
  #
689
743
  # Number of characters allowed is 100.
690
744
  # @!attribute [rw] publisher
691
745
  # @return [String]
692
- # Optional. The publisher of the journal.
746
+ # The publisher of the journal.
693
747
  #
694
748
  # Number of characters allowed is 100.
695
749
  # @!attribute [rw] publication_date
696
750
  # @return [Google::Type::Date]
697
- # Optional. The publication date.
751
+ # The publication date.
698
752
  # @!attribute [rw] publication_type
699
753
  # @return [String]
700
- # Optional. The publication type.
754
+ # The publication type.
701
755
  #
702
756
  # Number of characters allowed is 100.
703
757
  # @!attribute [rw] isbn
704
758
  # @return [String]
705
- # Optional. ISBN number.
759
+ # ISBN number.
706
760
  #
707
761
  # Number of characters allowed is 100.
708
762
  class Publication; end
@@ -710,43 +764,43 @@ module Google
710
764
  # Resource that represents the patent acquired by a candidate.
711
765
  # @!attribute [rw] display_name
712
766
  # @return [String]
713
- # Optional. Name of the patent.
767
+ # Name of the patent.
714
768
  #
715
769
  # Number of characters allowed is 100.
716
770
  # @!attribute [rw] inventors
717
771
  # @return [Array<String>]
718
- # Optional. A list of inventors' names.
772
+ # A list of inventors' names.
719
773
  #
720
774
  # Number of characters allowed for each is 100.
721
775
  # @!attribute [rw] patent_status
722
776
  # @return [String]
723
- # Optional. The status of the patent.
777
+ # The status of the patent.
724
778
  #
725
779
  # Number of characters allowed is 100.
726
780
  # @!attribute [rw] patent_status_date
727
781
  # @return [Google::Type::Date]
728
- # Optional. The date the last time the status of the patent was checked.
782
+ # The date the last time the status of the patent was checked.
729
783
  # @!attribute [rw] patent_filing_date
730
784
  # @return [Google::Type::Date]
731
- # Optional. The date that the patent was filed.
785
+ # The date that the patent was filed.
732
786
  # @!attribute [rw] patent_office
733
787
  # @return [String]
734
- # Optional. The name of the patent office.
788
+ # The name of the patent office.
735
789
  #
736
790
  # Number of characters allowed is 100.
737
791
  # @!attribute [rw] patent_number
738
792
  # @return [String]
739
- # Optional. The number of the patent.
793
+ # The number of the patent.
740
794
  #
741
795
  # Number of characters allowed is 100.
742
796
  # @!attribute [rw] patent_description
743
797
  # @return [String]
744
- # Optional. The description of the patent.
798
+ # The description of the patent.
745
799
  #
746
800
  # Number of characters allowed is 100,000.
747
801
  # @!attribute [rw] skills_used
748
802
  # @return [Array<Google::Cloud::Talent::V4beta1::Skill>]
749
- # Optional. The skills used in this patent.
803
+ # The skills used in this patent.
750
804
  class Patent; end
751
805
  end
752
806
  end