google-cloud-talent 0.5.0 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
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
data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/profile.rb CHANGED
@@ -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