google-cloud-bigquery-data_transfer-v1 0.2.1 → 0.2.6

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e284f6498f5bf027f45fb8094910d82ec3fc604c7391ca2e1f4a9c5d727b1263
4
- data.tar.gz: 352c3eaf54daf1a4cc1629f2aa11c5239cc16965ecf8b122e0282ec7561408db
3
+ metadata.gz: 01b2098a2fddc570f661b9d51267aee58e3f61a8d089dfe317a6cd80b0721ccf
4
+ data.tar.gz: a8bf1c39c135cd687ee543e50a08cbe3464e47de211b34fffe9fd73343316321
5
5
  SHA512:
6
- metadata.gz: 64d6d3138352742eff1e51f4119378c370408548ab9bf25d803bed77412d88104208a2f4f012532e8eaea5218a9b2d6e71f5084b1254a02f1439bba6816214c6
7
- data.tar.gz: 2b8a3a5adb16c61863b1cd4ffb8e65ce943d1b25c84e801e927457b5489efb8156def2a2c05f0904899b6c93713eb94161773c90293aa825e68676c4267b9162
6
+ metadata.gz: 1bcc633aa9b5c23ebda0373a9cc40663bf261328ba9412616240d07f7a420913cc8009d59b5c542721c13040f728430057ba46289413f3a44791d1c409fb9b54
7
+ data.tar.gz: eef6fb725498794c5cd494480d1b1780604cbf5b151c60a9dfa9cdb696c0771fe1963cbe9d8dcd907ec05d755adf88c51a5ee42cea7bd8af1a4083d2533ff71f
data/README.md CHANGED
@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
18
18
 
19
19
  1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
20
20
  1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
21
+ 1. [Enable the API.](https://console.cloud.google.com/apis/library/bigquerydatatransfer.googleapis.com)
21
22
  1. {file:AUTHENTICATION.md Set up authentication.}
22
23
 
23
24
  ## Quick Start
@@ -33,6 +34,9 @@ response = client.get_data_source request
33
34
  View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-bigquery-data_transfer-v1/latest)
34
35
  for class and method documentation.
35
36
 
37
+ See also the [Product Documentation](https://cloud.google.com/bigquery/transfer)
38
+ for general usage information.
39
+
36
40
  ## Enabling Logging
37
41
 
38
42
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
@@ -35,3 +35,6 @@ module Google
35
35
  end
36
36
  end
37
37
  end
38
+
39
+ helper_path = ::File.join __dir__, "v1", "_helpers.rb"
40
+ require "google/cloud/bigquery/data_transfer/v1/_helpers" if ::File.file? helper_path
@@ -74,7 +74,7 @@ module Google
74
74
  initial_delay: 0.1,
75
75
  max_delay: 60.0,
76
76
  multiplier: 1.3,
77
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
77
+ retry_codes: [14, 4]
78
78
  }
79
79
 
80
80
  default_config.rpcs.list_data_sources.timeout = 20.0
@@ -82,7 +82,7 @@ module Google
82
82
  initial_delay: 0.1,
83
83
  max_delay: 60.0,
84
84
  multiplier: 1.3,
85
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
85
+ retry_codes: [14, 4]
86
86
  }
87
87
 
88
88
  default_config.rpcs.create_transfer_config.timeout = 30.0
@@ -94,7 +94,7 @@ module Google
94
94
  initial_delay: 0.1,
95
95
  max_delay: 60.0,
96
96
  multiplier: 1.3,
97
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
97
+ retry_codes: [14, 4]
98
98
  }
99
99
 
100
100
  default_config.rpcs.get_transfer_config.timeout = 20.0
@@ -102,7 +102,7 @@ module Google
102
102
  initial_delay: 0.1,
103
103
  max_delay: 60.0,
104
104
  multiplier: 1.3,
105
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
105
+ retry_codes: [14, 4]
106
106
  }
107
107
 
108
108
  default_config.rpcs.list_transfer_configs.timeout = 20.0
@@ -110,7 +110,7 @@ module Google
110
110
  initial_delay: 0.1,
111
111
  max_delay: 60.0,
112
112
  multiplier: 1.3,
113
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
113
+ retry_codes: [14, 4]
114
114
  }
115
115
 
116
116
  default_config.rpcs.schedule_transfer_runs.timeout = 30.0
@@ -120,7 +120,7 @@ module Google
120
120
  initial_delay: 0.1,
121
121
  max_delay: 60.0,
122
122
  multiplier: 1.3,
123
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
123
+ retry_codes: [14, 4]
124
124
  }
125
125
 
126
126
  default_config.rpcs.delete_transfer_run.timeout = 20.0
@@ -128,7 +128,7 @@ module Google
128
128
  initial_delay: 0.1,
129
129
  max_delay: 60.0,
130
130
  multiplier: 1.3,
131
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
131
+ retry_codes: [14, 4]
132
132
  }
133
133
 
134
134
  default_config.rpcs.list_transfer_runs.timeout = 20.0
@@ -136,7 +136,7 @@ module Google
136
136
  initial_delay: 0.1,
137
137
  max_delay: 60.0,
138
138
  multiplier: 1.3,
139
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
139
+ retry_codes: [14, 4]
140
140
  }
141
141
 
142
142
  default_config.rpcs.list_transfer_logs.timeout = 20.0
@@ -144,7 +144,7 @@ module Google
144
144
  initial_delay: 0.1,
145
145
  max_delay: 60.0,
146
146
  multiplier: 1.3,
147
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
147
+ retry_codes: [14, 4]
148
148
  }
149
149
 
150
150
  default_config.rpcs.check_valid_creds.timeout = 20.0
@@ -152,7 +152,7 @@ module Google
152
152
  initial_delay: 0.1,
153
153
  max_delay: 60.0,
154
154
  multiplier: 1.3,
155
- retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
155
+ retry_codes: [14, 4]
156
156
  }
157
157
 
158
158
  default_config
@@ -1406,7 +1406,7 @@ module Google
1406
1406
 
1407
1407
  config_attr :endpoint, "bigquerydatatransfer.googleapis.com", ::String
1408
1408
  config_attr :credentials, nil do |value|
1409
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1409
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1410
1410
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
1411
1411
  allowed.any? { |klass| klass === value }
1412
1412
  end
@@ -1434,7 +1434,7 @@ module Google
1434
1434
  def rpcs
1435
1435
  @rpcs ||= begin
1436
1436
  parent_rpcs = nil
1437
- parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
1437
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
1438
1438
  Rpcs.new parent_rpcs
1439
1439
  end
1440
1440
  end
@@ -1446,7 +1446,7 @@ module Google
1446
1446
  # Each configuration object is of type `Gapic::Config::Method` and includes
1447
1447
  # the following configuration fields:
1448
1448
  #
1449
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
1449
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1450
1450
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
1451
1451
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
1452
1452
  # include the following keys:
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module DataTransfer
24
24
  module V1
25
- VERSION = "0.2.1"
25
+ VERSION = "0.2.6"
26
26
  end
27
27
  end
28
28
  end
@@ -39,48 +39,48 @@ module Google
39
39
 
40
40
  # Retrieves a supported data source and returns its settings,
41
41
  # which can be used for UI rendering.
42
- rpc :GetDataSource, Google::Cloud::Bigquery::DataTransfer::V1::GetDataSourceRequest, Google::Cloud::Bigquery::DataTransfer::V1::DataSource
42
+ rpc :GetDataSource, ::Google::Cloud::Bigquery::DataTransfer::V1::GetDataSourceRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::DataSource
43
43
  # Lists supported data sources and returns their settings,
44
44
  # which can be used for UI rendering.
45
- rpc :ListDataSources, Google::Cloud::Bigquery::DataTransfer::V1::ListDataSourcesRequest, Google::Cloud::Bigquery::DataTransfer::V1::ListDataSourcesResponse
45
+ rpc :ListDataSources, ::Google::Cloud::Bigquery::DataTransfer::V1::ListDataSourcesRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::ListDataSourcesResponse
46
46
  # Creates a new data transfer configuration.
47
- rpc :CreateTransferConfig, Google::Cloud::Bigquery::DataTransfer::V1::CreateTransferConfigRequest, Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
47
+ rpc :CreateTransferConfig, ::Google::Cloud::Bigquery::DataTransfer::V1::CreateTransferConfigRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
48
48
  # Updates a data transfer configuration.
49
49
  # All fields must be set, even if they are not updated.
50
- rpc :UpdateTransferConfig, Google::Cloud::Bigquery::DataTransfer::V1::UpdateTransferConfigRequest, Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
50
+ rpc :UpdateTransferConfig, ::Google::Cloud::Bigquery::DataTransfer::V1::UpdateTransferConfigRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
51
51
  # Deletes a data transfer configuration,
52
52
  # including any associated transfer runs and logs.
53
- rpc :DeleteTransferConfig, Google::Cloud::Bigquery::DataTransfer::V1::DeleteTransferConfigRequest, Google::Protobuf::Empty
53
+ rpc :DeleteTransferConfig, ::Google::Cloud::Bigquery::DataTransfer::V1::DeleteTransferConfigRequest, ::Google::Protobuf::Empty
54
54
  # Returns information about a data transfer config.
55
- rpc :GetTransferConfig, Google::Cloud::Bigquery::DataTransfer::V1::GetTransferConfigRequest, Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
55
+ rpc :GetTransferConfig, ::Google::Cloud::Bigquery::DataTransfer::V1::GetTransferConfigRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig
56
56
  # Returns information about all data transfers in the project.
57
- rpc :ListTransferConfigs, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferConfigsRequest, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferConfigsResponse
57
+ rpc :ListTransferConfigs, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferConfigsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferConfigsResponse
58
58
  # Creates transfer runs for a time range [start_time, end_time].
59
59
  # For each date - or whatever granularity the data source supports - in the
60
60
  # range, one transfer run is created.
61
61
  # Note that runs are created per UTC time in the time range.
62
62
  # DEPRECATED: use StartManualTransferRuns instead.
63
- rpc :ScheduleTransferRuns, Google::Cloud::Bigquery::DataTransfer::V1::ScheduleTransferRunsRequest, Google::Cloud::Bigquery::DataTransfer::V1::ScheduleTransferRunsResponse
63
+ rpc :ScheduleTransferRuns, ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleTransferRunsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleTransferRunsResponse
64
64
  # Start manual transfer runs to be executed now with schedule_time equal to
65
65
  # current time. The transfer runs can be created for a time range where the
66
66
  # run_time is between start_time (inclusive) and end_time (exclusive), or for
67
67
  # a specific run_time.
68
- rpc :StartManualTransferRuns, Google::Cloud::Bigquery::DataTransfer::V1::StartManualTransferRunsRequest, Google::Cloud::Bigquery::DataTransfer::V1::StartManualTransferRunsResponse
68
+ rpc :StartManualTransferRuns, ::Google::Cloud::Bigquery::DataTransfer::V1::StartManualTransferRunsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::StartManualTransferRunsResponse
69
69
  # Returns information about the particular transfer run.
70
- rpc :GetTransferRun, Google::Cloud::Bigquery::DataTransfer::V1::GetTransferRunRequest, Google::Cloud::Bigquery::DataTransfer::V1::TransferRun
70
+ rpc :GetTransferRun, ::Google::Cloud::Bigquery::DataTransfer::V1::GetTransferRunRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::TransferRun
71
71
  # Deletes the specified transfer run.
72
- rpc :DeleteTransferRun, Google::Cloud::Bigquery::DataTransfer::V1::DeleteTransferRunRequest, Google::Protobuf::Empty
72
+ rpc :DeleteTransferRun, ::Google::Cloud::Bigquery::DataTransfer::V1::DeleteTransferRunRequest, ::Google::Protobuf::Empty
73
73
  # Returns information about running and completed jobs.
74
- rpc :ListTransferRuns, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferRunsRequest, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferRunsResponse
74
+ rpc :ListTransferRuns, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferRunsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferRunsResponse
75
75
  # Returns user facing log messages for the data transfer run.
76
- rpc :ListTransferLogs, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferLogsRequest, Google::Cloud::Bigquery::DataTransfer::V1::ListTransferLogsResponse
76
+ rpc :ListTransferLogs, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferLogsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferLogsResponse
77
77
  # Returns true if valid credentials exist for the given data source and
78
78
  # requesting user.
79
79
  # Some data sources doesn't support service account, so we need to talk to
80
80
  # them on behalf of the end user. This API just checks whether we have OAuth
81
81
  # token for the particular user, which is a pre-requisite before user can
82
82
  # create a transfer config.
83
- rpc :CheckValidCreds, Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsRequest, Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsResponse
83
+ rpc :CheckValidCreds, ::Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsResponse
84
84
  end
85
85
 
86
86
  Stub = Service.rpc_stub_class
@@ -43,12 +43,12 @@ module Google
43
43
  #
44
44
  # The ResourceDescriptor Yaml config will look like:
45
45
  #
46
- # resources:
47
- # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/\\{project}/topics/\\{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/\\{project}"
46
+ # resources:
47
+ # - type: "pubsub.googleapis.com/Topic"
48
+ # name_descriptor:
49
+ # - pattern: "projects/{project}/topics/{topic}"
50
+ # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
+ # parent_name_extractor: "projects/{project}"
52
52
  #
53
53
  # Sometimes, resources have multiple patterns, typically because they can
54
54
  # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
183
183
  # }
184
184
  # @!attribute [rw] plural
185
185
  # @return [::String]
186
- # The plural name used in the resource name, such as 'projects' for
187
- # the name of 'projects/\\{project}'. It is the same concept of the `plural`
188
- # field in k8s CRD spec
186
+ # The plural name used in the resource name and permission names, such as
187
+ # 'projects' for the resource name of 'projects/\\{project}' and the permission
188
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
189
+ # concept of the `plural` field in k8s CRD spec
189
190
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
191
+ #
192
+ # Note: The plural form is required even for singleton resources. See
193
+ # https://aip.dev/156
190
194
  # @!attribute [rw] singular
191
195
  # @return [::String]
192
196
  # The same concept of the `singular` field in k8s CRD spec
193
197
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
194
198
  # Such as "project" for the `resourcemanager.googleapis.com/Project` type.
199
+ # @!attribute [rw] style
200
+ # @return [::Array<::Google::Api::ResourceDescriptor::Style>]
201
+ # Style flag(s) for this resource.
202
+ # These indicate that a resource is expected to conform to a given
203
+ # style. See the specific style flags for additional information.
195
204
  class ResourceDescriptor
196
205
  include ::Google::Protobuf::MessageExts
197
206
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
211
220
  # that from being necessary once there are multiple patterns.)
212
221
  FUTURE_MULTI_PATTERN = 2
213
222
  end
223
+
224
+ # A flag representing a specific style that a resource claims to conform to.
225
+ module Style
226
+ # The unspecified value. Do not use.
227
+ STYLE_UNSPECIFIED = 0
228
+
229
+ # This resource is intended to be "declarative-friendly".
230
+ #
231
+ # Declarative-friendly resources must be more strictly consistent, and
232
+ # setting this to true communicates to tools that this resource should
233
+ # adhere to declarative-friendly expectations.
234
+ #
235
+ # Note: This is used by the API linter (linter.aip.dev) to enable
236
+ # additional checks.
237
+ DECLARATIVE_FRIENDLY = 1
238
+ end
214
239
  end
215
240
 
216
241
  # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
226
251
  # type: "pubsub.googleapis.com/Topic"
227
252
  # }];
228
253
  # }
254
+ #
255
+ # Occasionally, a field may reference an arbitrary resource. In this case,
256
+ # APIs use the special value * in their resource reference.
257
+ #
258
+ # Example:
259
+ #
260
+ # message GetIamPolicyRequest {
261
+ # string resource = 2 [(google.api.resource_reference) = {
262
+ # type: "*"
263
+ # }];
264
+ # }
229
265
  # @!attribute [rw] child_type
230
266
  # @return [::String]
231
267
  # The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
234
270
  #
235
271
  # Example:
236
272
  #
237
- # message ListLogEntriesRequest {
238
- # string parent = 1 [(google.api.resource_reference) = {
239
- # child_type: "logging.googleapis.com/LogEntry"
240
- # };
241
- # }
273
+ # message ListLogEntriesRequest {
274
+ # string parent = 1 [(google.api.resource_reference) = {
275
+ # child_type: "logging.googleapis.com/LogEntry"
276
+ # };
277
+ # }
242
278
  class ResourceReference
243
279
  include ::Google::Protobuf::MessageExts
244
280
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-data_transfer-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.1
4
+ version: 0.2.6
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-05-26 00:00:00.000000000 Z
11
+ date: 2021-01-20 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '0.2'
19
+ version: '0.3'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '0.2'
26
+ version: '0.3'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: google-cloud-errors
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -203,7 +203,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
203
203
  - !ruby/object:Gem::Version
204
204
  version: '0'
205
205
  requirements: []
206
- rubygems_version: 3.0.6
206
+ rubygems_version: 3.2.6
207
207
  signing_key:
208
208
  specification_version: 4
209
209
  summary: API Client library for the BigQuery Data Transfer Service V1 API