google-cloud-automl-v1beta1 0.2.5 → 0.4.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6cee0313f4dcb6530d9cbd2c3b18476e3d520f64631bc11694f96f6d0dbc6d2d
4
- data.tar.gz: 6f9ee9272a44dc6f021eafddd22af83beb6d8b7294a7f47e26f8f5db0df7fd34
3
+ metadata.gz: aefaf8e84f61910a27258d6b6fe0f03611220066aed8f55b6b4a500ffe00051e
4
+ data.tar.gz: ad6855a50d698ddc624d90717b674f63055c6a9a6c99b22895a45541c0d7852c
5
5
  SHA512:
6
- metadata.gz: 9b3c74706729dbed461e871fbab8b6609db3dc526c17a6e46d91bbb94b3f51ca791ab74eff1e46c25b3b0ead452b7b1a010784e8910030bed54d46589118b76a
7
- data.tar.gz: d61f58dcae3788b992ab808f5cf8f9b4bd023308cd34b4d801c6b723dff0ce06a638195809992e23ffb36b310d96ded044cec0857353fa57a76f27048e92d002
6
+ metadata.gz: b76e8ded35fed7f549bad8205483b618967f45f1b63d96c03d215d54d03c8033ff98715353a585f24cac054ba7539cc0d8fb095589f0a42c7ad763a67b156cde
7
+ data.tar.gz: fea129c5564c3644e65e25e78f3a8945ef85e6821af38a2b0afb627293f93204d90c0ab57b1c53c3fb9b292d39062cda107ee2db9d51948af7aea3e4e1a4fbbd
data/README.md CHANGED
@@ -6,6 +6,12 @@ AutoML makes the power of machine learning available to you even if you have lim
6
6
 
7
7
  https://github.com/googleapis/google-cloud-ruby
8
8
 
9
+ This gem is a _versioned_ client. It provides basic client classes for a
10
+ specific version of the Cloud AutoML V1beta1 API. Most users should consider using
11
+ the main client gem,
12
+ [google-cloud-automl](https://rubygems.org/gems/google-cloud-automl).
13
+ See the section below titled *Which client should I use?* for more information.
14
+
9
15
  ## Installation
10
16
 
11
17
  ```
@@ -73,3 +79,61 @@ in security maintenance, and not end of life. Currently, this means Ruby 2.4
73
79
  and later. Older versions of Ruby _may_ still work, but are unsupported and not
74
80
  recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
75
81
  about the Ruby support schedule.
82
+
83
+ ## Which client should I use?
84
+
85
+ Most modern Ruby client libraries for Google APIs come in two flavors: the main
86
+ client library with a name such as `google-cloud-automl`,
87
+ and lower-level _versioned_ client libraries with names such as
88
+ `google-cloud-automl-v1beta1`.
89
+ _In most cases, you should install the main client._
90
+
91
+ ### What's the difference between the main client and a versioned client?
92
+
93
+ A _versioned client_ provides a basic set of data types and client classes for
94
+ a _single version_ of a specific service. (That is, for a service with multiple
95
+ versions, there might be a separate versioned client for each service version.)
96
+ Most versioned clients are written and maintained by a code generator.
97
+
98
+ The _main client_ is designed to provide you with the _recommended_ client
99
+ interfaces for the service. There will be only one main client for any given
100
+ service, even a service with multiple versions. The main client includes
101
+ factory methods for constructing the client objects we recommend for most
102
+ users. In some cases, those will be classes provided by an underlying versioned
103
+ client; in other cases, they will be handwritten higher-level client objects
104
+ with additional capabilities, convenience methods, or best practices built in.
105
+ Generally, the main client will default to a recommended service version,
106
+ although in some cases you can override this if you need to talk to a specific
107
+ service version.
108
+
109
+ ### Why would I want to use the main client?
110
+
111
+ We recommend that most users install the main client gem for a service. You can
112
+ identify this gem as the one _without_ a version in its name, e.g.
113
+ `google-cloud-automl`.
114
+ The main client is recommended because it will embody the best practices for
115
+ accessing the service, and may also provide more convenient interfaces or
116
+ tighter integration into frameworks and third-party libraries. In addition, the
117
+ documentation and samples published by Google will generally demonstrate use of
118
+ the main client.
119
+
120
+ ### Why would I want to use a versioned client?
121
+
122
+ You can use a versioned client if you are content with a possibly lower-level
123
+ class interface, you explicitly want to avoid features provided by the main
124
+ client, or you want to access a specific service version not be covered by the
125
+ main client. You can identify versioned client gems because the service version
126
+ is part of the name, e.g. `google-cloud-automl-v1beta1`.
127
+
128
+ ### What about the google-apis-<name> clients?
129
+
130
+ Client library gems with names that begin with `google-apis-` are based on an
131
+ older code generation technology. They talk to a REST/JSON backend (whereas
132
+ most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
133
+ not offer the same performance, features, and ease of use provided by more
134
+ modern clients.
135
+
136
+ The `google-apis-` clients have wide coverage across Google services, so you
137
+ might need to use one if there is no modern client available for the service.
138
+ However, if a modern client is available, we generally recommend it over the
139
+ older `google-apis-` clients.
@@ -34,3 +34,6 @@ module Google
34
34
  end
35
35
  end
36
36
  end
37
+
38
+ helper_path = ::File.join __dir__, "v1beta1", "_helpers.rb"
39
+ require "google/cloud/automl/v1beta1/_helpers" if ::File.file? helper_path
@@ -0,0 +1,26 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+
18
+ module Google
19
+ module Cloud
20
+ module Automl
21
+ module V1beta1
22
+ VERSION = ::Google::Cloud::AutoML::V1beta1::VERSION
23
+ end
24
+ end
25
+ end
26
+ end
@@ -259,7 +259,13 @@ module Google
259
259
 
260
260
  # Create credentials
261
261
  credentials = @config.credentials
262
- credentials ||= Credentials.default scope: @config.scope
262
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
263
+ # but only if the default endpoint does not have a region prefix.
264
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
265
+ @config.endpoint == Client.configure.endpoint &&
266
+ !@config.endpoint.split(".").first.include?("-")
267
+ credentials ||= Credentials.default scope: @config.scope,
268
+ enable_self_signed_jwt: enable_self_signed_jwt
263
269
  if credentials.is_a?(String) || credentials.is_a?(Hash)
264
270
  credentials = Credentials.new credentials, scope: @config.scope
265
271
  end
@@ -334,7 +340,7 @@ module Google
334
340
  # Set x-goog-api-client and x-goog-user-project headers
335
341
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
336
342
  lib_name: @config.lib_name, lib_version: @config.lib_version,
337
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
343
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
338
344
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
339
345
 
340
346
  header_params = {
@@ -400,7 +406,7 @@ module Google
400
406
  # Set x-goog-api-client and x-goog-user-project headers
401
407
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
402
408
  lib_name: @config.lib_name, lib_version: @config.lib_version,
403
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
409
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
404
410
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
405
411
 
406
412
  header_params = {
@@ -482,7 +488,7 @@ module Google
482
488
  # Set x-goog-api-client and x-goog-user-project headers
483
489
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
484
490
  lib_name: @config.lib_name, lib_version: @config.lib_version,
485
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
491
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
486
492
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
487
493
 
488
494
  header_params = {
@@ -551,7 +557,7 @@ module Google
551
557
  # Set x-goog-api-client and x-goog-user-project headers
552
558
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
553
559
  lib_name: @config.lib_name, lib_version: @config.lib_version,
554
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
560
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
555
561
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
556
562
 
557
563
  header_params = {
@@ -621,7 +627,7 @@ module Google
621
627
  # Set x-goog-api-client and x-goog-user-project headers
622
628
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
623
629
  lib_name: @config.lib_name, lib_version: @config.lib_version,
624
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
630
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
625
631
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
626
632
 
627
633
  header_params = {
@@ -700,7 +706,7 @@ module Google
700
706
  # Set x-goog-api-client and x-goog-user-project headers
701
707
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
702
708
  lib_name: @config.lib_name, lib_version: @config.lib_version,
703
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
709
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
704
710
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
705
711
 
706
712
  header_params = {
@@ -771,7 +777,7 @@ module Google
771
777
  # Set x-goog-api-client and x-goog-user-project headers
772
778
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
773
779
  lib_name: @config.lib_name, lib_version: @config.lib_version,
774
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
780
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
775
781
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
776
782
 
777
783
  header_params = {
@@ -838,7 +844,7 @@ module Google
838
844
  # Set x-goog-api-client and x-goog-user-project headers
839
845
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
840
846
  lib_name: @config.lib_name, lib_version: @config.lib_version,
841
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
847
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
842
848
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
843
849
 
844
850
  header_params = {
@@ -906,7 +912,7 @@ module Google
906
912
  # Set x-goog-api-client and x-goog-user-project headers
907
913
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
908
914
  lib_name: @config.lib_name, lib_version: @config.lib_version,
909
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
915
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
910
916
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
911
917
 
912
918
  header_params = {
@@ -984,7 +990,7 @@ module Google
984
990
  # Set x-goog-api-client and x-goog-user-project headers
985
991
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
986
992
  lib_name: @config.lib_name, lib_version: @config.lib_version,
987
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
993
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
988
994
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
989
995
 
990
996
  header_params = {
@@ -1053,7 +1059,7 @@ module Google
1053
1059
  # Set x-goog-api-client and x-goog-user-project headers
1054
1060
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1055
1061
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1056
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1062
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1057
1063
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1058
1064
 
1059
1065
  header_params = {
@@ -1121,7 +1127,7 @@ module Google
1121
1127
  # Set x-goog-api-client and x-goog-user-project headers
1122
1128
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1123
1129
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1124
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1130
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1125
1131
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1126
1132
 
1127
1133
  header_params = {
@@ -1199,7 +1205,7 @@ module Google
1199
1205
  # Set x-goog-api-client and x-goog-user-project headers
1200
1206
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1201
1207
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1202
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1208
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1203
1209
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1204
1210
 
1205
1211
  header_params = {
@@ -1268,7 +1274,7 @@ module Google
1268
1274
  # Set x-goog-api-client and x-goog-user-project headers
1269
1275
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1270
1276
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1271
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1277
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1272
1278
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1273
1279
 
1274
1280
  header_params = {
@@ -1340,7 +1346,7 @@ module Google
1340
1346
  # Set x-goog-api-client and x-goog-user-project headers
1341
1347
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1342
1348
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1343
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1349
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1344
1350
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1345
1351
 
1346
1352
  header_params = {
@@ -1407,7 +1413,7 @@ module Google
1407
1413
  # Set x-goog-api-client and x-goog-user-project headers
1408
1414
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1409
1415
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1410
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1416
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1411
1417
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1412
1418
 
1413
1419
  header_params = {
@@ -1490,7 +1496,7 @@ module Google
1490
1496
  # Set x-goog-api-client and x-goog-user-project headers
1491
1497
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1492
1498
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1493
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1499
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1494
1500
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1495
1501
 
1496
1502
  header_params = {
@@ -1561,7 +1567,7 @@ module Google
1561
1567
  # Set x-goog-api-client and x-goog-user-project headers
1562
1568
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1563
1569
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1564
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1570
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1565
1571
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1566
1572
 
1567
1573
  header_params = {
@@ -1643,7 +1649,7 @@ module Google
1643
1649
  # Set x-goog-api-client and x-goog-user-project headers
1644
1650
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1645
1651
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1646
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1652
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1647
1653
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1648
1654
 
1649
1655
  header_params = {
@@ -1716,7 +1722,7 @@ module Google
1716
1722
  # Set x-goog-api-client and x-goog-user-project headers
1717
1723
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1718
1724
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1719
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1725
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1720
1726
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1721
1727
 
1722
1728
  header_params = {
@@ -1792,7 +1798,7 @@ module Google
1792
1798
  # Set x-goog-api-client and x-goog-user-project headers
1793
1799
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1794
1800
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1795
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1801
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1796
1802
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1797
1803
 
1798
1804
  header_params = {
@@ -1875,7 +1881,7 @@ module Google
1875
1881
  # Set x-goog-api-client and x-goog-user-project headers
1876
1882
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1877
1883
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1878
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1884
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1879
1885
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1880
1886
 
1881
1887
  header_params = {
@@ -1942,7 +1948,7 @@ module Google
1942
1948
  # Set x-goog-api-client and x-goog-user-project headers
1943
1949
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1944
1950
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1945
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
1951
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
1946
1952
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1947
1953
 
1948
1954
  header_params = {
@@ -2029,7 +2035,7 @@ module Google
2029
2035
  # Set x-goog-api-client and x-goog-user-project headers
2030
2036
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2031
2037
  lib_name: @config.lib_name, lib_version: @config.lib_version,
2032
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
2038
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
2033
2039
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2034
2040
 
2035
2041
  header_params = {
@@ -2138,7 +2144,7 @@ module Google
2138
2144
 
2139
2145
  config_attr :endpoint, "automl.googleapis.com", ::String
2140
2146
  config_attr :credentials, nil do |value|
2141
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
2147
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
2142
2148
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
2143
2149
  allowed.any? { |klass| klass === value }
2144
2150
  end
@@ -2178,7 +2184,7 @@ module Google
2178
2184
  # Each configuration object is of type `Gapic::Config::Method` and includes
2179
2185
  # the following configuration fields:
2180
2186
  #
2181
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
2187
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
2182
2188
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
2183
2189
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
2184
2190
  # include the following keys:
@@ -103,8 +103,13 @@ module Google
103
103
  # Lists operations that match the specified filter in the request. If the
104
104
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
105
105
  #
106
- # NOTE: the `name` binding below allows API services to override the binding
107
- # to use different resource name schemes, such as `users/*/operations`.
106
+ # NOTE: the `name` binding allows API services to override the binding
107
+ # to use different resource name schemes, such as `users/*/operations`. To
108
+ # override the binding, API services can add a binding such as
109
+ # `"/v1/{name=users/*}/operations"` to their service configuration.
110
+ # For backwards compatibility, the default name includes the operations
111
+ # collection id, however overriding users must ensure the name binding
112
+ # is the parent resource, without the operations collection id.
108
113
  #
109
114
  # @overload list_operations(request, options = nil)
110
115
  # Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
122
127
  # the default parameter values, pass an empty Hash as a request object (see above).
123
128
  #
124
129
  # @param name [::String]
125
- # The name of the operation collection.
130
+ # The name of the operation's parent resource.
126
131
  # @param filter [::String]
127
132
  # The standard list filter.
128
133
  # @param page_size [::Integer]
@@ -152,7 +157,7 @@ module Google
152
157
  # Set x-goog-api-client and x-goog-user-project headers
153
158
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
154
159
  lib_name: @config.lib_name, lib_version: @config.lib_version,
155
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
160
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
156
161
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
157
162
 
158
163
  header_params = {
@@ -222,7 +227,7 @@ module Google
222
227
  # Set x-goog-api-client and x-goog-user-project headers
223
228
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
224
229
  lib_name: @config.lib_name, lib_version: @config.lib_version,
225
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
230
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
226
231
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
227
232
 
228
233
  header_params = {
@@ -292,7 +297,7 @@ module Google
292
297
  # Set x-goog-api-client and x-goog-user-project headers
293
298
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
294
299
  lib_name: @config.lib_name, lib_version: @config.lib_version,
295
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
300
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
296
301
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
297
302
 
298
303
  header_params = {
@@ -367,7 +372,7 @@ module Google
367
372
  # Set x-goog-api-client and x-goog-user-project headers
368
373
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
369
374
  lib_name: @config.lib_name, lib_version: @config.lib_version,
370
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
375
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
371
376
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
372
377
 
373
378
  header_params = {
@@ -390,6 +395,79 @@ module Google
390
395
  raise ::Google::Cloud::Error.from_error(e)
391
396
  end
392
397
 
398
+ ##
399
+ # Waits for the specified long-running operation until it is done or reaches
400
+ # at most a specified timeout, returning the latest state. If the operation
401
+ # is already done, the latest state is immediately returned. If the timeout
402
+ # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
403
+ # timeout is used. If the server does not support this method, it returns
404
+ # `google.rpc.Code.UNIMPLEMENTED`.
405
+ # Note that this method is on a best-effort basis. It may return the latest
406
+ # state before the specified timeout (including immediately), meaning even an
407
+ # immediate response is no guarantee that the operation is done.
408
+ #
409
+ # @overload wait_operation(request, options = nil)
410
+ # Pass arguments to `wait_operation` via a request object, either of type
411
+ # {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
412
+ #
413
+ # @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
414
+ # A request object representing the call parameters. Required. To specify no
415
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
416
+ # @param options [::Gapic::CallOptions, ::Hash]
417
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
418
+ #
419
+ # @overload wait_operation(name: nil, timeout: nil)
420
+ # Pass arguments to `wait_operation` via keyword arguments. Note that at
421
+ # least one keyword argument is required. To specify no parameters, or to keep all
422
+ # the default parameter values, pass an empty Hash as a request object (see above).
423
+ #
424
+ # @param name [::String]
425
+ # The name of the operation resource to wait on.
426
+ # @param timeout [::Google::Protobuf::Duration, ::Hash]
427
+ # The maximum duration to wait before timing out. If left blank, the wait
428
+ # will be at most the time permitted by the underlying HTTP/RPC protocol.
429
+ # If RPC context deadline is also specified, the shorter one will be used.
430
+ #
431
+ # @yield [response, operation] Access the result along with the RPC operation
432
+ # @yieldparam response [::Gapic::Operation]
433
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
434
+ #
435
+ # @return [::Gapic::Operation]
436
+ #
437
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
438
+ #
439
+ def wait_operation request, options = nil
440
+ raise ::ArgumentError, "request must be provided" if request.nil?
441
+
442
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
443
+
444
+ # Converts hash and nil to an options object
445
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
446
+
447
+ # Customize the options with defaults
448
+ metadata = @config.rpcs.wait_operation.metadata.to_h
449
+
450
+ # Set x-goog-api-client and x-goog-user-project headers
451
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
452
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
453
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
454
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
455
+
456
+ options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
457
+ metadata: metadata,
458
+ retry_policy: @config.rpcs.wait_operation.retry_policy
459
+ options.apply_defaults metadata: @config.metadata,
460
+ retry_policy: @config.retry_policy
461
+
462
+ @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
463
+ response = ::Gapic::Operation.new response, @operations_client, options: options
464
+ yield response, operation if block_given?
465
+ return response
466
+ end
467
+ rescue ::GRPC::BadStatus => e
468
+ raise ::Google::Cloud::Error.from_error(e)
469
+ end
470
+
393
471
  ##
394
472
  # Configuration class for the Operations API.
395
473
  #
@@ -475,7 +553,7 @@ module Google
475
553
 
476
554
  config_attr :endpoint, "automl.googleapis.com", ::String
477
555
  config_attr :credentials, nil do |value|
478
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
556
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
479
557
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
480
558
  allowed.any? { |klass| klass === value }
481
559
  end
@@ -515,7 +593,7 @@ module Google
515
593
  # Each configuration object is of type `Gapic::Config::Method` and includes
516
594
  # the following configuration fields:
517
595
  #
518
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
596
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
519
597
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
520
598
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
521
599
  # include the following keys:
@@ -546,6 +624,11 @@ module Google
546
624
  # @return [::Gapic::Config::Method]
547
625
  #
548
626
  attr_reader :cancel_operation
627
+ ##
628
+ # RPC-specific configuration for `wait_operation`
629
+ # @return [::Gapic::Config::Method]
630
+ #
631
+ attr_reader :wait_operation
549
632
 
550
633
  # @private
551
634
  def initialize parent_rpcs = nil
@@ -557,6 +640,8 @@ module Google
557
640
  @delete_operation = ::Gapic::Config::Method.new delete_operation_config
558
641
  cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
559
642
  @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
643
+ wait_operation_config = parent_rpcs&.wait_operation if parent_rpcs&.respond_to? :wait_operation
644
+ @wait_operation = ::Gapic::Config::Method.new wait_operation_config
560
645
 
561
646
  yield self if block_given?
562
647
  end
@@ -133,7 +133,13 @@ module Google
133
133
 
134
134
  # Create credentials
135
135
  credentials = @config.credentials
136
- credentials ||= Credentials.default scope: @config.scope
136
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
137
+ # but only if the default endpoint does not have a region prefix.
138
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
139
+ @config.endpoint == Client.configure.endpoint &&
140
+ !@config.endpoint.split(".").first.include?("-")
141
+ credentials ||= Credentials.default scope: @config.scope,
142
+ enable_self_signed_jwt: enable_self_signed_jwt
137
143
  if credentials.is_a?(String) || credentials.is_a?(Hash)
138
144
  credentials = Credentials.new credentials, scope: @config.scope
139
145
  end
@@ -248,7 +254,7 @@ module Google
248
254
  # Set x-goog-api-client and x-goog-user-project headers
249
255
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
250
256
  lib_name: @config.lib_name, lib_version: @config.lib_version,
251
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
257
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
252
258
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
253
259
 
254
260
  header_params = {
@@ -401,7 +407,7 @@ module Google
401
407
  # Set x-goog-api-client and x-goog-user-project headers
402
408
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
403
409
  lib_name: @config.lib_name, lib_version: @config.lib_version,
404
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
410
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
405
411
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
406
412
 
407
413
  header_params = {
@@ -510,7 +516,7 @@ module Google
510
516
 
511
517
  config_attr :endpoint, "automl.googleapis.com", ::String
512
518
  config_attr :credentials, nil do |value|
513
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
519
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
514
520
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
515
521
  allowed.any? { |klass| klass === value }
516
522
  end
@@ -550,7 +556,7 @@ module Google
550
556
  # Each configuration object is of type `Gapic::Config::Method` and includes
551
557
  # the following configuration fields:
552
558
  #
553
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
559
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
554
560
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
555
561
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
556
562
  # include the following keys:
@@ -103,8 +103,13 @@ module Google
103
103
  # Lists operations that match the specified filter in the request. If the
104
104
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
105
105
  #
106
- # NOTE: the `name` binding below allows API services to override the binding
107
- # to use different resource name schemes, such as `users/*/operations`.
106
+ # NOTE: the `name` binding allows API services to override the binding
107
+ # to use different resource name schemes, such as `users/*/operations`. To
108
+ # override the binding, API services can add a binding such as
109
+ # `"/v1/{name=users/*}/operations"` to their service configuration.
110
+ # For backwards compatibility, the default name includes the operations
111
+ # collection id, however overriding users must ensure the name binding
112
+ # is the parent resource, without the operations collection id.
108
113
  #
109
114
  # @overload list_operations(request, options = nil)
110
115
  # Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
122
127
  # the default parameter values, pass an empty Hash as a request object (see above).
123
128
  #
124
129
  # @param name [::String]
125
- # The name of the operation collection.
130
+ # The name of the operation's parent resource.
126
131
  # @param filter [::String]
127
132
  # The standard list filter.
128
133
  # @param page_size [::Integer]
@@ -152,7 +157,7 @@ module Google
152
157
  # Set x-goog-api-client and x-goog-user-project headers
153
158
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
154
159
  lib_name: @config.lib_name, lib_version: @config.lib_version,
155
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
160
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
156
161
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
157
162
 
158
163
  header_params = {
@@ -222,7 +227,7 @@ module Google
222
227
  # Set x-goog-api-client and x-goog-user-project headers
223
228
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
224
229
  lib_name: @config.lib_name, lib_version: @config.lib_version,
225
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
230
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
226
231
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
227
232
 
228
233
  header_params = {
@@ -292,7 +297,7 @@ module Google
292
297
  # Set x-goog-api-client and x-goog-user-project headers
293
298
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
294
299
  lib_name: @config.lib_name, lib_version: @config.lib_version,
295
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
300
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
296
301
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
297
302
 
298
303
  header_params = {
@@ -367,7 +372,7 @@ module Google
367
372
  # Set x-goog-api-client and x-goog-user-project headers
368
373
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
369
374
  lib_name: @config.lib_name, lib_version: @config.lib_version,
370
- gapic_version: ::Google::Cloud::Automl::V1beta1::VERSION
375
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
371
376
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
372
377
 
373
378
  header_params = {
@@ -390,6 +395,79 @@ module Google
390
395
  raise ::Google::Cloud::Error.from_error(e)
391
396
  end
392
397
 
398
+ ##
399
+ # Waits for the specified long-running operation until it is done or reaches
400
+ # at most a specified timeout, returning the latest state. If the operation
401
+ # is already done, the latest state is immediately returned. If the timeout
402
+ # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
403
+ # timeout is used. If the server does not support this method, it returns
404
+ # `google.rpc.Code.UNIMPLEMENTED`.
405
+ # Note that this method is on a best-effort basis. It may return the latest
406
+ # state before the specified timeout (including immediately), meaning even an
407
+ # immediate response is no guarantee that the operation is done.
408
+ #
409
+ # @overload wait_operation(request, options = nil)
410
+ # Pass arguments to `wait_operation` via a request object, either of type
411
+ # {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
412
+ #
413
+ # @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
414
+ # A request object representing the call parameters. Required. To specify no
415
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
416
+ # @param options [::Gapic::CallOptions, ::Hash]
417
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
418
+ #
419
+ # @overload wait_operation(name: nil, timeout: nil)
420
+ # Pass arguments to `wait_operation` via keyword arguments. Note that at
421
+ # least one keyword argument is required. To specify no parameters, or to keep all
422
+ # the default parameter values, pass an empty Hash as a request object (see above).
423
+ #
424
+ # @param name [::String]
425
+ # The name of the operation resource to wait on.
426
+ # @param timeout [::Google::Protobuf::Duration, ::Hash]
427
+ # The maximum duration to wait before timing out. If left blank, the wait
428
+ # will be at most the time permitted by the underlying HTTP/RPC protocol.
429
+ # If RPC context deadline is also specified, the shorter one will be used.
430
+ #
431
+ # @yield [response, operation] Access the result along with the RPC operation
432
+ # @yieldparam response [::Gapic::Operation]
433
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
434
+ #
435
+ # @return [::Gapic::Operation]
436
+ #
437
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
438
+ #
439
+ def wait_operation request, options = nil
440
+ raise ::ArgumentError, "request must be provided" if request.nil?
441
+
442
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
443
+
444
+ # Converts hash and nil to an options object
445
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
446
+
447
+ # Customize the options with defaults
448
+ metadata = @config.rpcs.wait_operation.metadata.to_h
449
+
450
+ # Set x-goog-api-client and x-goog-user-project headers
451
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
452
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
453
+ gapic_version: ::Google::Cloud::AutoML::V1beta1::VERSION
454
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
455
+
456
+ options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
457
+ metadata: metadata,
458
+ retry_policy: @config.rpcs.wait_operation.retry_policy
459
+ options.apply_defaults metadata: @config.metadata,
460
+ retry_policy: @config.retry_policy
461
+
462
+ @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
463
+ response = ::Gapic::Operation.new response, @operations_client, options: options
464
+ yield response, operation if block_given?
465
+ return response
466
+ end
467
+ rescue ::GRPC::BadStatus => e
468
+ raise ::Google::Cloud::Error.from_error(e)
469
+ end
470
+
393
471
  ##
394
472
  # Configuration class for the Operations API.
395
473
  #
@@ -475,7 +553,7 @@ module Google
475
553
 
476
554
  config_attr :endpoint, "automl.googleapis.com", ::String
477
555
  config_attr :credentials, nil do |value|
478
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
556
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
479
557
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
480
558
  allowed.any? { |klass| klass === value }
481
559
  end
@@ -515,7 +593,7 @@ module Google
515
593
  # Each configuration object is of type `Gapic::Config::Method` and includes
516
594
  # the following configuration fields:
517
595
  #
518
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
596
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
519
597
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
520
598
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
521
599
  # include the following keys:
@@ -546,6 +624,11 @@ module Google
546
624
  # @return [::Gapic::Config::Method]
547
625
  #
548
626
  attr_reader :cancel_operation
627
+ ##
628
+ # RPC-specific configuration for `wait_operation`
629
+ # @return [::Gapic::Config::Method]
630
+ #
631
+ attr_reader :wait_operation
549
632
 
550
633
  # @private
551
634
  def initialize parent_rpcs = nil
@@ -557,6 +640,8 @@ module Google
557
640
  @delete_operation = ::Gapic::Config::Method.new delete_operation_config
558
641
  cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
559
642
  @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
643
+ wait_operation_config = parent_rpcs&.wait_operation if parent_rpcs&.respond_to? :wait_operation
644
+ @wait_operation = ::Gapic::Config::Method.new wait_operation_config
560
645
 
561
646
  yield self if block_given?
562
647
  end
@@ -55,7 +55,7 @@ module Google
55
55
  # [prediction_type][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type].
56
56
  # * Text Sentiment - TextSnippet, content up 500 characters, UTF-8
57
57
  # encoded.
58
- rpc :Predict, Google::Cloud::AutoML::V1beta1::PredictRequest, Google::Cloud::AutoML::V1beta1::PredictResponse
58
+ rpc :Predict, ::Google::Cloud::AutoML::V1beta1::PredictRequest, ::Google::Cloud::AutoML::V1beta1::PredictResponse
59
59
  # Perform a batch prediction. Unlike the online [Predict][google.cloud.automl.v1beta1.PredictionService.Predict], batch
60
60
  # prediction result won't be immediately available in the response. Instead,
61
61
  # a long running operation object is returned. User can poll the operation
@@ -68,7 +68,7 @@ module Google
68
68
  # * Video Classification
69
69
  # * Video Object Tracking * Text Extraction
70
70
  # * Tables
71
- rpc :BatchPredict, Google::Cloud::AutoML::V1beta1::BatchPredictRequest, Google::Longrunning::Operation
71
+ rpc :BatchPredict, ::Google::Cloud::AutoML::V1beta1::BatchPredictRequest, ::Google::Longrunning::Operation
72
72
  end
73
73
 
74
74
  Stub = Service.rpc_stub_class
@@ -47,19 +47,19 @@ module Google
47
47
  self.service_name = 'google.cloud.automl.v1beta1.AutoMl'
48
48
 
49
49
  # Creates a dataset.
50
- rpc :CreateDataset, Google::Cloud::AutoML::V1beta1::CreateDatasetRequest, Google::Cloud::AutoML::V1beta1::Dataset
50
+ rpc :CreateDataset, ::Google::Cloud::AutoML::V1beta1::CreateDatasetRequest, ::Google::Cloud::AutoML::V1beta1::Dataset
51
51
  # Gets a dataset.
52
- rpc :GetDataset, Google::Cloud::AutoML::V1beta1::GetDatasetRequest, Google::Cloud::AutoML::V1beta1::Dataset
52
+ rpc :GetDataset, ::Google::Cloud::AutoML::V1beta1::GetDatasetRequest, ::Google::Cloud::AutoML::V1beta1::Dataset
53
53
  # Lists datasets in a project.
54
- rpc :ListDatasets, Google::Cloud::AutoML::V1beta1::ListDatasetsRequest, Google::Cloud::AutoML::V1beta1::ListDatasetsResponse
54
+ rpc :ListDatasets, ::Google::Cloud::AutoML::V1beta1::ListDatasetsRequest, ::Google::Cloud::AutoML::V1beta1::ListDatasetsResponse
55
55
  # Updates a dataset.
56
- rpc :UpdateDataset, Google::Cloud::AutoML::V1beta1::UpdateDatasetRequest, Google::Cloud::AutoML::V1beta1::Dataset
56
+ rpc :UpdateDataset, ::Google::Cloud::AutoML::V1beta1::UpdateDatasetRequest, ::Google::Cloud::AutoML::V1beta1::Dataset
57
57
  # Deletes a dataset and all of its contents.
58
58
  # Returns empty response in the
59
59
  # [response][google.longrunning.Operation.response] field when it completes,
60
60
  # and `delete_details` in the
61
61
  # [metadata][google.longrunning.Operation.metadata] field.
62
- rpc :DeleteDataset, Google::Cloud::AutoML::V1beta1::DeleteDatasetRequest, Google::Longrunning::Operation
62
+ rpc :DeleteDataset, ::Google::Cloud::AutoML::V1beta1::DeleteDatasetRequest, ::Google::Longrunning::Operation
63
63
  # Imports data into a dataset.
64
64
  # For Tables this method can only be called on an empty Dataset.
65
65
  #
@@ -69,41 +69,41 @@ module Google
69
69
  # parameter must be explicitly set.
70
70
  # Returns an empty response in the
71
71
  # [response][google.longrunning.Operation.response] field when it completes.
72
- rpc :ImportData, Google::Cloud::AutoML::V1beta1::ImportDataRequest, Google::Longrunning::Operation
72
+ rpc :ImportData, ::Google::Cloud::AutoML::V1beta1::ImportDataRequest, ::Google::Longrunning::Operation
73
73
  # Exports dataset's data to the provided output location.
74
74
  # Returns an empty response in the
75
75
  # [response][google.longrunning.Operation.response] field when it completes.
76
- rpc :ExportData, Google::Cloud::AutoML::V1beta1::ExportDataRequest, Google::Longrunning::Operation
76
+ rpc :ExportData, ::Google::Cloud::AutoML::V1beta1::ExportDataRequest, ::Google::Longrunning::Operation
77
77
  # Gets an annotation spec.
78
- rpc :GetAnnotationSpec, Google::Cloud::AutoML::V1beta1::GetAnnotationSpecRequest, Google::Cloud::AutoML::V1beta1::AnnotationSpec
78
+ rpc :GetAnnotationSpec, ::Google::Cloud::AutoML::V1beta1::GetAnnotationSpecRequest, ::Google::Cloud::AutoML::V1beta1::AnnotationSpec
79
79
  # Gets a table spec.
80
- rpc :GetTableSpec, Google::Cloud::AutoML::V1beta1::GetTableSpecRequest, Google::Cloud::AutoML::V1beta1::TableSpec
80
+ rpc :GetTableSpec, ::Google::Cloud::AutoML::V1beta1::GetTableSpecRequest, ::Google::Cloud::AutoML::V1beta1::TableSpec
81
81
  # Lists table specs in a dataset.
82
- rpc :ListTableSpecs, Google::Cloud::AutoML::V1beta1::ListTableSpecsRequest, Google::Cloud::AutoML::V1beta1::ListTableSpecsResponse
82
+ rpc :ListTableSpecs, ::Google::Cloud::AutoML::V1beta1::ListTableSpecsRequest, ::Google::Cloud::AutoML::V1beta1::ListTableSpecsResponse
83
83
  # Updates a table spec.
84
- rpc :UpdateTableSpec, Google::Cloud::AutoML::V1beta1::UpdateTableSpecRequest, Google::Cloud::AutoML::V1beta1::TableSpec
84
+ rpc :UpdateTableSpec, ::Google::Cloud::AutoML::V1beta1::UpdateTableSpecRequest, ::Google::Cloud::AutoML::V1beta1::TableSpec
85
85
  # Gets a column spec.
86
- rpc :GetColumnSpec, Google::Cloud::AutoML::V1beta1::GetColumnSpecRequest, Google::Cloud::AutoML::V1beta1::ColumnSpec
86
+ rpc :GetColumnSpec, ::Google::Cloud::AutoML::V1beta1::GetColumnSpecRequest, ::Google::Cloud::AutoML::V1beta1::ColumnSpec
87
87
  # Lists column specs in a table spec.
88
- rpc :ListColumnSpecs, Google::Cloud::AutoML::V1beta1::ListColumnSpecsRequest, Google::Cloud::AutoML::V1beta1::ListColumnSpecsResponse
88
+ rpc :ListColumnSpecs, ::Google::Cloud::AutoML::V1beta1::ListColumnSpecsRequest, ::Google::Cloud::AutoML::V1beta1::ListColumnSpecsResponse
89
89
  # Updates a column spec.
90
- rpc :UpdateColumnSpec, Google::Cloud::AutoML::V1beta1::UpdateColumnSpecRequest, Google::Cloud::AutoML::V1beta1::ColumnSpec
90
+ rpc :UpdateColumnSpec, ::Google::Cloud::AutoML::V1beta1::UpdateColumnSpecRequest, ::Google::Cloud::AutoML::V1beta1::ColumnSpec
91
91
  # Creates a model.
92
92
  # Returns a Model in the [response][google.longrunning.Operation.response]
93
93
  # field when it completes.
94
94
  # When you create a model, several model evaluations are created for it:
95
95
  # a global evaluation, and one evaluation for each annotation spec.
96
- rpc :CreateModel, Google::Cloud::AutoML::V1beta1::CreateModelRequest, Google::Longrunning::Operation
96
+ rpc :CreateModel, ::Google::Cloud::AutoML::V1beta1::CreateModelRequest, ::Google::Longrunning::Operation
97
97
  # Gets a model.
98
- rpc :GetModel, Google::Cloud::AutoML::V1beta1::GetModelRequest, Google::Cloud::AutoML::V1beta1::Model
98
+ rpc :GetModel, ::Google::Cloud::AutoML::V1beta1::GetModelRequest, ::Google::Cloud::AutoML::V1beta1::Model
99
99
  # Lists models.
100
- rpc :ListModels, Google::Cloud::AutoML::V1beta1::ListModelsRequest, Google::Cloud::AutoML::V1beta1::ListModelsResponse
100
+ rpc :ListModels, ::Google::Cloud::AutoML::V1beta1::ListModelsRequest, ::Google::Cloud::AutoML::V1beta1::ListModelsResponse
101
101
  # Deletes a model.
102
102
  # Returns `google.protobuf.Empty` in the
103
103
  # [response][google.longrunning.Operation.response] field when it completes,
104
104
  # and `delete_details` in the
105
105
  # [metadata][google.longrunning.Operation.metadata] field.
106
- rpc :DeleteModel, Google::Cloud::AutoML::V1beta1::DeleteModelRequest, Google::Longrunning::Operation
106
+ rpc :DeleteModel, ::Google::Cloud::AutoML::V1beta1::DeleteModelRequest, ::Google::Longrunning::Operation
107
107
  # Deploys a model. If a model is already deployed, deploying it with the
108
108
  # same parameters has no effect. Deploying with different parametrs
109
109
  # (as e.g. changing
@@ -116,7 +116,7 @@ module Google
116
116
  #
117
117
  # Returns an empty response in the
118
118
  # [response][google.longrunning.Operation.response] field when it completes.
119
- rpc :DeployModel, Google::Cloud::AutoML::V1beta1::DeployModelRequest, Google::Longrunning::Operation
119
+ rpc :DeployModel, ::Google::Cloud::AutoML::V1beta1::DeployModelRequest, ::Google::Longrunning::Operation
120
120
  # Undeploys a model. If the model is not deployed this method has no effect.
121
121
  #
122
122
  # Only applicable for Text Classification, Image Object Detection and Tables;
@@ -124,7 +124,7 @@ module Google
124
124
  #
125
125
  # Returns an empty response in the
126
126
  # [response][google.longrunning.Operation.response] field when it completes.
127
- rpc :UndeployModel, Google::Cloud::AutoML::V1beta1::UndeployModelRequest, Google::Longrunning::Operation
127
+ rpc :UndeployModel, ::Google::Cloud::AutoML::V1beta1::UndeployModelRequest, ::Google::Longrunning::Operation
128
128
  # Exports a trained, "export-able", model to a user specified Google Cloud
129
129
  # Storage location. A model is considered export-able if and only if it has
130
130
  # an export format defined for it in
@@ -133,7 +133,7 @@ module Google
133
133
  #
134
134
  # Returns an empty response in the
135
135
  # [response][google.longrunning.Operation.response] field when it completes.
136
- rpc :ExportModel, Google::Cloud::AutoML::V1beta1::ExportModelRequest, Google::Longrunning::Operation
136
+ rpc :ExportModel, ::Google::Cloud::AutoML::V1beta1::ExportModelRequest, ::Google::Longrunning::Operation
137
137
  # Exports examples on which the model was evaluated (i.e. which were in the
138
138
  # TEST set of the dataset the model was created from), together with their
139
139
  # ground truth annotations and the annotations created (predicted) by the
@@ -148,11 +148,11 @@ module Google
148
148
  #
149
149
  # Returns an empty response in the
150
150
  # [response][google.longrunning.Operation.response] field when it completes.
151
- rpc :ExportEvaluatedExamples, Google::Cloud::AutoML::V1beta1::ExportEvaluatedExamplesRequest, Google::Longrunning::Operation
151
+ rpc :ExportEvaluatedExamples, ::Google::Cloud::AutoML::V1beta1::ExportEvaluatedExamplesRequest, ::Google::Longrunning::Operation
152
152
  # Gets a model evaluation.
153
- rpc :GetModelEvaluation, Google::Cloud::AutoML::V1beta1::GetModelEvaluationRequest, Google::Cloud::AutoML::V1beta1::ModelEvaluation
153
+ rpc :GetModelEvaluation, ::Google::Cloud::AutoML::V1beta1::GetModelEvaluationRequest, ::Google::Cloud::AutoML::V1beta1::ModelEvaluation
154
154
  # Lists model evaluations.
155
- rpc :ListModelEvaluations, Google::Cloud::AutoML::V1beta1::ListModelEvaluationsRequest, Google::Cloud::AutoML::V1beta1::ListModelEvaluationsResponse
155
+ rpc :ListModelEvaluations, ::Google::Cloud::AutoML::V1beta1::ListModelEvaluationsRequest, ::Google::Cloud::AutoML::V1beta1::ListModelEvaluationsResponse
156
156
  end
157
157
 
158
158
  Stub = Service.rpc_stub_class
@@ -16,6 +16,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  add_message "google.cloud.automl.v1beta1.TextExtractionDatasetMetadata" do
17
17
  end
18
18
  add_message "google.cloud.automl.v1beta1.TextExtractionModelMetadata" do
19
+ optional :model_hint, :string, 3
19
20
  end
20
21
  add_message "google.cloud.automl.v1beta1.TextSentimentDatasetMetadata" do
21
22
  optional :sentiment_max, :int32, 1
@@ -19,9 +19,9 @@
19
19
 
20
20
  module Google
21
21
  module Cloud
22
- module Automl
22
+ module AutoML
23
23
  module V1beta1
24
- VERSION = "0.2.5"
24
+ VERSION = "0.4.0"
25
25
  end
26
26
  end
27
27
  end
@@ -54,6 +54,12 @@ module Google
54
54
  # This indicates that the field may be set once in a request to create a
55
55
  # resource, but may not be changed thereafter.
56
56
  IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
57
63
  end
58
64
  end
59
65
  end
@@ -43,12 +43,12 @@ module Google
43
43
  #
44
44
  # The ResourceDescriptor Yaml config will look like:
45
45
  #
46
- # resources:
47
- # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/\\{project}/topics/\\{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/\\{project}"
46
+ # resources:
47
+ # - type: "pubsub.googleapis.com/Topic"
48
+ # name_descriptor:
49
+ # - pattern: "projects/{project}/topics/{topic}"
50
+ # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
+ # parent_name_extractor: "projects/{project}"
52
52
  #
53
53
  # Sometimes, resources have multiple patterns, typically because they can
54
54
  # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
183
183
  # }
184
184
  # @!attribute [rw] plural
185
185
  # @return [::String]
186
- # The plural name used in the resource name, such as 'projects' for
187
- # the name of 'projects/\\{project}'. It is the same concept of the `plural`
188
- # field in k8s CRD spec
186
+ # The plural name used in the resource name and permission names, such as
187
+ # 'projects' for the resource name of 'projects/\\{project}' and the permission
188
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
189
+ # concept of the `plural` field in k8s CRD spec
189
190
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
191
+ #
192
+ # Note: The plural form is required even for singleton resources. See
193
+ # https://aip.dev/156
190
194
  # @!attribute [rw] singular
191
195
  # @return [::String]
192
196
  # The same concept of the `singular` field in k8s CRD spec
193
197
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
194
198
  # Such as "project" for the `resourcemanager.googleapis.com/Project` type.
199
+ # @!attribute [rw] style
200
+ # @return [::Array<::Google::Api::ResourceDescriptor::Style>]
201
+ # Style flag(s) for this resource.
202
+ # These indicate that a resource is expected to conform to a given
203
+ # style. See the specific style flags for additional information.
195
204
  class ResourceDescriptor
196
205
  include ::Google::Protobuf::MessageExts
197
206
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
211
220
  # that from being necessary once there are multiple patterns.)
212
221
  FUTURE_MULTI_PATTERN = 2
213
222
  end
223
+
224
+ # A flag representing a specific style that a resource claims to conform to.
225
+ module Style
226
+ # The unspecified value. Do not use.
227
+ STYLE_UNSPECIFIED = 0
228
+
229
+ # This resource is intended to be "declarative-friendly".
230
+ #
231
+ # Declarative-friendly resources must be more strictly consistent, and
232
+ # setting this to true communicates to tools that this resource should
233
+ # adhere to declarative-friendly expectations.
234
+ #
235
+ # Note: This is used by the API linter (linter.aip.dev) to enable
236
+ # additional checks.
237
+ DECLARATIVE_FRIENDLY = 1
238
+ end
214
239
  end
215
240
 
216
241
  # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
226
251
  # type: "pubsub.googleapis.com/Topic"
227
252
  # }];
228
253
  # }
254
+ #
255
+ # Occasionally, a field may reference an arbitrary resource. In this case,
256
+ # APIs use the special value * in their resource reference.
257
+ #
258
+ # Example:
259
+ #
260
+ # message GetIamPolicyRequest {
261
+ # string resource = 2 [(google.api.resource_reference) = {
262
+ # type: "*"
263
+ # }];
264
+ # }
229
265
  # @!attribute [rw] child_type
230
266
  # @return [::String]
231
267
  # The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
234
270
  #
235
271
  # Example:
236
272
  #
237
- # message ListLogEntriesRequest {
238
- # string parent = 1 [(google.api.resource_reference) = {
239
- # child_type: "logging.googleapis.com/LogEntry"
240
- # };
241
- # }
273
+ # message ListLogEntriesRequest {
274
+ # string parent = 1 [(google.api.resource_reference) = {
275
+ # child_type: "logging.googleapis.com/LogEntry"
276
+ # };
277
+ # }
242
278
  class ResourceReference
243
279
  include ::Google::Protobuf::MessageExts
244
280
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1014,6 +1014,32 @@ module Google
1014
1014
  # * For Image Classification mobile-core-ml-low-latency-1,
1015
1015
  # mobile-core-ml-versatile-1, mobile-core-ml-high-accuracy-1:
1016
1016
  # "core_ml" (default).
1017
+ #
1018
+ # * For Image Object Detection mobile-low-latency-1, mobile-versatile-1,
1019
+ # mobile-high-accuracy-1:
1020
+ # "tflite", "tf_saved_model", "tf_js".
1021
+ #
1022
+ # * For Video Classification cloud,
1023
+ # "tf_saved_model".
1024
+ #
1025
+ # * For Video Object Tracking cloud,
1026
+ # "tf_saved_model".
1027
+ #
1028
+ # * For Video Object Tracking mobile-versatile-1:
1029
+ # "tflite", "edgetpu_tflite", "tf_saved_model", "docker".
1030
+ #
1031
+ # * For Video Object Tracking mobile-coral-versatile-1:
1032
+ # "tflite", "edgetpu_tflite", "docker".
1033
+ #
1034
+ # * For Video Object Tracking mobile-coral-low-latency-1:
1035
+ # "tflite", "edgetpu_tflite", "docker".
1036
+ #
1037
+ # * For Video Object Tracking mobile-jetson-versatile-1:
1038
+ # "tf_saved_model", "docker".
1039
+ #
1040
+ # * For Tables:
1041
+ # "docker".
1042
+ #
1017
1043
  # Formats description:
1018
1044
  #
1019
1045
  # * tflite - Used for Android mobile devices.
@@ -46,6 +46,14 @@ module Google
46
46
  end
47
47
 
48
48
  # Model metadata that is specific to text extraction.
49
+ # @!attribute [rw] model_hint
50
+ # @return [::String]
51
+ # Indicates the scope of model use case.
52
+ #
53
+ # * `default`: Use to train a general text extraction model. Default value.
54
+ #
55
+ # * `health_care`: Use to train a text extraction model that is tuned for
56
+ # healthcare applications.
49
57
  class TextExtractionModelMetadata
50
58
  include ::Google::Protobuf::MessageExts
51
59
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -25,7 +25,7 @@ module Google
25
25
  # @return [::String]
26
26
  # The server-assigned name, which is only unique within the same service that
27
27
  # originally returns it. If you use the default HTTP mapping, the
28
- # `name` should have the format of `operations/some/unique/name`.
28
+ # `name` should be a resource name ending with `operations/{unique_id}`.
29
29
  # @!attribute [rw] metadata
30
30
  # @return [::Google::Protobuf::Any]
31
31
  # Service-specific metadata associated with the operation. It typically
@@ -35,7 +35,7 @@ module Google
35
35
  # @!attribute [rw] done
36
36
  # @return [::Boolean]
37
37
  # If the value is `false`, it means the operation is still in progress.
38
- # If true, the operation is completed, and either `error` or `response` is
38
+ # If `true`, the operation is completed, and either `error` or `response` is
39
39
  # available.
40
40
  # @!attribute [rw] error
41
41
  # @return [::Google::Rpc::Status]
@@ -67,7 +67,7 @@ module Google
67
67
  # The request message for Operations.ListOperations.
68
68
  # @!attribute [rw] name
69
69
  # @return [::String]
70
- # The name of the operation collection.
70
+ # The name of the operation's parent resource.
71
71
  # @!attribute [rw] filter
72
72
  # @return [::String]
73
73
  # The standard list filter.
@@ -112,6 +112,20 @@ module Google
112
112
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
113
  end
114
114
 
115
+ # The request message for Operations.WaitOperation.
116
+ # @!attribute [rw] name
117
+ # @return [::String]
118
+ # The name of the operation resource to wait on.
119
+ # @!attribute [rw] timeout
120
+ # @return [::Google::Protobuf::Duration]
121
+ # The maximum duration to wait before timing out. If left blank, the wait
122
+ # will be at most the time permitted by the underlying HTTP/RPC protocol.
123
+ # If RPC context deadline is also specified, the shorter one will be used.
124
+ class WaitOperationRequest
125
+ include ::Google::Protobuf::MessageExts
126
+ extend ::Google::Protobuf::MessageExts::ClassMethods
127
+ end
128
+
115
129
  # A message representing the message types used by a long-running operation.
116
130
  #
117
131
  # Example:
@@ -57,10 +57,13 @@ module Google
57
57
  # Example 4: Pack and unpack a message in Go
58
58
  #
59
59
  # foo := &pb.Foo{...}
60
- # any, err := ptypes.MarshalAny(foo)
60
+ # any, err := anypb.New(foo)
61
+ # if err != nil {
62
+ # ...
63
+ # }
61
64
  # ...
62
65
  # foo := &pb.Foo{}
63
- # if err := ptypes.UnmarshalAny(any, foo); err != nil {
66
+ # if err := any.UnmarshalTo(foo); err != nil {
64
67
  # ...
65
68
  # }
66
69
  #
@@ -70,7 +70,16 @@ module Google
70
70
  # .setNanos((int) ((millis % 1000) * 1000000)).build();
71
71
  #
72
72
  #
73
- # Example 5: Compute Timestamp from current time in Python.
73
+ # Example 5: Compute Timestamp from Java `Instant.now()`.
74
+ #
75
+ # Instant now = Instant.now();
76
+ #
77
+ # Timestamp timestamp =
78
+ # Timestamp.newBuilder().setSeconds(now.getEpochSecond())
79
+ # .setNanos(now.getNano()).build();
80
+ #
81
+ #
82
+ # Example 6: Compute Timestamp from current time in Python.
74
83
  #
75
84
  # timestamp = Timestamp()
76
85
  # timestamp.GetCurrentTime()
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-automl-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.5
4
+ version: 0.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-08-06 00:00:00.000000000 Z
11
+ date: 2021-02-02 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -154,7 +154,9 @@ description: AutoML makes the power of machine learning available to you even if
154
154
  have limited knowledge of machine learning. You can use AutoML to build on Google's
155
155
  machine learning capabilities to create your own custom machine learning models
156
156
  that are tailored to your business needs, and then integrate those models into your
157
- applications and web sites.
157
+ applications and web sites. Note that google-cloud-automl-v1beta1 is a version-specific
158
+ client library. For most uses, we recommend installing the main client library google-cloud-automl
159
+ instead. See the readme for more details.
158
160
  email: googleapis-packages@google.com
159
161
  executables: []
160
162
  extensions: []
@@ -166,6 +168,7 @@ files:
166
168
  - README.md
167
169
  - lib/google-cloud-automl-v1beta1.rb
168
170
  - lib/google/cloud/automl/v1beta1.rb
171
+ - lib/google/cloud/automl/v1beta1/_helpers.rb
169
172
  - lib/google/cloud/automl/v1beta1/annotation_payload_pb.rb
170
173
  - lib/google/cloud/automl/v1beta1/annotation_spec_pb.rb
171
174
  - lib/google/cloud/automl/v1beta1/automl.rb
@@ -265,7 +268,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
265
268
  - !ruby/object:Gem::Version
266
269
  version: '0'
267
270
  requirements: []
268
- rubygems_version: 3.1.3
271
+ rubygems_version: 3.2.6
269
272
  signing_key:
270
273
  specification_version: 4
271
274
  summary: API Client library for the Cloud AutoML V1beta1 API