google-cloud-talent-v4 0.1.0 → 0.4.1

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 (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