google-cloud-talent-v4 0.1.0 → 0.4.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (40) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE.md +188 -190
  3. data/README.md +66 -2
  4. data/lib/google/cloud/talent/v4.rb +3 -0
  5. data/lib/google/cloud/talent/v4/common_pb.rb +1 -3
  6. data/lib/google/cloud/talent/v4/company_pb.rb +1 -1
  7. data/lib/google/cloud/talent/v4/company_service/client.rb +31 -30
  8. data/lib/google/cloud/talent/v4/company_service_services_pb.rb +1 -1
  9. data/lib/google/cloud/talent/v4/completion/client.rb +17 -13
  10. data/lib/google/cloud/talent/v4/completion_service_pb.rb +1 -1
  11. data/lib/google/cloud/talent/v4/completion_service_services_pb.rb +1 -1
  12. data/lib/google/cloud/talent/v4/event_pb.rb +1 -1
  13. data/lib/google/cloud/talent/v4/event_service/client.rb +14 -8
  14. data/lib/google/cloud/talent/v4/event_service_services_pb.rb +1 -1
  15. data/lib/google/cloud/talent/v4/filters_pb.rb +1 -1
  16. data/lib/google/cloud/talent/v4/job_pb.rb +1 -1
  17. data/lib/google/cloud/talent/v4/job_service/client.rb +30 -24
  18. data/lib/google/cloud/talent/v4/job_service/operations.rb +95 -10
  19. data/lib/google/cloud/talent/v4/job_service_services_pb.rb +1 -1
  20. data/lib/google/cloud/talent/v4/tenant_pb.rb +1 -1
  21. data/lib/google/cloud/talent/v4/tenant_service/client.rb +28 -25
  22. data/lib/google/cloud/talent/v4/tenant_service_services_pb.rb +1 -1
  23. data/lib/google/cloud/talent/v4/version.rb +1 -1
  24. data/proto_docs/google/api/field_behavior.rb +6 -0
  25. data/proto_docs/google/cloud/talent/v4/common.rb +56 -122
  26. data/proto_docs/google/cloud/talent/v4/company.rb +4 -7
  27. data/proto_docs/google/cloud/talent/v4/company_service.rb +6 -11
  28. data/proto_docs/google/cloud/talent/v4/completion_service.rb +10 -21
  29. data/proto_docs/google/cloud/talent/v4/event.rb +9 -17
  30. data/proto_docs/google/cloud/talent/v4/event_service.rb +2 -2
  31. data/proto_docs/google/cloud/talent/v4/filters.rb +34 -51
  32. data/proto_docs/google/cloud/talent/v4/histogram.rb +2 -6
  33. data/proto_docs/google/cloud/talent/v4/job.rb +55 -83
  34. data/proto_docs/google/cloud/talent/v4/tenant.rb +1 -2
  35. data/proto_docs/google/cloud/talent/v4/tenant_service.rb +3 -6
  36. data/proto_docs/google/longrunning/operations.rb +17 -3
  37. data/proto_docs/google/protobuf/any.rb +5 -2
  38. data/proto_docs/google/protobuf/timestamp.rb +10 -1
  39. data/proto_docs/google/type/latlng.rb +2 -2
  40. metadata +19 -11
@@ -103,8 +103,13 @@ module Google
103
103
  # Lists operations that match the specified filter in the request. If the
104
104
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
105
105
  #
106
- # NOTE: the `name` binding below allows API services to override the binding
107
- # to use different resource name schemes, such as `users/*/operations`.
106
+ # NOTE: the `name` binding allows API services to override the binding
107
+ # to use different resource name schemes, such as `users/*/operations`. To
108
+ # override the binding, API services can add a binding such as
109
+ # `"/v1/{name=users/*}/operations"` to their service configuration.
110
+ # For backwards compatibility, the default name includes the operations
111
+ # collection id, however overriding users must ensure the name binding
112
+ # is the parent resource, without the operations collection id.
108
113
  #
109
114
  # @overload list_operations(request, options = nil)
110
115
  # Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
122
127
  # the default parameter values, pass an empty Hash as a request object (see above).
123
128
  #
124
129
  # @param name [::String]
125
- # The name of the operation collection.
130
+ # The name of the operation's parent resource.
126
131
  # @param filter [::String]
127
132
  # The standard list filter.
128
133
  # @param page_size [::Integer]
@@ -390,6 +395,79 @@ module Google
390
395
  raise ::Google::Cloud::Error.from_error(e)
391
396
  end
392
397
 
398
+ ##
399
+ # Waits for the specified long-running operation until it is done or reaches
400
+ # at most a specified timeout, returning the latest state. If the operation
401
+ # is already done, the latest state is immediately returned. If the timeout
402
+ # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
403
+ # timeout is used. If the server does not support this method, it returns
404
+ # `google.rpc.Code.UNIMPLEMENTED`.
405
+ # Note that this method is on a best-effort basis. It may return the latest
406
+ # state before the specified timeout (including immediately), meaning even an
407
+ # immediate response is no guarantee that the operation is done.
408
+ #
409
+ # @overload wait_operation(request, options = nil)
410
+ # Pass arguments to `wait_operation` via a request object, either of type
411
+ # {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
412
+ #
413
+ # @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
414
+ # A request object representing the call parameters. Required. To specify no
415
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
416
+ # @param options [::Gapic::CallOptions, ::Hash]
417
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
418
+ #
419
+ # @overload wait_operation(name: nil, timeout: nil)
420
+ # Pass arguments to `wait_operation` via keyword arguments. Note that at
421
+ # least one keyword argument is required. To specify no parameters, or to keep all
422
+ # the default parameter values, pass an empty Hash as a request object (see above).
423
+ #
424
+ # @param name [::String]
425
+ # The name of the operation resource to wait on.
426
+ # @param timeout [::Google::Protobuf::Duration, ::Hash]
427
+ # The maximum duration to wait before timing out. If left blank, the wait
428
+ # will be at most the time permitted by the underlying HTTP/RPC protocol.
429
+ # If RPC context deadline is also specified, the shorter one will be used.
430
+ #
431
+ # @yield [response, operation] Access the result along with the RPC operation
432
+ # @yieldparam response [::Gapic::Operation]
433
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
434
+ #
435
+ # @return [::Gapic::Operation]
436
+ #
437
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
438
+ #
439
+ def wait_operation request, options = nil
440
+ raise ::ArgumentError, "request must be provided" if request.nil?
441
+
442
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
443
+
444
+ # Converts hash and nil to an options object
445
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
446
+
447
+ # Customize the options with defaults
448
+ metadata = @config.rpcs.wait_operation.metadata.to_h
449
+
450
+ # Set x-goog-api-client and x-goog-user-project headers
451
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
452
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
453
+ gapic_version: ::Google::Cloud::Talent::V4::VERSION
454
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
455
+
456
+ options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
457
+ metadata: metadata,
458
+ retry_policy: @config.rpcs.wait_operation.retry_policy
459
+ options.apply_defaults metadata: @config.metadata,
460
+ retry_policy: @config.retry_policy
461
+
462
+ @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
463
+ response = ::Gapic::Operation.new response, @operations_client, options: options
464
+ yield response, operation if block_given?
465
+ return response
466
+ end
467
+ rescue ::GRPC::BadStatus => e
468
+ raise ::Google::Cloud::Error.from_error(e)
469
+ end
470
+
393
471
  ##
394
472
  # Configuration class for the Operations API.
395
473
  #
@@ -482,7 +560,7 @@ module Google
482
560
  config_attr :scope, nil, ::String, ::Array, nil
483
561
  config_attr :lib_name, nil, ::String, nil
484
562
  config_attr :lib_version, nil, ::String, nil
485
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
563
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
486
564
  config_attr :interceptors, nil, ::Array, nil
487
565
  config_attr :timeout, nil, ::Numeric, nil
488
566
  config_attr :metadata, nil, ::Hash, nil
@@ -503,7 +581,7 @@ module Google
503
581
  def rpcs
504
582
  @rpcs ||= begin
505
583
  parent_rpcs = nil
506
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
584
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
507
585
  Rpcs.new parent_rpcs
508
586
  end
509
587
  end
@@ -515,7 +593,7 @@ module Google
515
593
  # Each configuration object is of type `Gapic::Config::Method` and includes
516
594
  # the following configuration fields:
517
595
  #
518
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
596
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
519
597
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
520
598
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
521
599
  # include the following keys:
@@ -546,17 +624,24 @@ module Google
546
624
  # @return [::Gapic::Config::Method]
547
625
  #
548
626
  attr_reader :cancel_operation
627
+ ##
628
+ # RPC-specific configuration for `wait_operation`
629
+ # @return [::Gapic::Config::Method]
630
+ #
631
+ attr_reader :wait_operation
549
632
 
550
633
  # @private
551
634
  def initialize parent_rpcs = nil
552
- list_operations_config = parent_rpcs&.list_operations if parent_rpcs&.respond_to? :list_operations
635
+ list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
553
636
  @list_operations = ::Gapic::Config::Method.new list_operations_config
554
- get_operation_config = parent_rpcs&.get_operation if parent_rpcs&.respond_to? :get_operation
637
+ get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
555
638
  @get_operation = ::Gapic::Config::Method.new get_operation_config
556
- delete_operation_config = parent_rpcs&.delete_operation if parent_rpcs&.respond_to? :delete_operation
639
+ delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
557
640
  @delete_operation = ::Gapic::Config::Method.new delete_operation_config
558
- cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
641
+ cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
559
642
  @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
643
+ wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
644
+ @wait_operation = ::Gapic::Config::Method.new wait_operation_config
560
645
 
561
646
  yield self if block_given?
562
647
  end
@@ -27,7 +27,7 @@ module Google
27
27
  # A service handles job management, including job CRUD, enumeration and search.
28
28
  class Service
29
29
 
30
- include GRPC::GenericService
30
+ include ::GRPC::GenericService
31
31
 
32
32
  self.marshal_class_method = :encode
33
33
  self.unmarshal_class_method = :decode
@@ -3,9 +3,9 @@
3
3
 
4
4
  require 'google/protobuf'
5
5
 
6
- require 'google/api/annotations_pb'
7
6
  require 'google/api/field_behavior_pb'
8
7
  require 'google/api/resource_pb'
8
+ require 'google/api/annotations_pb'
9
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
10
10
  add_file("google/cloud/talent/v4/tenant.proto", :syntax => :proto3) do
11
11
  add_message "google.cloud.talent.v4.Tenant" do
@@ -60,7 +60,7 @@ module Google
60
60
  parent_config = while namespace.any?
61
61
  parent_name = namespace.join "::"
62
62
  parent_const = const_get parent_name
63
- break parent_const.configure if parent_const&.respond_to? :configure
63
+ break parent_const.configure if parent_const.respond_to? :configure
64
64
  namespace.pop
65
65
  end
66
66
  default_config = Client::Configuration.new parent_config
@@ -70,9 +70,9 @@ module Google
70
70
  default_config.rpcs.get_tenant.timeout = 30.0
71
71
  default_config.rpcs.get_tenant.retry_policy = {
72
72
  initial_delay: 0.1,
73
- max_delay: 60.0,
74
- multiplier: 1.3,
75
- retry_codes: [4, 14]
73
+ max_delay: 60.0,
74
+ multiplier: 1.3,
75
+ retry_codes: [4, 14]
76
76
  }
77
77
 
78
78
  default_config.rpcs.update_tenant.timeout = 30.0
@@ -80,17 +80,17 @@ module Google
80
80
  default_config.rpcs.delete_tenant.timeout = 30.0
81
81
  default_config.rpcs.delete_tenant.retry_policy = {
82
82
  initial_delay: 0.1,
83
- max_delay: 60.0,
84
- multiplier: 1.3,
85
- retry_codes: [4, 14]
83
+ max_delay: 60.0,
84
+ multiplier: 1.3,
85
+ retry_codes: [4, 14]
86
86
  }
87
87
 
88
88
  default_config.rpcs.list_tenants.timeout = 30.0
89
89
  default_config.rpcs.list_tenants.retry_policy = {
90
90
  initial_delay: 0.1,
91
- max_delay: 60.0,
92
- multiplier: 1.3,
93
- retry_codes: [4, 14]
91
+ max_delay: 60.0,
92
+ multiplier: 1.3,
93
+ retry_codes: [4, 14]
94
94
  }
95
95
 
96
96
  default_config
@@ -154,7 +154,13 @@ module Google
154
154
 
155
155
  # Create credentials
156
156
  credentials = @config.credentials
157
- credentials ||= Credentials.default scope: @config.scope
157
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
158
+ # but only if the default endpoint does not have a region prefix.
159
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
160
+ @config.endpoint == Client.configure.endpoint &&
161
+ !@config.endpoint.split(".").first.include?("-")
162
+ credentials ||= Credentials.default scope: @config.scope,
163
+ enable_self_signed_jwt: enable_self_signed_jwt
158
164
  if credentials.is_a?(String) || credentials.is_a?(Hash)
159
165
  credentials = Credentials.new credentials, scope: @config.scope
160
166
  end
@@ -331,15 +337,12 @@ module Google
331
337
  # the default parameter values, pass an empty Hash as a request object (see above).
332
338
  #
333
339
  # @param tenant [::Google::Cloud::Talent::V4::Tenant, ::Hash]
334
- # Required. The tenant resource to replace the current resource in the
335
- # system.
340
+ # Required. The tenant resource to replace the current resource in the system.
336
341
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
337
342
  # Strongly recommended for the best service experience.
338
343
  #
339
- # If {::Google::Cloud::Talent::V4::UpdateTenantRequest#update_mask update_mask} is
340
- # provided, only the specified fields in
341
- # {::Google::Cloud::Talent::V4::UpdateTenantRequest#tenant tenant} are updated.
342
- # Otherwise all the fields are updated.
344
+ # If {::Google::Cloud::Talent::V4::UpdateTenantRequest#update_mask update_mask} is provided, only the specified fields in
345
+ # {::Google::Cloud::Talent::V4::UpdateTenantRequest#tenant tenant} are updated. Otherwise all the fields are updated.
343
346
  #
344
347
  # A field mask to specify the tenant fields to be updated. Only
345
348
  # top level fields of {::Google::Cloud::Talent::V4::Tenant Tenant} are supported.
@@ -625,7 +628,7 @@ module Google
625
628
  config_attr :scope, nil, ::String, ::Array, nil
626
629
  config_attr :lib_name, nil, ::String, nil
627
630
  config_attr :lib_version, nil, ::String, nil
628
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
631
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
629
632
  config_attr :interceptors, nil, ::Array, nil
630
633
  config_attr :timeout, nil, ::Numeric, nil
631
634
  config_attr :metadata, nil, ::Hash, nil
@@ -646,7 +649,7 @@ module Google
646
649
  def rpcs
647
650
  @rpcs ||= begin
648
651
  parent_rpcs = nil
649
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
652
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
650
653
  Rpcs.new parent_rpcs
651
654
  end
652
655
  end
@@ -658,7 +661,7 @@ module Google
658
661
  # Each configuration object is of type `Gapic::Config::Method` and includes
659
662
  # the following configuration fields:
660
663
  #
661
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
664
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
662
665
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
663
666
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
664
667
  # include the following keys:
@@ -697,15 +700,15 @@ module Google
697
700
 
698
701
  # @private
699
702
  def initialize parent_rpcs = nil
700
- create_tenant_config = parent_rpcs&.create_tenant if parent_rpcs&.respond_to? :create_tenant
703
+ create_tenant_config = parent_rpcs.create_tenant if parent_rpcs.respond_to? :create_tenant
701
704
  @create_tenant = ::Gapic::Config::Method.new create_tenant_config
702
- get_tenant_config = parent_rpcs&.get_tenant if parent_rpcs&.respond_to? :get_tenant
705
+ get_tenant_config = parent_rpcs.get_tenant if parent_rpcs.respond_to? :get_tenant
703
706
  @get_tenant = ::Gapic::Config::Method.new get_tenant_config
704
- update_tenant_config = parent_rpcs&.update_tenant if parent_rpcs&.respond_to? :update_tenant
707
+ update_tenant_config = parent_rpcs.update_tenant if parent_rpcs.respond_to? :update_tenant
705
708
  @update_tenant = ::Gapic::Config::Method.new update_tenant_config
706
- delete_tenant_config = parent_rpcs&.delete_tenant if parent_rpcs&.respond_to? :delete_tenant
709
+ delete_tenant_config = parent_rpcs.delete_tenant if parent_rpcs.respond_to? :delete_tenant
707
710
  @delete_tenant = ::Gapic::Config::Method.new delete_tenant_config
708
- list_tenants_config = parent_rpcs&.list_tenants if parent_rpcs&.respond_to? :list_tenants
711
+ list_tenants_config = parent_rpcs.list_tenants if parent_rpcs.respond_to? :list_tenants
709
712
  @list_tenants = ::Gapic::Config::Method.new list_tenants_config
710
713
 
711
714
  yield self if block_given?
@@ -27,7 +27,7 @@ module Google
27
27
  # A service that handles tenant management, including CRUD and enumeration.
28
28
  class Service
29
29
 
30
- include GRPC::GenericService
30
+ include ::GRPC::GenericService
31
31
 
32
32
  self.marshal_class_method = :encode
33
33
  self.unmarshal_class_method = :decode
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Talent
23
23
  module V4
24
- VERSION = "0.1.0"
24
+ VERSION = "0.4.1"
25
25
  end
26
26
  end
27
27
  end
@@ -54,6 +54,12 @@ module Google
54
54
  # This indicates that the field may be set once in a request to create a
55
55
  # resource, but may not be changed thereafter.
56
56
  IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
57
63
  end
58
64
  end
59
65
  end
@@ -37,11 +37,9 @@ module Google
37
37
  # @!attribute [rw] location_type
38
38
  # @return [::Google::Cloud::Talent::V4::Location::LocationType]
39
39
  # The type of a location, which corresponds to the address lines field of
40
- # {::Google::Type::PostalAddress google.type.PostalAddress}. For example,
41
- # "Downtown, Atlanta, GA, USA" has a type of
42
- # {::Google::Cloud::Talent::V4::Location::LocationType::NEIGHBORHOOD LocationType.NEIGHBORHOOD},
43
- # and "Kansas City, KS, USA" has a type of
44
- # {::Google::Cloud::Talent::V4::Location::LocationType::LOCALITY LocationType.LOCALITY}.
40
+ # {::Google::Type::PostalAddress google.type.PostalAddress}. For example, "Downtown, Atlanta, GA, USA"
41
+ # has a type of {::Google::Cloud::Talent::V4::Location::LocationType::NEIGHBORHOOD LocationType.NEIGHBORHOOD}, and "Kansas City, KS, USA"
42
+ # has a type of {::Google::Cloud::Talent::V4::Location::LocationType::LOCALITY LocationType.LOCALITY}.
45
43
  # @!attribute [rw] postal_address
46
44
  # @return [::Google::Type::PostalAddress]
47
45
  # Postal address of the location that includes human readable information,
@@ -55,9 +53,10 @@ module Google
55
53
  # @return [::Float]
56
54
  # Radius in miles of the job location. This value is derived from the
57
55
  # location bounding box in which a circle with the specified radius
58
- # centered from {::Google::Type::LatLng google.type.LatLng} covers the area
59
- # associated with the job location. For example, currently, "Mountain View,
60
- # CA, USA" has a radius of 6.17 miles.
56
+ # centered from {::Google::Type::LatLng google.type.LatLng} covers the area associated with the
57
+ # job location.
58
+ # For example, currently, "Mountain View, CA, USA" has a radius of
59
+ # 6.17 miles.
61
60
  class Location
62
61
  include ::Google::Protobuf::MessageExts
63
62
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -108,9 +107,7 @@ module Google
108
107
  # performance of the service.
109
108
  # @!attribute [rw] domain
110
109
  # @return [::String]
111
- # Required if
112
- # {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids}
113
- # is unset or `false`.
110
+ # Required if {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids} is unset or `false`.
114
111
  #
115
112
  # The client-defined scope or source of the service call, which typically
116
113
  # is the domain on
@@ -127,9 +124,7 @@ module Google
127
124
  # The maximum number of allowed characters is 255.
128
125
  # @!attribute [rw] session_id
129
126
  # @return [::String]
130
- # Required if
131
- # {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids}
132
- # is unset or `false`.
127
+ # Required if {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids} is unset or `false`.
133
128
  #
134
129
  # A unique session identification string. A session is defined as the
135
130
  # duration of an end user's interaction with the service over a certain
@@ -143,9 +138,7 @@ module Google
143
138
  # The maximum number of allowed characters is 255.
144
139
  # @!attribute [rw] user_id
145
140
  # @return [::String]
146
- # Required if
147
- # {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids}
148
- # is unset or `false`.
141
+ # Required if {::Google::Cloud::Talent::V4::RequestMetadata#allow_missing_ids allow_missing_ids} is unset or `false`.
149
142
  #
150
143
  # A unique user identification string, as determined by the client.
151
144
  # To have the strongest positive impact on search quality
@@ -159,15 +152,10 @@ module Google
159
152
  # The maximum number of allowed characters is 255.
160
153
  # @!attribute [rw] allow_missing_ids
161
154
  # @return [::Boolean]
162
- # Only set when any of
163
- # {::Google::Cloud::Talent::V4::RequestMetadata#domain domain},
164
- # {::Google::Cloud::Talent::V4::RequestMetadata#session_id session_id} and
165
- # {::Google::Cloud::Talent::V4::RequestMetadata#user_id user_id} isn't available
166
- # for some reason. It is highly recommended not to set this field and provide
167
- # accurate {::Google::Cloud::Talent::V4::RequestMetadata#domain domain},
168
- # {::Google::Cloud::Talent::V4::RequestMetadata#session_id session_id} and
169
- # {::Google::Cloud::Talent::V4::RequestMetadata#user_id user_id} for the best
170
- # service experience.
155
+ # Only set when any of {::Google::Cloud::Talent::V4::RequestMetadata#domain domain}, {::Google::Cloud::Talent::V4::RequestMetadata#session_id session_id} and {::Google::Cloud::Talent::V4::RequestMetadata#user_id user_id} isn't
156
+ # available for some reason. It is highly recommended not to set this field
157
+ # and provide accurate {::Google::Cloud::Talent::V4::RequestMetadata#domain domain}, {::Google::Cloud::Talent::V4::RequestMetadata#session_id session_id} and {::Google::Cloud::Talent::V4::RequestMetadata#user_id user_id} for the
158
+ # best service experience.
171
159
  # @!attribute [rw] device_info
172
160
  # @return [::Google::Cloud::Talent::V4::DeviceInfo]
173
161
  # The type of device used by the job seeker at the time of the call to the
@@ -232,10 +220,7 @@ module Google
232
220
  # Custom attribute values that are either filterable or non-filterable.
233
221
  # @!attribute [rw] string_values
234
222
  # @return [::Array<::String>]
235
- # Exactly one of
236
- # {::Google::Cloud::Talent::V4::CustomAttribute#string_values string_values} or
237
- # {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} must be
238
- # specified.
223
+ # Exactly one of {::Google::Cloud::Talent::V4::CustomAttribute#string_values string_values} or {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} must be specified.
239
224
  #
240
225
  # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
241
226
  # `CASE_INSENSITIVE_MATCH`) search.
@@ -247,22 +232,16 @@ module Google
247
232
  # Empty string isn't allowed.
248
233
  # @!attribute [rw] long_values
249
234
  # @return [::Array<::Integer>]
250
- # Exactly one of
251
- # {::Google::Cloud::Talent::V4::CustomAttribute#string_values string_values} or
252
- # {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} must be
253
- # specified.
235
+ # Exactly one of {::Google::Cloud::Talent::V4::CustomAttribute#string_values string_values} or {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} must be specified.
254
236
  #
255
237
  # This field is used to perform number range search.
256
238
  # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`.
257
239
  #
258
- # Currently at most 1
259
- # {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} is
260
- # supported.
240
+ # Currently at most 1 {::Google::Cloud::Talent::V4::CustomAttribute#long_values long_values} is supported.
261
241
  # @!attribute [rw] filterable
262
242
  # @return [::Boolean]
263
243
  # If the `filterable` flag is true, the custom field values may be used for
264
- # custom attribute filters
265
- # {::Google::Cloud::Talent::V4::JobQuery#custom_attribute_filter JobQuery.custom_attribute_filter}.
244
+ # custom attribute filters {::Google::Cloud::Talent::V4::JobQuery#custom_attribute_filter JobQuery.custom_attribute_filter}.
266
245
  # If false, these values may not be used for custom attribute filters.
267
246
  #
268
247
  # Default is false.
@@ -305,30 +284,22 @@ module Google
305
284
  # Job compensation information.
306
285
  #
307
286
  # At most one entry can be of type
308
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationType::BASE CompensationInfo.CompensationType.BASE},
309
- # which is referred as **base compensation entry** for the job.
287
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationType::BASE CompensationInfo.CompensationType.BASE}, which is
288
+ # referred as **base compensation entry** for the job.
310
289
  # @!attribute [r] annualized_base_compensation_range
311
290
  # @return [::Google::Cloud::Talent::V4::CompensationInfo::CompensationRange]
312
- # Output only. Annualized base compensation range. Computed as base
313
- # compensation entry's
314
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount}
315
- # times
291
+ # Output only. Annualized base compensation range. Computed as base compensation entry's
292
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount} times
316
293
  # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#expected_units_per_year CompensationEntry.expected_units_per_year}.
317
294
  #
318
- # See
319
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry CompensationEntry}
320
- # for explanation on compensation annualization.
295
+ # See {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry CompensationEntry} for explanation on compensation annualization.
321
296
  # @!attribute [r] annualized_total_compensation_range
322
297
  # @return [::Google::Cloud::Talent::V4::CompensationInfo::CompensationRange]
323
- # Output only. Annualized total compensation range. Computed as all
324
- # compensation entries'
325
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount}
326
- # times
298
+ # Output only. Annualized total compensation range. Computed as all compensation entries'
299
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount} times
327
300
  # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#expected_units_per_year CompensationEntry.expected_units_per_year}.
328
301
  #
329
- # See
330
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry CompensationEntry}
331
- # for explanation on compensation annualization.
302
+ # See {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry CompensationEntry} for explanation on compensation annualization.
332
303
  class CompensationInfo
333
304
  include ::Google::Protobuf::MessageExts
334
305
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -337,30 +308,20 @@ module Google
337
308
  # as base pay, bonus, or other compensation type.
338
309
  #
339
310
  # Annualization: One compensation entry can be annualized if
340
- # - it contains valid
341
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount amount}
342
- # or
343
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range range}.
344
- # - and its
345
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#expected_units_per_year expected_units_per_year}
346
- # is set or can be derived. Its annualized range is determined as
347
- # ({::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount amount}
348
- # or
349
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range range})
350
- # times
311
+ # - it contains valid {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount amount} or {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range range}.
312
+ # - and its {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#expected_units_per_year expected_units_per_year} is set or can be derived.
313
+ # Its annualized range is determined as ({::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount amount} or {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range range}) times
351
314
  # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#expected_units_per_year expected_units_per_year}.
352
315
  # @!attribute [rw] type
353
316
  # @return [::Google::Cloud::Talent::V4::CompensationInfo::CompensationType]
354
317
  # Compensation type.
355
318
  #
356
- # Default is
357
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationType::COMPENSATION_TYPE_UNSPECIFIED CompensationType.COMPENSATION_TYPE_UNSPECIFIED}.
319
+ # Default is {::Google::Cloud::Talent::V4::CompensationInfo::CompensationType::COMPENSATION_TYPE_UNSPECIFIED CompensationType.COMPENSATION_TYPE_UNSPECIFIED}.
358
320
  # @!attribute [rw] unit
359
321
  # @return [::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit]
360
322
  # Frequency of the specified amount.
361
323
  #
362
- # Default is
363
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit::COMPENSATION_UNIT_UNSPECIFIED CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED}.
324
+ # Default is {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit::COMPENSATION_UNIT_UNSPECIFIED CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED}.
364
325
  # @!attribute [rw] amount
365
326
  # @return [::Google::Type::Money]
366
327
  # Compensation amount.
@@ -375,10 +336,8 @@ module Google
375
336
  # @!attribute [rw] expected_units_per_year
376
337
  # @return [::Google::Protobuf::DoubleValue]
377
338
  # Expected number of units paid each year. If not specified, when
378
- # {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types} is
379
- # FULLTIME, a default value is inferred based on
380
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#unit unit}.
381
- # Default values:
339
+ # {::Google::Cloud::Talent::V4::Job#employment_types Job.employment_types} is FULLTIME, a default value is inferred
340
+ # based on {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#unit unit}. Default values:
382
341
  # - HOURLY: 2080
383
342
  # - DAILY: 260
384
343
  # - WEEKLY: 52
@@ -409,30 +368,19 @@ module Google
409
368
  # The type of compensation.
410
369
  #
411
370
  # For compensation amounts specified in non-monetary amounts,
412
- # describe the compensation scheme in the
413
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}.
371
+ # describe the compensation scheme in the {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}.
414
372
  #
415
373
  # For example, tipping format is described in
416
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}
417
- # (for example, "expect 15-20% tips based on customer bill.") and an estimate
418
- # of the tips provided in
419
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount}
420
- # or
421
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range CompensationEntry.range}
422
- # ($10 per hour).
374
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description} (for example, "expect 15-20% tips based
375
+ # on customer bill.") and an estimate of the tips provided in
376
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount} or {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range CompensationEntry.range} ($10 per hour).
423
377
  #
424
- # For example, equity is described in
425
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}
378
+ # For example, equity is described in {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}
426
379
  # (for example, "1% - 2% equity vesting over 4 years, 1 year cliff") and
427
- # value estimated in
428
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount}
429
- # or
430
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range CompensationEntry.range}.
431
- # If no value estimate is possible, units are
432
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit::COMPENSATION_UNIT_UNSPECIFIED CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED}
433
- # and then further clarified in
434
- # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description}
435
- # field.
380
+ # value estimated in {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#amount CompensationEntry.amount} or
381
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#range CompensationEntry.range}. If no value estimate is possible, units are
382
+ # {::Google::Cloud::Talent::V4::CompensationInfo::CompensationUnit::COMPENSATION_UNIT_UNSPECIFIED CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED} and then further
383
+ # clarified in {::Google::Cloud::Talent::V4::CompensationInfo::CompensationEntry#description CompensationEntry.description} field.
436
384
  module CompensationType
437
385
  # Default value.
438
386
  COMPENSATION_TYPE_UNSPECIFIED = 0
@@ -494,8 +442,7 @@ module Google
494
442
  end
495
443
 
496
444
  # Metadata used for long running operations returned by CTS batch APIs.
497
- # It's used to replace
498
- # {::Google::Longrunning::Operation#metadata google.longrunning.Operation.metadata}.
445
+ # It's used to replace {::Google::Longrunning::Operation#metadata google.longrunning.Operation.metadata}.
499
446
  # @!attribute [rw] state
500
447
  # @return [::Google::Cloud::Talent::V4::BatchOperationMetadata::State]
501
448
  # The state of a long running operation.
@@ -517,13 +464,12 @@ module Google
517
464
  # @!attribute [rw] update_time
518
465
  # @return [::Google::Protobuf::Timestamp]
519
466
  # The time when the batch operation status is updated. The metadata and the
520
- # {::Google::Cloud::Talent::V4::BatchOperationMetadata#update_time update_time} is
521
- # refreshed every minute otherwise cached data is returned.
467
+ # {::Google::Cloud::Talent::V4::BatchOperationMetadata#update_time update_time} is refreshed every minute otherwise cached data is
468
+ # returned.
522
469
  # @!attribute [rw] end_time
523
470
  # @return [::Google::Protobuf::Timestamp]
524
471
  # The time when the batch operation is finished and
525
- # {::Google::Longrunning::Operation#done google.longrunning.Operation.done} is
526
- # set to `true`.
472
+ # {::Google::Longrunning::Operation#done google.longrunning.Operation.done} is set to `true`.
527
473
  class BatchOperationMetadata
528
474
  include ::Google::Protobuf::MessageExts
529
475
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -546,14 +492,12 @@ module Google
546
492
  FAILED = 4
547
493
 
548
494
  # The batch operation is in the process of cancelling after
549
- # google.longrunning.Operations.CancelOperation
550
- # is called.
495
+ # google.longrunning.Operations.CancelOperation is called.
551
496
  CANCELLING = 5
552
497
 
553
498
  # The batch operation is done after
554
- # google.longrunning.Operations.CancelOperation
555
- # is called. Any items processed before cancelling are returned in the
556
- # response.
499
+ # google.longrunning.Operations.CancelOperation is called. Any items
500
+ # processed before cancelling are returned in the response.
557
501
  CANCELLED = 6
558
502
  end
559
503
  end
@@ -705,8 +649,7 @@ module Google
705
649
  # The job is offered as a contracted position with the understanding
706
650
  # that it's converted into a full-time position at the end of the
707
651
  # contract. Jobs of this type are also returned by a search for
708
- # {::Google::Cloud::Talent::V4::EmploymentType::CONTRACTOR EmploymentType.CONTRACTOR}
709
- # jobs.
652
+ # {::Google::Cloud::Talent::V4::EmploymentType::CONTRACTOR EmploymentType.CONTRACTOR} jobs.
710
653
  CONTRACT_TO_HIRE = 4
711
654
 
712
655
  # The job is offered as a temporary employment opportunity, usually
@@ -866,10 +809,9 @@ module Google
866
809
  POSTING_REGION_UNSPECIFIED = 0
867
810
 
868
811
  # In addition to exact location matching, job posting is returned when the
869
- # {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} in the search query
870
- # is in the same administrative area as the returned job posting. For
871
- # example, if a `ADMINISTRATIVE_AREA` job is posted in "CA, USA", it's
872
- # returned if {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} has
812
+ # {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} in the search query is in the same administrative area
813
+ # as the returned job posting. For example, if a `ADMINISTRATIVE_AREA` job
814
+ # is posted in "CA, USA", it's returned if {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} has
873
815
  # "Mountain View".
874
816
  #
875
817
  # Administrative area refers to top-level administrative subdivision of this
@@ -878,11 +820,9 @@ module Google
878
820
  ADMINISTRATIVE_AREA = 1
879
821
 
880
822
  # In addition to exact location matching, job is returned when
881
- # {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} in search query is
882
- # in the same country as this job. For example, if a `NATION_WIDE` job is
883
- # posted in "USA", it's returned if
884
- # {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} has 'Mountain
885
- # View'.
823
+ # {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} in search query is in the same country as this job.
824
+ # For example, if a `NATION_WIDE` job is posted in "USA", it's
825
+ # returned if {::Google::Cloud::Talent::V4::LocationFilter LocationFilter} has 'Mountain View'.
886
826
  NATION = 2
887
827
 
888
828
  # Job allows employees to work remotely (telecommute).
@@ -936,12 +876,6 @@ module Google
936
876
  # Commute time is calculated based on public transit including bus, metro,
937
877
  # subway, and so on.
938
878
  TRANSIT = 2
939
-
940
- # Commute time is calculated based on walking time.
941
- WALKING = 3
942
-
943
- # Commute time is calculated based on biking time.
944
- CYCLING = 4
945
879
  end
946
880
  end
947
881
  end