google-cloud-data_catalog-v1 0.12.0 → 0.13.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 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