google-cloud-data_catalog-v1 0.12.0 → 0.13.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: '0833c987609adaf473aca4a9db8656504ad5e08d53cc6c66e8c9837934c9c1b7'
4
- data.tar.gz: 2b9ad2d30d214a9a6629cff7199926d7a564d5e98b3b8b85805fb7446a3731e3
3
+ metadata.gz: 411fd1764f657bce89c9ed3d1b28753d8119afc7f0c460cc7b8df8aeb640a48e
4
+ data.tar.gz: df455550c1154e9f84e7034129ae917e2eef020f74b6d996e772414fd9025c78
5
5
  SHA512:
6
- metadata.gz: e60e9588dae474a472eed368616e3f95cec9979feefdb713d14831f44762a454255c5a71bad009498ad83d3a291318f4ad6a96b2a3a00df3615a986dea37be24
7
- data.tar.gz: e4553a603364c5651482de0d7b1b18d73ca340afe8bf4eb8ed3f8446bf302e9a496df861eebc1da0f5b0256cd4ca5e88f7ce76c32774f55fa7779205df2ac862
6
+ metadata.gz: 6ac6b7d57c7868b779b4c9de2d71ddcd783731e6d6d3b92e8ce8e90230ccb1cd064c837295b03f22d76fb5d49416e545cb10855587b96855f55d46142c310d7f
7
+ data.tar.gz: 2af89f682588cafeafd8f196e1356f73709b440079dcd154d0d4b77c82d26d41ebe0f3ad6beb109ae167cb49528a71766d808e98cdedf582ba4a1302db3f29b0
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/datacatalog/v1/datacatalog_pb"
21
+ require "google/iam/v1"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -176,6 +177,12 @@ module Google
176
177
  @quota_project_id = @config.quota_project
177
178
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
178
179
 
180
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
181
+ config.credentials = credentials
182
+ config.quota_project = @quota_project_id
183
+ config.endpoint = @config.endpoint
184
+ end
185
+
179
186
  @data_catalog_stub = ::Gapic::ServiceStub.new(
180
187
  ::Google::Cloud::DataCatalog::V1::DataCatalog::Stub,
181
188
  credentials: credentials,
@@ -185,6 +192,13 @@ module Google
185
192
  )
186
193
  end
187
194
 
195
+ ##
196
+ # Get the associated client for mix-in of the IAMPolicy.
197
+ #
198
+ # @return [Google::Iam::V1::IAMPolicy::Client]
199
+ #
200
+ attr_reader :iam_policy_client
201
+
188
202
  # Service calls
189
203
 
190
204
  ##
@@ -284,13 +298,11 @@ module Google
284
298
  # # Call the search_catalog method.
285
299
  # result = client.search_catalog request
286
300
  #
287
- # # The returned object is of type Gapic::PagedEnumerable. You can
288
- # # iterate over all elements by calling #each, and the enumerable
289
- # # will lazily make API calls to fetch subsequent pages. Other
290
- # # methods are also available for managing paging directly.
291
- # result.each do |response|
301
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
302
+ # # over elements, and API calls will be issued to fetch pages as needed.
303
+ # result.each do |item|
292
304
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::SearchCatalogResult.
293
- # p response
305
+ # p item
294
306
  # end
295
307
  #
296
308
  def search_catalog request, options = nil
@@ -775,13 +787,11 @@ module Google
775
787
  # # Call the list_entry_groups method.
776
788
  # result = client.list_entry_groups request
777
789
  #
778
- # # The returned object is of type Gapic::PagedEnumerable. You can
779
- # # iterate over all elements by calling #each, and the enumerable
780
- # # will lazily make API calls to fetch subsequent pages. Other
781
- # # methods are also available for managing paging directly.
782
- # result.each do |response|
790
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
791
+ # # over elements, and API calls will be issued to fetch pages as needed.
792
+ # result.each do |item|
783
793
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::EntryGroup.
784
- # p response
794
+ # p item
785
795
  # end
786
796
  #
787
797
  def list_entry_groups request, options = nil
@@ -1406,13 +1416,11 @@ module Google
1406
1416
  # # Call the list_entries method.
1407
1417
  # result = client.list_entries request
1408
1418
  #
1409
- # # The returned object is of type Gapic::PagedEnumerable. You can
1410
- # # iterate over all elements by calling #each, and the enumerable
1411
- # # will lazily make API calls to fetch subsequent pages. Other
1412
- # # methods are also available for managing paging directly.
1413
- # result.each do |response|
1419
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1420
+ # # over elements, and API calls will be issued to fetch pages as needed.
1421
+ # result.each do |item|
1414
1422
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::Entry.
1415
- # p response
1423
+ # p item
1416
1424
  # end
1417
1425
  #
1418
1426
  def list_entries request, options = nil
@@ -2838,13 +2846,11 @@ module Google
2838
2846
  # # Call the list_tags method.
2839
2847
  # result = client.list_tags request
2840
2848
  #
2841
- # # The returned object is of type Gapic::PagedEnumerable. You can
2842
- # # iterate over all elements by calling #each, and the enumerable
2843
- # # will lazily make API calls to fetch subsequent pages. Other
2844
- # # methods are also available for managing paging directly.
2845
- # result.each do |response|
2849
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2850
+ # # over elements, and API calls will be issued to fetch pages as needed.
2851
+ # result.each do |item|
2846
2852
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::Tag.
2847
- # p response
2853
+ # p item
2848
2854
  # end
2849
2855
  #
2850
2856
  def list_tags request, options = nil
@@ -34,7 +34,7 @@ module Google
34
34
  # Data Catalog API service allows you to discover, understand, and manage
35
35
  # your data.
36
36
  #
37
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
38
38
  #
39
39
  # require "google/cloud/data_catalog/v1/data_catalog"
40
40
  # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/datacatalog/v1/policytagmanager_pb"
21
+ require "google/iam/v1"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -140,6 +141,12 @@ module Google
140
141
  @quota_project_id = @config.quota_project
141
142
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
142
143
 
144
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
145
+ config.credentials = credentials
146
+ config.quota_project = @quota_project_id
147
+ config.endpoint = @config.endpoint
148
+ end
149
+
143
150
  @policy_tag_manager_stub = ::Gapic::ServiceStub.new(
144
151
  ::Google::Cloud::DataCatalog::V1::PolicyTagManager::Stub,
145
152
  credentials: credentials,
@@ -149,6 +156,13 @@ module Google
149
156
  )
150
157
  end
151
158
 
159
+ ##
160
+ # Get the associated client for mix-in of the IAMPolicy.
161
+ #
162
+ # @return [Google::Iam::V1::IAMPolicy::Client]
163
+ #
164
+ attr_reader :iam_policy_client
165
+
152
166
  # Service calls
153
167
 
154
168
  ##
@@ -472,13 +486,11 @@ module Google
472
486
  # # Call the list_taxonomies method.
473
487
  # result = client.list_taxonomies request
474
488
  #
475
- # # The returned object is of type Gapic::PagedEnumerable. You can
476
- # # iterate over all elements by calling #each, and the enumerable
477
- # # will lazily make API calls to fetch subsequent pages. Other
478
- # # methods are also available for managing paging directly.
479
- # result.each do |response|
489
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
490
+ # # over elements, and API calls will be issued to fetch pages as needed.
491
+ # result.each do |item|
480
492
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::Taxonomy.
481
- # p response
493
+ # p item
482
494
  # end
483
495
  #
484
496
  def list_taxonomies request, options = nil
@@ -931,13 +943,11 @@ module Google
931
943
  # # Call the list_policy_tags method.
932
944
  # result = client.list_policy_tags request
933
945
  #
934
- # # The returned object is of type Gapic::PagedEnumerable. You can
935
- # # iterate over all elements by calling #each, and the enumerable
936
- # # will lazily make API calls to fetch subsequent pages. Other
937
- # # methods are also available for managing paging directly.
938
- # result.each do |response|
946
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
947
+ # # over elements, and API calls will be issued to fetch pages as needed.
948
+ # result.each do |item|
939
949
  # # Each element is of type ::Google::Cloud::DataCatalog::V1::PolicyTag.
940
- # p response
950
+ # p item
941
951
  # end
942
952
  #
943
953
  def list_policy_tags request, options = nil
@@ -38,7 +38,7 @@ module Google
38
38
  # control policies. A taxonomy is a hierarchical grouping of policy tags that
39
39
  # classify data along a common axis.
40
40
  #
41
- # To load this service and instantiate a client:
41
+ # @example Load this service and instantiate a gRPC client
42
42
  #
43
43
  # require "google/cloud/data_catalog/v1/policy_tag_manager"
44
44
  # client = ::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client.new
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/datacatalog/v1/policytagmanagerserialization_pb"
21
+ require "google/iam/v1"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -138,6 +139,12 @@ module Google
138
139
  @quota_project_id = @config.quota_project
139
140
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
140
141
 
142
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
143
+ config.credentials = credentials
144
+ config.quota_project = @quota_project_id
145
+ config.endpoint = @config.endpoint
146
+ end
147
+
141
148
  @policy_tag_manager_serialization_stub = ::Gapic::ServiceStub.new(
142
149
  ::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Stub,
143
150
  credentials: credentials,
@@ -147,6 +154,13 @@ module Google
147
154
  )
148
155
  end
149
156
 
157
+ ##
158
+ # Get the associated client for mix-in of the IAMPolicy.
159
+ #
160
+ # @return [Google::Iam::V1::IAMPolicy::Client]
161
+ #
162
+ attr_reader :iam_policy_client
163
+
150
164
  # Service calls
151
165
 
152
166
  ##
@@ -36,7 +36,7 @@ module Google
36
36
  #
37
37
  # Taxonomy is a hierarchical group of policy tags.
38
38
  #
39
- # To load this service and instantiate a client:
39
+ # @example Load this service and instantiate a gRPC client
40
40
  #
41
41
  # require "google/cloud/data_catalog/v1/policy_tag_manager_serialization"
42
42
  # client = ::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client.new
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module DataCatalog
23
23
  module V1
24
- VERSION = "0.12.0"
24
+ VERSION = "0.13.0"
25
25
  end
26
26
  end
27
27
  end
@@ -25,9 +25,9 @@ module Google
25
25
  module Cloud
26
26
  module DataCatalog
27
27
  ##
28
- # To load this package, including all its services, and instantiate a client:
28
+ # API client module.
29
29
  #
30
- # @example
30
+ # @example Load this package, including all its services, and instantiate a gRPC client
31
31
  #
32
32
  # require "google/cloud/data_catalog/v1"
33
33
  # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
@@ -3,6 +3,7 @@
3
3
 
4
4
  require 'google/protobuf'
5
5
 
6
+ require 'google/api/field_behavior_pb'
6
7
  require 'google/protobuf/timestamp_pb'
7
8
 
8
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -0,0 +1,318 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Required information for every language.
23
+ # @!attribute [rw] reference_docs_uri
24
+ # @return [::String]
25
+ # Link to automatically generated reference documentation. Example:
26
+ # https://cloud.google.com/nodejs/docs/reference/asset/latest
27
+ # @!attribute [rw] destinations
28
+ # @return [::Array<::Google::Api::ClientLibraryDestination>]
29
+ # The destination where API teams want this client library to be published.
30
+ class CommonLanguageSettings
31
+ include ::Google::Protobuf::MessageExts
32
+ extend ::Google::Protobuf::MessageExts::ClassMethods
33
+ end
34
+
35
+ # Details about how and where to publish client libraries.
36
+ # @!attribute [rw] version
37
+ # @return [::String]
38
+ # Version of the API to apply these settings to.
39
+ # @!attribute [rw] launch_stage
40
+ # @return [::Google::Api::LaunchStage]
41
+ # Launch stage of this version of the API.
42
+ # @!attribute [rw] rest_numeric_enums
43
+ # @return [::Boolean]
44
+ # When using transport=rest, the client request will encode enums as
45
+ # numbers rather than strings.
46
+ # @!attribute [rw] java_settings
47
+ # @return [::Google::Api::JavaSettings]
48
+ # Settings for legacy Java features, supported in the Service YAML.
49
+ # @!attribute [rw] cpp_settings
50
+ # @return [::Google::Api::CppSettings]
51
+ # Settings for C++ client libraries.
52
+ # @!attribute [rw] php_settings
53
+ # @return [::Google::Api::PhpSettings]
54
+ # Settings for PHP client libraries.
55
+ # @!attribute [rw] python_settings
56
+ # @return [::Google::Api::PythonSettings]
57
+ # Settings for Python client libraries.
58
+ # @!attribute [rw] node_settings
59
+ # @return [::Google::Api::NodeSettings]
60
+ # Settings for Node client libraries.
61
+ # @!attribute [rw] dotnet_settings
62
+ # @return [::Google::Api::DotnetSettings]
63
+ # Settings for .NET client libraries.
64
+ # @!attribute [rw] ruby_settings
65
+ # @return [::Google::Api::RubySettings]
66
+ # Settings for Ruby client libraries.
67
+ # @!attribute [rw] go_settings
68
+ # @return [::Google::Api::GoSettings]
69
+ # Settings for Go client libraries.
70
+ class ClientLibrarySettings
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # This message configures the settings for publishing [Google Cloud Client
76
+ # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
77
+ # generated from the service config.
78
+ # @!attribute [rw] method_settings
79
+ # @return [::Array<::Google::Api::MethodSettings>]
80
+ # A list of API method settings, e.g. the behavior for methods that use the
81
+ # long-running operation pattern.
82
+ # @!attribute [rw] new_issue_uri
83
+ # @return [::String]
84
+ # Link to a place that API users can report issues. Example:
85
+ # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
+ # @!attribute [rw] documentation_uri
87
+ # @return [::String]
88
+ # Link to product home page. Example:
89
+ # https://cloud.google.com/asset-inventory/docs/overview
90
+ # @!attribute [rw] api_short_name
91
+ # @return [::String]
92
+ # Used as a tracking tag when collecting data about the APIs developer
93
+ # relations artifacts like docs, packages delivered to package managers,
94
+ # etc. Example: "speech".
95
+ # @!attribute [rw] github_label
96
+ # @return [::String]
97
+ # GitHub label to apply to issues and pull requests opened for this API.
98
+ # @!attribute [rw] codeowner_github_teams
99
+ # @return [::Array<::String>]
100
+ # GitHub teams to be added to CODEOWNERS in the directory in GitHub
101
+ # containing source code for the client libraries for this API.
102
+ # @!attribute [rw] doc_tag_prefix
103
+ # @return [::String]
104
+ # A prefix used in sample code when demarking regions to be included in
105
+ # documentation.
106
+ # @!attribute [rw] organization
107
+ # @return [::Google::Api::ClientLibraryOrganization]
108
+ # For whom the client library is being published.
109
+ # @!attribute [rw] library_settings
110
+ # @return [::Array<::Google::Api::ClientLibrarySettings>]
111
+ # Client library settings. If the same version string appears multiple
112
+ # times in this list, then the last one wins. Settings from earlier
113
+ # settings with the same version string are discarded.
114
+ class Publishing
115
+ include ::Google::Protobuf::MessageExts
116
+ extend ::Google::Protobuf::MessageExts::ClassMethods
117
+ end
118
+
119
+ # Settings for Java client libraries.
120
+ # @!attribute [rw] library_package
121
+ # @return [::String]
122
+ # The package name to use in Java. Clobbers the java_package option
123
+ # set in the protobuf. This should be used **only** by APIs
124
+ # who have already set the language_settings.java.package_name" field
125
+ # in gapic.yaml. API teams should use the protobuf java_package option
126
+ # where possible.
127
+ #
128
+ # Example of a YAML configuration::
129
+ #
130
+ # publishing:
131
+ # java_settings:
132
+ # library_package: com.google.cloud.pubsub.v1
133
+ # @!attribute [rw] service_class_names
134
+ # @return [::Google::Protobuf::Map{::String => ::String}]
135
+ # Configure the Java class name to use instead of the service's for its
136
+ # corresponding generated GAPIC client. Keys are fully-qualified
137
+ # service names as they appear in the protobuf (including the full
138
+ # the language_settings.java.interface_names" field in gapic.yaml. API
139
+ # teams should otherwise use the service name as it appears in the
140
+ # protobuf.
141
+ #
142
+ # Example of a YAML configuration::
143
+ #
144
+ # publishing:
145
+ # java_settings:
146
+ # service_class_names:
147
+ # - google.pubsub.v1.Publisher: TopicAdmin
148
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
149
+ # @!attribute [rw] common
150
+ # @return [::Google::Api::CommonLanguageSettings]
151
+ # Some settings.
152
+ class JavaSettings
153
+ include ::Google::Protobuf::MessageExts
154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
155
+
156
+ # @!attribute [rw] key
157
+ # @return [::String]
158
+ # @!attribute [rw] value
159
+ # @return [::String]
160
+ class ServiceClassNamesEntry
161
+ include ::Google::Protobuf::MessageExts
162
+ extend ::Google::Protobuf::MessageExts::ClassMethods
163
+ end
164
+ end
165
+
166
+ # Settings for C++ client libraries.
167
+ # @!attribute [rw] common
168
+ # @return [::Google::Api::CommonLanguageSettings]
169
+ # Some settings.
170
+ class CppSettings
171
+ include ::Google::Protobuf::MessageExts
172
+ extend ::Google::Protobuf::MessageExts::ClassMethods
173
+ end
174
+
175
+ # Settings for Php client libraries.
176
+ # @!attribute [rw] common
177
+ # @return [::Google::Api::CommonLanguageSettings]
178
+ # Some settings.
179
+ class PhpSettings
180
+ include ::Google::Protobuf::MessageExts
181
+ extend ::Google::Protobuf::MessageExts::ClassMethods
182
+ end
183
+
184
+ # Settings for Python client libraries.
185
+ # @!attribute [rw] common
186
+ # @return [::Google::Api::CommonLanguageSettings]
187
+ # Some settings.
188
+ class PythonSettings
189
+ include ::Google::Protobuf::MessageExts
190
+ extend ::Google::Protobuf::MessageExts::ClassMethods
191
+ end
192
+
193
+ # Settings for Node client libraries.
194
+ # @!attribute [rw] common
195
+ # @return [::Google::Api::CommonLanguageSettings]
196
+ # Some settings.
197
+ class NodeSettings
198
+ include ::Google::Protobuf::MessageExts
199
+ extend ::Google::Protobuf::MessageExts::ClassMethods
200
+ end
201
+
202
+ # Settings for Dotnet client libraries.
203
+ # @!attribute [rw] common
204
+ # @return [::Google::Api::CommonLanguageSettings]
205
+ # Some settings.
206
+ class DotnetSettings
207
+ include ::Google::Protobuf::MessageExts
208
+ extend ::Google::Protobuf::MessageExts::ClassMethods
209
+ end
210
+
211
+ # Settings for Ruby client libraries.
212
+ # @!attribute [rw] common
213
+ # @return [::Google::Api::CommonLanguageSettings]
214
+ # Some settings.
215
+ class RubySettings
216
+ include ::Google::Protobuf::MessageExts
217
+ extend ::Google::Protobuf::MessageExts::ClassMethods
218
+ end
219
+
220
+ # Settings for Go client libraries.
221
+ # @!attribute [rw] common
222
+ # @return [::Google::Api::CommonLanguageSettings]
223
+ # Some settings.
224
+ class GoSettings
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
228
+
229
+ # Describes the generator configuration for a method.
230
+ # @!attribute [rw] selector
231
+ # @return [::String]
232
+ # The fully qualified name of the method, for which the options below apply.
233
+ # This is used to find the method to apply the options.
234
+ # @!attribute [rw] long_running
235
+ # @return [::Google::Api::MethodSettings::LongRunning]
236
+ # Describes settings to use for long-running operations when generating
237
+ # API methods for RPCs. Complements RPCs that use the annotations in
238
+ # google/longrunning/operations.proto.
239
+ #
240
+ # Example of a YAML configuration::
241
+ #
242
+ # publishing:
243
+ # method_behavior:
244
+ # - selector: CreateAdDomain
245
+ # long_running:
246
+ # initial_poll_delay:
247
+ # seconds: 60 # 1 minute
248
+ # poll_delay_multiplier: 1.5
249
+ # max_poll_delay:
250
+ # seconds: 360 # 6 minutes
251
+ # total_poll_timeout:
252
+ # seconds: 54000 # 90 minutes
253
+ class MethodSettings
254
+ include ::Google::Protobuf::MessageExts
255
+ extend ::Google::Protobuf::MessageExts::ClassMethods
256
+
257
+ # Describes settings to use when generating API methods that use the
258
+ # long-running operation pattern.
259
+ # All default values below are from those used in the client library
260
+ # generators (e.g.
261
+ # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
262
+ # @!attribute [rw] initial_poll_delay
263
+ # @return [::Google::Protobuf::Duration]
264
+ # Initial delay after which the first poll request will be made.
265
+ # Default value: 5 seconds.
266
+ # @!attribute [rw] poll_delay_multiplier
267
+ # @return [::Float]
268
+ # Multiplier to gradually increase delay between subsequent polls until it
269
+ # reaches max_poll_delay.
270
+ # Default value: 1.5.
271
+ # @!attribute [rw] max_poll_delay
272
+ # @return [::Google::Protobuf::Duration]
273
+ # Maximum time between two subsequent poll requests.
274
+ # Default value: 45 seconds.
275
+ # @!attribute [rw] total_poll_timeout
276
+ # @return [::Google::Protobuf::Duration]
277
+ # Total polling timeout.
278
+ # Default value: 5 minutes.
279
+ class LongRunning
280
+ include ::Google::Protobuf::MessageExts
281
+ extend ::Google::Protobuf::MessageExts::ClassMethods
282
+ end
283
+ end
284
+
285
+ # The organization for which the client libraries are being published.
286
+ # Affects the url where generated docs are published, etc.
287
+ module ClientLibraryOrganization
288
+ # Not useful.
289
+ CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
290
+
291
+ # Google Cloud Platform Org.
292
+ CLOUD = 1
293
+
294
+ # Ads (Advertising) Org.
295
+ ADS = 2
296
+
297
+ # Photos Org.
298
+ PHOTOS = 3
299
+
300
+ # Street View Org.
301
+ STREET_VIEW = 4
302
+ end
303
+
304
+ # To where should client libraries be published?
305
+ module ClientLibraryDestination
306
+ # Client libraries will neither be generated nor published to package
307
+ # managers.
308
+ CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
309
+
310
+ # Generate the client library in a repo under github.com/googleapis,
311
+ # but don't publish it to package managers.
312
+ GITHUB = 10
313
+
314
+ # Publish the library to package managers like nuget.org and npmjs.com.
315
+ PACKAGE_MANAGER = 20
316
+ end
317
+ end
318
+ end