google-cloud-automl 0.1.0
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 +7 -0
- data/.yardopts +11 -0
- data/AUTHENTICATION.md +199 -0
- data/LICENSE +201 -0
- data/README.md +69 -0
- data/lib/google/cloud/automl/v1beta1/annotation_payload_pb.rb +34 -0
- data/lib/google/cloud/automl/v1beta1/annotation_spec_pb.rb +18 -0
- data/lib/google/cloud/automl/v1beta1/automl_client.rb +1914 -0
- data/lib/google/cloud/automl/v1beta1/automl_client_config.json +146 -0
- data/lib/google/cloud/automl/v1beta1/classification_pb.rb +65 -0
- data/lib/google/cloud/automl/v1beta1/column_spec_pb.rb +28 -0
- data/lib/google/cloud/automl/v1beta1/credentials.rb +41 -0
- data/lib/google/cloud/automl/v1beta1/data_items_pb.rb +48 -0
- data/lib/google/cloud/automl/v1beta1/data_stats_pb.rb +77 -0
- data/lib/google/cloud/automl/v1beta1/data_types_pb.rb +36 -0
- data/lib/google/cloud/automl/v1beta1/dataset_pb.rb +38 -0
- data/lib/google/cloud/automl/v1beta1/detection_pb.rb +52 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/annotation_payload.rb +63 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/annotation_spec.rb +41 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/classification.rb +203 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/column_spec.rb +72 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/data_items.rb +94 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/data_stats.rb +160 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/data_types.rb +107 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/dataset.rb +77 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/detection.rb +134 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/geometry.rb +43 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/image.rb +141 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/io.rb +975 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/model.rb +92 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/model_evaluation.rb +100 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/prediction_service.rb +136 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/ranges.rb +31 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/regression.rb +41 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/service.rb +368 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/table_spec.rb +64 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/tables.rb +261 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/temporal.rb +33 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/text.rb +53 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/text_extraction.rb +60 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/text_segment.rb +37 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/text_sentiment.rb +76 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/translation.rb +63 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/cloud/automl/v1beta1/video.rb +35 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/longrunning/operations.rb +51 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/protobuf/any.rb +131 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/protobuf/duration.rb +91 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/protobuf/field_mask.rb +222 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/protobuf/struct.rb +74 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/protobuf/timestamp.rb +111 -0
- data/lib/google/cloud/automl/v1beta1/doc/google/rpc/status.rb +87 -0
- data/lib/google/cloud/automl/v1beta1/geometry_pb.rb +21 -0
- data/lib/google/cloud/automl/v1beta1/image_pb.rb +43 -0
- data/lib/google/cloud/automl/v1beta1/io_pb.rb +80 -0
- data/lib/google/cloud/automl/v1beta1/model_evaluation_pb.rb +37 -0
- data/lib/google/cloud/automl/v1beta1/model_pb.rb +44 -0
- data/lib/google/cloud/automl/v1beta1/operations_pb.rb +90 -0
- data/lib/google/cloud/automl/v1beta1/prediction_service_client.rb +442 -0
- data/lib/google/cloud/automl/v1beta1/prediction_service_client_config.json +36 -0
- data/lib/google/cloud/automl/v1beta1/prediction_service_pb.rb +39 -0
- data/lib/google/cloud/automl/v1beta1/prediction_service_services_pb.rb +72 -0
- data/lib/google/cloud/automl/v1beta1/ranges_pb.rb +17 -0
- data/lib/google/cloud/automl/v1beta1/regression_pb.rb +20 -0
- data/lib/google/cloud/automl/v1beta1/service_pb.rb +177 -0
- data/lib/google/cloud/automl/v1beta1/service_services_pb.rb +159 -0
- data/lib/google/cloud/automl/v1beta1/table_spec_pb.rb +22 -0
- data/lib/google/cloud/automl/v1beta1/tables_pb.rb +56 -0
- data/lib/google/cloud/automl/v1beta1/temporal_pb.rb +18 -0
- data/lib/google/cloud/automl/v1beta1/text_extraction_pb.rb +32 -0
- data/lib/google/cloud/automl/v1beta1/text_pb.rb +33 -0
- data/lib/google/cloud/automl/v1beta1/text_segment_pb.rb +18 -0
- data/lib/google/cloud/automl/v1beta1/text_sentiment_pb.rb +29 -0
- data/lib/google/cloud/automl/v1beta1/translation_pb.rb +33 -0
- data/lib/google/cloud/automl/v1beta1/video_pb.rb +25 -0
- data/lib/google/cloud/automl/v1beta1.rb +231 -0
- data/lib/google/cloud/automl/version.rb +22 -0
- data/lib/google/cloud/automl.rb +219 -0
- data/lib/google-cloud-automl.rb +15 -0
- metadata +203 -0
|
@@ -0,0 +1,1914 @@
|
|
|
1
|
+
# Copyright 2019 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
|
+
# EDITING INSTRUCTIONS
|
|
16
|
+
# This file was generated from the file
|
|
17
|
+
# https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1beta1/service.proto,
|
|
18
|
+
# and updates to that file get reflected here through a refresh process.
|
|
19
|
+
# For the short term, the refresh process will only be runnable by Google
|
|
20
|
+
# engineers.
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
require "json"
|
|
24
|
+
require "pathname"
|
|
25
|
+
|
|
26
|
+
require "google/gax"
|
|
27
|
+
require "google/gax/operation"
|
|
28
|
+
require "google/longrunning/operations_client"
|
|
29
|
+
|
|
30
|
+
require "google/cloud/automl/v1beta1/service_pb"
|
|
31
|
+
require "google/cloud/automl/v1beta1/credentials"
|
|
32
|
+
require "google/cloud/automl/version"
|
|
33
|
+
|
|
34
|
+
module Google
|
|
35
|
+
module Cloud
|
|
36
|
+
module AutoML
|
|
37
|
+
module V1beta1
|
|
38
|
+
# AutoML Server API.
|
|
39
|
+
#
|
|
40
|
+
# The resource names are assigned by the server.
|
|
41
|
+
# The server never reuses names that it has created after the resources with
|
|
42
|
+
# those names are deleted.
|
|
43
|
+
#
|
|
44
|
+
# An ID of a resource is the last element of the item's resource name. For
|
|
45
|
+
# `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`, then
|
|
46
|
+
# the id for the item is `{dataset_id}`.
|
|
47
|
+
#
|
|
48
|
+
# Currently the only supported `location_id` is "us-central1".
|
|
49
|
+
#
|
|
50
|
+
# On any input that is documented to expect a string parameter in
|
|
51
|
+
# snake_case or kebab-case, either of those cases is accepted.
|
|
52
|
+
#
|
|
53
|
+
# @!attribute [r] automl_stub
|
|
54
|
+
# @return [Google::Cloud::AutoML::V1beta1::AutoML::Stub]
|
|
55
|
+
class AutoMLClient
|
|
56
|
+
# @private
|
|
57
|
+
attr_reader :automl_stub
|
|
58
|
+
|
|
59
|
+
# The default address of the service.
|
|
60
|
+
SERVICE_ADDRESS = "automl.googleapis.com".freeze
|
|
61
|
+
|
|
62
|
+
# The default port of the service.
|
|
63
|
+
DEFAULT_SERVICE_PORT = 443
|
|
64
|
+
|
|
65
|
+
# The default set of gRPC interceptors.
|
|
66
|
+
GRPC_INTERCEPTORS = []
|
|
67
|
+
|
|
68
|
+
DEFAULT_TIMEOUT = 30
|
|
69
|
+
|
|
70
|
+
PAGE_DESCRIPTORS = {
|
|
71
|
+
"list_datasets" => Google::Gax::PageDescriptor.new(
|
|
72
|
+
"page_token",
|
|
73
|
+
"next_page_token",
|
|
74
|
+
"datasets"),
|
|
75
|
+
"list_models" => Google::Gax::PageDescriptor.new(
|
|
76
|
+
"page_token",
|
|
77
|
+
"next_page_token",
|
|
78
|
+
"model"),
|
|
79
|
+
"list_model_evaluations" => Google::Gax::PageDescriptor.new(
|
|
80
|
+
"page_token",
|
|
81
|
+
"next_page_token",
|
|
82
|
+
"model_evaluation"),
|
|
83
|
+
"list_table_specs" => Google::Gax::PageDescriptor.new(
|
|
84
|
+
"page_token",
|
|
85
|
+
"next_page_token",
|
|
86
|
+
"table_specs"),
|
|
87
|
+
"list_column_specs" => Google::Gax::PageDescriptor.new(
|
|
88
|
+
"page_token",
|
|
89
|
+
"next_page_token",
|
|
90
|
+
"column_specs")
|
|
91
|
+
}.freeze
|
|
92
|
+
|
|
93
|
+
private_constant :PAGE_DESCRIPTORS
|
|
94
|
+
|
|
95
|
+
# The scopes needed to make gRPC calls to all of the methods defined in
|
|
96
|
+
# this service.
|
|
97
|
+
ALL_SCOPES = [
|
|
98
|
+
"https://www.googleapis.com/auth/cloud-platform"
|
|
99
|
+
].freeze
|
|
100
|
+
|
|
101
|
+
class OperationsClient < Google::Longrunning::OperationsClient
|
|
102
|
+
self::SERVICE_ADDRESS = AutoMLClient::SERVICE_ADDRESS
|
|
103
|
+
self::GRPC_INTERCEPTORS = AutoMLClient::GRPC_INTERCEPTORS
|
|
104
|
+
end
|
|
105
|
+
|
|
106
|
+
ANNOTATION_SPEC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
107
|
+
"projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}"
|
|
108
|
+
)
|
|
109
|
+
|
|
110
|
+
private_constant :ANNOTATION_SPEC_PATH_TEMPLATE
|
|
111
|
+
|
|
112
|
+
COLUMN_SPEC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
113
|
+
"projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}/columnSpecs/{column_spec}"
|
|
114
|
+
)
|
|
115
|
+
|
|
116
|
+
private_constant :COLUMN_SPEC_PATH_TEMPLATE
|
|
117
|
+
|
|
118
|
+
DATASET_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
119
|
+
"projects/{project}/locations/{location}/datasets/{dataset}"
|
|
120
|
+
)
|
|
121
|
+
|
|
122
|
+
private_constant :DATASET_PATH_TEMPLATE
|
|
123
|
+
|
|
124
|
+
LOCATION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
125
|
+
"projects/{project}/locations/{location}"
|
|
126
|
+
)
|
|
127
|
+
|
|
128
|
+
private_constant :LOCATION_PATH_TEMPLATE
|
|
129
|
+
|
|
130
|
+
MODEL_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
131
|
+
"projects/{project}/locations/{location}/models/{model}"
|
|
132
|
+
)
|
|
133
|
+
|
|
134
|
+
private_constant :MODEL_PATH_TEMPLATE
|
|
135
|
+
|
|
136
|
+
MODEL_EVALUATION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
137
|
+
"projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation}"
|
|
138
|
+
)
|
|
139
|
+
|
|
140
|
+
private_constant :MODEL_EVALUATION_PATH_TEMPLATE
|
|
141
|
+
|
|
142
|
+
TABLE_SPEC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
|
|
143
|
+
"projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}"
|
|
144
|
+
)
|
|
145
|
+
|
|
146
|
+
private_constant :TABLE_SPEC_PATH_TEMPLATE
|
|
147
|
+
|
|
148
|
+
# Returns a fully-qualified annotation_spec resource name string.
|
|
149
|
+
# @param project [String]
|
|
150
|
+
# @param location [String]
|
|
151
|
+
# @param dataset [String]
|
|
152
|
+
# @param annotation_spec [String]
|
|
153
|
+
# @return [String]
|
|
154
|
+
def self.annotation_spec_path project, location, dataset, annotation_spec
|
|
155
|
+
ANNOTATION_SPEC_PATH_TEMPLATE.render(
|
|
156
|
+
:"project" => project,
|
|
157
|
+
:"location" => location,
|
|
158
|
+
:"dataset" => dataset,
|
|
159
|
+
:"annotation_spec" => annotation_spec
|
|
160
|
+
)
|
|
161
|
+
end
|
|
162
|
+
|
|
163
|
+
# Returns a fully-qualified column_spec resource name string.
|
|
164
|
+
# @param project [String]
|
|
165
|
+
# @param location [String]
|
|
166
|
+
# @param dataset [String]
|
|
167
|
+
# @param table_spec [String]
|
|
168
|
+
# @param column_spec [String]
|
|
169
|
+
# @return [String]
|
|
170
|
+
def self.column_spec_path project, location, dataset, table_spec, column_spec
|
|
171
|
+
COLUMN_SPEC_PATH_TEMPLATE.render(
|
|
172
|
+
:"project" => project,
|
|
173
|
+
:"location" => location,
|
|
174
|
+
:"dataset" => dataset,
|
|
175
|
+
:"table_spec" => table_spec,
|
|
176
|
+
:"column_spec" => column_spec
|
|
177
|
+
)
|
|
178
|
+
end
|
|
179
|
+
|
|
180
|
+
# Returns a fully-qualified dataset resource name string.
|
|
181
|
+
# @param project [String]
|
|
182
|
+
# @param location [String]
|
|
183
|
+
# @param dataset [String]
|
|
184
|
+
# @return [String]
|
|
185
|
+
def self.dataset_path project, location, dataset
|
|
186
|
+
DATASET_PATH_TEMPLATE.render(
|
|
187
|
+
:"project" => project,
|
|
188
|
+
:"location" => location,
|
|
189
|
+
:"dataset" => dataset
|
|
190
|
+
)
|
|
191
|
+
end
|
|
192
|
+
|
|
193
|
+
# Returns a fully-qualified location resource name string.
|
|
194
|
+
# @param project [String]
|
|
195
|
+
# @param location [String]
|
|
196
|
+
# @return [String]
|
|
197
|
+
def self.location_path project, location
|
|
198
|
+
LOCATION_PATH_TEMPLATE.render(
|
|
199
|
+
:"project" => project,
|
|
200
|
+
:"location" => location
|
|
201
|
+
)
|
|
202
|
+
end
|
|
203
|
+
|
|
204
|
+
# Returns a fully-qualified model resource name string.
|
|
205
|
+
# @param project [String]
|
|
206
|
+
# @param location [String]
|
|
207
|
+
# @param model [String]
|
|
208
|
+
# @return [String]
|
|
209
|
+
def self.model_path project, location, model
|
|
210
|
+
MODEL_PATH_TEMPLATE.render(
|
|
211
|
+
:"project" => project,
|
|
212
|
+
:"location" => location,
|
|
213
|
+
:"model" => model
|
|
214
|
+
)
|
|
215
|
+
end
|
|
216
|
+
|
|
217
|
+
# Returns a fully-qualified model_evaluation resource name string.
|
|
218
|
+
# @param project [String]
|
|
219
|
+
# @param location [String]
|
|
220
|
+
# @param model [String]
|
|
221
|
+
# @param model_evaluation [String]
|
|
222
|
+
# @return [String]
|
|
223
|
+
def self.model_evaluation_path project, location, model, model_evaluation
|
|
224
|
+
MODEL_EVALUATION_PATH_TEMPLATE.render(
|
|
225
|
+
:"project" => project,
|
|
226
|
+
:"location" => location,
|
|
227
|
+
:"model" => model,
|
|
228
|
+
:"model_evaluation" => model_evaluation
|
|
229
|
+
)
|
|
230
|
+
end
|
|
231
|
+
|
|
232
|
+
# Returns a fully-qualified table_spec resource name string.
|
|
233
|
+
# @param project [String]
|
|
234
|
+
# @param location [String]
|
|
235
|
+
# @param dataset [String]
|
|
236
|
+
# @param table_spec [String]
|
|
237
|
+
# @return [String]
|
|
238
|
+
def self.table_spec_path project, location, dataset, table_spec
|
|
239
|
+
TABLE_SPEC_PATH_TEMPLATE.render(
|
|
240
|
+
:"project" => project,
|
|
241
|
+
:"location" => location,
|
|
242
|
+
:"dataset" => dataset,
|
|
243
|
+
:"table_spec" => table_spec
|
|
244
|
+
)
|
|
245
|
+
end
|
|
246
|
+
|
|
247
|
+
# @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
|
|
248
|
+
# Provides the means for authenticating requests made by the client. This parameter can
|
|
249
|
+
# be many types.
|
|
250
|
+
# A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
|
|
251
|
+
# authenticating requests made by this client.
|
|
252
|
+
# A `String` will be treated as the path to the keyfile to be used for the construction of
|
|
253
|
+
# credentials for this client.
|
|
254
|
+
# A `Hash` will be treated as the contents of a keyfile to be used for the construction of
|
|
255
|
+
# credentials for this client.
|
|
256
|
+
# A `GRPC::Core::Channel` will be used to make calls through.
|
|
257
|
+
# A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
|
|
258
|
+
# should already be composed with a `GRPC::Core::CallCredentials` object.
|
|
259
|
+
# A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
|
|
260
|
+
# metadata for requests, generally, to give OAuth credentials.
|
|
261
|
+
# @param scopes [Array<String>]
|
|
262
|
+
# The OAuth scopes for this service. This parameter is ignored if
|
|
263
|
+
# an updater_proc is supplied.
|
|
264
|
+
# @param client_config [Hash]
|
|
265
|
+
# A Hash for call options for each method. See
|
|
266
|
+
# Google::Gax#construct_settings for the structure of
|
|
267
|
+
# this data. Falls back to the default config if not specified
|
|
268
|
+
# or the specified config is missing data points.
|
|
269
|
+
# @param timeout [Numeric]
|
|
270
|
+
# The default timeout, in seconds, for calls made through this client.
|
|
271
|
+
# @param metadata [Hash]
|
|
272
|
+
# Default metadata to be sent with each request. This can be overridden on a per call basis.
|
|
273
|
+
# @param service_address [String]
|
|
274
|
+
# Override for the service hostname, or `nil` to leave as the default.
|
|
275
|
+
# @param service_port [Integer]
|
|
276
|
+
# Override for the service port, or `nil` to leave as the default.
|
|
277
|
+
# @param exception_transformer [Proc]
|
|
278
|
+
# An optional proc that intercepts any exceptions raised during an API call to inject
|
|
279
|
+
# custom error handling.
|
|
280
|
+
def initialize \
|
|
281
|
+
credentials: nil,
|
|
282
|
+
scopes: ALL_SCOPES,
|
|
283
|
+
client_config: {},
|
|
284
|
+
timeout: DEFAULT_TIMEOUT,
|
|
285
|
+
metadata: nil,
|
|
286
|
+
service_address: nil,
|
|
287
|
+
service_port: nil,
|
|
288
|
+
exception_transformer: nil,
|
|
289
|
+
lib_name: nil,
|
|
290
|
+
lib_version: ""
|
|
291
|
+
# These require statements are intentionally placed here to initialize
|
|
292
|
+
# the gRPC module only when it's required.
|
|
293
|
+
# See https://github.com/googleapis/toolkit/issues/446
|
|
294
|
+
require "google/gax/grpc"
|
|
295
|
+
require "google/cloud/automl/v1beta1/service_services_pb"
|
|
296
|
+
|
|
297
|
+
credentials ||= Google::Cloud::AutoML::V1beta1::Credentials.default
|
|
298
|
+
|
|
299
|
+
@operations_client = OperationsClient.new(
|
|
300
|
+
credentials: credentials,
|
|
301
|
+
scopes: scopes,
|
|
302
|
+
client_config: client_config,
|
|
303
|
+
timeout: timeout,
|
|
304
|
+
lib_name: lib_name,
|
|
305
|
+
service_address: service_address,
|
|
306
|
+
service_port: service_port,
|
|
307
|
+
lib_version: lib_version,
|
|
308
|
+
metadata: metadata,
|
|
309
|
+
)
|
|
310
|
+
|
|
311
|
+
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
|
312
|
+
updater_proc = Google::Cloud::AutoML::V1beta1::Credentials.new(credentials).updater_proc
|
|
313
|
+
end
|
|
314
|
+
if credentials.is_a?(GRPC::Core::Channel)
|
|
315
|
+
channel = credentials
|
|
316
|
+
end
|
|
317
|
+
if credentials.is_a?(GRPC::Core::ChannelCredentials)
|
|
318
|
+
chan_creds = credentials
|
|
319
|
+
end
|
|
320
|
+
if credentials.is_a?(Proc)
|
|
321
|
+
updater_proc = credentials
|
|
322
|
+
end
|
|
323
|
+
if credentials.is_a?(Google::Auth::Credentials)
|
|
324
|
+
updater_proc = credentials.updater_proc
|
|
325
|
+
end
|
|
326
|
+
|
|
327
|
+
package_version = Google::Cloud::AutoML::VERSION
|
|
328
|
+
|
|
329
|
+
google_api_client = "gl-ruby/#{RUBY_VERSION}"
|
|
330
|
+
google_api_client << " #{lib_name}/#{lib_version}" if lib_name
|
|
331
|
+
google_api_client << " gapic/#{package_version} gax/#{Google::Gax::VERSION}"
|
|
332
|
+
google_api_client << " grpc/#{GRPC::VERSION}"
|
|
333
|
+
google_api_client.freeze
|
|
334
|
+
|
|
335
|
+
headers = { :"x-goog-api-client" => google_api_client }
|
|
336
|
+
headers.merge!(metadata) unless metadata.nil?
|
|
337
|
+
client_config_file = Pathname.new(__dir__).join(
|
|
338
|
+
"automl_client_config.json"
|
|
339
|
+
)
|
|
340
|
+
defaults = client_config_file.open do |f|
|
|
341
|
+
Google::Gax.construct_settings(
|
|
342
|
+
"google.cloud.automl.v1beta1.AutoMl",
|
|
343
|
+
JSON.parse(f.read),
|
|
344
|
+
client_config,
|
|
345
|
+
Google::Gax::Grpc::STATUS_CODE_NAMES,
|
|
346
|
+
timeout,
|
|
347
|
+
page_descriptors: PAGE_DESCRIPTORS,
|
|
348
|
+
errors: Google::Gax::Grpc::API_ERRORS,
|
|
349
|
+
metadata: headers
|
|
350
|
+
)
|
|
351
|
+
end
|
|
352
|
+
|
|
353
|
+
# Allow overriding the service path/port in subclasses.
|
|
354
|
+
service_path = service_address || self.class::SERVICE_ADDRESS
|
|
355
|
+
port = service_port || self.class::DEFAULT_SERVICE_PORT
|
|
356
|
+
interceptors = self.class::GRPC_INTERCEPTORS
|
|
357
|
+
@automl_stub = Google::Gax::Grpc.create_stub(
|
|
358
|
+
service_path,
|
|
359
|
+
port,
|
|
360
|
+
chan_creds: chan_creds,
|
|
361
|
+
channel: channel,
|
|
362
|
+
updater_proc: updater_proc,
|
|
363
|
+
scopes: scopes,
|
|
364
|
+
interceptors: interceptors,
|
|
365
|
+
&Google::Cloud::AutoML::V1beta1::AutoML::Stub.method(:new)
|
|
366
|
+
)
|
|
367
|
+
|
|
368
|
+
@create_dataset = Google::Gax.create_api_call(
|
|
369
|
+
@automl_stub.method(:create_dataset),
|
|
370
|
+
defaults["create_dataset"],
|
|
371
|
+
exception_transformer: exception_transformer,
|
|
372
|
+
params_extractor: proc do |request|
|
|
373
|
+
{'parent' => request.parent}
|
|
374
|
+
end
|
|
375
|
+
)
|
|
376
|
+
@update_dataset = Google::Gax.create_api_call(
|
|
377
|
+
@automl_stub.method(:update_dataset),
|
|
378
|
+
defaults["update_dataset"],
|
|
379
|
+
exception_transformer: exception_transformer,
|
|
380
|
+
params_extractor: proc do |request|
|
|
381
|
+
{'dataset.name' => request.dataset.name}
|
|
382
|
+
end
|
|
383
|
+
)
|
|
384
|
+
@get_dataset = Google::Gax.create_api_call(
|
|
385
|
+
@automl_stub.method(:get_dataset),
|
|
386
|
+
defaults["get_dataset"],
|
|
387
|
+
exception_transformer: exception_transformer,
|
|
388
|
+
params_extractor: proc do |request|
|
|
389
|
+
{'name' => request.name}
|
|
390
|
+
end
|
|
391
|
+
)
|
|
392
|
+
@list_datasets = Google::Gax.create_api_call(
|
|
393
|
+
@automl_stub.method(:list_datasets),
|
|
394
|
+
defaults["list_datasets"],
|
|
395
|
+
exception_transformer: exception_transformer,
|
|
396
|
+
params_extractor: proc do |request|
|
|
397
|
+
{'parent' => request.parent}
|
|
398
|
+
end
|
|
399
|
+
)
|
|
400
|
+
@delete_dataset = Google::Gax.create_api_call(
|
|
401
|
+
@automl_stub.method(:delete_dataset),
|
|
402
|
+
defaults["delete_dataset"],
|
|
403
|
+
exception_transformer: exception_transformer,
|
|
404
|
+
params_extractor: proc do |request|
|
|
405
|
+
{'name' => request.name}
|
|
406
|
+
end
|
|
407
|
+
)
|
|
408
|
+
@import_data = Google::Gax.create_api_call(
|
|
409
|
+
@automl_stub.method(:import_data),
|
|
410
|
+
defaults["import_data"],
|
|
411
|
+
exception_transformer: exception_transformer,
|
|
412
|
+
params_extractor: proc do |request|
|
|
413
|
+
{'name' => request.name}
|
|
414
|
+
end
|
|
415
|
+
)
|
|
416
|
+
@export_data = Google::Gax.create_api_call(
|
|
417
|
+
@automl_stub.method(:export_data),
|
|
418
|
+
defaults["export_data"],
|
|
419
|
+
exception_transformer: exception_transformer,
|
|
420
|
+
params_extractor: proc do |request|
|
|
421
|
+
{'name' => request.name}
|
|
422
|
+
end
|
|
423
|
+
)
|
|
424
|
+
@create_model = Google::Gax.create_api_call(
|
|
425
|
+
@automl_stub.method(:create_model),
|
|
426
|
+
defaults["create_model"],
|
|
427
|
+
exception_transformer: exception_transformer,
|
|
428
|
+
params_extractor: proc do |request|
|
|
429
|
+
{'parent' => request.parent}
|
|
430
|
+
end
|
|
431
|
+
)
|
|
432
|
+
@get_model = Google::Gax.create_api_call(
|
|
433
|
+
@automl_stub.method(:get_model),
|
|
434
|
+
defaults["get_model"],
|
|
435
|
+
exception_transformer: exception_transformer,
|
|
436
|
+
params_extractor: proc do |request|
|
|
437
|
+
{'name' => request.name}
|
|
438
|
+
end
|
|
439
|
+
)
|
|
440
|
+
@list_models = Google::Gax.create_api_call(
|
|
441
|
+
@automl_stub.method(:list_models),
|
|
442
|
+
defaults["list_models"],
|
|
443
|
+
exception_transformer: exception_transformer,
|
|
444
|
+
params_extractor: proc do |request|
|
|
445
|
+
{'parent' => request.parent}
|
|
446
|
+
end
|
|
447
|
+
)
|
|
448
|
+
@delete_model = Google::Gax.create_api_call(
|
|
449
|
+
@automl_stub.method(:delete_model),
|
|
450
|
+
defaults["delete_model"],
|
|
451
|
+
exception_transformer: exception_transformer,
|
|
452
|
+
params_extractor: proc do |request|
|
|
453
|
+
{'name' => request.name}
|
|
454
|
+
end
|
|
455
|
+
)
|
|
456
|
+
@deploy_model = Google::Gax.create_api_call(
|
|
457
|
+
@automl_stub.method(:deploy_model),
|
|
458
|
+
defaults["deploy_model"],
|
|
459
|
+
exception_transformer: exception_transformer,
|
|
460
|
+
params_extractor: proc do |request|
|
|
461
|
+
{'name' => request.name}
|
|
462
|
+
end
|
|
463
|
+
)
|
|
464
|
+
@undeploy_model = Google::Gax.create_api_call(
|
|
465
|
+
@automl_stub.method(:undeploy_model),
|
|
466
|
+
defaults["undeploy_model"],
|
|
467
|
+
exception_transformer: exception_transformer,
|
|
468
|
+
params_extractor: proc do |request|
|
|
469
|
+
{'name' => request.name}
|
|
470
|
+
end
|
|
471
|
+
)
|
|
472
|
+
@get_model_evaluation = Google::Gax.create_api_call(
|
|
473
|
+
@automl_stub.method(:get_model_evaluation),
|
|
474
|
+
defaults["get_model_evaluation"],
|
|
475
|
+
exception_transformer: exception_transformer,
|
|
476
|
+
params_extractor: proc do |request|
|
|
477
|
+
{'name' => request.name}
|
|
478
|
+
end
|
|
479
|
+
)
|
|
480
|
+
@export_model = Google::Gax.create_api_call(
|
|
481
|
+
@automl_stub.method(:export_model),
|
|
482
|
+
defaults["export_model"],
|
|
483
|
+
exception_transformer: exception_transformer,
|
|
484
|
+
params_extractor: proc do |request|
|
|
485
|
+
{'name' => request.name}
|
|
486
|
+
end
|
|
487
|
+
)
|
|
488
|
+
@export_evaluated_examples = Google::Gax.create_api_call(
|
|
489
|
+
@automl_stub.method(:export_evaluated_examples),
|
|
490
|
+
defaults["export_evaluated_examples"],
|
|
491
|
+
exception_transformer: exception_transformer,
|
|
492
|
+
params_extractor: proc do |request|
|
|
493
|
+
{'name' => request.name}
|
|
494
|
+
end
|
|
495
|
+
)
|
|
496
|
+
@list_model_evaluations = Google::Gax.create_api_call(
|
|
497
|
+
@automl_stub.method(:list_model_evaluations),
|
|
498
|
+
defaults["list_model_evaluations"],
|
|
499
|
+
exception_transformer: exception_transformer,
|
|
500
|
+
params_extractor: proc do |request|
|
|
501
|
+
{'parent' => request.parent}
|
|
502
|
+
end
|
|
503
|
+
)
|
|
504
|
+
@get_annotation_spec = Google::Gax.create_api_call(
|
|
505
|
+
@automl_stub.method(:get_annotation_spec),
|
|
506
|
+
defaults["get_annotation_spec"],
|
|
507
|
+
exception_transformer: exception_transformer,
|
|
508
|
+
params_extractor: proc do |request|
|
|
509
|
+
{'name' => request.name}
|
|
510
|
+
end
|
|
511
|
+
)
|
|
512
|
+
@get_table_spec = Google::Gax.create_api_call(
|
|
513
|
+
@automl_stub.method(:get_table_spec),
|
|
514
|
+
defaults["get_table_spec"],
|
|
515
|
+
exception_transformer: exception_transformer,
|
|
516
|
+
params_extractor: proc do |request|
|
|
517
|
+
{'name' => request.name}
|
|
518
|
+
end
|
|
519
|
+
)
|
|
520
|
+
@list_table_specs = Google::Gax.create_api_call(
|
|
521
|
+
@automl_stub.method(:list_table_specs),
|
|
522
|
+
defaults["list_table_specs"],
|
|
523
|
+
exception_transformer: exception_transformer,
|
|
524
|
+
params_extractor: proc do |request|
|
|
525
|
+
{'parent' => request.parent}
|
|
526
|
+
end
|
|
527
|
+
)
|
|
528
|
+
@update_table_spec = Google::Gax.create_api_call(
|
|
529
|
+
@automl_stub.method(:update_table_spec),
|
|
530
|
+
defaults["update_table_spec"],
|
|
531
|
+
exception_transformer: exception_transformer,
|
|
532
|
+
params_extractor: proc do |request|
|
|
533
|
+
{'table_spec.name' => request.table_spec.name}
|
|
534
|
+
end
|
|
535
|
+
)
|
|
536
|
+
@get_column_spec = Google::Gax.create_api_call(
|
|
537
|
+
@automl_stub.method(:get_column_spec),
|
|
538
|
+
defaults["get_column_spec"],
|
|
539
|
+
exception_transformer: exception_transformer,
|
|
540
|
+
params_extractor: proc do |request|
|
|
541
|
+
{'name' => request.name}
|
|
542
|
+
end
|
|
543
|
+
)
|
|
544
|
+
@list_column_specs = Google::Gax.create_api_call(
|
|
545
|
+
@automl_stub.method(:list_column_specs),
|
|
546
|
+
defaults["list_column_specs"],
|
|
547
|
+
exception_transformer: exception_transformer,
|
|
548
|
+
params_extractor: proc do |request|
|
|
549
|
+
{'parent' => request.parent}
|
|
550
|
+
end
|
|
551
|
+
)
|
|
552
|
+
@update_column_spec = Google::Gax.create_api_call(
|
|
553
|
+
@automl_stub.method(:update_column_spec),
|
|
554
|
+
defaults["update_column_spec"],
|
|
555
|
+
exception_transformer: exception_transformer,
|
|
556
|
+
params_extractor: proc do |request|
|
|
557
|
+
{'column_spec.name' => request.column_spec.name}
|
|
558
|
+
end
|
|
559
|
+
)
|
|
560
|
+
end
|
|
561
|
+
|
|
562
|
+
# Service calls
|
|
563
|
+
|
|
564
|
+
# Creates a dataset.
|
|
565
|
+
#
|
|
566
|
+
# @param parent [String]
|
|
567
|
+
# The resource name of the project to create the dataset for.
|
|
568
|
+
# @param dataset [Google::Cloud::AutoML::V1beta1::Dataset | Hash]
|
|
569
|
+
# The dataset to create.
|
|
570
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::Dataset`
|
|
571
|
+
# can also be provided.
|
|
572
|
+
# @param options [Google::Gax::CallOptions]
|
|
573
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
574
|
+
# retries, etc.
|
|
575
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
576
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
577
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
578
|
+
# @return [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
579
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
580
|
+
# @example
|
|
581
|
+
# require "google/cloud/automl"
|
|
582
|
+
#
|
|
583
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
584
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.location_path("[PROJECT]", "[LOCATION]")
|
|
585
|
+
#
|
|
586
|
+
# # TODO: Initialize `dataset`:
|
|
587
|
+
# dataset = {}
|
|
588
|
+
# response = automl_client.create_dataset(formatted_parent, dataset)
|
|
589
|
+
|
|
590
|
+
def create_dataset \
|
|
591
|
+
parent,
|
|
592
|
+
dataset,
|
|
593
|
+
options: nil,
|
|
594
|
+
&block
|
|
595
|
+
req = {
|
|
596
|
+
parent: parent,
|
|
597
|
+
dataset: dataset
|
|
598
|
+
}.delete_if { |_, v| v.nil? }
|
|
599
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::CreateDatasetRequest)
|
|
600
|
+
@create_dataset.call(req, options, &block)
|
|
601
|
+
end
|
|
602
|
+
|
|
603
|
+
# Updates a dataset.
|
|
604
|
+
#
|
|
605
|
+
# @param dataset [Google::Cloud::AutoML::V1beta1::Dataset | Hash]
|
|
606
|
+
# The dataset which replaces the resource on the server.
|
|
607
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::Dataset`
|
|
608
|
+
# can also be provided.
|
|
609
|
+
# @param update_mask [Google::Protobuf::FieldMask | Hash]
|
|
610
|
+
# The update mask applies to the resource. For the `FieldMask` definition,
|
|
611
|
+
# see
|
|
612
|
+
#
|
|
613
|
+
# https:
|
|
614
|
+
# //developers.google.com/protocol-buffers
|
|
615
|
+
# // /docs/reference/google.protobuf#fieldmask
|
|
616
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
617
|
+
# can also be provided.
|
|
618
|
+
# @param options [Google::Gax::CallOptions]
|
|
619
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
620
|
+
# retries, etc.
|
|
621
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
622
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
623
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
624
|
+
# @return [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
625
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
626
|
+
# @example
|
|
627
|
+
# require "google/cloud/automl"
|
|
628
|
+
#
|
|
629
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
630
|
+
#
|
|
631
|
+
# # TODO: Initialize `dataset`:
|
|
632
|
+
# dataset = {}
|
|
633
|
+
# response = automl_client.update_dataset(dataset)
|
|
634
|
+
|
|
635
|
+
def update_dataset \
|
|
636
|
+
dataset,
|
|
637
|
+
update_mask: nil,
|
|
638
|
+
options: nil,
|
|
639
|
+
&block
|
|
640
|
+
req = {
|
|
641
|
+
dataset: dataset,
|
|
642
|
+
update_mask: update_mask
|
|
643
|
+
}.delete_if { |_, v| v.nil? }
|
|
644
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::UpdateDatasetRequest)
|
|
645
|
+
@update_dataset.call(req, options, &block)
|
|
646
|
+
end
|
|
647
|
+
|
|
648
|
+
# Gets a dataset.
|
|
649
|
+
#
|
|
650
|
+
# @param name [String]
|
|
651
|
+
# The resource name of the dataset to retrieve.
|
|
652
|
+
# @param options [Google::Gax::CallOptions]
|
|
653
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
654
|
+
# retries, etc.
|
|
655
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
656
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
657
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
658
|
+
# @return [Google::Cloud::AutoML::V1beta1::Dataset]
|
|
659
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
660
|
+
# @example
|
|
661
|
+
# require "google/cloud/automl"
|
|
662
|
+
#
|
|
663
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
664
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
|
|
665
|
+
# response = automl_client.get_dataset(formatted_name)
|
|
666
|
+
|
|
667
|
+
def get_dataset \
|
|
668
|
+
name,
|
|
669
|
+
options: nil,
|
|
670
|
+
&block
|
|
671
|
+
req = {
|
|
672
|
+
name: name
|
|
673
|
+
}.delete_if { |_, v| v.nil? }
|
|
674
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetDatasetRequest)
|
|
675
|
+
@get_dataset.call(req, options, &block)
|
|
676
|
+
end
|
|
677
|
+
|
|
678
|
+
# Lists datasets in a project.
|
|
679
|
+
#
|
|
680
|
+
# @param parent [String]
|
|
681
|
+
# The resource name of the project from which to list datasets.
|
|
682
|
+
# @param filter [String]
|
|
683
|
+
# An expression for filtering the results of the request.
|
|
684
|
+
#
|
|
685
|
+
# * `dataset_metadata` - for existence of the case (e.g.
|
|
686
|
+
# image_classification_dataset_metadata:*). Some examples of using the filter are:
|
|
687
|
+
#
|
|
688
|
+
# * `translation_dataset_metadata:*` --> The dataset has
|
|
689
|
+
# translation_dataset_metadata.
|
|
690
|
+
# @param page_size [Integer]
|
|
691
|
+
# The maximum number of resources contained in the underlying API
|
|
692
|
+
# response. If page streaming is performed per-resource, this
|
|
693
|
+
# parameter does not affect the return value. If page streaming is
|
|
694
|
+
# performed per-page, this determines the maximum number of
|
|
695
|
+
# resources in a page.
|
|
696
|
+
# @param options [Google::Gax::CallOptions]
|
|
697
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
698
|
+
# retries, etc.
|
|
699
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
700
|
+
# @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::Dataset>]
|
|
701
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
702
|
+
# @return [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::Dataset>]
|
|
703
|
+
# An enumerable of Google::Cloud::AutoML::V1beta1::Dataset instances.
|
|
704
|
+
# See Google::Gax::PagedEnumerable documentation for other
|
|
705
|
+
# operations such as per-page iteration or access to the response
|
|
706
|
+
# object.
|
|
707
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
708
|
+
# @example
|
|
709
|
+
# require "google/cloud/automl"
|
|
710
|
+
#
|
|
711
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
712
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.location_path("[PROJECT]", "[LOCATION]")
|
|
713
|
+
#
|
|
714
|
+
# # Iterate over all results.
|
|
715
|
+
# automl_client.list_datasets(formatted_parent).each do |element|
|
|
716
|
+
# # Process element.
|
|
717
|
+
# end
|
|
718
|
+
#
|
|
719
|
+
# # Or iterate over results one page at a time.
|
|
720
|
+
# automl_client.list_datasets(formatted_parent).each_page do |page|
|
|
721
|
+
# # Process each page at a time.
|
|
722
|
+
# page.each do |element|
|
|
723
|
+
# # Process element.
|
|
724
|
+
# end
|
|
725
|
+
# end
|
|
726
|
+
|
|
727
|
+
def list_datasets \
|
|
728
|
+
parent,
|
|
729
|
+
filter: nil,
|
|
730
|
+
page_size: nil,
|
|
731
|
+
options: nil,
|
|
732
|
+
&block
|
|
733
|
+
req = {
|
|
734
|
+
parent: parent,
|
|
735
|
+
filter: filter,
|
|
736
|
+
page_size: page_size
|
|
737
|
+
}.delete_if { |_, v| v.nil? }
|
|
738
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ListDatasetsRequest)
|
|
739
|
+
@list_datasets.call(req, options, &block)
|
|
740
|
+
end
|
|
741
|
+
|
|
742
|
+
# Deletes a dataset and all of its contents.
|
|
743
|
+
# Returns empty response in the
|
|
744
|
+
# {Google::Longrunning::Operation#response response} field when it completes,
|
|
745
|
+
# and `delete_details` in the
|
|
746
|
+
# {Google::Longrunning::Operation#metadata metadata} field.
|
|
747
|
+
#
|
|
748
|
+
# @param name [String]
|
|
749
|
+
# The resource name of the dataset to delete.
|
|
750
|
+
# @param options [Google::Gax::CallOptions]
|
|
751
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
752
|
+
# retries, etc.
|
|
753
|
+
# @return [Google::Gax::Operation]
|
|
754
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
755
|
+
# @example
|
|
756
|
+
# require "google/cloud/automl"
|
|
757
|
+
#
|
|
758
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
759
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
|
|
760
|
+
#
|
|
761
|
+
# # Register a callback during the method call.
|
|
762
|
+
# operation = automl_client.delete_dataset(formatted_name) do |op|
|
|
763
|
+
# raise op.results.message if op.error?
|
|
764
|
+
# op_results = op.results
|
|
765
|
+
# # Process the results.
|
|
766
|
+
#
|
|
767
|
+
# metadata = op.metadata
|
|
768
|
+
# # Process the metadata.
|
|
769
|
+
# end
|
|
770
|
+
#
|
|
771
|
+
# # Or use the return value to register a callback.
|
|
772
|
+
# operation.on_done do |op|
|
|
773
|
+
# raise op.results.message if op.error?
|
|
774
|
+
# op_results = op.results
|
|
775
|
+
# # Process the results.
|
|
776
|
+
#
|
|
777
|
+
# metadata = op.metadata
|
|
778
|
+
# # Process the metadata.
|
|
779
|
+
# end
|
|
780
|
+
#
|
|
781
|
+
# # Manually reload the operation.
|
|
782
|
+
# operation.reload!
|
|
783
|
+
#
|
|
784
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
785
|
+
# # completion.
|
|
786
|
+
# operation.wait_until_done!
|
|
787
|
+
|
|
788
|
+
def delete_dataset \
|
|
789
|
+
name,
|
|
790
|
+
options: nil
|
|
791
|
+
req = {
|
|
792
|
+
name: name
|
|
793
|
+
}.delete_if { |_, v| v.nil? }
|
|
794
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::DeleteDatasetRequest)
|
|
795
|
+
operation = Google::Gax::Operation.new(
|
|
796
|
+
@delete_dataset.call(req, options),
|
|
797
|
+
@operations_client,
|
|
798
|
+
Google::Protobuf::Empty,
|
|
799
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
800
|
+
call_options: options
|
|
801
|
+
)
|
|
802
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
803
|
+
operation
|
|
804
|
+
end
|
|
805
|
+
|
|
806
|
+
# Imports data into a dataset.
|
|
807
|
+
# For Tables this method can only be called on an empty Dataset.
|
|
808
|
+
#
|
|
809
|
+
# For Tables:
|
|
810
|
+
# * A
|
|
811
|
+
# {Google::Cloud::AutoML::V1beta1::InputConfig#params schema_inference_version}
|
|
812
|
+
# parameter must be explicitly set.
|
|
813
|
+
# Returns an empty response in the
|
|
814
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
815
|
+
#
|
|
816
|
+
# @param name [String]
|
|
817
|
+
# Required. Dataset name. Dataset must already exist. All imported
|
|
818
|
+
# annotations and examples will be added.
|
|
819
|
+
# @param input_config [Google::Cloud::AutoML::V1beta1::InputConfig | Hash]
|
|
820
|
+
# Required. The desired input location and its domain specific semantics,
|
|
821
|
+
# if any.
|
|
822
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::InputConfig`
|
|
823
|
+
# can also be provided.
|
|
824
|
+
# @param options [Google::Gax::CallOptions]
|
|
825
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
826
|
+
# retries, etc.
|
|
827
|
+
# @return [Google::Gax::Operation]
|
|
828
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
829
|
+
# @example
|
|
830
|
+
# require "google/cloud/automl"
|
|
831
|
+
#
|
|
832
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
833
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
|
|
834
|
+
#
|
|
835
|
+
# # TODO: Initialize `input_config`:
|
|
836
|
+
# input_config = {}
|
|
837
|
+
#
|
|
838
|
+
# # Register a callback during the method call.
|
|
839
|
+
# operation = automl_client.import_data(formatted_name, input_config) do |op|
|
|
840
|
+
# raise op.results.message if op.error?
|
|
841
|
+
# op_results = op.results
|
|
842
|
+
# # Process the results.
|
|
843
|
+
#
|
|
844
|
+
# metadata = op.metadata
|
|
845
|
+
# # Process the metadata.
|
|
846
|
+
# end
|
|
847
|
+
#
|
|
848
|
+
# # Or use the return value to register a callback.
|
|
849
|
+
# operation.on_done do |op|
|
|
850
|
+
# raise op.results.message if op.error?
|
|
851
|
+
# op_results = op.results
|
|
852
|
+
# # Process the results.
|
|
853
|
+
#
|
|
854
|
+
# metadata = op.metadata
|
|
855
|
+
# # Process the metadata.
|
|
856
|
+
# end
|
|
857
|
+
#
|
|
858
|
+
# # Manually reload the operation.
|
|
859
|
+
# operation.reload!
|
|
860
|
+
#
|
|
861
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
862
|
+
# # completion.
|
|
863
|
+
# operation.wait_until_done!
|
|
864
|
+
|
|
865
|
+
def import_data \
|
|
866
|
+
name,
|
|
867
|
+
input_config,
|
|
868
|
+
options: nil
|
|
869
|
+
req = {
|
|
870
|
+
name: name,
|
|
871
|
+
input_config: input_config
|
|
872
|
+
}.delete_if { |_, v| v.nil? }
|
|
873
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ImportDataRequest)
|
|
874
|
+
operation = Google::Gax::Operation.new(
|
|
875
|
+
@import_data.call(req, options),
|
|
876
|
+
@operations_client,
|
|
877
|
+
Google::Protobuf::Empty,
|
|
878
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
879
|
+
call_options: options
|
|
880
|
+
)
|
|
881
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
882
|
+
operation
|
|
883
|
+
end
|
|
884
|
+
|
|
885
|
+
# Exports dataset's data to the provided output location.
|
|
886
|
+
# Returns an empty response in the
|
|
887
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
888
|
+
#
|
|
889
|
+
# @param name [String]
|
|
890
|
+
# Required. The resource name of the dataset.
|
|
891
|
+
# @param output_config [Google::Cloud::AutoML::V1beta1::OutputConfig | Hash]
|
|
892
|
+
# Required. The desired output location.
|
|
893
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::OutputConfig`
|
|
894
|
+
# can also be provided.
|
|
895
|
+
# @param options [Google::Gax::CallOptions]
|
|
896
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
897
|
+
# retries, etc.
|
|
898
|
+
# @return [Google::Gax::Operation]
|
|
899
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
900
|
+
# @example
|
|
901
|
+
# require "google/cloud/automl"
|
|
902
|
+
#
|
|
903
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
904
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
|
|
905
|
+
#
|
|
906
|
+
# # TODO: Initialize `output_config`:
|
|
907
|
+
# output_config = {}
|
|
908
|
+
#
|
|
909
|
+
# # Register a callback during the method call.
|
|
910
|
+
# operation = automl_client.export_data(formatted_name, output_config) do |op|
|
|
911
|
+
# raise op.results.message if op.error?
|
|
912
|
+
# op_results = op.results
|
|
913
|
+
# # Process the results.
|
|
914
|
+
#
|
|
915
|
+
# metadata = op.metadata
|
|
916
|
+
# # Process the metadata.
|
|
917
|
+
# end
|
|
918
|
+
#
|
|
919
|
+
# # Or use the return value to register a callback.
|
|
920
|
+
# operation.on_done do |op|
|
|
921
|
+
# raise op.results.message if op.error?
|
|
922
|
+
# op_results = op.results
|
|
923
|
+
# # Process the results.
|
|
924
|
+
#
|
|
925
|
+
# metadata = op.metadata
|
|
926
|
+
# # Process the metadata.
|
|
927
|
+
# end
|
|
928
|
+
#
|
|
929
|
+
# # Manually reload the operation.
|
|
930
|
+
# operation.reload!
|
|
931
|
+
#
|
|
932
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
933
|
+
# # completion.
|
|
934
|
+
# operation.wait_until_done!
|
|
935
|
+
|
|
936
|
+
def export_data \
|
|
937
|
+
name,
|
|
938
|
+
output_config,
|
|
939
|
+
options: nil
|
|
940
|
+
req = {
|
|
941
|
+
name: name,
|
|
942
|
+
output_config: output_config
|
|
943
|
+
}.delete_if { |_, v| v.nil? }
|
|
944
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ExportDataRequest)
|
|
945
|
+
operation = Google::Gax::Operation.new(
|
|
946
|
+
@export_data.call(req, options),
|
|
947
|
+
@operations_client,
|
|
948
|
+
Google::Protobuf::Empty,
|
|
949
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
950
|
+
call_options: options
|
|
951
|
+
)
|
|
952
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
953
|
+
operation
|
|
954
|
+
end
|
|
955
|
+
|
|
956
|
+
# Creates a model.
|
|
957
|
+
# Returns a Model in the {Google::Longrunning::Operation#response response}
|
|
958
|
+
# field when it completes.
|
|
959
|
+
# When you create a model, several model evaluations are created for it:
|
|
960
|
+
# a global evaluation, and one evaluation for each annotation spec.
|
|
961
|
+
#
|
|
962
|
+
# @param parent [String]
|
|
963
|
+
# Resource name of the parent project where the model is being created.
|
|
964
|
+
# @param model [Google::Cloud::AutoML::V1beta1::Model | Hash]
|
|
965
|
+
# The model to create.
|
|
966
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::Model`
|
|
967
|
+
# can also be provided.
|
|
968
|
+
# @param options [Google::Gax::CallOptions]
|
|
969
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
970
|
+
# retries, etc.
|
|
971
|
+
# @return [Google::Gax::Operation]
|
|
972
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
973
|
+
# @example
|
|
974
|
+
# require "google/cloud/automl"
|
|
975
|
+
#
|
|
976
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
977
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.location_path("[PROJECT]", "[LOCATION]")
|
|
978
|
+
#
|
|
979
|
+
# # TODO: Initialize `model`:
|
|
980
|
+
# model = {}
|
|
981
|
+
#
|
|
982
|
+
# # Register a callback during the method call.
|
|
983
|
+
# operation = automl_client.create_model(formatted_parent, model) do |op|
|
|
984
|
+
# raise op.results.message if op.error?
|
|
985
|
+
# op_results = op.results
|
|
986
|
+
# # Process the results.
|
|
987
|
+
#
|
|
988
|
+
# metadata = op.metadata
|
|
989
|
+
# # Process the metadata.
|
|
990
|
+
# end
|
|
991
|
+
#
|
|
992
|
+
# # Or use the return value to register a callback.
|
|
993
|
+
# operation.on_done do |op|
|
|
994
|
+
# raise op.results.message if op.error?
|
|
995
|
+
# op_results = op.results
|
|
996
|
+
# # Process the results.
|
|
997
|
+
#
|
|
998
|
+
# metadata = op.metadata
|
|
999
|
+
# # Process the metadata.
|
|
1000
|
+
# end
|
|
1001
|
+
#
|
|
1002
|
+
# # Manually reload the operation.
|
|
1003
|
+
# operation.reload!
|
|
1004
|
+
#
|
|
1005
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1006
|
+
# # completion.
|
|
1007
|
+
# operation.wait_until_done!
|
|
1008
|
+
|
|
1009
|
+
def create_model \
|
|
1010
|
+
parent,
|
|
1011
|
+
model,
|
|
1012
|
+
options: nil
|
|
1013
|
+
req = {
|
|
1014
|
+
parent: parent,
|
|
1015
|
+
model: model
|
|
1016
|
+
}.delete_if { |_, v| v.nil? }
|
|
1017
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::CreateModelRequest)
|
|
1018
|
+
operation = Google::Gax::Operation.new(
|
|
1019
|
+
@create_model.call(req, options),
|
|
1020
|
+
@operations_client,
|
|
1021
|
+
Google::Cloud::AutoML::V1beta1::Model,
|
|
1022
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1023
|
+
call_options: options
|
|
1024
|
+
)
|
|
1025
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1026
|
+
operation
|
|
1027
|
+
end
|
|
1028
|
+
|
|
1029
|
+
# Gets a model.
|
|
1030
|
+
#
|
|
1031
|
+
# @param name [String]
|
|
1032
|
+
# Resource name of the model.
|
|
1033
|
+
# @param options [Google::Gax::CallOptions]
|
|
1034
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1035
|
+
# retries, etc.
|
|
1036
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1037
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::Model]
|
|
1038
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1039
|
+
# @return [Google::Cloud::AutoML::V1beta1::Model]
|
|
1040
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1041
|
+
# @example
|
|
1042
|
+
# require "google/cloud/automl"
|
|
1043
|
+
#
|
|
1044
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1045
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1046
|
+
# response = automl_client.get_model(formatted_name)
|
|
1047
|
+
|
|
1048
|
+
def get_model \
|
|
1049
|
+
name,
|
|
1050
|
+
options: nil,
|
|
1051
|
+
&block
|
|
1052
|
+
req = {
|
|
1053
|
+
name: name
|
|
1054
|
+
}.delete_if { |_, v| v.nil? }
|
|
1055
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetModelRequest)
|
|
1056
|
+
@get_model.call(req, options, &block)
|
|
1057
|
+
end
|
|
1058
|
+
|
|
1059
|
+
# Lists models.
|
|
1060
|
+
#
|
|
1061
|
+
# @param parent [String]
|
|
1062
|
+
# Resource name of the project, from which to list the models.
|
|
1063
|
+
# @param filter [String]
|
|
1064
|
+
# An expression for filtering the results of the request.
|
|
1065
|
+
#
|
|
1066
|
+
# * `model_metadata` - for existence of the case (e.g.
|
|
1067
|
+
# video_classification_model_metadata:*).
|
|
1068
|
+
# * `dataset_id` - for = or !=. Some examples of using the filter are:
|
|
1069
|
+
#
|
|
1070
|
+
# * `image_classification_model_metadata:*` --> The model has
|
|
1071
|
+
# image_classification_model_metadata.
|
|
1072
|
+
# * `dataset_id=5` --> The model was created from a dataset with ID 5.
|
|
1073
|
+
# @param page_size [Integer]
|
|
1074
|
+
# The maximum number of resources contained in the underlying API
|
|
1075
|
+
# response. If page streaming is performed per-resource, this
|
|
1076
|
+
# parameter does not affect the return value. If page streaming is
|
|
1077
|
+
# performed per-page, this determines the maximum number of
|
|
1078
|
+
# resources in a page.
|
|
1079
|
+
# @param options [Google::Gax::CallOptions]
|
|
1080
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1081
|
+
# retries, etc.
|
|
1082
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1083
|
+
# @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::Model>]
|
|
1084
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1085
|
+
# @return [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::Model>]
|
|
1086
|
+
# An enumerable of Google::Cloud::AutoML::V1beta1::Model instances.
|
|
1087
|
+
# See Google::Gax::PagedEnumerable documentation for other
|
|
1088
|
+
# operations such as per-page iteration or access to the response
|
|
1089
|
+
# object.
|
|
1090
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1091
|
+
# @example
|
|
1092
|
+
# require "google/cloud/automl"
|
|
1093
|
+
#
|
|
1094
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1095
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.location_path("[PROJECT]", "[LOCATION]")
|
|
1096
|
+
#
|
|
1097
|
+
# # Iterate over all results.
|
|
1098
|
+
# automl_client.list_models(formatted_parent).each do |element|
|
|
1099
|
+
# # Process element.
|
|
1100
|
+
# end
|
|
1101
|
+
#
|
|
1102
|
+
# # Or iterate over results one page at a time.
|
|
1103
|
+
# automl_client.list_models(formatted_parent).each_page do |page|
|
|
1104
|
+
# # Process each page at a time.
|
|
1105
|
+
# page.each do |element|
|
|
1106
|
+
# # Process element.
|
|
1107
|
+
# end
|
|
1108
|
+
# end
|
|
1109
|
+
|
|
1110
|
+
def list_models \
|
|
1111
|
+
parent,
|
|
1112
|
+
filter: nil,
|
|
1113
|
+
page_size: nil,
|
|
1114
|
+
options: nil,
|
|
1115
|
+
&block
|
|
1116
|
+
req = {
|
|
1117
|
+
parent: parent,
|
|
1118
|
+
filter: filter,
|
|
1119
|
+
page_size: page_size
|
|
1120
|
+
}.delete_if { |_, v| v.nil? }
|
|
1121
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ListModelsRequest)
|
|
1122
|
+
@list_models.call(req, options, &block)
|
|
1123
|
+
end
|
|
1124
|
+
|
|
1125
|
+
# Deletes a model.
|
|
1126
|
+
# Returns `google.protobuf.Empty` in the
|
|
1127
|
+
# {Google::Longrunning::Operation#response response} field when it completes,
|
|
1128
|
+
# and `delete_details` in the
|
|
1129
|
+
# {Google::Longrunning::Operation#metadata metadata} field.
|
|
1130
|
+
#
|
|
1131
|
+
# @param name [String]
|
|
1132
|
+
# Resource name of the model being deleted.
|
|
1133
|
+
# @param options [Google::Gax::CallOptions]
|
|
1134
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1135
|
+
# retries, etc.
|
|
1136
|
+
# @return [Google::Gax::Operation]
|
|
1137
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1138
|
+
# @example
|
|
1139
|
+
# require "google/cloud/automl"
|
|
1140
|
+
#
|
|
1141
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1142
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1143
|
+
#
|
|
1144
|
+
# # Register a callback during the method call.
|
|
1145
|
+
# operation = automl_client.delete_model(formatted_name) do |op|
|
|
1146
|
+
# raise op.results.message if op.error?
|
|
1147
|
+
# op_results = op.results
|
|
1148
|
+
# # Process the results.
|
|
1149
|
+
#
|
|
1150
|
+
# metadata = op.metadata
|
|
1151
|
+
# # Process the metadata.
|
|
1152
|
+
# end
|
|
1153
|
+
#
|
|
1154
|
+
# # Or use the return value to register a callback.
|
|
1155
|
+
# operation.on_done do |op|
|
|
1156
|
+
# raise op.results.message if op.error?
|
|
1157
|
+
# op_results = op.results
|
|
1158
|
+
# # Process the results.
|
|
1159
|
+
#
|
|
1160
|
+
# metadata = op.metadata
|
|
1161
|
+
# # Process the metadata.
|
|
1162
|
+
# end
|
|
1163
|
+
#
|
|
1164
|
+
# # Manually reload the operation.
|
|
1165
|
+
# operation.reload!
|
|
1166
|
+
#
|
|
1167
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1168
|
+
# # completion.
|
|
1169
|
+
# operation.wait_until_done!
|
|
1170
|
+
|
|
1171
|
+
def delete_model \
|
|
1172
|
+
name,
|
|
1173
|
+
options: nil
|
|
1174
|
+
req = {
|
|
1175
|
+
name: name
|
|
1176
|
+
}.delete_if { |_, v| v.nil? }
|
|
1177
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::DeleteModelRequest)
|
|
1178
|
+
operation = Google::Gax::Operation.new(
|
|
1179
|
+
@delete_model.call(req, options),
|
|
1180
|
+
@operations_client,
|
|
1181
|
+
Google::Protobuf::Empty,
|
|
1182
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1183
|
+
call_options: options
|
|
1184
|
+
)
|
|
1185
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1186
|
+
operation
|
|
1187
|
+
end
|
|
1188
|
+
|
|
1189
|
+
# Deploys a model. If a model is already deployed, deploying it with the
|
|
1190
|
+
# same parameters has no effect. Deploying with different parametrs
|
|
1191
|
+
# (as e.g. changing
|
|
1192
|
+
#
|
|
1193
|
+
# {Google::Cloud::AutoML::V1beta1::ImageObjectDetectionModelDeploymentMetadata#node_number node_number})
|
|
1194
|
+
# will reset the deployment state without pausing the model's availability.
|
|
1195
|
+
#
|
|
1196
|
+
# Only applicable for Text Classification, Image Object Detection and Tables;
|
|
1197
|
+
# all other domains manage deployment automatically.
|
|
1198
|
+
#
|
|
1199
|
+
# Returns an empty response in the
|
|
1200
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
1201
|
+
#
|
|
1202
|
+
# @param name [String]
|
|
1203
|
+
# Resource name of the model to deploy.
|
|
1204
|
+
# @param image_object_detection_model_deployment_metadata [Google::Cloud::AutoML::V1beta1::ImageObjectDetectionModelDeploymentMetadata | Hash]
|
|
1205
|
+
# Model deployment metadata specific to Image Object Detection.
|
|
1206
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::ImageObjectDetectionModelDeploymentMetadata`
|
|
1207
|
+
# can also be provided.
|
|
1208
|
+
# @param options [Google::Gax::CallOptions]
|
|
1209
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1210
|
+
# retries, etc.
|
|
1211
|
+
# @return [Google::Gax::Operation]
|
|
1212
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1213
|
+
# @example
|
|
1214
|
+
# require "google/cloud/automl"
|
|
1215
|
+
#
|
|
1216
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1217
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1218
|
+
#
|
|
1219
|
+
# # Register a callback during the method call.
|
|
1220
|
+
# operation = automl_client.deploy_model(formatted_name) do |op|
|
|
1221
|
+
# raise op.results.message if op.error?
|
|
1222
|
+
# op_results = op.results
|
|
1223
|
+
# # Process the results.
|
|
1224
|
+
#
|
|
1225
|
+
# metadata = op.metadata
|
|
1226
|
+
# # Process the metadata.
|
|
1227
|
+
# end
|
|
1228
|
+
#
|
|
1229
|
+
# # Or use the return value to register a callback.
|
|
1230
|
+
# operation.on_done do |op|
|
|
1231
|
+
# raise op.results.message if op.error?
|
|
1232
|
+
# op_results = op.results
|
|
1233
|
+
# # Process the results.
|
|
1234
|
+
#
|
|
1235
|
+
# metadata = op.metadata
|
|
1236
|
+
# # Process the metadata.
|
|
1237
|
+
# end
|
|
1238
|
+
#
|
|
1239
|
+
# # Manually reload the operation.
|
|
1240
|
+
# operation.reload!
|
|
1241
|
+
#
|
|
1242
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1243
|
+
# # completion.
|
|
1244
|
+
# operation.wait_until_done!
|
|
1245
|
+
|
|
1246
|
+
def deploy_model \
|
|
1247
|
+
name,
|
|
1248
|
+
image_object_detection_model_deployment_metadata: nil,
|
|
1249
|
+
options: nil
|
|
1250
|
+
req = {
|
|
1251
|
+
name: name,
|
|
1252
|
+
image_object_detection_model_deployment_metadata: image_object_detection_model_deployment_metadata
|
|
1253
|
+
}.delete_if { |_, v| v.nil? }
|
|
1254
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::DeployModelRequest)
|
|
1255
|
+
operation = Google::Gax::Operation.new(
|
|
1256
|
+
@deploy_model.call(req, options),
|
|
1257
|
+
@operations_client,
|
|
1258
|
+
Google::Protobuf::Empty,
|
|
1259
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1260
|
+
call_options: options
|
|
1261
|
+
)
|
|
1262
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1263
|
+
operation
|
|
1264
|
+
end
|
|
1265
|
+
|
|
1266
|
+
# Undeploys a model. If the model is not deployed this method has no effect.
|
|
1267
|
+
#
|
|
1268
|
+
# Only applicable for Text Classification, Image Object Detection and Tables;
|
|
1269
|
+
# all other domains manage deployment automatically.
|
|
1270
|
+
#
|
|
1271
|
+
# Returns an empty response in the
|
|
1272
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
1273
|
+
#
|
|
1274
|
+
# @param name [String]
|
|
1275
|
+
# Resource name of the model to undeploy.
|
|
1276
|
+
# @param options [Google::Gax::CallOptions]
|
|
1277
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1278
|
+
# retries, etc.
|
|
1279
|
+
# @return [Google::Gax::Operation]
|
|
1280
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1281
|
+
# @example
|
|
1282
|
+
# require "google/cloud/automl"
|
|
1283
|
+
#
|
|
1284
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1285
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1286
|
+
#
|
|
1287
|
+
# # Register a callback during the method call.
|
|
1288
|
+
# operation = automl_client.undeploy_model(formatted_name) do |op|
|
|
1289
|
+
# raise op.results.message if op.error?
|
|
1290
|
+
# op_results = op.results
|
|
1291
|
+
# # Process the results.
|
|
1292
|
+
#
|
|
1293
|
+
# metadata = op.metadata
|
|
1294
|
+
# # Process the metadata.
|
|
1295
|
+
# end
|
|
1296
|
+
#
|
|
1297
|
+
# # Or use the return value to register a callback.
|
|
1298
|
+
# operation.on_done do |op|
|
|
1299
|
+
# raise op.results.message if op.error?
|
|
1300
|
+
# op_results = op.results
|
|
1301
|
+
# # Process the results.
|
|
1302
|
+
#
|
|
1303
|
+
# metadata = op.metadata
|
|
1304
|
+
# # Process the metadata.
|
|
1305
|
+
# end
|
|
1306
|
+
#
|
|
1307
|
+
# # Manually reload the operation.
|
|
1308
|
+
# operation.reload!
|
|
1309
|
+
#
|
|
1310
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1311
|
+
# # completion.
|
|
1312
|
+
# operation.wait_until_done!
|
|
1313
|
+
|
|
1314
|
+
def undeploy_model \
|
|
1315
|
+
name,
|
|
1316
|
+
options: nil
|
|
1317
|
+
req = {
|
|
1318
|
+
name: name
|
|
1319
|
+
}.delete_if { |_, v| v.nil? }
|
|
1320
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::UndeployModelRequest)
|
|
1321
|
+
operation = Google::Gax::Operation.new(
|
|
1322
|
+
@undeploy_model.call(req, options),
|
|
1323
|
+
@operations_client,
|
|
1324
|
+
Google::Protobuf::Empty,
|
|
1325
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1326
|
+
call_options: options
|
|
1327
|
+
)
|
|
1328
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1329
|
+
operation
|
|
1330
|
+
end
|
|
1331
|
+
|
|
1332
|
+
# Gets a model evaluation.
|
|
1333
|
+
#
|
|
1334
|
+
# @param name [String]
|
|
1335
|
+
# Resource name for the model evaluation.
|
|
1336
|
+
# @param options [Google::Gax::CallOptions]
|
|
1337
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1338
|
+
# retries, etc.
|
|
1339
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1340
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::ModelEvaluation]
|
|
1341
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1342
|
+
# @return [Google::Cloud::AutoML::V1beta1::ModelEvaluation]
|
|
1343
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1344
|
+
# @example
|
|
1345
|
+
# require "google/cloud/automl"
|
|
1346
|
+
#
|
|
1347
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1348
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_evaluation_path("[PROJECT]", "[LOCATION]", "[MODEL]", "[MODEL_EVALUATION]")
|
|
1349
|
+
# response = automl_client.get_model_evaluation(formatted_name)
|
|
1350
|
+
|
|
1351
|
+
def get_model_evaluation \
|
|
1352
|
+
name,
|
|
1353
|
+
options: nil,
|
|
1354
|
+
&block
|
|
1355
|
+
req = {
|
|
1356
|
+
name: name
|
|
1357
|
+
}.delete_if { |_, v| v.nil? }
|
|
1358
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetModelEvaluationRequest)
|
|
1359
|
+
@get_model_evaluation.call(req, options, &block)
|
|
1360
|
+
end
|
|
1361
|
+
|
|
1362
|
+
# Exports a trained, "export-able", model to a user specified Google Cloud
|
|
1363
|
+
# Storage location. A model is considered export-able if and only if it has
|
|
1364
|
+
# an export format defined for it in
|
|
1365
|
+
#
|
|
1366
|
+
# {Google::Cloud::AutoML::V1beta1::ModelExportOutputConfig ModelExportOutputConfig}.
|
|
1367
|
+
#
|
|
1368
|
+
# Returns an empty response in the
|
|
1369
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
1370
|
+
#
|
|
1371
|
+
# @param name [String]
|
|
1372
|
+
# Required. The resource name of the model to export.
|
|
1373
|
+
# @param output_config [Google::Cloud::AutoML::V1beta1::ModelExportOutputConfig | Hash]
|
|
1374
|
+
# Required. The desired output location and configuration.
|
|
1375
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::ModelExportOutputConfig`
|
|
1376
|
+
# can also be provided.
|
|
1377
|
+
# @param options [Google::Gax::CallOptions]
|
|
1378
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1379
|
+
# retries, etc.
|
|
1380
|
+
# @return [Google::Gax::Operation]
|
|
1381
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1382
|
+
# @example
|
|
1383
|
+
# require "google/cloud/automl"
|
|
1384
|
+
#
|
|
1385
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1386
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1387
|
+
#
|
|
1388
|
+
# # TODO: Initialize `output_config`:
|
|
1389
|
+
# output_config = {}
|
|
1390
|
+
#
|
|
1391
|
+
# # Register a callback during the method call.
|
|
1392
|
+
# operation = automl_client.export_model(formatted_name, output_config) do |op|
|
|
1393
|
+
# raise op.results.message if op.error?
|
|
1394
|
+
# op_results = op.results
|
|
1395
|
+
# # Process the results.
|
|
1396
|
+
#
|
|
1397
|
+
# metadata = op.metadata
|
|
1398
|
+
# # Process the metadata.
|
|
1399
|
+
# end
|
|
1400
|
+
#
|
|
1401
|
+
# # Or use the return value to register a callback.
|
|
1402
|
+
# operation.on_done do |op|
|
|
1403
|
+
# raise op.results.message if op.error?
|
|
1404
|
+
# op_results = op.results
|
|
1405
|
+
# # Process the results.
|
|
1406
|
+
#
|
|
1407
|
+
# metadata = op.metadata
|
|
1408
|
+
# # Process the metadata.
|
|
1409
|
+
# end
|
|
1410
|
+
#
|
|
1411
|
+
# # Manually reload the operation.
|
|
1412
|
+
# operation.reload!
|
|
1413
|
+
#
|
|
1414
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1415
|
+
# # completion.
|
|
1416
|
+
# operation.wait_until_done!
|
|
1417
|
+
|
|
1418
|
+
def export_model \
|
|
1419
|
+
name,
|
|
1420
|
+
output_config,
|
|
1421
|
+
options: nil
|
|
1422
|
+
req = {
|
|
1423
|
+
name: name,
|
|
1424
|
+
output_config: output_config
|
|
1425
|
+
}.delete_if { |_, v| v.nil? }
|
|
1426
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ExportModelRequest)
|
|
1427
|
+
operation = Google::Gax::Operation.new(
|
|
1428
|
+
@export_model.call(req, options),
|
|
1429
|
+
@operations_client,
|
|
1430
|
+
Google::Protobuf::Empty,
|
|
1431
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1432
|
+
call_options: options
|
|
1433
|
+
)
|
|
1434
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1435
|
+
operation
|
|
1436
|
+
end
|
|
1437
|
+
|
|
1438
|
+
# Exports examples on which the model was evaluated (i.e. which were in the
|
|
1439
|
+
# TEST set of the dataset the model was created from), together with their
|
|
1440
|
+
# ground truth annotations and the annotations created (predicted) by the
|
|
1441
|
+
# model.
|
|
1442
|
+
# The examples, ground truth and predictions are exported in the state
|
|
1443
|
+
# they were at the moment the model was evaluated.
|
|
1444
|
+
#
|
|
1445
|
+
# This export is available only for 30 days since the model evaluation is
|
|
1446
|
+
# created.
|
|
1447
|
+
#
|
|
1448
|
+
# Currently only available for Tables.
|
|
1449
|
+
#
|
|
1450
|
+
# Returns an empty response in the
|
|
1451
|
+
# {Google::Longrunning::Operation#response response} field when it completes.
|
|
1452
|
+
#
|
|
1453
|
+
# @param name [String]
|
|
1454
|
+
# Required. The resource name of the model whose evaluated examples are to
|
|
1455
|
+
# be exported.
|
|
1456
|
+
# @param output_config [Google::Cloud::AutoML::V1beta1::ExportEvaluatedExamplesOutputConfig | Hash]
|
|
1457
|
+
# Required. The desired output location and configuration.
|
|
1458
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::ExportEvaluatedExamplesOutputConfig`
|
|
1459
|
+
# can also be provided.
|
|
1460
|
+
# @param options [Google::Gax::CallOptions]
|
|
1461
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1462
|
+
# retries, etc.
|
|
1463
|
+
# @return [Google::Gax::Operation]
|
|
1464
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1465
|
+
# @example
|
|
1466
|
+
# require "google/cloud/automl"
|
|
1467
|
+
#
|
|
1468
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1469
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1470
|
+
#
|
|
1471
|
+
# # TODO: Initialize `output_config`:
|
|
1472
|
+
# output_config = {}
|
|
1473
|
+
#
|
|
1474
|
+
# # Register a callback during the method call.
|
|
1475
|
+
# operation = automl_client.export_evaluated_examples(formatted_name, output_config) do |op|
|
|
1476
|
+
# raise op.results.message if op.error?
|
|
1477
|
+
# op_results = op.results
|
|
1478
|
+
# # Process the results.
|
|
1479
|
+
#
|
|
1480
|
+
# metadata = op.metadata
|
|
1481
|
+
# # Process the metadata.
|
|
1482
|
+
# end
|
|
1483
|
+
#
|
|
1484
|
+
# # Or use the return value to register a callback.
|
|
1485
|
+
# operation.on_done do |op|
|
|
1486
|
+
# raise op.results.message if op.error?
|
|
1487
|
+
# op_results = op.results
|
|
1488
|
+
# # Process the results.
|
|
1489
|
+
#
|
|
1490
|
+
# metadata = op.metadata
|
|
1491
|
+
# # Process the metadata.
|
|
1492
|
+
# end
|
|
1493
|
+
#
|
|
1494
|
+
# # Manually reload the operation.
|
|
1495
|
+
# operation.reload!
|
|
1496
|
+
#
|
|
1497
|
+
# # Or block until the operation completes, triggering callbacks on
|
|
1498
|
+
# # completion.
|
|
1499
|
+
# operation.wait_until_done!
|
|
1500
|
+
|
|
1501
|
+
def export_evaluated_examples \
|
|
1502
|
+
name,
|
|
1503
|
+
output_config,
|
|
1504
|
+
options: nil
|
|
1505
|
+
req = {
|
|
1506
|
+
name: name,
|
|
1507
|
+
output_config: output_config
|
|
1508
|
+
}.delete_if { |_, v| v.nil? }
|
|
1509
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ExportEvaluatedExamplesRequest)
|
|
1510
|
+
operation = Google::Gax::Operation.new(
|
|
1511
|
+
@export_evaluated_examples.call(req, options),
|
|
1512
|
+
@operations_client,
|
|
1513
|
+
Google::Protobuf::Empty,
|
|
1514
|
+
Google::Cloud::AutoML::V1beta1::OperationMetadata,
|
|
1515
|
+
call_options: options
|
|
1516
|
+
)
|
|
1517
|
+
operation.on_done { |operation| yield(operation) } if block_given?
|
|
1518
|
+
operation
|
|
1519
|
+
end
|
|
1520
|
+
|
|
1521
|
+
# Lists model evaluations.
|
|
1522
|
+
#
|
|
1523
|
+
# @param parent [String]
|
|
1524
|
+
# Resource name of the model to list the model evaluations for.
|
|
1525
|
+
# If modelId is set as "-", this will list model evaluations from across all
|
|
1526
|
+
# models of the parent location.
|
|
1527
|
+
# @param filter [String]
|
|
1528
|
+
# An expression for filtering the results of the request.
|
|
1529
|
+
#
|
|
1530
|
+
# * `annotation_spec_id` - for =, != or existence. See example below for
|
|
1531
|
+
# the last.
|
|
1532
|
+
#
|
|
1533
|
+
# Some examples of using the filter are:
|
|
1534
|
+
#
|
|
1535
|
+
# * `annotation_spec_id!=4` --> The model evaluation was done for
|
|
1536
|
+
# annotation spec with ID different than 4.
|
|
1537
|
+
# * `NOT annotation_spec_id:*` --> The model evaluation was done for
|
|
1538
|
+
# aggregate of all annotation specs.
|
|
1539
|
+
# @param page_size [Integer]
|
|
1540
|
+
# The maximum number of resources contained in the underlying API
|
|
1541
|
+
# response. If page streaming is performed per-resource, this
|
|
1542
|
+
# parameter does not affect the return value. If page streaming is
|
|
1543
|
+
# performed per-page, this determines the maximum number of
|
|
1544
|
+
# resources in a page.
|
|
1545
|
+
# @param options [Google::Gax::CallOptions]
|
|
1546
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1547
|
+
# retries, etc.
|
|
1548
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1549
|
+
# @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::ModelEvaluation>]
|
|
1550
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1551
|
+
# @return [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::ModelEvaluation>]
|
|
1552
|
+
# An enumerable of Google::Cloud::AutoML::V1beta1::ModelEvaluation instances.
|
|
1553
|
+
# See Google::Gax::PagedEnumerable documentation for other
|
|
1554
|
+
# operations such as per-page iteration or access to the response
|
|
1555
|
+
# object.
|
|
1556
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1557
|
+
# @example
|
|
1558
|
+
# require "google/cloud/automl"
|
|
1559
|
+
#
|
|
1560
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1561
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
|
|
1562
|
+
#
|
|
1563
|
+
# # Iterate over all results.
|
|
1564
|
+
# automl_client.list_model_evaluations(formatted_parent).each do |element|
|
|
1565
|
+
# # Process element.
|
|
1566
|
+
# end
|
|
1567
|
+
#
|
|
1568
|
+
# # Or iterate over results one page at a time.
|
|
1569
|
+
# automl_client.list_model_evaluations(formatted_parent).each_page do |page|
|
|
1570
|
+
# # Process each page at a time.
|
|
1571
|
+
# page.each do |element|
|
|
1572
|
+
# # Process element.
|
|
1573
|
+
# end
|
|
1574
|
+
# end
|
|
1575
|
+
|
|
1576
|
+
def list_model_evaluations \
|
|
1577
|
+
parent,
|
|
1578
|
+
filter: nil,
|
|
1579
|
+
page_size: nil,
|
|
1580
|
+
options: nil,
|
|
1581
|
+
&block
|
|
1582
|
+
req = {
|
|
1583
|
+
parent: parent,
|
|
1584
|
+
filter: filter,
|
|
1585
|
+
page_size: page_size
|
|
1586
|
+
}.delete_if { |_, v| v.nil? }
|
|
1587
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ListModelEvaluationsRequest)
|
|
1588
|
+
@list_model_evaluations.call(req, options, &block)
|
|
1589
|
+
end
|
|
1590
|
+
|
|
1591
|
+
# Gets an annotation spec.
|
|
1592
|
+
#
|
|
1593
|
+
# @param name [String]
|
|
1594
|
+
# The resource name of the annotation spec to retrieve.
|
|
1595
|
+
# @param options [Google::Gax::CallOptions]
|
|
1596
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1597
|
+
# retries, etc.
|
|
1598
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1599
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::AnnotationSpec]
|
|
1600
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1601
|
+
# @return [Google::Cloud::AutoML::V1beta1::AnnotationSpec]
|
|
1602
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1603
|
+
# @example
|
|
1604
|
+
# require "google/cloud/automl"
|
|
1605
|
+
#
|
|
1606
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1607
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.annotation_spec_path("[PROJECT]", "[LOCATION]", "[DATASET]", "[ANNOTATION_SPEC]")
|
|
1608
|
+
# response = automl_client.get_annotation_spec(formatted_name)
|
|
1609
|
+
|
|
1610
|
+
def get_annotation_spec \
|
|
1611
|
+
name,
|
|
1612
|
+
options: nil,
|
|
1613
|
+
&block
|
|
1614
|
+
req = {
|
|
1615
|
+
name: name
|
|
1616
|
+
}.delete_if { |_, v| v.nil? }
|
|
1617
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetAnnotationSpecRequest)
|
|
1618
|
+
@get_annotation_spec.call(req, options, &block)
|
|
1619
|
+
end
|
|
1620
|
+
|
|
1621
|
+
# Gets a table spec.
|
|
1622
|
+
#
|
|
1623
|
+
# @param name [String]
|
|
1624
|
+
# The resource name of the table spec to retrieve.
|
|
1625
|
+
# @param field_mask [Google::Protobuf::FieldMask | Hash]
|
|
1626
|
+
# Mask specifying which fields to read.
|
|
1627
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1628
|
+
# can also be provided.
|
|
1629
|
+
# @param options [Google::Gax::CallOptions]
|
|
1630
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1631
|
+
# retries, etc.
|
|
1632
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1633
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::TableSpec]
|
|
1634
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1635
|
+
# @return [Google::Cloud::AutoML::V1beta1::TableSpec]
|
|
1636
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1637
|
+
# @example
|
|
1638
|
+
# require "google/cloud/automl"
|
|
1639
|
+
#
|
|
1640
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1641
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.table_spec_path("[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]")
|
|
1642
|
+
# response = automl_client.get_table_spec(formatted_name)
|
|
1643
|
+
|
|
1644
|
+
def get_table_spec \
|
|
1645
|
+
name,
|
|
1646
|
+
field_mask: nil,
|
|
1647
|
+
options: nil,
|
|
1648
|
+
&block
|
|
1649
|
+
req = {
|
|
1650
|
+
name: name,
|
|
1651
|
+
field_mask: field_mask
|
|
1652
|
+
}.delete_if { |_, v| v.nil? }
|
|
1653
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetTableSpecRequest)
|
|
1654
|
+
@get_table_spec.call(req, options, &block)
|
|
1655
|
+
end
|
|
1656
|
+
|
|
1657
|
+
# Lists table specs in a dataset.
|
|
1658
|
+
#
|
|
1659
|
+
# @param parent [String]
|
|
1660
|
+
# The resource name of the dataset to list table specs from.
|
|
1661
|
+
# @param field_mask [Google::Protobuf::FieldMask | Hash]
|
|
1662
|
+
# Mask specifying which fields to read.
|
|
1663
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1664
|
+
# can also be provided.
|
|
1665
|
+
# @param filter [String]
|
|
1666
|
+
# Filter expression, see go/filtering.
|
|
1667
|
+
# @param page_size [Integer]
|
|
1668
|
+
# The maximum number of resources contained in the underlying API
|
|
1669
|
+
# response. If page streaming is performed per-resource, this
|
|
1670
|
+
# parameter does not affect the return value. If page streaming is
|
|
1671
|
+
# performed per-page, this determines the maximum number of
|
|
1672
|
+
# resources in a page.
|
|
1673
|
+
# @param options [Google::Gax::CallOptions]
|
|
1674
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1675
|
+
# retries, etc.
|
|
1676
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1677
|
+
# @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::TableSpec>]
|
|
1678
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1679
|
+
# @return [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::TableSpec>]
|
|
1680
|
+
# An enumerable of Google::Cloud::AutoML::V1beta1::TableSpec instances.
|
|
1681
|
+
# See Google::Gax::PagedEnumerable documentation for other
|
|
1682
|
+
# operations such as per-page iteration or access to the response
|
|
1683
|
+
# object.
|
|
1684
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1685
|
+
# @example
|
|
1686
|
+
# require "google/cloud/automl"
|
|
1687
|
+
#
|
|
1688
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1689
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
|
|
1690
|
+
#
|
|
1691
|
+
# # Iterate over all results.
|
|
1692
|
+
# automl_client.list_table_specs(formatted_parent).each do |element|
|
|
1693
|
+
# # Process element.
|
|
1694
|
+
# end
|
|
1695
|
+
#
|
|
1696
|
+
# # Or iterate over results one page at a time.
|
|
1697
|
+
# automl_client.list_table_specs(formatted_parent).each_page do |page|
|
|
1698
|
+
# # Process each page at a time.
|
|
1699
|
+
# page.each do |element|
|
|
1700
|
+
# # Process element.
|
|
1701
|
+
# end
|
|
1702
|
+
# end
|
|
1703
|
+
|
|
1704
|
+
def list_table_specs \
|
|
1705
|
+
parent,
|
|
1706
|
+
field_mask: nil,
|
|
1707
|
+
filter: nil,
|
|
1708
|
+
page_size: nil,
|
|
1709
|
+
options: nil,
|
|
1710
|
+
&block
|
|
1711
|
+
req = {
|
|
1712
|
+
parent: parent,
|
|
1713
|
+
field_mask: field_mask,
|
|
1714
|
+
filter: filter,
|
|
1715
|
+
page_size: page_size
|
|
1716
|
+
}.delete_if { |_, v| v.nil? }
|
|
1717
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ListTableSpecsRequest)
|
|
1718
|
+
@list_table_specs.call(req, options, &block)
|
|
1719
|
+
end
|
|
1720
|
+
|
|
1721
|
+
# Updates a table spec.
|
|
1722
|
+
#
|
|
1723
|
+
# @param table_spec [Google::Cloud::AutoML::V1beta1::TableSpec | Hash]
|
|
1724
|
+
# The table spec which replaces the resource on the server.
|
|
1725
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::TableSpec`
|
|
1726
|
+
# can also be provided.
|
|
1727
|
+
# @param update_mask [Google::Protobuf::FieldMask | Hash]
|
|
1728
|
+
# The update mask applies to the resource. For the `FieldMask` definition,
|
|
1729
|
+
# see
|
|
1730
|
+
#
|
|
1731
|
+
# https:
|
|
1732
|
+
# //developers.google.com/protocol-buffers
|
|
1733
|
+
# // /docs/reference/google.protobuf#fieldmask
|
|
1734
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1735
|
+
# can also be provided.
|
|
1736
|
+
# @param options [Google::Gax::CallOptions]
|
|
1737
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1738
|
+
# retries, etc.
|
|
1739
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1740
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::TableSpec]
|
|
1741
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1742
|
+
# @return [Google::Cloud::AutoML::V1beta1::TableSpec]
|
|
1743
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1744
|
+
# @example
|
|
1745
|
+
# require "google/cloud/automl"
|
|
1746
|
+
#
|
|
1747
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1748
|
+
#
|
|
1749
|
+
# # TODO: Initialize `table_spec`:
|
|
1750
|
+
# table_spec = {}
|
|
1751
|
+
# response = automl_client.update_table_spec(table_spec)
|
|
1752
|
+
|
|
1753
|
+
def update_table_spec \
|
|
1754
|
+
table_spec,
|
|
1755
|
+
update_mask: nil,
|
|
1756
|
+
options: nil,
|
|
1757
|
+
&block
|
|
1758
|
+
req = {
|
|
1759
|
+
table_spec: table_spec,
|
|
1760
|
+
update_mask: update_mask
|
|
1761
|
+
}.delete_if { |_, v| v.nil? }
|
|
1762
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::UpdateTableSpecRequest)
|
|
1763
|
+
@update_table_spec.call(req, options, &block)
|
|
1764
|
+
end
|
|
1765
|
+
|
|
1766
|
+
# Gets a column spec.
|
|
1767
|
+
#
|
|
1768
|
+
# @param name [String]
|
|
1769
|
+
# The resource name of the column spec to retrieve.
|
|
1770
|
+
# @param field_mask [Google::Protobuf::FieldMask | Hash]
|
|
1771
|
+
# Mask specifying which fields to read.
|
|
1772
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1773
|
+
# can also be provided.
|
|
1774
|
+
# @param options [Google::Gax::CallOptions]
|
|
1775
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1776
|
+
# retries, etc.
|
|
1777
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1778
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::ColumnSpec]
|
|
1779
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1780
|
+
# @return [Google::Cloud::AutoML::V1beta1::ColumnSpec]
|
|
1781
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1782
|
+
# @example
|
|
1783
|
+
# require "google/cloud/automl"
|
|
1784
|
+
#
|
|
1785
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1786
|
+
# formatted_name = Google::Cloud::AutoML::V1beta1::AutoMLClient.column_spec_path("[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]", "[COLUMN_SPEC]")
|
|
1787
|
+
# response = automl_client.get_column_spec(formatted_name)
|
|
1788
|
+
|
|
1789
|
+
def get_column_spec \
|
|
1790
|
+
name,
|
|
1791
|
+
field_mask: nil,
|
|
1792
|
+
options: nil,
|
|
1793
|
+
&block
|
|
1794
|
+
req = {
|
|
1795
|
+
name: name,
|
|
1796
|
+
field_mask: field_mask
|
|
1797
|
+
}.delete_if { |_, v| v.nil? }
|
|
1798
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::GetColumnSpecRequest)
|
|
1799
|
+
@get_column_spec.call(req, options, &block)
|
|
1800
|
+
end
|
|
1801
|
+
|
|
1802
|
+
# Lists column specs in a table spec.
|
|
1803
|
+
#
|
|
1804
|
+
# @param parent [String]
|
|
1805
|
+
# The resource name of the table spec to list column specs from.
|
|
1806
|
+
# @param field_mask [Google::Protobuf::FieldMask | Hash]
|
|
1807
|
+
# Mask specifying which fields to read.
|
|
1808
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1809
|
+
# can also be provided.
|
|
1810
|
+
# @param filter [String]
|
|
1811
|
+
# Filter expression, see go/filtering.
|
|
1812
|
+
# @param page_size [Integer]
|
|
1813
|
+
# The maximum number of resources contained in the underlying API
|
|
1814
|
+
# response. If page streaming is performed per-resource, this
|
|
1815
|
+
# parameter does not affect the return value. If page streaming is
|
|
1816
|
+
# performed per-page, this determines the maximum number of
|
|
1817
|
+
# resources in a page.
|
|
1818
|
+
# @param options [Google::Gax::CallOptions]
|
|
1819
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1820
|
+
# retries, etc.
|
|
1821
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1822
|
+
# @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::ColumnSpec>]
|
|
1823
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1824
|
+
# @return [Google::Gax::PagedEnumerable<Google::Cloud::AutoML::V1beta1::ColumnSpec>]
|
|
1825
|
+
# An enumerable of Google::Cloud::AutoML::V1beta1::ColumnSpec instances.
|
|
1826
|
+
# See Google::Gax::PagedEnumerable documentation for other
|
|
1827
|
+
# operations such as per-page iteration or access to the response
|
|
1828
|
+
# object.
|
|
1829
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1830
|
+
# @example
|
|
1831
|
+
# require "google/cloud/automl"
|
|
1832
|
+
#
|
|
1833
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1834
|
+
# formatted_parent = Google::Cloud::AutoML::V1beta1::AutoMLClient.table_spec_path("[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]")
|
|
1835
|
+
#
|
|
1836
|
+
# # Iterate over all results.
|
|
1837
|
+
# automl_client.list_column_specs(formatted_parent).each do |element|
|
|
1838
|
+
# # Process element.
|
|
1839
|
+
# end
|
|
1840
|
+
#
|
|
1841
|
+
# # Or iterate over results one page at a time.
|
|
1842
|
+
# automl_client.list_column_specs(formatted_parent).each_page do |page|
|
|
1843
|
+
# # Process each page at a time.
|
|
1844
|
+
# page.each do |element|
|
|
1845
|
+
# # Process element.
|
|
1846
|
+
# end
|
|
1847
|
+
# end
|
|
1848
|
+
|
|
1849
|
+
def list_column_specs \
|
|
1850
|
+
parent,
|
|
1851
|
+
field_mask: nil,
|
|
1852
|
+
filter: nil,
|
|
1853
|
+
page_size: nil,
|
|
1854
|
+
options: nil,
|
|
1855
|
+
&block
|
|
1856
|
+
req = {
|
|
1857
|
+
parent: parent,
|
|
1858
|
+
field_mask: field_mask,
|
|
1859
|
+
filter: filter,
|
|
1860
|
+
page_size: page_size
|
|
1861
|
+
}.delete_if { |_, v| v.nil? }
|
|
1862
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::ListColumnSpecsRequest)
|
|
1863
|
+
@list_column_specs.call(req, options, &block)
|
|
1864
|
+
end
|
|
1865
|
+
|
|
1866
|
+
# Updates a column spec.
|
|
1867
|
+
#
|
|
1868
|
+
# @param column_spec [Google::Cloud::AutoML::V1beta1::ColumnSpec | Hash]
|
|
1869
|
+
# The column spec which replaces the resource on the server.
|
|
1870
|
+
# A hash of the same form as `Google::Cloud::AutoML::V1beta1::ColumnSpec`
|
|
1871
|
+
# can also be provided.
|
|
1872
|
+
# @param update_mask [Google::Protobuf::FieldMask | Hash]
|
|
1873
|
+
# The update mask applies to the resource. For the `FieldMask` definition,
|
|
1874
|
+
# see
|
|
1875
|
+
#
|
|
1876
|
+
# https:
|
|
1877
|
+
# //developers.google.com/protocol-buffers
|
|
1878
|
+
# // /docs/reference/google.protobuf#fieldmask
|
|
1879
|
+
# A hash of the same form as `Google::Protobuf::FieldMask`
|
|
1880
|
+
# can also be provided.
|
|
1881
|
+
# @param options [Google::Gax::CallOptions]
|
|
1882
|
+
# Overrides the default settings for this call, e.g, timeout,
|
|
1883
|
+
# retries, etc.
|
|
1884
|
+
# @yield [result, operation] Access the result along with the RPC operation
|
|
1885
|
+
# @yieldparam result [Google::Cloud::AutoML::V1beta1::ColumnSpec]
|
|
1886
|
+
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
|
1887
|
+
# @return [Google::Cloud::AutoML::V1beta1::ColumnSpec]
|
|
1888
|
+
# @raise [Google::Gax::GaxError] if the RPC is aborted.
|
|
1889
|
+
# @example
|
|
1890
|
+
# require "google/cloud/automl"
|
|
1891
|
+
#
|
|
1892
|
+
# automl_client = Google::Cloud::AutoML::AutoML.new(version: :v1beta1)
|
|
1893
|
+
#
|
|
1894
|
+
# # TODO: Initialize `column_spec`:
|
|
1895
|
+
# column_spec = {}
|
|
1896
|
+
# response = automl_client.update_column_spec(column_spec)
|
|
1897
|
+
|
|
1898
|
+
def update_column_spec \
|
|
1899
|
+
column_spec,
|
|
1900
|
+
update_mask: nil,
|
|
1901
|
+
options: nil,
|
|
1902
|
+
&block
|
|
1903
|
+
req = {
|
|
1904
|
+
column_spec: column_spec,
|
|
1905
|
+
update_mask: update_mask
|
|
1906
|
+
}.delete_if { |_, v| v.nil? }
|
|
1907
|
+
req = Google::Gax::to_proto(req, Google::Cloud::AutoML::V1beta1::UpdateColumnSpecRequest)
|
|
1908
|
+
@update_column_spec.call(req, options, &block)
|
|
1909
|
+
end
|
|
1910
|
+
end
|
|
1911
|
+
end
|
|
1912
|
+
end
|
|
1913
|
+
end
|
|
1914
|
+
end
|