google-cloud-bigquery-data_transfer 0.7.0 → 1.1.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 (36) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +3 -2
  3. data/AUTHENTICATION.md +51 -59
  4. data/LICENSE.md +203 -0
  5. data/MIGRATING.md +301 -0
  6. data/README.md +33 -45
  7. data/lib/{google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/datasource.rb → google-cloud-bigquery-data_transfer.rb} +5 -11
  8. data/lib/google/cloud/bigquery/data_transfer.rb +88 -140
  9. data/lib/google/cloud/bigquery/data_transfer/version.rb +6 -2
  10. metadata +60 -68
  11. data/LICENSE +0 -201
  12. data/lib/google/cloud/bigquery/data_transfer/credentials.rb +0 -33
  13. data/lib/google/cloud/bigquery/data_transfer/v1.rb +0 -173
  14. data/lib/google/cloud/bigquery/data_transfer/v1/credentials.rb +0 -43
  15. data/lib/google/cloud/bigquery/data_transfer/v1/data_transfer_pb.rb +0 -190
  16. data/lib/google/cloud/bigquery/data_transfer/v1/data_transfer_service_client.rb +0 -1177
  17. data/lib/google/cloud/bigquery/data_transfer/v1/data_transfer_service_client_config.json +0 -96
  18. data/lib/google/cloud/bigquery/data_transfer/v1/data_transfer_services_pb.rb +0 -87
  19. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/data_transfer/v1/data_transfer.rb +0 -500
  20. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/data_transfer/v1/transfer.rb +0 -217
  21. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/datatransfer.rb +0 -565
  22. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/transfer.rb +0 -257
  23. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/any.rb +0 -131
  24. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/duration.rb +0 -91
  25. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/empty.rb +0 -29
  26. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/field_mask.rb +0 -222
  27. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/struct.rb +0 -74
  28. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/timestamp.rb +0 -113
  29. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/wrappers.rb +0 -26
  30. data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/rpc/status.rb +0 -39
  31. data/lib/google/cloud/bigquery/data_transfer/v1/transfer_pb.rb +0 -83
  32. data/lib/google/cloud/bigquery/datatransfer/v1/datasource_pb.rb +0 -170
  33. data/lib/google/cloud/bigquery/datatransfer/v1/datasource_services_pb.rb +0 -103
  34. data/lib/google/cloud/bigquery/datatransfer/v1/datatransfer_pb.rb +0 -215
  35. data/lib/google/cloud/bigquery/datatransfer/v1/datatransfer_services_pb.rb +0 -94
  36. data/lib/google/cloud/bigquery/datatransfer/v1/transfer_pb.rb +0 -103
@@ -1,217 +0,0 @@
1
- # Copyright 2018 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Cloud
18
- module Bigquery
19
- module DataTransfer
20
- module V1
21
- # Represents a data transfer configuration. A transfer configuration
22
- # contains all metadata needed to perform a data transfer. For example,
23
- # +destination_dataset_id+ specifies where data should be stored.
24
- # When a new transfer configuration is created, the specified
25
- # +destination_dataset_id+ is created when needed and shared with the
26
- # appropriate data source service account.
27
- # Next id: 20
28
- # @!attribute [rw] name
29
- # @return [String]
30
- # The resource name of the transfer config.
31
- # Transfer config names have the form
32
- # +projects/\\{project_id}/transferConfigs/\\{config_id}+.
33
- # Where +config_id+ is usually a uuid, even though it is not
34
- # guaranteed or required. The name is ignored when creating a transfer
35
- # config.
36
- # @!attribute [rw] destination_dataset_id
37
- # @return [String]
38
- # The BigQuery target dataset id.
39
- # @!attribute [rw] display_name
40
- # @return [String]
41
- # User specified display name for the data transfer.
42
- # @!attribute [rw] data_source_id
43
- # @return [String]
44
- # Data source id. Cannot be changed once data transfer is created.
45
- # @!attribute [rw] params
46
- # @return [Google::Protobuf::Struct]
47
- # Data transfer specific parameters.
48
- # @!attribute [rw] schedule
49
- # @return [String]
50
- # Data transfer schedule.
51
- # If the data source does not support a custom schedule, this should be
52
- # empty. If it is empty, the default value for the data source will be
53
- # used.
54
- # The specified times are in UTC.
55
- # Examples of valid format:
56
- # +1st,3rd monday of month 15:30+,
57
- # +every wed,fri of jan,jun 13:15+, and
58
- # +first sunday of quarter 00:00+.
59
- # See more explanation about the format here:
60
- # https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
61
- # NOTE: the granularity should be at least 8 hours, or less frequent.
62
- # @!attribute [rw] data_refresh_window_days
63
- # @return [Integer]
64
- # The number of days to look back to automatically refresh the data.
65
- # For example, if +data_refresh_window_days = 10+, then every day
66
- # BigQuery reingests data for [today-10, today-1], rather than ingesting data
67
- # for just [today-1].
68
- # Only valid if the data source supports the feature. Set the value to 0
69
- # to use the default value.
70
- # @!attribute [rw] disabled
71
- # @return [true, false]
72
- # Is this config disabled. When set to true, no runs are scheduled
73
- # for a given transfer.
74
- # @!attribute [rw] update_time
75
- # @return [Google::Protobuf::Timestamp]
76
- # Output only. Data transfer modification time. Ignored by server on input.
77
- # @!attribute [rw] next_run_time
78
- # @return [Google::Protobuf::Timestamp]
79
- # Output only. Next time when data transfer will run.
80
- # @!attribute [rw] state
81
- # @return [Google::Cloud::Bigquery::DataTransfer::V1::TransferState]
82
- # Output only. State of the most recently updated transfer run.
83
- # @!attribute [rw] user_id
84
- # @return [Integer]
85
- # Output only. Unique ID of the user on whose behalf transfer is done.
86
- # Applicable only to data sources that do not support service accounts.
87
- # When set to 0, the data source service account credentials are used.
88
- # May be negative. Note, that this identifier is not stable.
89
- # It may change over time even for the same user.
90
- # @!attribute [rw] dataset_region
91
- # @return [String]
92
- # Output only. Region in which BigQuery dataset is located.
93
- class TransferConfig; end
94
-
95
- # Represents a data transfer run.
96
- # Next id: 27
97
- # @!attribute [rw] name
98
- # @return [String]
99
- # The resource name of the transfer run.
100
- # Transfer run names have the form
101
- # +projects/\\{project_id}/locations/\\{location}/transferConfigs/\\{config_id}/runs/\\{run_id}+.
102
- # The name is ignored when creating a transfer run.
103
- # @!attribute [rw] schedule_time
104
- # @return [Google::Protobuf::Timestamp]
105
- # Minimum time after which a transfer run can be started.
106
- # @!attribute [rw] run_time
107
- # @return [Google::Protobuf::Timestamp]
108
- # For batch transfer runs, specifies the date and time that
109
- # data should be ingested.
110
- # @!attribute [rw] error_status
111
- # @return [Google::Rpc::Status]
112
- # Status of the transfer run.
113
- # @!attribute [rw] start_time
114
- # @return [Google::Protobuf::Timestamp]
115
- # Output only. Time when transfer run was started.
116
- # Parameter ignored by server for input requests.
117
- # @!attribute [rw] end_time
118
- # @return [Google::Protobuf::Timestamp]
119
- # Output only. Time when transfer run ended.
120
- # Parameter ignored by server for input requests.
121
- # @!attribute [rw] update_time
122
- # @return [Google::Protobuf::Timestamp]
123
- # Output only. Last time the data transfer run state was updated.
124
- # @!attribute [rw] params
125
- # @return [Google::Protobuf::Struct]
126
- # Output only. Data transfer specific parameters.
127
- # @!attribute [rw] destination_dataset_id
128
- # @return [String]
129
- # Output only. The BigQuery target dataset id.
130
- # @!attribute [rw] data_source_id
131
- # @return [String]
132
- # Output only. Data source id.
133
- # @!attribute [rw] state
134
- # @return [Google::Cloud::Bigquery::DataTransfer::V1::TransferState]
135
- # Data transfer run state. Ignored for input requests.
136
- # @!attribute [rw] user_id
137
- # @return [Integer]
138
- # Output only. Unique ID of the user on whose behalf transfer is done.
139
- # Applicable only to data sources that do not support service accounts.
140
- # When set to 0, the data source service account credentials are used.
141
- # May be negative. Note, that this identifier is not stable.
142
- # It may change over time even for the same user.
143
- # @!attribute [rw] schedule
144
- # @return [String]
145
- # Output only. Describes the schedule of this transfer run if it was
146
- # created as part of a regular schedule. For batch transfer runs that are
147
- # scheduled manually, this is empty.
148
- # NOTE: the system might choose to delay the schedule depending on the
149
- # current load, so +schedule_time+ doesn't always matches this.
150
- class TransferRun; end
151
-
152
- # Represents a user facing message for a particular data transfer run.
153
- # @!attribute [rw] message_time
154
- # @return [Google::Protobuf::Timestamp]
155
- # Time when message was logged.
156
- # @!attribute [rw] severity
157
- # @return [Google::Cloud::Bigquery::DataTransfer::V1::TransferMessage::MessageSeverity]
158
- # Message severity.
159
- # @!attribute [rw] message_text
160
- # @return [String]
161
- # Message text.
162
- class TransferMessage
163
- # Represents data transfer user facing message severity.
164
- module MessageSeverity
165
- # No severity specified.
166
- MESSAGE_SEVERITY_UNSPECIFIED = 0
167
-
168
- # Informational message.
169
- INFO = 1
170
-
171
- # Warning message.
172
- WARNING = 2
173
-
174
- # Error message.
175
- ERROR = 3
176
- end
177
- end
178
-
179
- # Represents data transfer type.
180
- module TransferType
181
- # Invalid or Unknown transfer type placeholder.
182
- TRANSFER_TYPE_UNSPECIFIED = 0
183
-
184
- # Batch data transfer.
185
- BATCH = 1
186
-
187
- # Streaming data transfer. Streaming data source currently doesn't
188
- # support multiple transfer configs per project.
189
- STREAMING = 2
190
- end
191
-
192
- # Represents data transfer run state.
193
- module TransferState
194
- # State placeholder.
195
- TRANSFER_STATE_UNSPECIFIED = 0
196
-
197
- # Data transfer is scheduled and is waiting to be picked up by
198
- # data transfer backend.
199
- PENDING = 2
200
-
201
- # Data transfer is in progress.
202
- RUNNING = 3
203
-
204
- # Data transfer completed successsfully.
205
- SUCCEEDED = 4
206
-
207
- # Data transfer failed.
208
- FAILED = 5
209
-
210
- # Data transfer is cancelled.
211
- CANCELLED = 6
212
- end
213
- end
214
- end
215
- end
216
- end
217
- end
@@ -1,565 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Cloud
18
- module Bigquery
19
- module Datatransfer
20
- module V1
21
- # Represents a data source parameter with validation rules, so that
22
- # parameters can be rendered in the UI. These parameters are given to us by
23
- # supported data sources, and include all needed information for rendering
24
- # and validation.
25
- # Thus, whoever uses this api can decide to generate either generic ui,
26
- # or custom data source specific forms.
27
- # @!attribute [rw] param_id
28
- # @return [String]
29
- # Parameter identifier.
30
- # @!attribute [rw] display_name
31
- # @return [String]
32
- # Parameter display name in the user interface.
33
- # @!attribute [rw] description
34
- # @return [String]
35
- # Parameter description.
36
- # @!attribute [rw] type
37
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::DataSourceParameter::Type]
38
- # Parameter type.
39
- # @!attribute [rw] required
40
- # @return [true, false]
41
- # Is parameter required.
42
- # @!attribute [rw] repeated
43
- # @return [true, false]
44
- # Deprecated. This field has no effect.
45
- # @!attribute [rw] validation_regex
46
- # @return [String]
47
- # Regular expression which can be used for parameter validation.
48
- # @!attribute [rw] allowed_values
49
- # @return [Array<String>]
50
- # All possible values for the parameter.
51
- # @!attribute [rw] min_value
52
- # @return [Google::Protobuf::DoubleValue]
53
- # For integer and double values specifies minimum allowed value.
54
- # @!attribute [rw] max_value
55
- # @return [Google::Protobuf::DoubleValue]
56
- # For integer and double values specifies maxminum allowed value.
57
- # @!attribute [rw] fields
58
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::DataSourceParameter>]
59
- # Deprecated. This field has no effect.
60
- # @!attribute [rw] validation_description
61
- # @return [String]
62
- # Description of the requirements for this field, in case the user input does
63
- # not fulfill the regex pattern or min/max values.
64
- # @!attribute [rw] validation_help_url
65
- # @return [String]
66
- # URL to a help document to further explain the naming requirements.
67
- # @!attribute [rw] immutable
68
- # @return [true, false]
69
- # Cannot be changed after initial creation.
70
- # @!attribute [rw] recurse
71
- # @return [true, false]
72
- # Deprecated. This field has no effect.
73
- # @!attribute [rw] deprecated
74
- # @return [true, false]
75
- # If true, it should not be used in new transfers, and it should not be
76
- # visible to users.
77
- class DataSourceParameter
78
- # Parameter type.
79
- module Type
80
- # Type unspecified.
81
- TYPE_UNSPECIFIED = 0
82
-
83
- # String parameter.
84
- STRING = 1
85
-
86
- # Integer parameter (64-bits).
87
- # Will be serialized to json as string.
88
- INTEGER = 2
89
-
90
- # Double precision floating point parameter.
91
- DOUBLE = 3
92
-
93
- # Boolean parameter.
94
- BOOLEAN = 4
95
-
96
- # Deprecated. This field has no effect.
97
- RECORD = 5
98
-
99
- # Page ID for a Google+ Page.
100
- PLUS_PAGE = 6
101
- end
102
- end
103
-
104
- # Represents data source metadata. Metadata is sufficient to
105
- # render UI and request proper OAuth tokens.
106
- # @!attribute [rw] name
107
- # @return [String]
108
- # Output only. Data source resource name.
109
- # @!attribute [rw] data_source_id
110
- # @return [String]
111
- # Data source id.
112
- # @!attribute [rw] display_name
113
- # @return [String]
114
- # User friendly data source name.
115
- # @!attribute [rw] description
116
- # @return [String]
117
- # User friendly data source description string.
118
- # @!attribute [rw] client_id
119
- # @return [String]
120
- # Data source client id which should be used to receive refresh token.
121
- # @!attribute [rw] scopes
122
- # @return [Array<String>]
123
- # Api auth scopes for which refresh token needs to be obtained. These are
124
- # scopes needed by a data source to prepare data and ingest them into
125
- # BigQuery, e.g., https://www.googleapis.com/auth/bigquery
126
- # @!attribute [rw] transfer_type
127
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::TransferType]
128
- # Deprecated. This field has no effect.
129
- # @!attribute [rw] supports_multiple_transfers
130
- # @return [true, false]
131
- # Deprecated. This field has no effect.
132
- # @!attribute [rw] update_deadline_seconds
133
- # @return [Integer]
134
- # The number of seconds to wait for an update from the data source
135
- # before the Data Transfer Service marks the transfer as FAILED.
136
- # @!attribute [rw] default_schedule
137
- # @return [String]
138
- # Default data transfer schedule.
139
- # Examples of valid schedules include:
140
- # `1st,3rd monday of month 15:30`,
141
- # `every wed,fri of jan,jun 13:15`, and
142
- # `first sunday of quarter 00:00`.
143
- # @!attribute [rw] supports_custom_schedule
144
- # @return [true, false]
145
- # Specifies whether the data source supports a user defined schedule, or
146
- # operates on the default schedule.
147
- # When set to `true`, user can override default schedule.
148
- # @!attribute [rw] parameters
149
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::DataSourceParameter>]
150
- # Data source parameters.
151
- # @!attribute [rw] help_url
152
- # @return [String]
153
- # Url for the help document for this data source.
154
- # @!attribute [rw] authorization_type
155
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::DataSource::AuthorizationType]
156
- # Indicates the type of authorization.
157
- # @!attribute [rw] data_refresh_type
158
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::DataSource::DataRefreshType]
159
- # Specifies whether the data source supports automatic data refresh for the
160
- # past few days, and how it's supported.
161
- # For some data sources, data might not be complete until a few days later,
162
- # so it's useful to refresh data automatically.
163
- # @!attribute [rw] default_data_refresh_window_days
164
- # @return [Integer]
165
- # Default data refresh window on days.
166
- # Only meaningful when `data_refresh_type` = `SLIDING_WINDOW`.
167
- # @!attribute [rw] manual_runs_disabled
168
- # @return [true, false]
169
- # Disables backfilling and manual run scheduling
170
- # for the data source.
171
- # @!attribute [rw] minimum_schedule_interval
172
- # @return [Google::Protobuf::Duration]
173
- # The minimum interval for scheduler to schedule runs.
174
- class DataSource
175
- # The type of authorization needed for this data source.
176
- module AuthorizationType
177
- # Type unspecified.
178
- AUTHORIZATION_TYPE_UNSPECIFIED = 0
179
-
180
- # Use OAuth 2 authorization codes that can be exchanged
181
- # for a refresh token on the backend.
182
- AUTHORIZATION_CODE = 1
183
-
184
- # Return an authorization code for a given Google+ page that can then be
185
- # exchanged for a refresh token on the backend.
186
- GOOGLE_PLUS_AUTHORIZATION_CODE = 2
187
- end
188
-
189
- # Represents how the data source supports data auto refresh.
190
- module DataRefreshType
191
- # The data source won't support data auto refresh, which is default value.
192
- DATA_REFRESH_TYPE_UNSPECIFIED = 0
193
-
194
- # The data source supports data auto refresh, and runs will be scheduled
195
- # for the past few days. Does not allow custom values to be set for each
196
- # transfer config.
197
- SLIDING_WINDOW = 1
198
-
199
- # The data source supports data auto refresh, and runs will be scheduled
200
- # for the past few days. Allows custom values to be set for each transfer
201
- # config.
202
- CUSTOM_SLIDING_WINDOW = 2
203
- end
204
- end
205
-
206
- # A request to get data source info.
207
- # @!attribute [rw] name
208
- # @return [String]
209
- # Required. The field will contain name of the resource requested, for example:
210
- # `projects/{project_id}/dataSources/{data_source_id}` or
211
- # `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`
212
- class GetDataSourceRequest; end
213
-
214
- # Request to list supported data sources and their data transfer settings.
215
- # @!attribute [rw] parent
216
- # @return [String]
217
- # Required. The BigQuery project id for which data sources should be returned.
218
- # Must be in the form: `projects/{project_id}` or
219
- # `projects/{project_id}/locations/{location_id}
220
- # @!attribute [rw] page_token
221
- # @return [String]
222
- # Pagination token, which can be used to request a specific page
223
- # of `ListDataSourcesRequest` list results. For multiple-page
224
- # results, `ListDataSourcesResponse` outputs
225
- # a `next_page` token, which can be used as the
226
- # `page_token` value to request the next page of list results.
227
- # @!attribute [rw] page_size
228
- # @return [Integer]
229
- # Page size. The default page size is the maximum value of 1000 results.
230
- class ListDataSourcesRequest; end
231
-
232
- # Returns list of supported data sources and their metadata.
233
- # @!attribute [rw] data_sources
234
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::DataSource>]
235
- # List of supported data sources and their transfer settings.
236
- # @!attribute [rw] next_page_token
237
- # @return [String]
238
- # Output only. The next-pagination token. For multiple-page list results,
239
- # this token can be used as the
240
- # `ListDataSourcesRequest.page_token`
241
- # to request the next page of list results.
242
- class ListDataSourcesResponse; end
243
-
244
- # A request to create a data transfer configuration. If new credentials are
245
- # needed for this transfer configuration, an authorization code must be
246
- # provided. If an authorization code is provided, the transfer configuration
247
- # will be associated with the user id corresponding to the
248
- # authorization code. Otherwise, the transfer configuration will be associated
249
- # with the calling user.
250
- # @!attribute [rw] parent
251
- # @return [String]
252
- # Required. The BigQuery project id where the transfer configuration should be created.
253
- # Must be in the format projects/\\{project_id}/locations/\\{location_id} or
254
- # projects/\\{project_id}. If specified location and location of the
255
- # destination bigquery dataset do not match - the request will fail.
256
- # @!attribute [rw] transfer_config
257
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig]
258
- # Required. Data transfer configuration to create.
259
- # @!attribute [rw] authorization_code
260
- # @return [String]
261
- # Optional OAuth2 authorization code to use with this transfer configuration.
262
- # This is required if new credentials are needed, as indicated by
263
- # `CheckValidCreds`.
264
- # In order to obtain authorization_code, please make a
265
- # request to
266
- # https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
267
- #
268
- # * client_id should be OAuth client_id of BigQuery DTS API for the given
269
- # data source returned by ListDataSources method.
270
- # * data_source_scopes are the scopes returned by ListDataSources method.
271
- # * redirect_uri is an optional parameter. If not specified, then
272
- # authorization code is posted to the opener of authorization flow window.
273
- # Otherwise it will be sent to the redirect uri. A special value of
274
- # urn:ietf:wg:oauth:2.0:oob means that authorization code should be
275
- # returned in the title bar of the browser, with the page text prompting
276
- # the user to copy the code and paste it in the application.
277
- # @!attribute [rw] version_info
278
- # @return [String]
279
- # Optional version info. If users want to find a very recent access token,
280
- # that is, immediately after approving access, users have to set the
281
- # version_info claim in the token request. To obtain the version_info, users
282
- # must use the "none+gsession" response type. which be return a
283
- # version_info back in the authorization response which be be put in a JWT
284
- # claim in the token request.
285
- # @!attribute [rw] service_account_name
286
- # @return [String]
287
- # Optional service account name. If this field is set, transfer config will
288
- # be created with this service account credentials. It requires that
289
- # requesting user calling this API has permissions to act as this service
290
- # account.
291
- class CreateTransferConfigRequest; end
292
-
293
- # A request to update a transfer configuration. To update the user id of the
294
- # transfer configuration, an authorization code needs to be provided.
295
- # @!attribute [rw] transfer_config
296
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig]
297
- # Required. Data transfer configuration to create.
298
- # @!attribute [rw] authorization_code
299
- # @return [String]
300
- # Optional OAuth2 authorization code to use with this transfer configuration.
301
- # If it is provided, the transfer configuration will be associated with the
302
- # authorizing user.
303
- # In order to obtain authorization_code, please make a
304
- # request to
305
- # https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
306
- #
307
- # * client_id should be OAuth client_id of BigQuery DTS API for the given
308
- # data source returned by ListDataSources method.
309
- # * data_source_scopes are the scopes returned by ListDataSources method.
310
- # * redirect_uri is an optional parameter. If not specified, then
311
- # authorization code is posted to the opener of authorization flow window.
312
- # Otherwise it will be sent to the redirect uri. A special value of
313
- # urn:ietf:wg:oauth:2.0:oob means that authorization code should be
314
- # returned in the title bar of the browser, with the page text prompting
315
- # the user to copy the code and paste it in the application.
316
- # @!attribute [rw] update_mask
317
- # @return [Google::Protobuf::FieldMask]
318
- # Required. Required list of fields to be updated in this request.
319
- # @!attribute [rw] version_info
320
- # @return [String]
321
- # Optional version info. If users want to find a very recent access token,
322
- # that is, immediately after approving access, users have to set the
323
- # version_info claim in the token request. To obtain the version_info, users
324
- # must use the "none+gsession" response type. which be return a
325
- # version_info back in the authorization response which be be put in a JWT
326
- # claim in the token request.
327
- # @!attribute [rw] service_account_name
328
- # @return [String]
329
- # Optional service account name. If this field is set and
330
- # "service_account_name" is set in update_mask, transfer config will be
331
- # updated to use this service account credentials. It requires that
332
- # requesting user calling this API has permissions to act as this service
333
- # account.
334
- class UpdateTransferConfigRequest; end
335
-
336
- # A request to get data transfer information.
337
- # @!attribute [rw] name
338
- # @return [String]
339
- # Required. The field will contain name of the resource requested, for example:
340
- # `projects/{project_id}/transferConfigs/{config_id}` or
341
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
342
- class GetTransferConfigRequest; end
343
-
344
- # A request to delete data transfer information. All associated transfer runs
345
- # and log messages will be deleted as well.
346
- # @!attribute [rw] name
347
- # @return [String]
348
- # Required. The field will contain name of the resource requested, for example:
349
- # `projects/{project_id}/transferConfigs/{config_id}` or
350
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`
351
- class DeleteTransferConfigRequest; end
352
-
353
- # A request to get data transfer run information.
354
- # @!attribute [rw] name
355
- # @return [String]
356
- # Required. The field will contain name of the resource requested, for example:
357
- # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or
358
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}`
359
- class GetTransferRunRequest; end
360
-
361
- # A request to delete data transfer run information.
362
- # @!attribute [rw] name
363
- # @return [String]
364
- # Required. The field will contain name of the resource requested, for example:
365
- # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or
366
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}`
367
- class DeleteTransferRunRequest; end
368
-
369
- # A request to list data transfers configured for a BigQuery project.
370
- # @!attribute [rw] parent
371
- # @return [String]
372
- # Required. The BigQuery project id for which data sources
373
- # should be returned: `projects/{project_id}` or
374
- # `projects/{project_id}/locations/{location_id}`
375
- # @!attribute [rw] data_source_ids
376
- # @return [Array<String>]
377
- # When specified, only configurations of requested data sources are returned.
378
- # @!attribute [rw] page_token
379
- # @return [String]
380
- # Pagination token, which can be used to request a specific page
381
- # of `ListTransfersRequest` list results. For multiple-page
382
- # results, `ListTransfersResponse` outputs
383
- # a `next_page` token, which can be used as the
384
- # `page_token` value to request the next page of list results.
385
- # @!attribute [rw] page_size
386
- # @return [Integer]
387
- # Page size. The default page size is the maximum value of 1000 results.
388
- class ListTransferConfigsRequest; end
389
-
390
- # The returned list of pipelines in the project.
391
- # @!attribute [rw] transfer_configs
392
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig>]
393
- # Output only. The stored pipeline transfer configurations.
394
- # @!attribute [rw] next_page_token
395
- # @return [String]
396
- # Output only. The next-pagination token. For multiple-page list results,
397
- # this token can be used as the
398
- # `ListTransferConfigsRequest.page_token`
399
- # to request the next page of list results.
400
- class ListTransferConfigsResponse; end
401
-
402
- # A request to list data transfer runs. UI can use this method to show/filter
403
- # specific data transfer runs. The data source can use this method to request
404
- # all scheduled transfer runs.
405
- # @!attribute [rw] parent
406
- # @return [String]
407
- # Required. Name of transfer configuration for which transfer runs should be retrieved.
408
- # Format of transfer configuration resource name is:
409
- # `projects/{project_id}/transferConfigs/{config_id}` or
410
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
411
- # @!attribute [rw] states
412
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferState>]
413
- # When specified, only transfer runs with requested states are returned.
414
- # @!attribute [rw] page_token
415
- # @return [String]
416
- # Pagination token, which can be used to request a specific page
417
- # of `ListTransferRunsRequest` list results. For multiple-page
418
- # results, `ListTransferRunsResponse` outputs
419
- # a `next_page` token, which can be used as the
420
- # `page_token` value to request the next page of list results.
421
- # @!attribute [rw] page_size
422
- # @return [Integer]
423
- # Page size. The default page size is the maximum value of 1000 results.
424
- # @!attribute [rw] run_attempt
425
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::ListTransferRunsRequest::RunAttempt]
426
- # Indicates how run attempts are to be pulled.
427
- class ListTransferRunsRequest
428
- # Represents which runs should be pulled.
429
- module RunAttempt
430
- # All runs should be returned.
431
- RUN_ATTEMPT_UNSPECIFIED = 0
432
-
433
- # Only latest run per day should be returned.
434
- LATEST = 1
435
- end
436
- end
437
-
438
- # The returned list of pipelines in the project.
439
- # @!attribute [rw] transfer_runs
440
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferRun>]
441
- # Output only. The stored pipeline transfer runs.
442
- # @!attribute [rw] next_page_token
443
- # @return [String]
444
- # Output only. The next-pagination token. For multiple-page list results,
445
- # this token can be used as the
446
- # `ListTransferRunsRequest.page_token`
447
- # to request the next page of list results.
448
- class ListTransferRunsResponse; end
449
-
450
- # A request to get user facing log messages associated with data transfer run.
451
- # @!attribute [rw] parent
452
- # @return [String]
453
- # Required. Transfer run name in the form:
454
- # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or
455
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}`
456
- # @!attribute [rw] page_token
457
- # @return [String]
458
- # Pagination token, which can be used to request a specific page
459
- # of `ListTransferLogsRequest` list results. For multiple-page
460
- # results, `ListTransferLogsResponse` outputs
461
- # a `next_page` token, which can be used as the
462
- # `page_token` value to request the next page of list results.
463
- # @!attribute [rw] page_size
464
- # @return [Integer]
465
- # Page size. The default page size is the maximum value of 1000 results.
466
- # @!attribute [rw] message_types
467
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferMessage::MessageSeverity>]
468
- # Message types to return. If not populated - INFO, WARNING and ERROR
469
- # messages are returned.
470
- class ListTransferLogsRequest; end
471
-
472
- # The returned list transfer run messages.
473
- # @!attribute [rw] transfer_messages
474
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferMessage>]
475
- # Output only. The stored pipeline transfer messages.
476
- # @!attribute [rw] next_page_token
477
- # @return [String]
478
- # Output only. The next-pagination token. For multiple-page list results,
479
- # this token can be used as the
480
- # `GetTransferRunLogRequest.page_token`
481
- # to request the next page of list results.
482
- class ListTransferLogsResponse; end
483
-
484
- # A request to determine whether the user has valid credentials. This method
485
- # is used to limit the number of OAuth popups in the user interface. The
486
- # user id is inferred from the API call context.
487
- # If the data source has the Google+ authorization type, this method
488
- # returns false, as it cannot be determined whether the credentials are
489
- # already valid merely based on the user id.
490
- # @!attribute [rw] name
491
- # @return [String]
492
- # Required. The data source in the form:
493
- # `projects/{project_id}/dataSources/{data_source_id}` or
494
- # `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`.
495
- class CheckValidCredsRequest; end
496
-
497
- # A response indicating whether the credentials exist and are valid.
498
- # @!attribute [rw] has_valid_creds
499
- # @return [true, false]
500
- # If set to `true`, the credentials exist and are valid.
501
- class CheckValidCredsResponse; end
502
-
503
- # A request to schedule transfer runs for a time range.
504
- # @!attribute [rw] parent
505
- # @return [String]
506
- # Required. Transfer configuration name in the form:
507
- # `projects/{project_id}/transferConfigs/{config_id}` or
508
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
509
- # @!attribute [rw] start_time
510
- # @return [Google::Protobuf::Timestamp]
511
- # Required. Start time of the range of transfer runs. For example,
512
- # `"2017-05-25T00:00:00+00:00"`.
513
- # @!attribute [rw] end_time
514
- # @return [Google::Protobuf::Timestamp]
515
- # Required. End time of the range of transfer runs. For example,
516
- # `"2017-05-30T00:00:00+00:00"`.
517
- class ScheduleTransferRunsRequest; end
518
-
519
- # A response to schedule transfer runs for a time range.
520
- # @!attribute [rw] runs
521
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferRun>]
522
- # The transfer runs that were scheduled.
523
- class ScheduleTransferRunsResponse; end
524
-
525
- # A request to start manual transfer runs.
526
- # @!attribute [rw] parent
527
- # @return [String]
528
- # Transfer configuration name in the form:
529
- # `projects/{project_id}/transferConfigs/{config_id}` or
530
- # `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`.
531
- # @!attribute [rw] requested_time_range
532
- # @return [Google::Cloud::Bigquery::Datatransfer::V1::StartManualTransferRunsRequest::TimeRange]
533
- # Time range for the transfer runs that should be started.
534
- # @!attribute [rw] requested_run_time
535
- # @return [Google::Protobuf::Timestamp]
536
- # Specific run_time for a transfer run to be started. The
537
- # requested_run_time must not be in the future.
538
- class StartManualTransferRunsRequest
539
- # A specification for a time range, this will request transfer runs with
540
- # run_time between start_time (inclusive) and end_time (exclusive).
541
- # @!attribute [rw] start_time
542
- # @return [Google::Protobuf::Timestamp]
543
- # Start time of the range of transfer runs. For example,
544
- # `"2017-05-25T00:00:00+00:00"`. The start_time must be strictly less than
545
- # the end_time. Creates transfer runs where run_time is in the range betwen
546
- # start_time (inclusive) and end_time (exlusive).
547
- # @!attribute [rw] end_time
548
- # @return [Google::Protobuf::Timestamp]
549
- # End time of the range of transfer runs. For example,
550
- # `"2017-05-30T00:00:00+00:00"`. The end_time must not be in the future.
551
- # Creates transfer runs where run_time is in the range betwen start_time
552
- # (inclusive) and end_time (exlusive).
553
- class TimeRange; end
554
- end
555
-
556
- # A response to start manual transfer runs.
557
- # @!attribute [rw] runs
558
- # @return [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferRun>]
559
- # The transfer runs that were created.
560
- class StartManualTransferRunsResponse; end
561
- end
562
- end
563
- end
564
- end
565
- end