google-cloud-tasks-v2 0.8.0 → 0.8.2

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 064c681abcc996474534d0eb75e5e7439f3951ee6117c4d711633a430347f16c
4
- data.tar.gz: e86008b03f3a05f17afca6782b02ce57b5b640d54ffb77fea1952d3bc454c917
3
+ metadata.gz: 4fc458310d9519284809db91d4decce47c8590e7a44af2c444d6ba626d198e51
4
+ data.tar.gz: '0908a45fc002152c9e1259dfcc6680652efc79cd6ba11e2447d13124d328014d'
5
5
  SHA512:
6
- metadata.gz: d1a14695f17cbbb5c9506b19a0d139470fa24371ed86c9ca8b3caf2ece08912cbfbcf176ba5ffca71de4451b266b764a5d7fc625c2faa09d7cf3b1619de16f42
7
- data.tar.gz: 51cfb55f2070950d4d15cdf4a107fbdf46ee006853d8ff77980d7fa58fdb3dea70b6dabf150c5148bb0ac35958004c5f1459b9d0f92e56dbc271f76f14c8c107
6
+ metadata.gz: 505427abd2604868628701d74666a47cc00961817c6bedf5dd5ccecca9bc78ad99c03a129aaf132c9ed343054bd086198c9837344a8f8eaea8f3f630cd881735
7
+ data.tar.gz: 495a3154f884a9b7ea3671530a6103bab8cab73e93b50360943e8802e85e505957e9edff8647aa8933f05642c622e919783f395e8ecc12a0e1e6efcf65052081
@@ -0,0 +1,102 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/config"
20
+
21
+ module Google
22
+ module Cloud
23
+ module Tasks
24
+ ##
25
+ # @example Loading just the REST part of this package, including all its services, and instantiating a REST client
26
+ #
27
+ # require "google/cloud/tasks/v2/rest"
28
+ # client = ::Google::Cloud::Tasks::V2::CloudTasks::Rest::Client.new
29
+ #
30
+ module V2
31
+ ##
32
+ # @private
33
+ # Initialize the mixin bindings configuration
34
+ #
35
+ def self.configure
36
+ @configure ||= begin
37
+ namespace = ["Google", "Cloud", "Tasks"]
38
+ parent_config = while namespace.any?
39
+ parent_name = namespace.join "::"
40
+ parent_const = const_get parent_name
41
+ break parent_const.configure if parent_const.respond_to? :configure
42
+ namespace.pop
43
+ end
44
+
45
+ default_config = Configuration.new parent_config
46
+ default_config.bindings_override["google.cloud.location.Locations.GetLocation"] = [
47
+ Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
48
+ uri_method: :get,
49
+ uri_template: "/v2/{name}",
50
+ matches: [
51
+ ["name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
52
+ ],
53
+ body: nil
54
+ )
55
+ ]
56
+ default_config.bindings_override["google.cloud.location.Locations.ListLocations"] = [
57
+
58
+ Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
59
+ uri_method: :get,
60
+ uri_template: "/v2/{name}/locations",
61
+ matches: [
62
+ ["name", %r{^projects/[^/]+/?$}, false]
63
+ ],
64
+ body: nil
65
+ )
66
+ ]
67
+ default_config
68
+ end
69
+ yield @configure if block_given?
70
+ @configure
71
+ end
72
+
73
+ ##
74
+ # @private
75
+ # Configuration class for the google.cloud.tasks.v2 package.
76
+ #
77
+ # This class contains common configuration for all services
78
+ # of the google.cloud.tasks.v2 package.
79
+ #
80
+ # This configuration is for internal use of the client library classes,
81
+ # and it is not intended that the end-users will read or change it.
82
+ #
83
+ class Configuration
84
+ extend ::Gapic::Config
85
+
86
+ # @private
87
+ # Overrides for http bindings for the RPC of the mixins for this package.
88
+ # Services in this package should use these when creating clients for the mixin services.
89
+ # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
90
+ config_attr :bindings_override, {}, ::Hash, nil
91
+
92
+ # @private
93
+ def initialize parent_config = nil
94
+ @parent_config = parent_config unless parent_config.nil?
95
+
96
+ yield self if block_given?
97
+ end
98
+ end
99
+ end
100
+ end
101
+ end
102
+ end
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/tasks/v2/cloudtasks_pb"
21
+ require "google/cloud/location"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -65,61 +66,61 @@ module Google
65
66
  end
66
67
  default_config = Client::Configuration.new parent_config
67
68
 
68
- default_config.rpcs.list_queues.timeout = 10.0
69
+ default_config.rpcs.list_queues.timeout = 20.0
69
70
  default_config.rpcs.list_queues.retry_policy = {
70
71
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
71
72
  }
72
73
 
73
- default_config.rpcs.get_queue.timeout = 10.0
74
+ default_config.rpcs.get_queue.timeout = 20.0
74
75
  default_config.rpcs.get_queue.retry_policy = {
75
76
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
76
77
  }
77
78
 
78
- default_config.rpcs.create_queue.timeout = 10.0
79
+ default_config.rpcs.create_queue.timeout = 20.0
79
80
 
80
- default_config.rpcs.update_queue.timeout = 10.0
81
+ default_config.rpcs.update_queue.timeout = 20.0
81
82
 
82
- default_config.rpcs.delete_queue.timeout = 10.0
83
+ default_config.rpcs.delete_queue.timeout = 20.0
83
84
  default_config.rpcs.delete_queue.retry_policy = {
84
85
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
85
86
  }
86
87
 
87
- default_config.rpcs.purge_queue.timeout = 10.0
88
+ default_config.rpcs.purge_queue.timeout = 20.0
88
89
 
89
- default_config.rpcs.pause_queue.timeout = 10.0
90
+ default_config.rpcs.pause_queue.timeout = 20.0
90
91
 
91
- default_config.rpcs.resume_queue.timeout = 10.0
92
+ default_config.rpcs.resume_queue.timeout = 20.0
92
93
 
93
- default_config.rpcs.get_iam_policy.timeout = 10.0
94
+ default_config.rpcs.get_iam_policy.timeout = 20.0
94
95
  default_config.rpcs.get_iam_policy.retry_policy = {
95
96
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
96
97
  }
97
98
 
98
- default_config.rpcs.set_iam_policy.timeout = 10.0
99
+ default_config.rpcs.set_iam_policy.timeout = 20.0
99
100
 
100
- default_config.rpcs.test_iam_permissions.timeout = 10.0
101
+ default_config.rpcs.test_iam_permissions.timeout = 20.0
101
102
  default_config.rpcs.test_iam_permissions.retry_policy = {
102
103
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
103
104
  }
104
105
 
105
- default_config.rpcs.list_tasks.timeout = 10.0
106
+ default_config.rpcs.list_tasks.timeout = 20.0
106
107
  default_config.rpcs.list_tasks.retry_policy = {
107
108
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
108
109
  }
109
110
 
110
- default_config.rpcs.get_task.timeout = 10.0
111
+ default_config.rpcs.get_task.timeout = 20.0
111
112
  default_config.rpcs.get_task.retry_policy = {
112
113
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
113
114
  }
114
115
 
115
- default_config.rpcs.create_task.timeout = 10.0
116
+ default_config.rpcs.create_task.timeout = 20.0
116
117
 
117
- default_config.rpcs.delete_task.timeout = 10.0
118
+ default_config.rpcs.delete_task.timeout = 20.0
118
119
  default_config.rpcs.delete_task.retry_policy = {
119
120
  initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
120
121
  }
121
122
 
122
- default_config.rpcs.run_task.timeout = 10.0
123
+ default_config.rpcs.run_task.timeout = 20.0
123
124
 
124
125
  default_config
125
126
  end
@@ -180,7 +181,7 @@ module Google
180
181
  credentials = @config.credentials
181
182
  # Use self-signed JWT if the endpoint is unchanged from default,
182
183
  # but only if the default endpoint does not have a region prefix.
183
- enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
184
+ enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
184
185
  !@config.endpoint.split(".").first.include?("-")
185
186
  credentials ||= Credentials.default scope: @config.scope,
186
187
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -190,6 +191,12 @@ module Google
190
191
  @quota_project_id = @config.quota_project
191
192
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
192
193
 
194
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
195
+ config.credentials = credentials
196
+ config.quota_project = @quota_project_id
197
+ config.endpoint = @config.endpoint
198
+ end
199
+
193
200
  @cloud_tasks_stub = ::Gapic::ServiceStub.new(
194
201
  ::Google::Cloud::Tasks::V2::CloudTasks::Stub,
195
202
  credentials: credentials,
@@ -199,6 +206,13 @@ module Google
199
206
  )
200
207
  end
201
208
 
209
+ ##
210
+ # Get the associated client for mix-in of the Locations.
211
+ #
212
+ # @return [Google::Cloud::Location::Locations::Client]
213
+ #
214
+ attr_reader :location_client
215
+
202
216
  # Service calls
203
217
 
204
218
  ##
@@ -225,11 +239,10 @@ module Google
225
239
  # Required. The location name.
226
240
  # For example: `projects/PROJECT_ID/locations/LOCATION_ID`
227
241
  # @param filter [::String]
228
- # `filter` can be used to specify a subset of queues. Any {::Google::Cloud::Tasks::V2::Queue Queue}
229
- # field can be used as a filter and several operators as supported.
230
- # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
231
- # described in
232
- # [Stackdriver's Advanced Logs
242
+ # `filter` can be used to specify a subset of queues. Any
243
+ # {::Google::Cloud::Tasks::V2::Queue Queue} field can be used as a filter and
244
+ # several operators as supported. For example: `<=, <, >=, >, !=, =, :`. The
245
+ # filter syntax is the same as described in [Stackdriver's Advanced Logs
233
246
  # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
234
247
  #
235
248
  # Sample filter "state: PAUSED".
@@ -242,17 +255,19 @@ module Google
242
255
  # The maximum page size is 9800. If unspecified, the page size will
243
256
  # be the maximum. Fewer queues than requested might be returned,
244
257
  # even if more queues exist; use the
245
- # {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token} in the
246
- # response to determine if more queues exist.
258
+ # {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token}
259
+ # in the response to determine if more queues exist.
247
260
  # @param page_token [::String]
248
261
  # A token identifying the page of results to return.
249
262
  #
250
263
  # To request the first page results, page_token must be empty. To
251
264
  # request the next page of results, page_token must be the value of
252
- # {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token} returned
253
- # from the previous call to {::Google::Cloud::Tasks::V2::CloudTasks::Client#list_queues ListQueues}
254
- # method. It is an error to switch the value of the
255
- # {::Google::Cloud::Tasks::V2::ListQueuesRequest#filter filter} while iterating through pages.
265
+ # {::Google::Cloud::Tasks::V2::ListQueuesResponse#next_page_token next_page_token}
266
+ # returned from the previous call to
267
+ # {::Google::Cloud::Tasks::V2::CloudTasks::Client#list_queues ListQueues} method. It is an
268
+ # error to switch the value of the
269
+ # {::Google::Cloud::Tasks::V2::ListQueuesRequest#filter filter} while iterating
270
+ # through pages.
256
271
  #
257
272
  # @yield [response, operation] Access the result along with the RPC operation
258
273
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Tasks::V2::Queue>]
@@ -413,8 +428,8 @@ module Google
413
428
  # Creates a queue.
414
429
  #
415
430
  # Queues created with this method allow tasks to live for a maximum of 31
416
- # days. After a task is 31 days old, the task will be deleted regardless of whether
417
- # it was dispatched or not.
431
+ # days. After a task is 31 days old, the task will be deleted regardless of
432
+ # whether it was dispatched or not.
418
433
  #
419
434
  # WARNING: Using this method may have unintended side effects if you are
420
435
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -444,11 +459,12 @@ module Google
444
459
  #
445
460
  # The list of allowed locations can be obtained by calling Cloud
446
461
  # Tasks' implementation of
447
- # [ListLocations][google.cloud.location.Locations.ListLocations].
462
+ # `::Google::Cloud::Location::Locations::Client#list_locations`.
448
463
  # @param queue [::Google::Cloud::Tasks::V2::Queue, ::Hash]
449
464
  # Required. The queue to create.
450
465
  #
451
- # [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue.
466
+ # [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an
467
+ # existing queue.
452
468
  #
453
469
  # @yield [response, operation] Access the result along with the RPC operation
454
470
  # @yieldparam response [::Google::Cloud::Tasks::V2::Queue]
@@ -521,8 +537,8 @@ module Google
521
537
  # the queue if it does exist.
522
538
  #
523
539
  # Queues created with this method allow tasks to live for a maximum of 31
524
- # days. After a task is 31 days old, the task will be deleted regardless of whether
525
- # it was dispatched or not.
540
+ # days. After a task is 31 days old, the task will be deleted regardless of
541
+ # whether it was dispatched or not.
526
542
  #
527
543
  # WARNING: Using this method may have unintended side effects if you are
528
544
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -817,9 +833,10 @@ module Google
817
833
  #
818
834
  # If a queue is paused then the system will stop dispatching tasks
819
835
  # until the queue is resumed via
820
- # {::Google::Cloud::Tasks::V2::CloudTasks::Client#resume_queue ResumeQueue}. Tasks can still be added
821
- # when the queue is paused. A queue is paused if its
822
- # {::Google::Cloud::Tasks::V2::Queue#state state} is {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
836
+ # {::Google::Cloud::Tasks::V2::CloudTasks::Client#resume_queue ResumeQueue}. Tasks can
837
+ # still be added when the queue is paused. A queue is paused if its
838
+ # {::Google::Cloud::Tasks::V2::Queue#state state} is
839
+ # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
823
840
  #
824
841
  # @overload pause_queue(request, options = nil)
825
842
  # Pass arguments to `pause_queue` via a request object, either of type
@@ -909,9 +926,10 @@ module Google
909
926
  #
910
927
  # This method resumes a queue after it has been
911
928
  # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED} or
912
- # {::Google::Cloud::Tasks::V2::Queue::State::DISABLED DISABLED}. The state of a queue is stored
913
- # in the queue's {::Google::Cloud::Tasks::V2::Queue#state state}; after calling this method it
914
- # will be set to {::Google::Cloud::Tasks::V2::Queue::State::RUNNING RUNNING}.
929
+ # {::Google::Cloud::Tasks::V2::Queue::State::DISABLED DISABLED}. The state of a
930
+ # queue is stored in the queue's {::Google::Cloud::Tasks::V2::Queue#state state};
931
+ # after calling this method it will be set to
932
+ # {::Google::Cloud::Tasks::V2::Queue::State::RUNNING RUNNING}.
915
933
  #
916
934
  # WARNING: Resuming many high-QPS queues at the same time can
917
935
  # lead to target overloading. If you are resuming high-QPS
@@ -1100,8 +1118,8 @@ module Google
1100
1118
  end
1101
1119
 
1102
1120
  ##
1103
- # Sets the access control policy for a {::Google::Cloud::Tasks::V2::Queue Queue}. Replaces any existing
1104
- # policy.
1121
+ # Sets the access control policy for a {::Google::Cloud::Tasks::V2::Queue Queue}.
1122
+ # Replaces any existing policy.
1105
1123
  #
1106
1124
  # Note: The Cloud Console does not check queue-level IAM permissions yet.
1107
1125
  # Project-level permissions are required to use the Cloud Console.
@@ -1207,9 +1225,10 @@ module Google
1207
1225
  end
1208
1226
 
1209
1227
  ##
1210
- # Returns permissions that a caller has on a {::Google::Cloud::Tasks::V2::Queue Queue}.
1211
- # If the resource does not exist, this will return an empty set of
1212
- # permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
1228
+ # Returns permissions that a caller has on a
1229
+ # {::Google::Cloud::Tasks::V2::Queue Queue}. If the resource does not exist, this
1230
+ # will return an empty set of permissions, not a
1231
+ # [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
1213
1232
  #
1214
1233
  # Note: This operation is designed to be used for building permission-aware
1215
1234
  # UIs and command-line tools, not for authorization checking. This operation
@@ -1306,10 +1325,10 @@ module Google
1306
1325
  ##
1307
1326
  # Lists the tasks in a queue.
1308
1327
  #
1309
- # By default, only the {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC} view is retrieved
1310
- # due to performance considerations;
1311
- # {::Google::Cloud::Tasks::V2::ListTasksRequest#response_view response_view} controls the
1312
- # subset of information which is returned.
1328
+ # By default, only the {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC} view is
1329
+ # retrieved due to performance considerations;
1330
+ # {::Google::Cloud::Tasks::V2::ListTasksRequest#response_view response_view}
1331
+ # controls the subset of information which is returned.
1313
1332
  #
1314
1333
  # The tasks may be returned in any order. The ordering may change at any
1315
1334
  # time.
@@ -1333,11 +1352,11 @@ module Google
1333
1352
  # Required. The queue name. For example:
1334
1353
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
1335
1354
  # @param response_view [::Google::Cloud::Tasks::V2::Task::View]
1336
- # The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
1337
- # returned.
1355
+ # The response_view specifies which subset of the
1356
+ # {::Google::Cloud::Tasks::V2::Task Task} will be returned.
1338
1357
  #
1339
- # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
1340
- # information is retrieved by default because some data, such as
1358
+ # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
1359
+ # not all information is retrieved by default because some data, such as
1341
1360
  # payloads, might be desirable to return only when needed because
1342
1361
  # of its large size or because of the sensitivity of data that it
1343
1362
  # contains.
@@ -1349,8 +1368,8 @@ module Google
1349
1368
  # Maximum page size.
1350
1369
  #
1351
1370
  # Fewer tasks than requested might be returned, even if more tasks exist; use
1352
- # {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} in the response to
1353
- # determine if more tasks exist.
1371
+ # {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token}
1372
+ # in the response to determine if more tasks exist.
1354
1373
  #
1355
1374
  # The maximum page size is 1000. If unspecified, the page size will be the
1356
1375
  # maximum.
@@ -1359,9 +1378,9 @@ module Google
1359
1378
  #
1360
1379
  # To request the first page results, page_token must be empty. To
1361
1380
  # request the next page of results, page_token must be the value of
1362
- # {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} returned
1363
- # from the previous call to {::Google::Cloud::Tasks::V2::CloudTasks::Client#list_tasks ListTasks}
1364
- # method.
1381
+ # {::Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token}
1382
+ # returned from the previous call to
1383
+ # {::Google::Cloud::Tasks::V2::CloudTasks::Client#list_tasks ListTasks} method.
1365
1384
  #
1366
1385
  # The page token is valid for only 2 hours.
1367
1386
  #
@@ -1456,11 +1475,11 @@ module Google
1456
1475
  # Required. The task name. For example:
1457
1476
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
1458
1477
  # @param response_view [::Google::Cloud::Tasks::V2::Task::View]
1459
- # The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
1460
- # returned.
1478
+ # The response_view specifies which subset of the
1479
+ # {::Google::Cloud::Tasks::V2::Task Task} will be returned.
1461
1480
  #
1462
- # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
1463
- # information is retrieved by default because some data, such as
1481
+ # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
1482
+ # not all information is retrieved by default because some data, such as
1464
1483
  # payloads, might be desirable to return only when needed because
1465
1484
  # of its large size or because of the sensitivity of data that it
1466
1485
  # contains.
@@ -1565,13 +1584,13 @@ module Google
1565
1584
  #
1566
1585
  # Task names have the following format:
1567
1586
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
1568
- # The user can optionally specify a task {::Google::Cloud::Tasks::V2::Task#name name}. If a
1569
- # name is not specified then the system will generate a random
1570
- # unique task id, which will be set in the task returned in the
1571
- # {::Google::Cloud::Tasks::V2::Task#name response}.
1587
+ # The user can optionally specify a task
1588
+ # {::Google::Cloud::Tasks::V2::Task#name name}. If a name is not specified then
1589
+ # the system will generate a random unique task id, which will be set in the
1590
+ # task returned in the {::Google::Cloud::Tasks::V2::Task#name response}.
1572
1591
  #
1573
- # If {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} is not set or is in the
1574
- # past then Cloud Tasks will set it to the current time.
1592
+ # If {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} is not set or
1593
+ # is in the past then Cloud Tasks will set it to the current time.
1575
1594
  #
1576
1595
  # Task De-duplication:
1577
1596
  #
@@ -1586,20 +1605,20 @@ module Google
1586
1605
  # for ~9days after the original task was deleted or executed.
1587
1606
  #
1588
1607
  # Because there is an extra lookup cost to identify duplicate task
1589
- # names, these {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask} calls have significantly
1590
- # increased latency. Using hashed strings for the task id or for
1591
- # the prefix of the task id is recommended. Choosing task ids that
1592
- # are sequential or have sequential prefixes, for example using a
1608
+ # names, these {::Google::Cloud::Tasks::V2::CloudTasks::Client#create_task CreateTask}
1609
+ # calls have significantly increased latency. Using hashed strings for the
1610
+ # task id or for the prefix of the task id is recommended. Choosing task ids
1611
+ # that are sequential or have sequential prefixes, for example using a
1593
1612
  # timestamp, causes an increase in latency and error rates in all
1594
1613
  # task commands. The infrastructure relies on an approximately
1595
1614
  # uniform distribution of task ids to store and serve tasks
1596
1615
  # efficiently.
1597
1616
  # @param response_view [::Google::Cloud::Tasks::V2::Task::View]
1598
- # The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
1599
- # returned.
1617
+ # The response_view specifies which subset of the
1618
+ # {::Google::Cloud::Tasks::V2::Task Task} will be returned.
1600
1619
  #
1601
- # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
1602
- # information is retrieved by default because some data, such as
1620
+ # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
1621
+ # not all information is retrieved by default because some data, such as
1603
1622
  # payloads, might be desirable to return only when needed because
1604
1623
  # of its large size or because of the sensitivity of data that it
1605
1624
  # contains.
@@ -1766,13 +1785,14 @@ module Google
1766
1785
  # Forces a task to run now.
1767
1786
  #
1768
1787
  # When this method is called, Cloud Tasks will dispatch the task, even if
1769
- # the task is already running, the queue has reached its {::Google::Cloud::Tasks::V2::RateLimits RateLimits} or
1770
- # is {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
1788
+ # the task is already running, the queue has reached its
1789
+ # {::Google::Cloud::Tasks::V2::RateLimits RateLimits} or is
1790
+ # {::Google::Cloud::Tasks::V2::Queue::State::PAUSED PAUSED}.
1771
1791
  #
1772
1792
  # This command is meant to be used for manual debugging. For
1773
- # example, {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask} can be used to retry a failed
1774
- # task after a fix has been made or to manually force a task to be
1775
- # dispatched now.
1793
+ # example, {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask} can be used to
1794
+ # retry a failed task after a fix has been made or to manually force a task
1795
+ # to be dispatched now.
1776
1796
  #
1777
1797
  # The dispatched task is returned. That is, the task that is returned
1778
1798
  # contains the [status][Task.status] after the task is dispatched but
@@ -1780,9 +1800,10 @@ module Google
1780
1800
  #
1781
1801
  # If Cloud Tasks receives a successful response from the task's
1782
1802
  # target, then the task will be deleted; otherwise the task's
1783
- # {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} will be reset to the time that
1784
- # {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask} was called plus the retry delay specified
1785
- # in the queue's {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig}.
1803
+ # {::Google::Cloud::Tasks::V2::Task#schedule_time schedule_time} will be reset to
1804
+ # the time that {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask} was
1805
+ # called plus the retry delay specified in the queue's
1806
+ # {::Google::Cloud::Tasks::V2::RetryConfig RetryConfig}.
1786
1807
  #
1787
1808
  # {::Google::Cloud::Tasks::V2::CloudTasks::Client#run_task RunTask} returns
1788
1809
  # [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
@@ -1807,11 +1828,11 @@ module Google
1807
1828
  # Required. The task name. For example:
1808
1829
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
1809
1830
  # @param response_view [::Google::Cloud::Tasks::V2::Task::View]
1810
- # The response_view specifies which subset of the {::Google::Cloud::Tasks::V2::Task Task} will be
1811
- # returned.
1831
+ # The response_view specifies which subset of the
1832
+ # {::Google::Cloud::Tasks::V2::Task Task} will be returned.
1812
1833
  #
1813
- # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC}; not all
1814
- # information is retrieved by default because some data, such as
1834
+ # By default response_view is {::Google::Cloud::Tasks::V2::Task::View::BASIC BASIC};
1835
+ # not all information is retrieved by default because some data, such as
1815
1836
  # payloads, might be desirable to return only when needed because
1816
1837
  # of its large size or because of the sensitivity of data that it
1817
1838
  # contains.
@@ -1966,7 +1987,9 @@ module Google
1966
1987
  class Configuration
1967
1988
  extend ::Gapic::Config
1968
1989
 
1969
- config_attr :endpoint, "cloudtasks.googleapis.com", ::String
1990
+ DEFAULT_ENDPOINT = "cloudtasks.googleapis.com"
1991
+
1992
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1970
1993
  config_attr :credentials, nil do |value|
1971
1994
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1972
1995
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC