google-apis-serviceusage_v1 0.28.0 → 0.70.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.
@@ -22,6 +22,46 @@ module Google
22
22
  module Apis
23
23
  module ServiceusageV1
24
24
 
25
+ # Metadata for the `AddEnableRules` method.
26
+ class AddEnableRulesMetadata
27
+ include Google::Apis::Core::Hashable
28
+
29
+ def initialize(**args)
30
+ update!(**args)
31
+ end
32
+
33
+ # Update properties of this object
34
+ def update!(**args)
35
+ end
36
+ end
37
+
38
+ # The response message of `AddEnableRules` method.
39
+ class AddEnableRulesResponse
40
+ include Google::Apis::Core::Hashable
41
+
42
+ # The values added to the parent consumer policy.
43
+ # Corresponds to the JSON property `addedValues`
44
+ # @return [Array<String>]
45
+ attr_accessor :added_values
46
+
47
+ # The parent consumer policy. It can be `projects/12345/consumerPolicies/default`
48
+ # , or `folders/12345/consumerPolicies/default`, or `organizations/12345/
49
+ # consumerPolicies/default`.
50
+ # Corresponds to the JSON property `parent`
51
+ # @return [String]
52
+ attr_accessor :parent
53
+
54
+ def initialize(**args)
55
+ update!(**args)
56
+ end
57
+
58
+ # Update properties of this object
59
+ def update!(**args)
60
+ @added_values = args[:added_values] if args.key?(:added_values)
61
+ @parent = args[:parent] if args.key?(:parent)
62
+ end
63
+ end
64
+
25
65
  # Quota policy created by quota administrator.
26
66
  class AdminQuotaPolicy
27
67
  include Google::Apis::Core::Hashable
@@ -33,7 +73,7 @@ module Google
33
73
  attr_accessor :container
34
74
 
35
75
  # If this map is nonempty, then this policy applies only to specific values for
36
- # dimensions defined in the limit unit. For example, an policy on a limit with
76
+ # dimensions defined in the limit unit. For example, a policy on a limit with
37
77
  # the unit `1/`project`/`region`` could contain an entry with the key `region`
38
78
  # and the value `us-east-1`; the policy is only applied to quota consumed in
39
79
  # that region. This map has the following restrictions: * If `region` appears as
@@ -87,16 +127,125 @@ module Google
87
127
  end
88
128
  end
89
129
 
130
+ # A message to group the analysis information.
131
+ class Analysis
132
+ include Google::Apis::Core::Hashable
133
+
134
+ # An analysis result including blockers and warnings.
135
+ # Corresponds to the JSON property `analysis`
136
+ # @return [Google::Apis::ServiceusageV1::AnalysisResult]
137
+ attr_accessor :analysis
138
+
139
+ # Output only. The type of analysis.
140
+ # Corresponds to the JSON property `analysisType`
141
+ # @return [String]
142
+ attr_accessor :analysis_type
143
+
144
+ # Output only. The user friendly display name of the analysis type. E.g. service
145
+ # dependency analysis, service resource usage analysis, etc.
146
+ # Corresponds to the JSON property `displayName`
147
+ # @return [String]
148
+ attr_accessor :display_name
149
+
150
+ # The names of the service that has analysis result of warnings or blockers.
151
+ # Example: `services/storage.googleapis.com`.
152
+ # Corresponds to the JSON property `service`
153
+ # @return [String]
154
+ attr_accessor :service
155
+
156
+ def initialize(**args)
157
+ update!(**args)
158
+ end
159
+
160
+ # Update properties of this object
161
+ def update!(**args)
162
+ @analysis = args[:analysis] if args.key?(:analysis)
163
+ @analysis_type = args[:analysis_type] if args.key?(:analysis_type)
164
+ @display_name = args[:display_name] if args.key?(:display_name)
165
+ @service = args[:service] if args.key?(:service)
166
+ end
167
+ end
168
+
169
+ # An analysis result including blockers and warnings.
170
+ class AnalysisResult
171
+ include Google::Apis::Core::Hashable
172
+
173
+ # Blocking information that would prevent the policy changes at runtime.
174
+ # Corresponds to the JSON property `blockers`
175
+ # @return [Array<Google::Apis::ServiceusageV1::Impact>]
176
+ attr_accessor :blockers
177
+
178
+ # Warning information indicating that the policy changes might be unsafe, but
179
+ # will not block the changes at runtime.
180
+ # Corresponds to the JSON property `warnings`
181
+ # @return [Array<Google::Apis::ServiceusageV1::Impact>]
182
+ attr_accessor :warnings
183
+
184
+ def initialize(**args)
185
+ update!(**args)
186
+ end
187
+
188
+ # Update properties of this object
189
+ def update!(**args)
190
+ @blockers = args[:blockers] if args.key?(:blockers)
191
+ @warnings = args[:warnings] if args.key?(:warnings)
192
+ end
193
+ end
194
+
195
+ # Metadata for the `AnalyzeConsumerPolicy` method.
196
+ class AnalyzeConsumerPolicyMetadata
197
+ include Google::Apis::Core::Hashable
198
+
199
+ def initialize(**args)
200
+ update!(**args)
201
+ end
202
+
203
+ # Update properties of this object
204
+ def update!(**args)
205
+ end
206
+ end
207
+
208
+ # The response of analyzing a consumer policy update.
209
+ class AnalyzeConsumerPolicyResponse
210
+ include Google::Apis::Core::Hashable
211
+
212
+ # The list of analyses returned from performing the intended policy update
213
+ # analysis. The analysis is grouped by service name and different analysis types.
214
+ # The empty analysis list means that the consumer policy can be updated without
215
+ # any warnings or blockers.
216
+ # Corresponds to the JSON property `analysis`
217
+ # @return [Array<Google::Apis::ServiceusageV1::Analysis>]
218
+ attr_accessor :analysis
219
+
220
+ def initialize(**args)
221
+ update!(**args)
222
+ end
223
+
224
+ # Update properties of this object
225
+ def update!(**args)
226
+ @analysis = args[:analysis] if args.key?(:analysis)
227
+ end
228
+ end
229
+
90
230
  # Api is a light-weight descriptor for an API Interface. Interfaces are also
91
231
  # described as "protocol buffer services" in some contexts, such as by the "
92
232
  # service" keyword in a .proto file, but they are different from API Services,
93
233
  # which represent a concrete implementation of an interface as opposed to simply
94
234
  # a description of methods and bindings. They are also sometimes simply referred
95
235
  # to as "APIs" in other contexts, such as the name of this message itself. See
96
- # https://cloud.google.com/apis/design/glossary for detailed terminology.
236
+ # https://cloud.google.com/apis/design/glossary for detailed terminology. New
237
+ # usages of this message as an alternative to ServiceDescriptorProto are
238
+ # strongly discouraged. This message does not reliability preserve all
239
+ # information necessary to model the schema and preserve semantics. Instead make
240
+ # use of FileDescriptorSet which preserves the necessary information.
97
241
  class Api
98
242
  include Google::Apis::Core::Hashable
99
243
 
244
+ # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
245
+ # Corresponds to the JSON property `edition`
246
+ # @return [String]
247
+ attr_accessor :edition
248
+
100
249
  # The methods of this interface, in unspecified order.
101
250
  # Corresponds to the JSON property `methods`
102
251
  # @return [Array<Google::Apis::ServiceusageV1::MethodProp>]
@@ -152,6 +301,7 @@ module Google
152
301
 
153
302
  # Update properties of this object
154
303
  def update!(**args)
304
+ @edition = args[:edition] if args.key?(:edition)
155
305
  @methods_prop = args[:methods_prop] if args.key?(:methods_prop)
156
306
  @mixins = args[:mixins] if args.key?(:mixins)
157
307
  @name = args[:name] if args.key?(:name)
@@ -162,6 +312,33 @@ module Google
162
312
  end
163
313
  end
164
314
 
315
+ # Aspect represents Generic aspect. It is used to configure an aspect without
316
+ # making direct changes to service.proto
317
+ class Aspect
318
+ include Google::Apis::Core::Hashable
319
+
320
+ # The type of this aspect configuration.
321
+ # Corresponds to the JSON property `kind`
322
+ # @return [String]
323
+ attr_accessor :kind
324
+
325
+ # Content of the configuration. The underlying schema should be defined by
326
+ # Aspect owners as protobuf message under `google/api/configaspects/proto`.
327
+ # Corresponds to the JSON property `spec`
328
+ # @return [Hash<String,Object>]
329
+ attr_accessor :spec
330
+
331
+ def initialize(**args)
332
+ update!(**args)
333
+ end
334
+
335
+ # Update properties of this object
336
+ def update!(**args)
337
+ @kind = args[:kind] if args.key?(:kind)
338
+ @spec = args[:spec] if args.key?(:spec)
339
+ end
340
+ end
341
+
165
342
  # Configuration for an authentication provider, including support for [JSON Web
166
343
  # Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
167
344
  class AuthProvider
@@ -419,6 +596,14 @@ module Google
419
596
  # @return [String]
420
597
  attr_accessor :jwt_audience
421
598
 
599
+ # The load balancing policy used for connection to the application backend.
600
+ # Defined as an arbitrary string to accomondate custom load balancing policies
601
+ # supported by the underlying channel, but suggest most users use one of the
602
+ # standard policies, such as the default, "RoundRobin".
603
+ # Corresponds to the JSON property `loadBalancingPolicy`
604
+ # @return [String]
605
+ attr_accessor :load_balancing_policy
606
+
422
607
  # Deprecated, do not use.
423
608
  # Corresponds to the JSON property `minDeadline`
424
609
  # @return [Float]
@@ -430,7 +615,12 @@ module Google
430
615
  # @return [Float]
431
616
  attr_accessor :operation_deadline
432
617
 
433
- #
618
+ # The map between request protocol and the backend address.
619
+ # Corresponds to the JSON property `overridesByRequestProtocol`
620
+ # @return [Hash<String,Google::Apis::ServiceusageV1::BackendRule>]
621
+ attr_accessor :overrides_by_request_protocol
622
+
623
+ # no-lint
434
624
  # Corresponds to the JSON property `pathTranslation`
435
625
  # @return [String]
436
626
  attr_accessor :path_translation
@@ -464,8 +654,10 @@ module Google
464
654
  @deadline = args[:deadline] if args.key?(:deadline)
465
655
  @disable_auth = args[:disable_auth] if args.key?(:disable_auth)
466
656
  @jwt_audience = args[:jwt_audience] if args.key?(:jwt_audience)
657
+ @load_balancing_policy = args[:load_balancing_policy] if args.key?(:load_balancing_policy)
467
658
  @min_deadline = args[:min_deadline] if args.key?(:min_deadline)
468
659
  @operation_deadline = args[:operation_deadline] if args.key?(:operation_deadline)
660
+ @overrides_by_request_protocol = args[:overrides_by_request_protocol] if args.key?(:overrides_by_request_protocol)
469
661
  @path_translation = args[:path_translation] if args.key?(:path_translation)
470
662
  @protocol = args[:protocol] if args.key?(:protocol)
471
663
  @selector = args[:selector] if args.key?(:selector)
@@ -580,6 +772,140 @@ module Google
580
772
  end
581
773
  end
582
774
 
775
+ # `BatchingConfigProto` defines the batching configuration for an API method.
776
+ class BatchingConfigProto
777
+ include Google::Apis::Core::Hashable
778
+
779
+ # `BatchingDescriptorProto` specifies the fields of the request message to be
780
+ # used for batching, and, optionally, the fields of the response message to be
781
+ # used for demultiplexing.
782
+ # Corresponds to the JSON property `batchDescriptor`
783
+ # @return [Google::Apis::ServiceusageV1::BatchingDescriptorProto]
784
+ attr_accessor :batch_descriptor
785
+
786
+ # `BatchingSettingsProto` specifies a set of batching thresholds, each of which
787
+ # acts as a trigger to send a batch of messages as a request. At least one
788
+ # threshold must be positive nonzero.
789
+ # Corresponds to the JSON property `thresholds`
790
+ # @return [Google::Apis::ServiceusageV1::BatchingSettingsProto]
791
+ attr_accessor :thresholds
792
+
793
+ def initialize(**args)
794
+ update!(**args)
795
+ end
796
+
797
+ # Update properties of this object
798
+ def update!(**args)
799
+ @batch_descriptor = args[:batch_descriptor] if args.key?(:batch_descriptor)
800
+ @thresholds = args[:thresholds] if args.key?(:thresholds)
801
+ end
802
+ end
803
+
804
+ # `BatchingDescriptorProto` specifies the fields of the request message to be
805
+ # used for batching, and, optionally, the fields of the response message to be
806
+ # used for demultiplexing.
807
+ class BatchingDescriptorProto
808
+ include Google::Apis::Core::Hashable
809
+
810
+ # The repeated field in the request message to be aggregated by batching.
811
+ # Corresponds to the JSON property `batchedField`
812
+ # @return [String]
813
+ attr_accessor :batched_field
814
+
815
+ # A list of the fields in the request message. Two requests will be batched
816
+ # together only if the values of every field specified in `
817
+ # request_discriminator_fields` is equal between the two requests.
818
+ # Corresponds to the JSON property `discriminatorFields`
819
+ # @return [Array<String>]
820
+ attr_accessor :discriminator_fields
821
+
822
+ # Optional. When present, indicates the field in the response message to be used
823
+ # to demultiplex the response into multiple response messages, in correspondence
824
+ # with the multiple request messages originally batched together.
825
+ # Corresponds to the JSON property `subresponseField`
826
+ # @return [String]
827
+ attr_accessor :subresponse_field
828
+
829
+ def initialize(**args)
830
+ update!(**args)
831
+ end
832
+
833
+ # Update properties of this object
834
+ def update!(**args)
835
+ @batched_field = args[:batched_field] if args.key?(:batched_field)
836
+ @discriminator_fields = args[:discriminator_fields] if args.key?(:discriminator_fields)
837
+ @subresponse_field = args[:subresponse_field] if args.key?(:subresponse_field)
838
+ end
839
+ end
840
+
841
+ # `BatchingSettingsProto` specifies a set of batching thresholds, each of which
842
+ # acts as a trigger to send a batch of messages as a request. At least one
843
+ # threshold must be positive nonzero.
844
+ class BatchingSettingsProto
845
+ include Google::Apis::Core::Hashable
846
+
847
+ # The duration after which a batch should be sent, starting from the addition of
848
+ # the first message to that batch.
849
+ # Corresponds to the JSON property `delayThreshold`
850
+ # @return [String]
851
+ attr_accessor :delay_threshold
852
+
853
+ # The maximum number of elements collected in a batch that could be accepted by
854
+ # server.
855
+ # Corresponds to the JSON property `elementCountLimit`
856
+ # @return [Fixnum]
857
+ attr_accessor :element_count_limit
858
+
859
+ # The number of elements of a field collected into a batch which, if exceeded,
860
+ # causes the batch to be sent.
861
+ # Corresponds to the JSON property `elementCountThreshold`
862
+ # @return [Fixnum]
863
+ attr_accessor :element_count_threshold
864
+
865
+ # The maximum size of data allowed by flow control.
866
+ # Corresponds to the JSON property `flowControlByteLimit`
867
+ # @return [Fixnum]
868
+ attr_accessor :flow_control_byte_limit
869
+
870
+ # The maximum number of elements allowed by flow control.
871
+ # Corresponds to the JSON property `flowControlElementLimit`
872
+ # @return [Fixnum]
873
+ attr_accessor :flow_control_element_limit
874
+
875
+ # The behavior to take when the flow control limit is exceeded.
876
+ # Corresponds to the JSON property `flowControlLimitExceededBehavior`
877
+ # @return [String]
878
+ attr_accessor :flow_control_limit_exceeded_behavior
879
+
880
+ # The maximum size of the request that could be accepted by server.
881
+ # Corresponds to the JSON property `requestByteLimit`
882
+ # @return [Fixnum]
883
+ attr_accessor :request_byte_limit
884
+
885
+ # The aggregated size of the batched field which, if exceeded, causes the batch
886
+ # to be sent. This size is computed by aggregating the sizes of the request
887
+ # field to be batched, not of the entire request message.
888
+ # Corresponds to the JSON property `requestByteThreshold`
889
+ # @return [Fixnum]
890
+ attr_accessor :request_byte_threshold
891
+
892
+ def initialize(**args)
893
+ update!(**args)
894
+ end
895
+
896
+ # Update properties of this object
897
+ def update!(**args)
898
+ @delay_threshold = args[:delay_threshold] if args.key?(:delay_threshold)
899
+ @element_count_limit = args[:element_count_limit] if args.key?(:element_count_limit)
900
+ @element_count_threshold = args[:element_count_threshold] if args.key?(:element_count_threshold)
901
+ @flow_control_byte_limit = args[:flow_control_byte_limit] if args.key?(:flow_control_byte_limit)
902
+ @flow_control_element_limit = args[:flow_control_element_limit] if args.key?(:flow_control_element_limit)
903
+ @flow_control_limit_exceeded_behavior = args[:flow_control_limit_exceeded_behavior] if args.key?(:flow_control_limit_exceeded_behavior)
904
+ @request_byte_limit = args[:request_byte_limit] if args.key?(:request_byte_limit)
905
+ @request_byte_threshold = args[:request_byte_threshold] if args.key?(:request_byte_threshold)
906
+ end
907
+ end
908
+
583
909
  # Billing related configuration of the service. The following example shows how
584
910
  # to configure monitored resources and metrics for billing, `
585
911
  # consumer_destinations` is the only supported destination and the monitored
@@ -713,7 +1039,9 @@ module Google
713
1039
  # @return [Google::Apis::ServiceusageV1::RubySettings]
714
1040
  attr_accessor :ruby_settings
715
1041
 
716
- # Version of the API to apply these settings to.
1042
+ # Version of the API to apply these settings to. This is the full protobuf
1043
+ # package for the API, ending in the version element. Examples: "google.cloud.
1044
+ # speech.v1" and "google.spanner.admin.database.v1".
717
1045
  # Corresponds to the JSON property `version`
718
1046
  # @return [String]
719
1047
  attr_accessor :version
@@ -753,6 +1081,12 @@ module Google
753
1081
  # @return [String]
754
1082
  attr_accessor :reference_docs_uri
755
1083
 
1084
+ # This message is used to configure the generation of a subset of the RPCs in a
1085
+ # service for client libraries.
1086
+ # Corresponds to the JSON property `selectiveGapicGeneration`
1087
+ # @return [Google::Apis::ServiceusageV1::SelectiveGapicGeneration]
1088
+ attr_accessor :selective_gapic_generation
1089
+
756
1090
  def initialize(**args)
757
1091
  update!(**args)
758
1092
  end
@@ -761,6 +1095,100 @@ module Google
761
1095
  def update!(**args)
762
1096
  @destinations = args[:destinations] if args.key?(:destinations)
763
1097
  @reference_docs_uri = args[:reference_docs_uri] if args.key?(:reference_docs_uri)
1098
+ @selective_gapic_generation = args[:selective_gapic_generation] if args.key?(:selective_gapic_generation)
1099
+ end
1100
+ end
1101
+
1102
+ # Consumer Policy is a set of rules that define what services or service groups
1103
+ # can be used for a cloud resource hierarchy.
1104
+ class ConsumerPolicy
1105
+ include Google::Apis::Core::Hashable
1106
+
1107
+ # Optional. Annotations is an unstructured key-value map stored with a policy
1108
+ # that may be set by external tools to store and retrieve arbitrary metadata.
1109
+ # They are not queryable and should be preserved when modifying objects. [AIP-
1110
+ # 128](https://google.aip.dev/128#annotations)
1111
+ # Corresponds to the JSON property `annotations`
1112
+ # @return [Hash<String,String>]
1113
+ attr_accessor :annotations
1114
+
1115
+ # Enable rules define usable services and service groups.
1116
+ # Corresponds to the JSON property `enableRules`
1117
+ # @return [Array<Google::Apis::ServiceusageV1::EnableRule>]
1118
+ attr_accessor :enable_rules
1119
+
1120
+ # An opaque tag indicating the current version of the policy, used for
1121
+ # concurrency control.
1122
+ # Corresponds to the JSON property `etag`
1123
+ # @return [String]
1124
+ attr_accessor :etag
1125
+
1126
+ # Output only. The resource name of the policy. We only allow consumer policy
1127
+ # name as `default` for now: `projects/12345/consumerPolicies/default`, `folders/
1128
+ # 12345/consumerPolicies/default`, `organizations/12345/consumerPolicies/default`
1129
+ # .
1130
+ # Corresponds to the JSON property `name`
1131
+ # @return [String]
1132
+ attr_accessor :name
1133
+
1134
+ # The last-modified time.
1135
+ # Corresponds to the JSON property `updateTime`
1136
+ # @return [String]
1137
+ attr_accessor :update_time
1138
+
1139
+ def initialize(**args)
1140
+ update!(**args)
1141
+ end
1142
+
1143
+ # Update properties of this object
1144
+ def update!(**args)
1145
+ @annotations = args[:annotations] if args.key?(:annotations)
1146
+ @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
1147
+ @etag = args[:etag] if args.key?(:etag)
1148
+ @name = args[:name] if args.key?(:name)
1149
+ @update_time = args[:update_time] if args.key?(:update_time)
1150
+ end
1151
+ end
1152
+
1153
+ # ContentSecurity defines the content security related fields of a MCP policy.
1154
+ class ContentSecurity
1155
+ include Google::Apis::Core::Hashable
1156
+
1157
+ # List of content security providers that are enabled for content scanning.
1158
+ # Corresponds to the JSON property `contentSecurityProviders`
1159
+ # @return [Array<Google::Apis::ServiceusageV1::ContentSecurityProvider>]
1160
+ attr_accessor :content_security_providers
1161
+
1162
+ def initialize(**args)
1163
+ update!(**args)
1164
+ end
1165
+
1166
+ # Update properties of this object
1167
+ def update!(**args)
1168
+ @content_security_providers = args[:content_security_providers] if args.key?(:content_security_providers)
1169
+ end
1170
+ end
1171
+
1172
+ # ContentSecurityProvider contains the name of content security provider.
1173
+ class ContentSecurityProvider
1174
+ include Google::Apis::Core::Hashable
1175
+
1176
+ # Name of security service for content scanning, such as Google Cloud Model
1177
+ # Armor or supported third-party ISV solutions. If it is Google 1P service, the
1178
+ # name should be prefixed with `services/`. If it is a 3P service, the format
1179
+ # needs to be documented. The currently supported values are: - `services/
1180
+ # modelarmor.googleapis.com` for Google Cloud Model Armor.
1181
+ # Corresponds to the JSON property `name`
1182
+ # @return [String]
1183
+ attr_accessor :name
1184
+
1185
+ def initialize(**args)
1186
+ update!(**args)
1187
+ end
1188
+
1189
+ # Update properties of this object
1190
+ def update!(**args)
1191
+ @name = args[:name] if args.key?(:name)
764
1192
  end
765
1193
  end
766
1194
 
@@ -813,12 +1241,14 @@ module Google
813
1241
  # @return [Array<String>]
814
1242
  attr_accessor :allowed_response_extensions
815
1243
 
816
- # A list of full type names of provided contexts.
1244
+ # A list of full type names of provided contexts. It is used to support
1245
+ # propagating HTTP headers and ETags from the response extension.
817
1246
  # Corresponds to the JSON property `provided`
818
1247
  # @return [Array<String>]
819
1248
  attr_accessor :provided
820
1249
 
821
- # A list of full type names of requested contexts.
1250
+ # A list of full type names of requested contexts, only the requested context
1251
+ # will be made available to the backend.
822
1252
  # Corresponds to the JSON property `requested`
823
1253
  # @return [Array<String>]
824
1254
  attr_accessor :requested
@@ -855,6 +1285,11 @@ module Google
855
1285
  # @return [String]
856
1286
  attr_accessor :environment
857
1287
 
1288
+ # Defines policies applying to the API methods of the service.
1289
+ # Corresponds to the JSON property `methodPolicies`
1290
+ # @return [Array<Google::Apis::ServiceusageV1::MethodPolicy>]
1291
+ attr_accessor :method_policies
1292
+
858
1293
  def initialize(**args)
859
1294
  update!(**args)
860
1295
  end
@@ -862,6 +1297,7 @@ module Google
862
1297
  # Update properties of this object
863
1298
  def update!(**args)
864
1299
  @environment = args[:environment] if args.key?(:environment)
1300
+ @method_policies = args[:method_policies] if args.key?(:method_policies)
865
1301
  end
866
1302
  end
867
1303
 
@@ -1050,7 +1486,7 @@ module Google
1050
1486
  # documentation: summary: > The Google Calendar API gives access to most
1051
1487
  # calendar features. pages: - name: Overview content: (== include google/foo/
1052
1488
  # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
1053
- # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
1489
+ # ) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==)
1054
1490
  # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
1055
1491
  # google.calendar.Calendar.Put description: > ... Documentation is provided in
1056
1492
  # markdown syntax. In addition to standard markdown features, definition lists,
@@ -1075,6 +1511,12 @@ module Google
1075
1511
  class Documentation
1076
1512
  include Google::Apis::Core::Hashable
1077
1513
 
1514
+ # Optional information about the IAM configuration. This is typically used to
1515
+ # link to documentation about a product's IAM roles and permissions.
1516
+ # Corresponds to the JSON property `additionalIamInfo`
1517
+ # @return [String]
1518
+ attr_accessor :additional_iam_info
1519
+
1078
1520
  # The URL to the root of documentation.
1079
1521
  # Corresponds to the JSON property `documentationRootUrl`
1080
1522
  # @return [String]
@@ -1100,6 +1542,12 @@ module Google
1100
1542
  # @return [Array<Google::Apis::ServiceusageV1::DocumentationRule>]
1101
1543
  attr_accessor :rules
1102
1544
 
1545
+ # Specifies section and content to override the boilerplate content. Currently
1546
+ # overrides following sections: 1. rest.service.client_libraries
1547
+ # Corresponds to the JSON property `sectionOverrides`
1548
+ # @return [Array<Google::Apis::ServiceusageV1::Page>]
1549
+ attr_accessor :section_overrides
1550
+
1103
1551
  # Specifies the service root url if the default one (the service name from the
1104
1552
  # yaml file) is not suitable. This can be seen in any fully specified service
1105
1553
  # urls as well as sections that show a base that other urls are relative to.
@@ -1120,10 +1568,12 @@ module Google
1120
1568
 
1121
1569
  # Update properties of this object
1122
1570
  def update!(**args)
1571
+ @additional_iam_info = args[:additional_iam_info] if args.key?(:additional_iam_info)
1123
1572
  @documentation_root_url = args[:documentation_root_url] if args.key?(:documentation_root_url)
1124
1573
  @overview = args[:overview] if args.key?(:overview)
1125
1574
  @pages = args[:pages] if args.key?(:pages)
1126
1575
  @rules = args[:rules] if args.key?(:rules)
1576
+ @section_overrides = args[:section_overrides] if args.key?(:section_overrides)
1127
1577
  @service_root_url = args[:service_root_url] if args.key?(:service_root_url)
1128
1578
  @summary = args[:summary] if args.key?(:summary)
1129
1579
  end
@@ -1146,6 +1596,12 @@ module Google
1146
1596
  # @return [String]
1147
1597
  attr_accessor :description
1148
1598
 
1599
+ # String of comma or space separated case-sensitive words for which method/field
1600
+ # name replacement will be disabled.
1601
+ # Corresponds to the JSON property `disableReplacementWords`
1602
+ # @return [String]
1603
+ attr_accessor :disable_replacement_words
1604
+
1149
1605
  # The selector is a comma-separated list of patterns for any element such as a
1150
1606
  # method, a field, an enum value. Each pattern is a qualified name of the
1151
1607
  # element which may end in "*", indicating a wildcard. Wildcards are only
@@ -1165,6 +1621,7 @@ module Google
1165
1621
  def update!(**args)
1166
1622
  @deprecation_description = args[:deprecation_description] if args.key?(:deprecation_description)
1167
1623
  @description = args[:description] if args.key?(:description)
1624
+ @disable_replacement_words = args[:disable_replacement_words] if args.key?(:disable_replacement_words)
1168
1625
  @selector = args[:selector] if args.key?(:selector)
1169
1626
  end
1170
1627
  end
@@ -1178,6 +1635,42 @@ module Google
1178
1635
  # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
1179
1636
  attr_accessor :common
1180
1637
 
1638
+ # Namespaces which must be aliased in snippets due to a known (but non-generator-
1639
+ # predictable) naming collision
1640
+ # Corresponds to the JSON property `forcedNamespaceAliases`
1641
+ # @return [Array<String>]
1642
+ attr_accessor :forced_namespace_aliases
1643
+
1644
+ # Method signatures (in the form "service.method(signature)") which are provided
1645
+ # separately, so shouldn't be generated. Snippets *calling* these methods are
1646
+ # still generated, however.
1647
+ # Corresponds to the JSON property `handwrittenSignatures`
1648
+ # @return [Array<String>]
1649
+ attr_accessor :handwritten_signatures
1650
+
1651
+ # List of full resource types to ignore during generation. This is typically
1652
+ # used for API-specific Location resources, which should be handled by the
1653
+ # generator as if they were actually the common Location resources. Example
1654
+ # entry: "documentai.googleapis.com/Location"
1655
+ # Corresponds to the JSON property `ignoredResources`
1656
+ # @return [Array<String>]
1657
+ attr_accessor :ignored_resources
1658
+
1659
+ # Map from full resource types to the effective short name for the resource.
1660
+ # This is used when otherwise resource named from different services would cause
1661
+ # naming collisions. Example entry: "datalabeling.googleapis.com/Dataset": "
1662
+ # DataLabelingDataset"
1663
+ # Corresponds to the JSON property `renamedResources`
1664
+ # @return [Hash<String,String>]
1665
+ attr_accessor :renamed_resources
1666
+
1667
+ # Map from original service names to renamed versions. This is used when the
1668
+ # default generated types would cause a naming conflict. (Neither name is fully-
1669
+ # qualified.) Example: Subscriber to SubscriberServiceApi.
1670
+ # Corresponds to the JSON property `renamedServices`
1671
+ # @return [Hash<String,String>]
1672
+ attr_accessor :renamed_services
1673
+
1181
1674
  def initialize(**args)
1182
1675
  update!(**args)
1183
1676
  end
@@ -1185,6 +1678,11 @@ module Google
1185
1678
  # Update properties of this object
1186
1679
  def update!(**args)
1187
1680
  @common = args[:common] if args.key?(:common)
1681
+ @forced_namespace_aliases = args[:forced_namespace_aliases] if args.key?(:forced_namespace_aliases)
1682
+ @handwritten_signatures = args[:handwritten_signatures] if args.key?(:handwritten_signatures)
1683
+ @ignored_resources = args[:ignored_resources] if args.key?(:ignored_resources)
1684
+ @renamed_resources = args[:renamed_resources] if args.key?(:renamed_resources)
1685
+ @renamed_services = args[:renamed_services] if args.key?(:renamed_services)
1188
1686
  end
1189
1687
  end
1190
1688
 
@@ -1229,6 +1727,48 @@ module Google
1229
1727
  end
1230
1728
  end
1231
1729
 
1730
+ # The consumer policy rule that defines usable services and service groups.
1731
+ class EnableRule
1732
+ include Google::Apis::Core::Hashable
1733
+
1734
+ # Client and resource project enable type.
1735
+ # Corresponds to the JSON property `enableType`
1736
+ # @return [String]
1737
+ attr_accessor :enable_type
1738
+
1739
+ # DEPRECATED: Please use field `values`. Service group should have prefix `
1740
+ # groups/`. The names of the service groups that are enabled (Not Implemented).
1741
+ # Example: `groups/googleServices`.
1742
+ # Corresponds to the JSON property `groups`
1743
+ # @return [Array<String>]
1744
+ attr_accessor :groups
1745
+
1746
+ # DEPRECATED: Please use field `values`. Service should have prefix `services/`.
1747
+ # The names of the services that are enabled. Example: `storage.googleapis.com`.
1748
+ # Corresponds to the JSON property `services`
1749
+ # @return [Array<String>]
1750
+ attr_accessor :services
1751
+
1752
+ # The names of the services or service groups that are enabled. Example: `
1753
+ # services/storage.googleapis.com`, `groups/googleServices`, `groups/allServices`
1754
+ # .
1755
+ # Corresponds to the JSON property `values`
1756
+ # @return [Array<String>]
1757
+ attr_accessor :values
1758
+
1759
+ def initialize(**args)
1760
+ update!(**args)
1761
+ end
1762
+
1763
+ # Update properties of this object
1764
+ def update!(**args)
1765
+ @enable_type = args[:enable_type] if args.key?(:enable_type)
1766
+ @groups = args[:groups] if args.key?(:groups)
1767
+ @services = args[:services] if args.key?(:services)
1768
+ @values = args[:values] if args.key?(:values)
1769
+ end
1770
+ end
1771
+
1232
1772
  # Request message for the `EnableService` method.
1233
1773
  class EnableServiceRequest
1234
1774
  include Google::Apis::Core::Hashable
@@ -1278,9 +1818,9 @@ module Google
1278
1818
  class Endpoint
1279
1819
  include Google::Apis::Core::Hashable
1280
1820
 
1281
- # Unimplemented. Dot not use. DEPRECATED: This field is no longer supported.
1282
- # Instead of using aliases, please specify multiple google.api.Endpoint for each
1283
- # of the intended aliases. Additional names that this endpoint will be hosted on.
1821
+ # Aliases for this endpoint, these will be served by the same UrlMap as the
1822
+ # parent endpoint, and will be provisioned in the GCP stack for the Regional
1823
+ # Endpoints.
1284
1824
  # Corresponds to the JSON property `aliases`
1285
1825
  # @return [Array<String>]
1286
1826
  attr_accessor :aliases
@@ -1321,10 +1861,19 @@ module Google
1321
1861
  end
1322
1862
  end
1323
1863
 
1324
- # Enum type definition.
1864
+ # Enum type definition. New usages of this message as an alternative to
1865
+ # EnumDescriptorProto are strongly discouraged. This message does not
1866
+ # reliability preserve all information necessary to model the schema and
1867
+ # preserve semantics. Instead make use of FileDescriptorSet which preserves the
1868
+ # necessary information.
1325
1869
  class Enum
1326
1870
  include Google::Apis::Core::Hashable
1327
1871
 
1872
+ # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
1873
+ # Corresponds to the JSON property `edition`
1874
+ # @return [String]
1875
+ attr_accessor :edition
1876
+
1328
1877
  # Enum value definitions.
1329
1878
  # Corresponds to the JSON property `enumvalue`
1330
1879
  # @return [Array<Google::Apis::ServiceusageV1::EnumValue>]
@@ -1357,6 +1906,7 @@ module Google
1357
1906
 
1358
1907
  # Update properties of this object
1359
1908
  def update!(**args)
1909
+ @edition = args[:edition] if args.key?(:edition)
1360
1910
  @enumvalue = args[:enumvalue] if args.key?(:enumvalue)
1361
1911
  @name = args[:name] if args.key?(:name)
1362
1912
  @options = args[:options] if args.key?(:options)
@@ -1365,7 +1915,11 @@ module Google
1365
1915
  end
1366
1916
  end
1367
1917
 
1368
- # Enum value definition.
1918
+ # Enum value definition. New usages of this message as an alternative to
1919
+ # EnumValueDescriptorProto are strongly discouraged. This message does not
1920
+ # reliability preserve all information necessary to model the schema and
1921
+ # preserve semantics. Instead make use of FileDescriptorSet which preserves the
1922
+ # necessary information.
1369
1923
  class EnumValue
1370
1924
  include Google::Apis::Core::Hashable
1371
1925
 
@@ -1396,7 +1950,54 @@ module Google
1396
1950
  end
1397
1951
  end
1398
1952
 
1399
- # A single field of a message type.
1953
+ # Experimental features to be included during client library generation. These
1954
+ # fields will be deprecated once the feature graduates and is enabled by default.
1955
+ class ExperimentalFeatures
1956
+ include Google::Apis::Core::Hashable
1957
+
1958
+ # Enables generation of protobuf code using new types that are more Pythonic
1959
+ # which are included in `protobuf>=5.29.x`. This feature will be enabled by
1960
+ # default 1 month after launching the feature in preview packages.
1961
+ # Corresponds to the JSON property `protobufPythonicTypesEnabled`
1962
+ # @return [Boolean]
1963
+ attr_accessor :protobuf_pythonic_types_enabled
1964
+ alias_method :protobuf_pythonic_types_enabled?, :protobuf_pythonic_types_enabled
1965
+
1966
+ # Enables generation of asynchronous REST clients if `rest` transport is enabled.
1967
+ # By default, asynchronous REST clients will not be generated. This feature
1968
+ # will be enabled by default 1 month after launching the feature in preview
1969
+ # packages.
1970
+ # Corresponds to the JSON property `restAsyncIoEnabled`
1971
+ # @return [Boolean]
1972
+ attr_accessor :rest_async_io_enabled
1973
+ alias_method :rest_async_io_enabled?, :rest_async_io_enabled
1974
+
1975
+ # Disables generation of an unversioned Python package for this client library.
1976
+ # This means that the module names will need to be versioned in import
1977
+ # statements. For example `import google.cloud.library_v2` instead of `import
1978
+ # google.cloud.library`.
1979
+ # Corresponds to the JSON property `unversionedPackageDisabled`
1980
+ # @return [Boolean]
1981
+ attr_accessor :unversioned_package_disabled
1982
+ alias_method :unversioned_package_disabled?, :unversioned_package_disabled
1983
+
1984
+ def initialize(**args)
1985
+ update!(**args)
1986
+ end
1987
+
1988
+ # Update properties of this object
1989
+ def update!(**args)
1990
+ @protobuf_pythonic_types_enabled = args[:protobuf_pythonic_types_enabled] if args.key?(:protobuf_pythonic_types_enabled)
1991
+ @rest_async_io_enabled = args[:rest_async_io_enabled] if args.key?(:rest_async_io_enabled)
1992
+ @unversioned_package_disabled = args[:unversioned_package_disabled] if args.key?(:unversioned_package_disabled)
1993
+ end
1994
+ end
1995
+
1996
+ # A single field of a message type. New usages of this message as an alternative
1997
+ # to FieldDescriptorProto are strongly discouraged. This message does not
1998
+ # reliability preserve all information necessary to model the schema and
1999
+ # preserve semantics. Instead make use of FileDescriptorSet which preserves the
2000
+ # necessary information.
1400
2001
  class Field
1401
2002
  include Google::Apis::Core::Hashable
1402
2003
 
@@ -1472,6 +2073,50 @@ module Google
1472
2073
  end
1473
2074
  end
1474
2075
 
2076
+ # Google API Policy Annotation This message defines a simple API policy
2077
+ # annotation that can be used to annotate API request and response message
2078
+ # fields with applicable policies. One field may have multiple applicable
2079
+ # policies that must all be satisfied before a request can be processed. This
2080
+ # policy annotation is used to generate the overall policy that will be used for
2081
+ # automatic runtime policy enforcement and documentation generation.
2082
+ class FieldPolicy
2083
+ include Google::Apis::Core::Hashable
2084
+
2085
+ # Specifies the required permission(s) for the resource referred to by the field.
2086
+ # It requires the field contains a valid resource reference, and the request
2087
+ # must pass the permission checks to proceed. For example, "resourcemanager.
2088
+ # projects.get".
2089
+ # Corresponds to the JSON property `resourcePermission`
2090
+ # @return [String]
2091
+ attr_accessor :resource_permission
2092
+
2093
+ # Specifies the resource type for the resource referred to by the field.
2094
+ # Corresponds to the JSON property `resourceType`
2095
+ # @return [String]
2096
+ attr_accessor :resource_type
2097
+
2098
+ # Selects one or more request or response message fields to apply this `
2099
+ # FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector
2100
+ # must be left as empty. The service config generator will automatically fill
2101
+ # the correct value. When a `FieldPolicy` is used in service config, the
2102
+ # selector must be a comma-separated string with valid request or response field
2103
+ # paths, such as "foo.bar" or "foo.bar,foo.baz".
2104
+ # Corresponds to the JSON property `selector`
2105
+ # @return [String]
2106
+ attr_accessor :selector
2107
+
2108
+ def initialize(**args)
2109
+ update!(**args)
2110
+ end
2111
+
2112
+ # Update properties of this object
2113
+ def update!(**args)
2114
+ @resource_permission = args[:resource_permission] if args.key?(:resource_permission)
2115
+ @resource_type = args[:resource_type] if args.key?(:resource_type)
2116
+ @selector = args[:selector] if args.key?(:selector)
2117
+ end
2118
+ end
2119
+
1475
2120
  # Metadata for the `GetServiceIdentity` method.
1476
2121
  class GetServiceIdentityMetadata
1477
2122
  include Google::Apis::Core::Hashable
@@ -1520,6 +2165,14 @@ module Google
1520
2165
  # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
1521
2166
  attr_accessor :common
1522
2167
 
2168
+ # Map of service names to renamed services. Keys are the package relative
2169
+ # service names and values are the name to be used for the service client and
2170
+ # call options. Example: publishing: go_settings: renamed_services: Publisher:
2171
+ # TopicAdmin
2172
+ # Corresponds to the JSON property `renamedServices`
2173
+ # @return [Hash<String,String>]
2174
+ attr_accessor :renamed_services
2175
+
1523
2176
  def initialize(**args)
1524
2177
  update!(**args)
1525
2178
  end
@@ -1527,6 +2180,7 @@ module Google
1527
2180
  # Update properties of this object
1528
2181
  def update!(**args)
1529
2182
  @common = args[:common] if args.key?(:common)
2183
+ @renamed_services = args[:renamed_services] if args.key?(:renamed_services)
1530
2184
  end
1531
2185
  end
1532
2186
 
@@ -1555,6 +2209,14 @@ module Google
1555
2209
  # @return [Array<Google::Apis::ServiceusageV1::Api>]
1556
2210
  attr_accessor :apis
1557
2211
 
2212
+ # Configuration aspects. This is a repeated field to allow multiple aspects to
2213
+ # be configured. The kind field in each ConfigAspect specifies the type of
2214
+ # aspect. The spec field contains the configuration for that aspect. The schema
2215
+ # for the spec field is defined by the backend service owners.
2216
+ # Corresponds to the JSON property `aspects`
2217
+ # @return [Array<Google::Apis::ServiceusageV1::Aspect>]
2218
+ attr_accessor :aspects
2219
+
1558
2220
  # `Authentication` defines the authentication configuration for API methods
1559
2221
  # provided by an API service. Example: name: calendar.googleapis.com
1560
2222
  # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
@@ -1631,7 +2293,7 @@ module Google
1631
2293
  # documentation: summary: > The Google Calendar API gives access to most
1632
2294
  # calendar features. pages: - name: Overview content: (== include google/foo/
1633
2295
  # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
1634
- # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
2296
+ # ) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==)
1635
2297
  # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
1636
2298
  # google.calendar.Calendar.Put description: > ... Documentation is provided in
1637
2299
  # markdown syntax. In addition to standard markdown features, definition lists,
@@ -1834,6 +2496,7 @@ module Google
1834
2496
  # Update properties of this object
1835
2497
  def update!(**args)
1836
2498
  @apis = args[:apis] if args.key?(:apis)
2499
+ @aspects = args[:aspects] if args.key?(:aspects)
1837
2500
  @authentication = args[:authentication] if args.key?(:authentication)
1838
2501
  @backend = args[:backend] if args.key?(:backend)
1839
2502
  @billing = args[:billing] if args.key?(:billing)
@@ -1946,7 +2609,7 @@ module Google
1946
2609
  # documentation: summary: > The Google Calendar API gives access to most
1947
2610
  # calendar features. pages: - name: Overview content: (== include google/foo/
1948
2611
  # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
1949
- # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
2612
+ # ) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==)
1950
2613
  # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
1951
2614
  # google.calendar.Calendar.Put description: > ... Documentation is provided in
1952
2615
  # markdown syntax. In addition to standard markdown features, definition lists,
@@ -2039,15 +2702,324 @@ module Google
2039
2702
  # @return [Google::Apis::ServiceusageV1::Quota]
2040
2703
  attr_accessor :quota
2041
2704
 
2042
- # The product title for this service.
2043
- # Corresponds to the JSON property `title`
2705
+ # The product title for this service.
2706
+ # Corresponds to the JSON property `title`
2707
+ # @return [String]
2708
+ attr_accessor :title
2709
+
2710
+ # Configuration controlling usage of a service.
2711
+ # Corresponds to the JSON property `usage`
2712
+ # @return [Google::Apis::ServiceusageV1::Usage]
2713
+ attr_accessor :usage
2714
+
2715
+ def initialize(**args)
2716
+ update!(**args)
2717
+ end
2718
+
2719
+ # Update properties of this object
2720
+ def update!(**args)
2721
+ @apis = args[:apis] if args.key?(:apis)
2722
+ @authentication = args[:authentication] if args.key?(:authentication)
2723
+ @documentation = args[:documentation] if args.key?(:documentation)
2724
+ @endpoints = args[:endpoints] if args.key?(:endpoints)
2725
+ @monitored_resources = args[:monitored_resources] if args.key?(:monitored_resources)
2726
+ @monitoring = args[:monitoring] if args.key?(:monitoring)
2727
+ @name = args[:name] if args.key?(:name)
2728
+ @quota = args[:quota] if args.key?(:quota)
2729
+ @title = args[:title] if args.key?(:title)
2730
+ @usage = args[:usage] if args.key?(:usage)
2731
+ end
2732
+ end
2733
+
2734
+ # Response message for getting service identity.
2735
+ class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
2736
+ include Google::Apis::Core::Hashable
2737
+
2738
+ # Service identity for a service. This is the identity that service producer
2739
+ # should use to access consumer resources.
2740
+ # Corresponds to the JSON property `identity`
2741
+ # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV1beta1ServiceIdentity]
2742
+ attr_accessor :identity
2743
+
2744
+ # Service identity state.
2745
+ # Corresponds to the JSON property `state`
2746
+ # @return [String]
2747
+ attr_accessor :state
2748
+
2749
+ def initialize(**args)
2750
+ update!(**args)
2751
+ end
2752
+
2753
+ # Update properties of this object
2754
+ def update!(**args)
2755
+ @identity = args[:identity] if args.key?(:identity)
2756
+ @state = args[:state] if args.key?(:state)
2757
+ end
2758
+ end
2759
+
2760
+ # Service identity for a service. This is the identity that service producer
2761
+ # should use to access consumer resources.
2762
+ class GoogleApiServiceusageV1beta1ServiceIdentity
2763
+ include Google::Apis::Core::Hashable
2764
+
2765
+ # The email address of the service account that a service producer would use to
2766
+ # access consumer resources.
2767
+ # Corresponds to the JSON property `email`
2768
+ # @return [String]
2769
+ attr_accessor :email
2770
+
2771
+ # The unique and stable id of the service account. https://cloud.google.com/iam/
2772
+ # reference/rest/v1/projects.serviceAccounts#ServiceAccount
2773
+ # Corresponds to the JSON property `uniqueId`
2774
+ # @return [String]
2775
+ attr_accessor :unique_id
2776
+
2777
+ def initialize(**args)
2778
+ update!(**args)
2779
+ end
2780
+
2781
+ # Update properties of this object
2782
+ def update!(**args)
2783
+ @email = args[:email] if args.key?(:email)
2784
+ @unique_id = args[:unique_id] if args.key?(:unique_id)
2785
+ end
2786
+ end
2787
+
2788
+ # Consumer Policy is a set of rules that define what services or service groups
2789
+ # can be used for a cloud resource hierarchy.
2790
+ class GoogleApiServiceusageV2alphaConsumerPolicy
2791
+ include Google::Apis::Core::Hashable
2792
+
2793
+ # Optional. Annotations is an unstructured key-value map stored with a policy
2794
+ # that may be set by external tools to store and retrieve arbitrary metadata.
2795
+ # They are not queryable and should be preserved when modifying objects. [AIP-
2796
+ # 128](https://google.aip.dev/128#annotations)
2797
+ # Corresponds to the JSON property `annotations`
2798
+ # @return [Hash<String,String>]
2799
+ attr_accessor :annotations
2800
+
2801
+ # Output only. The time the policy was created. For singleton policies, this is
2802
+ # the first touch of the policy.
2803
+ # Corresponds to the JSON property `createTime`
2804
+ # @return [String]
2805
+ attr_accessor :create_time
2806
+
2807
+ # Enable rules define usable services, groups, and categories. There can
2808
+ # currently be at most one `EnableRule`. This restriction will be lifted in
2809
+ # later releases.
2810
+ # Corresponds to the JSON property `enableRules`
2811
+ # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2alphaEnableRule>]
2812
+ attr_accessor :enable_rules
2813
+
2814
+ # Output only. An opaque tag indicating the current version of the policy, used
2815
+ # for concurrency control.
2816
+ # Corresponds to the JSON property `etag`
2817
+ # @return [String]
2818
+ attr_accessor :etag
2819
+
2820
+ # Output only. The resource name of the policy. Only the `default` policy is
2821
+ # supported: `projects/12345/consumerPolicies/default`, `folders/12345/
2822
+ # consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.
2823
+ # Corresponds to the JSON property `name`
2824
+ # @return [String]
2825
+ attr_accessor :name
2826
+
2827
+ # Output only. The time the policy was last updated.
2828
+ # Corresponds to the JSON property `updateTime`
2829
+ # @return [String]
2830
+ attr_accessor :update_time
2831
+
2832
+ def initialize(**args)
2833
+ update!(**args)
2834
+ end
2835
+
2836
+ # Update properties of this object
2837
+ def update!(**args)
2838
+ @annotations = args[:annotations] if args.key?(:annotations)
2839
+ @create_time = args[:create_time] if args.key?(:create_time)
2840
+ @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
2841
+ @etag = args[:etag] if args.key?(:etag)
2842
+ @name = args[:name] if args.key?(:name)
2843
+ @update_time = args[:update_time] if args.key?(:update_time)
2844
+ end
2845
+ end
2846
+
2847
+ # The consumer policy rule that defines enabled services, groups, and categories.
2848
+ class GoogleApiServiceusageV2alphaEnableRule
2849
+ include Google::Apis::Core::Hashable
2850
+
2851
+ # The names of the services that are enabled. Example: `services/storage.
2852
+ # googleapis.com`.
2853
+ # Corresponds to the JSON property `services`
2854
+ # @return [Array<String>]
2855
+ attr_accessor :services
2856
+
2857
+ def initialize(**args)
2858
+ update!(**args)
2859
+ end
2860
+
2861
+ # Update properties of this object
2862
+ def update!(**args)
2863
+ @services = args[:services] if args.key?(:services)
2864
+ end
2865
+ end
2866
+
2867
+ # Metadata for the `UpdateConsumerPolicy` method.
2868
+ class GoogleApiServiceusageV2alphaUpdateConsumerPolicyMetadata
2869
+ include Google::Apis::Core::Hashable
2870
+
2871
+ def initialize(**args)
2872
+ update!(**args)
2873
+ end
2874
+
2875
+ # Update properties of this object
2876
+ def update!(**args)
2877
+ end
2878
+ end
2879
+
2880
+ # A message to group the analysis information.
2881
+ class GoogleApiServiceusageV2betaAnalysis
2882
+ include Google::Apis::Core::Hashable
2883
+
2884
+ # An analysis result including blockers and warnings.
2885
+ # Corresponds to the JSON property `analysisResult`
2886
+ # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaAnalysisResult]
2887
+ attr_accessor :analysis_result
2888
+
2889
+ # Output only. The type of analysis.
2890
+ # Corresponds to the JSON property `analysisType`
2891
+ # @return [String]
2892
+ attr_accessor :analysis_type
2893
+
2894
+ # Output only. The user friendly display name of the analysis type. E.g. service
2895
+ # dependency analysis, service resource usage analysis, etc.
2896
+ # Corresponds to the JSON property `displayName`
2897
+ # @return [String]
2898
+ attr_accessor :display_name
2899
+
2900
+ # The names of the service that has analysis result of warnings or blockers.
2901
+ # Example: `services/storage.googleapis.com`.
2902
+ # Corresponds to the JSON property `service`
2903
+ # @return [String]
2904
+ attr_accessor :service
2905
+
2906
+ def initialize(**args)
2907
+ update!(**args)
2908
+ end
2909
+
2910
+ # Update properties of this object
2911
+ def update!(**args)
2912
+ @analysis_result = args[:analysis_result] if args.key?(:analysis_result)
2913
+ @analysis_type = args[:analysis_type] if args.key?(:analysis_type)
2914
+ @display_name = args[:display_name] if args.key?(:display_name)
2915
+ @service = args[:service] if args.key?(:service)
2916
+ end
2917
+ end
2918
+
2919
+ # An analysis result including blockers and warnings.
2920
+ class GoogleApiServiceusageV2betaAnalysisResult
2921
+ include Google::Apis::Core::Hashable
2922
+
2923
+ # Blocking information that would prevent the policy changes at runtime.
2924
+ # Corresponds to the JSON property `blockers`
2925
+ # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaImpact>]
2926
+ attr_accessor :blockers
2927
+
2928
+ # Warning information indicating that the policy changes might be unsafe, but
2929
+ # will not block the changes at runtime.
2930
+ # Corresponds to the JSON property `warnings`
2931
+ # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaImpact>]
2932
+ attr_accessor :warnings
2933
+
2934
+ def initialize(**args)
2935
+ update!(**args)
2936
+ end
2937
+
2938
+ # Update properties of this object
2939
+ def update!(**args)
2940
+ @blockers = args[:blockers] if args.key?(:blockers)
2941
+ @warnings = args[:warnings] if args.key?(:warnings)
2942
+ end
2943
+ end
2944
+
2945
+ # Metadata for the `AnalyzeConsumerPolicy` method.
2946
+ class GoogleApiServiceusageV2betaAnalyzeConsumerPolicyMetadata
2947
+ include Google::Apis::Core::Hashable
2948
+
2949
+ def initialize(**args)
2950
+ update!(**args)
2951
+ end
2952
+
2953
+ # Update properties of this object
2954
+ def update!(**args)
2955
+ end
2956
+ end
2957
+
2958
+ # The response of analyzing a consumer policy update.
2959
+ class GoogleApiServiceusageV2betaAnalyzeConsumerPolicyResponse
2960
+ include Google::Apis::Core::Hashable
2961
+
2962
+ # The list of analyses returned from performing the intended policy update
2963
+ # analysis. The analysis is grouped by service name and different analysis types.
2964
+ # The empty analysis list means that the consumer policy can be updated without
2965
+ # any warnings or blockers.
2966
+ # Corresponds to the JSON property `analysis`
2967
+ # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaAnalysis>]
2968
+ attr_accessor :analysis
2969
+
2970
+ def initialize(**args)
2971
+ update!(**args)
2972
+ end
2973
+
2974
+ # Update properties of this object
2975
+ def update!(**args)
2976
+ @analysis = args[:analysis] if args.key?(:analysis)
2977
+ end
2978
+ end
2979
+
2980
+ # Consumer Policy is a set of rules that define what services or service groups
2981
+ # can be used for a cloud resource hierarchy.
2982
+ class GoogleApiServiceusageV2betaConsumerPolicy
2983
+ include Google::Apis::Core::Hashable
2984
+
2985
+ # Optional. Annotations is an unstructured key-value map stored with a policy
2986
+ # that may be set by external tools to store and retrieve arbitrary metadata.
2987
+ # They are not queryable and should be preserved when modifying objects. [AIP-
2988
+ # 128](https://google.aip.dev/128#annotations)
2989
+ # Corresponds to the JSON property `annotations`
2990
+ # @return [Hash<String,String>]
2991
+ attr_accessor :annotations
2992
+
2993
+ # Output only. The time the policy was created. For singleton policies, this is
2994
+ # the first touch of the policy.
2995
+ # Corresponds to the JSON property `createTime`
2044
2996
  # @return [String]
2045
- attr_accessor :title
2997
+ attr_accessor :create_time
2046
2998
 
2047
- # Configuration controlling usage of a service.
2048
- # Corresponds to the JSON property `usage`
2049
- # @return [Google::Apis::ServiceusageV1::Usage]
2050
- attr_accessor :usage
2999
+ # Enable rules define usable services, groups, and categories. There can
3000
+ # currently be at most one `EnableRule`. This restriction will be lifted in
3001
+ # later releases.
3002
+ # Corresponds to the JSON property `enableRules`
3003
+ # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaEnableRule>]
3004
+ attr_accessor :enable_rules
3005
+
3006
+ # An opaque tag indicating the current version of the policy, used for
3007
+ # concurrency control.
3008
+ # Corresponds to the JSON property `etag`
3009
+ # @return [String]
3010
+ attr_accessor :etag
3011
+
3012
+ # Output only. The resource name of the policy. Only the `default` policy is
3013
+ # supported: `projects/12345/consumerPolicies/default`, `folders/12345/
3014
+ # consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.
3015
+ # Corresponds to the JSON property `name`
3016
+ # @return [String]
3017
+ attr_accessor :name
3018
+
3019
+ # Output only. The time the policy was last updated.
3020
+ # Corresponds to the JSON property `updateTime`
3021
+ # @return [String]
3022
+ attr_accessor :update_time
2051
3023
 
2052
3024
  def initialize(**args)
2053
3025
  update!(**args)
@@ -2055,33 +3027,24 @@ module Google
2055
3027
 
2056
3028
  # Update properties of this object
2057
3029
  def update!(**args)
2058
- @apis = args[:apis] if args.key?(:apis)
2059
- @authentication = args[:authentication] if args.key?(:authentication)
2060
- @documentation = args[:documentation] if args.key?(:documentation)
2061
- @endpoints = args[:endpoints] if args.key?(:endpoints)
2062
- @monitored_resources = args[:monitored_resources] if args.key?(:monitored_resources)
2063
- @monitoring = args[:monitoring] if args.key?(:monitoring)
3030
+ @annotations = args[:annotations] if args.key?(:annotations)
3031
+ @create_time = args[:create_time] if args.key?(:create_time)
3032
+ @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
3033
+ @etag = args[:etag] if args.key?(:etag)
2064
3034
  @name = args[:name] if args.key?(:name)
2065
- @quota = args[:quota] if args.key?(:quota)
2066
- @title = args[:title] if args.key?(:title)
2067
- @usage = args[:usage] if args.key?(:usage)
3035
+ @update_time = args[:update_time] if args.key?(:update_time)
2068
3036
  end
2069
3037
  end
2070
3038
 
2071
- # Response message for getting service identity.
2072
- class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
3039
+ # The consumer policy rule that defines enabled services, groups, and categories.
3040
+ class GoogleApiServiceusageV2betaEnableRule
2073
3041
  include Google::Apis::Core::Hashable
2074
3042
 
2075
- # Service identity for a service. This is the identity that service producer
2076
- # should use to access consumer resources.
2077
- # Corresponds to the JSON property `identity`
2078
- # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV1beta1ServiceIdentity]
2079
- attr_accessor :identity
2080
-
2081
- # Service identity state.
2082
- # Corresponds to the JSON property `state`
2083
- # @return [String]
2084
- attr_accessor :state
3043
+ # The names of the services that are enabled. Example: `services/storage.
3044
+ # googleapis.com`.
3045
+ # Corresponds to the JSON property `services`
3046
+ # @return [Array<String>]
3047
+ attr_accessor :services
2085
3048
 
2086
3049
  def initialize(**args)
2087
3050
  update!(**args)
@@ -2089,27 +3052,47 @@ module Google
2089
3052
 
2090
3053
  # Update properties of this object
2091
3054
  def update!(**args)
2092
- @identity = args[:identity] if args.key?(:identity)
2093
- @state = args[:state] if args.key?(:state)
3055
+ @services = args[:services] if args.key?(:services)
2094
3056
  end
2095
3057
  end
2096
3058
 
2097
- # Service identity for a service. This is the identity that service producer
2098
- # should use to access consumer resources.
2099
- class GoogleApiServiceusageV1beta1ServiceIdentity
3059
+ # A message to group impacts of updating a policy.
3060
+ class GoogleApiServiceusageV2betaImpact
2100
3061
  include Google::Apis::Core::Hashable
2101
3062
 
2102
- # The email address of the service account that a service producer would use to
2103
- # access consumer resources.
2104
- # Corresponds to the JSON property `email`
3063
+ # Output only. User friendly impact detail in a free form message.
3064
+ # Corresponds to the JSON property `detail`
2105
3065
  # @return [String]
2106
- attr_accessor :email
3066
+ attr_accessor :detail
2107
3067
 
2108
- # The unique and stable id of the service account. https://cloud.google.com/iam/
2109
- # reference/rest/v1/projects.serviceAccounts#ServiceAccount
2110
- # Corresponds to the JSON property `uniqueId`
3068
+ # Output only. The type of impact.
3069
+ # Corresponds to the JSON property `impactType`
2111
3070
  # @return [String]
2112
- attr_accessor :unique_id
3071
+ attr_accessor :impact_type
3072
+
3073
+ # Output only. This field will be populated only for the `
3074
+ # DEPENDENCY_MISSING_DEPENDENCIES` impact type. Example: `services/compute.
3075
+ # googleapis.com`. Impact.detail will be in format : `missing service dependency:
3076
+ # `missing_dependency`.`
3077
+ # Corresponds to the JSON property `missingDependency`
3078
+ # @return [String]
3079
+ attr_accessor :missing_dependency
3080
+
3081
+ def initialize(**args)
3082
+ update!(**args)
3083
+ end
3084
+
3085
+ # Update properties of this object
3086
+ def update!(**args)
3087
+ @detail = args[:detail] if args.key?(:detail)
3088
+ @impact_type = args[:impact_type] if args.key?(:impact_type)
3089
+ @missing_dependency = args[:missing_dependency] if args.key?(:missing_dependency)
3090
+ end
3091
+ end
3092
+
3093
+ # Metadata for the `UpdateConsumerPolicy` method.
3094
+ class GoogleApiServiceusageV2betaUpdateConsumerPolicyMetadata
3095
+ include Google::Apis::Core::Hashable
2113
3096
 
2114
3097
  def initialize(**args)
2115
3098
  update!(**args)
@@ -2117,8 +3100,6 @@ module Google
2117
3100
 
2118
3101
  # Update properties of this object
2119
3102
  def update!(**args)
2120
- @email = args[:email] if args.key?(:email)
2121
- @unique_id = args[:unique_id] if args.key?(:unique_id)
2122
3103
  end
2123
3104
  end
2124
3105
 
@@ -2154,7 +3135,7 @@ module Google
2154
3135
  end
2155
3136
  end
2156
3137
 
2157
- # # gRPC Transcoding gRPC Transcoding is a feature for mapping between a gRPC
3138
+ # gRPC Transcoding gRPC Transcoding is a feature for mapping between a gRPC
2158
3139
  # method and one or more HTTP REST endpoints. It allows developers to build a
2159
3140
  # single API service that supports both gRPC APIs and REST APIs. Many systems,
2160
3141
  # including [Google APIs](https://github.com/googleapis/googleapis), [Cloud
@@ -2174,70 +3155,69 @@ module Google
2174
3155
  # Message) ` option (google.api.http) = ` get: "/v1/`name=messages/*`" `; ` `
2175
3156
  # message GetMessageRequest ` string name = 1; // Mapped to URL path. ` message
2176
3157
  # Message ` string text = 1; // The resource content. ` This enables an HTTP
2177
- # REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET /v1/messages/
2178
- # 123456` | `GetMessage(name: "messages/123456")` Any fields in the request
2179
- # message which are not bound by the path template automatically become HTTP
2180
- # query parameters if there is no HTTP request body. For example: service
2181
- # Messaging ` rpc GetMessage(GetMessageRequest) returns (Message) ` option (
2182
- # google.api.http) = ` get:"/v1/messages/`message_id`" `; ` ` message
2183
- # GetMessageRequest ` message SubMessage ` string subfield = 1; ` string
2184
- # message_id = 1; // Mapped to URL path. int64 revision = 2; // Mapped to URL
2185
- # query parameter `revision`. SubMessage sub = 3; // Mapped to URL query
2186
- # parameter `sub.subfield`. ` This enables a HTTP JSON to RPC mapping as below:
2187
- # HTTP | gRPC -----|----- `GET /v1/messages/123456?revision=2&sub.subfield=foo` |
2188
- # `GetMessage(message_id: "123456" revision: 2 sub: SubMessage(subfield: "foo"))
2189
- # ` Note that fields which are mapped to URL query parameters must have a
2190
- # primitive type or a repeated primitive type or a non-repeated message type. In
2191
- # the case of a repeated type, the parameter can be repeated in the URL as `...?
2192
- # param=A&param=B`. In the case of a message type, each field of the message is
2193
- # mapped to a separate parameter, such as `...?foo.a=A&foo.b=B&foo.c=C`. For
2194
- # HTTP methods that allow a request body, the `body` field specifies the mapping.
2195
- # Consider a REST update method on the message resource collection: service
2196
- # Messaging ` rpc UpdateMessage(UpdateMessageRequest) returns (Message) ` option
2197
- # (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "message" `; ` `
2198
- # message UpdateMessageRequest ` string message_id = 1; // mapped to the URL
2199
- # Message message = 2; // mapped to the body ` The following HTTP JSON to RPC
2200
- # mapping is enabled, where the representation of the JSON in the request body
2201
- # is determined by protos JSON encoding: HTTP | gRPC -----|----- `PATCH /v1/
2202
- # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456"
2203
- # message ` text: "Hi!" `)` The special name `*` can be used in the body mapping
2204
- # to define that every field not bound by the path template should be mapped to
2205
- # the request body. This enables the following alternative definition of the
2206
- # update method: service Messaging ` rpc UpdateMessage(Message) returns (Message)
2207
- # ` option (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "*" `;
2208
- # ` ` message Message ` string message_id = 1; string text = 2; ` The following
2209
- # HTTP JSON to RPC mapping is enabled: HTTP | gRPC -----|----- `PATCH /v1/
2210
- # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456" text:
2211
- # "Hi!")` Note that when using `*` in the body mapping, it is not possible to
2212
- # have HTTP parameters, as all fields not bound by the path end in the body.
2213
- # This makes this option more rarely used in practice when defining REST APIs.
2214
- # The common usage of `*` is in custom methods which don't use the URL at all
2215
- # for transferring data. It is possible to define multiple HTTP methods for one
2216
- # RPC by using the `additional_bindings` option. Example: service Messaging `
2217
- # rpc GetMessage(GetMessageRequest) returns (Message) ` option (google.api.http)
2218
- # = ` get: "/v1/messages/`message_id`" additional_bindings ` get: "/v1/users/`
2219
- # user_id`/messages/`message_id`" ` `; ` ` message GetMessageRequest ` string
2220
- # message_id = 1; string user_id = 2; ` This enables the following two
2221
- # alternative HTTP JSON to RPC mappings: HTTP | gRPC -----|----- `GET /v1/
2222
- # messages/123456` | `GetMessage(message_id: "123456")` `GET /v1/users/me/
2223
- # messages/123456` | `GetMessage(user_id: "me" message_id: "123456")` ## Rules
2224
- # for HTTP mapping 1. Leaf request fields (recursive expansion nested messages
2225
- # in the request message) are classified into three categories: - Fields
2226
- # referred by the path template. They are passed via the URL path. - Fields
2227
- # referred by the HttpRule.body. They are passed via the HTTP request body. -
2228
- # All other fields are passed via the URL query parameters, and the parameter
2229
- # name is the field path in the request message. A repeated field can be
2230
- # represented as multiple query parameters under the same name. 2. If HttpRule.
2231
- # body is "*", there is no URL query parameter, all fields are passed via URL
2232
- # path and HTTP request body. 3. If HttpRule.body is omitted, there is no HTTP
2233
- # request body, all fields are passed via URL path and URL query parameters. ###
2234
- # Path template syntax Template = "/" Segments [ Verb ] ; Segments = Segment ` "/
2235
- # " Segment ` ; Segment = "*" | "**" | LITERAL | Variable ; Variable = "`"
2236
- # FieldPath [ "=" Segments ] "`" ; FieldPath = IDENT ` "." IDENT ` ; Verb = ":"
2237
- # LITERAL ; The syntax `*` matches a single URL path segment. The syntax `**`
2238
- # matches zero or more URL path segments, which must be the last part of the URL
2239
- # path except the `Verb`. The syntax `Variable` matches part of the URL path as
2240
- # specified by its template. A variable template must not contain other
3158
+ # REST to gRPC mapping as below: - HTTP: `GET /v1/messages/123456` - gRPC: `
3159
+ # GetMessage(name: "messages/123456")` Any fields in the request message which
3160
+ # are not bound by the path template automatically become HTTP query parameters
3161
+ # if there is no HTTP request body. For example: service Messaging ` rpc
3162
+ # GetMessage(GetMessageRequest) returns (Message) ` option (google.api.http) = `
3163
+ # get:"/v1/messages/`message_id`" `; ` ` message GetMessageRequest ` message
3164
+ # SubMessage ` string subfield = 1; ` string message_id = 1; // Mapped to URL
3165
+ # path. int64 revision = 2; // Mapped to URL query parameter `revision`.
3166
+ # SubMessage sub = 3; // Mapped to URL query parameter `sub.subfield`. ` This
3167
+ # enables a HTTP JSON to RPC mapping as below: - HTTP: `GET /v1/messages/123456?
3168
+ # revision=2&sub.subfield=foo` - gRPC: `GetMessage(message_id: "123456" revision:
3169
+ # 2 sub: SubMessage(subfield: "foo"))` Note that fields which are mapped to URL
3170
+ # query parameters must have a primitive type or a repeated primitive type or a
3171
+ # non-repeated message type. In the case of a repeated type, the parameter can
3172
+ # be repeated in the URL as `...?param=A&param=B`. In the case of a message type,
3173
+ # each field of the message is mapped to a separate parameter, such as `...?foo.
3174
+ # a=A&foo.b=B&foo.c=C`. For HTTP methods that allow a request body, the `body`
3175
+ # field specifies the mapping. Consider a REST update method on the message
3176
+ # resource collection: service Messaging ` rpc UpdateMessage(
3177
+ # UpdateMessageRequest) returns (Message) ` option (google.api.http) = ` patch: "
3178
+ # /v1/messages/`message_id`" body: "message" `; ` ` message UpdateMessageRequest
3179
+ # ` string message_id = 1; // mapped to the URL Message message = 2; // mapped
3180
+ # to the body ` The following HTTP JSON to RPC mapping is enabled, where the
3181
+ # representation of the JSON in the request body is determined by protos JSON
3182
+ # encoding: - HTTP: `PATCH /v1/messages/123456 ` "text": "Hi!" `` - gRPC: `
3183
+ # UpdateMessage(message_id: "123456" message ` text: "Hi!" `)` The special name `
3184
+ # *` can be used in the body mapping to define that every field not bound by the
3185
+ # path template should be mapped to the request body. This enables the following
3186
+ # alternative definition of the update method: service Messaging ` rpc
3187
+ # UpdateMessage(Message) returns (Message) ` option (google.api.http) = ` patch:
3188
+ # "/v1/messages/`message_id`" body: "*" `; ` ` message Message ` string
3189
+ # message_id = 1; string text = 2; ` The following HTTP JSON to RPC mapping is
3190
+ # enabled: - HTTP: `PATCH /v1/messages/123456 ` "text": "Hi!" `` - gRPC: `
3191
+ # UpdateMessage(message_id: "123456" text: "Hi!")` Note that when using `*` in
3192
+ # the body mapping, it is not possible to have HTTP parameters, as all fields
3193
+ # not bound by the path end in the body. This makes this option more rarely used
3194
+ # in practice when defining REST APIs. The common usage of `*` is in custom
3195
+ # methods which don't use the URL at all for transferring data. It is possible
3196
+ # to define multiple HTTP methods for one RPC by using the `additional_bindings`
3197
+ # option. Example: service Messaging ` rpc GetMessage(GetMessageRequest) returns
3198
+ # (Message) ` option (google.api.http) = ` get: "/v1/messages/`message_id`"
3199
+ # additional_bindings ` get: "/v1/users/`user_id`/messages/`message_id`" ` `; ` `
3200
+ # message GetMessageRequest ` string message_id = 1; string user_id = 2; ` This
3201
+ # enables the following two alternative HTTP JSON to RPC mappings: - HTTP: `GET /
3202
+ # v1/messages/123456` - gRPC: `GetMessage(message_id: "123456")` - HTTP: `GET /
3203
+ # v1/users/me/messages/123456` - gRPC: `GetMessage(user_id: "me" message_id: "
3204
+ # 123456")` Rules for HTTP mapping 1. Leaf request fields (recursive expansion
3205
+ # nested messages in the request message) are classified into three categories: -
3206
+ # Fields referred by the path template. They are passed via the URL path. -
3207
+ # Fields referred by the HttpRule.body. They are passed via the HTTP request
3208
+ # body. - All other fields are passed via the URL query parameters, and the
3209
+ # parameter name is the field path in the request message. A repeated field can
3210
+ # be represented as multiple query parameters under the same name. 2. If
3211
+ # HttpRule.body is "*", there is no URL query parameter, all fields are passed
3212
+ # via URL path and HTTP request body. 3. If HttpRule.body is omitted, there is
3213
+ # no HTTP request body, all fields are passed via URL path and URL query
3214
+ # parameters. Path template syntax Template = "/" Segments [ Verb ] ; Segments =
3215
+ # Segment ` "/" Segment ` ; Segment = "*" | "**" | LITERAL | Variable ; Variable
3216
+ # = "`" FieldPath [ "=" Segments ] "`" ; FieldPath = IDENT ` "." IDENT ` ; Verb =
3217
+ # ":" LITERAL ; The syntax `*` matches a single URL path segment. The syntax `**
3218
+ # ` matches zero or more URL path segments, which must be the last part of the
3219
+ # URL path except the `Verb`. The syntax `Variable` matches part of the URL path
3220
+ # as specified by its template. A variable template must not contain other
2241
3221
  # variables. If a variable matches a single path segment, its template may be
2242
3222
  # omitted, e.g. ``var`` is equivalent to ``var=*``. The syntax `LITERAL` matches
2243
3223
  # literal text in the URL path. If the `LITERAL` contains any reserved character,
@@ -2252,7 +3232,7 @@ module Google
2252
3232
  # except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the
2253
3233
  # reverse decoding, except "%2F" and "%2f" are left unchanged. Such variables
2254
3234
  # show up in the [Discovery Document](https://developers.google.com/discovery/v1/
2255
- # reference/apis) as ``+var``. ## Using gRPC API Service Configuration gRPC API
3235
+ # reference/apis) as ``+var``. Using gRPC API Service Configuration gRPC API
2256
3236
  # Service Configuration (service config) is a configuration language for
2257
3237
  # configuring a gRPC service to become a user-facing product. The service config
2258
3238
  # is simply the YAML representation of the `google.api.Service` proto message.
@@ -2262,27 +3242,27 @@ module Google
2262
3242
  # effect as the proto annotation. This can be particularly useful if you have a
2263
3243
  # proto that is reused in multiple services. Note that any transcoding specified
2264
3244
  # in the service config will override any matching transcoding configuration in
2265
- # the proto. Example: http: rules: # Selects a gRPC method and applies HttpRule
2266
- # to it. - selector: example.v1.Messaging.GetMessage get: /v1/messages/`
2267
- # message_id`/`sub.subfield` ## Special notes When gRPC Transcoding is used to
2268
- # map a gRPC to JSON REST endpoints, the proto to JSON conversion must follow
2269
- # the [proto3 specification](https://developers.google.com/protocol-buffers/docs/
2270
- # proto3#json). While the single segment variable follows the semantics of [RFC
2271
- # 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
2272
- # Expansion, the multi segment variable **does not** follow RFC 6570 Section 3.2.
2273
- # 3 Reserved Expansion. The reason is that the Reserved Expansion does not
2274
- # expand special characters like `?` and `#`, which would lead to invalid URLs.
2275
- # As the result, gRPC Transcoding uses a custom encoding for multi segment
2276
- # variables. The path variables **must not** refer to any repeated or mapped
2277
- # field, because client libraries are not capable of handling such variable
2278
- # expansion. The path variables **must not** capture the leading "/" character.
2279
- # The reason is that the most common use case "`var`" does not capture the
2280
- # leading "/" character. For consistency, all path variables must share the same
2281
- # behavior. Repeated message fields must not be mapped to URL query parameters,
2282
- # because no client library can support such complicated mapping. If an API
2283
- # needs to use a JSON array for request or response body, it can map the request
2284
- # or response body to a repeated field. However, some gRPC Transcoding
2285
- # implementations may not support this feature.
3245
+ # the proto. The following example selects a gRPC method and applies an `
3246
+ # HttpRule` to it: http: rules: - selector: example.v1.Messaging.GetMessage get:
3247
+ # /v1/messages/`message_id`/`sub.subfield` Special notes When gRPC Transcoding
3248
+ # is used to map a gRPC to JSON REST endpoints, the proto to JSON conversion
3249
+ # must follow the [proto3 specification](https://developers.google.com/protocol-
3250
+ # buffers/docs/proto3#json). While the single segment variable follows the
3251
+ # semantics of [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2
3252
+ # Simple String Expansion, the multi segment variable **does not** follow RFC
3253
+ # 6570 Section 3.2.3 Reserved Expansion. The reason is that the Reserved
3254
+ # Expansion does not expand special characters like `?` and `#`, which would
3255
+ # lead to invalid URLs. As the result, gRPC Transcoding uses a custom encoding
3256
+ # for multi segment variables. The path variables **must not** refer to any
3257
+ # repeated or mapped field, because client libraries are not capable of handling
3258
+ # such variable expansion. The path variables **must not** capture the leading "/
3259
+ # " character. The reason is that the most common use case "`var`" does not
3260
+ # capture the leading "/" character. For consistency, all path variables must
3261
+ # share the same behavior. Repeated message fields must not be mapped to URL
3262
+ # query parameters, because no client library can support such complicated
3263
+ # mapping. If an API needs to use a JSON array for request or response body, it
3264
+ # can map the request or response body to a repeated field. However, some gRPC
3265
+ # Transcoding implementations may not support this feature.
2286
3266
  class HttpRule
2287
3267
  include Google::Apis::Core::Hashable
2288
3268
 
@@ -2364,6 +3344,44 @@ module Google
2364
3344
  end
2365
3345
  end
2366
3346
 
3347
+ # A message to group impacts of updating a policy.
3348
+ class Impact
3349
+ include Google::Apis::Core::Hashable
3350
+
3351
+ # Output only. User friendly impact detail in a free form message.
3352
+ # Corresponds to the JSON property `detail`
3353
+ # @return [String]
3354
+ attr_accessor :detail
3355
+
3356
+ # Output only. The type of impact.
3357
+ # Corresponds to the JSON property `impactType`
3358
+ # @return [String]
3359
+ attr_accessor :impact_type
3360
+
3361
+ # The parent resource that the analysis is based on and the service name that
3362
+ # the analysis is for. Example: `projects/100/services/compute.googleapis.com`,
3363
+ # folders/101/services/compute.googleapis.com` and `organizations/102/services/
3364
+ # compute.googleapis.com`. Usually, the parent resource here is same as the
3365
+ # parent resource of the analyzed policy. However, for some analysis types, the
3366
+ # parent can be different. For example, for resource existence analysis, if the
3367
+ # parent resource of the analyzed policy is a folder or an organization, the
3368
+ # parent resource here can still be the project that contains the resources.
3369
+ # Corresponds to the JSON property `parent`
3370
+ # @return [String]
3371
+ attr_accessor :parent
3372
+
3373
+ def initialize(**args)
3374
+ update!(**args)
3375
+ end
3376
+
3377
+ # Update properties of this object
3378
+ def update!(**args)
3379
+ @detail = args[:detail] if args.key?(:detail)
3380
+ @impact_type = args[:impact_type] if args.key?(:impact_type)
3381
+ @parent = args[:parent] if args.key?(:parent)
3382
+ end
3383
+ end
3384
+
2367
3385
  # Metadata message that provides information such as progress, partial failures,
2368
3386
  # and similar information on each GetOperation call of LRO returned by
2369
3387
  # ImportAdminOverrides.
@@ -2479,8 +3497,8 @@ module Google
2479
3497
  # protobuf. This should be used **only** by APIs who have already set the
2480
3498
  # language_settings.java.package_name" field in gapic.yaml. API teams should use
2481
3499
  # the protobuf java_package option where possible. Example of a YAML
2482
- # configuration:: publishing: java_settings: library_package: com.google.cloud.
2483
- # pubsub.v1
3500
+ # configuration:: publishing: library_settings: java_settings: library_package:
3501
+ # com.google.cloud.pubsub.v1
2484
3502
  # Corresponds to the JSON property `libraryPackage`
2485
3503
  # @return [String]
2486
3504
  attr_accessor :library_package
@@ -2788,10 +3806,115 @@ module Google
2788
3806
  end
2789
3807
  end
2790
3808
 
2791
- # Method represents a method of an API interface.
3809
+ # McpEnableRule contains MCP enablement related rules.
3810
+ class McpEnableRule
3811
+ include Google::Apis::Core::Hashable
3812
+
3813
+ # List of enabled MCP services.
3814
+ # Corresponds to the JSON property `mcpServices`
3815
+ # @return [Array<Google::Apis::ServiceusageV1::McpService>]
3816
+ attr_accessor :mcp_services
3817
+
3818
+ def initialize(**args)
3819
+ update!(**args)
3820
+ end
3821
+
3822
+ # Update properties of this object
3823
+ def update!(**args)
3824
+ @mcp_services = args[:mcp_services] if args.key?(:mcp_services)
3825
+ end
3826
+ end
3827
+
3828
+ # MCP Consumer Policy is a set of rules that define MCP related policy for a
3829
+ # cloud resource hierarchy.
3830
+ class McpPolicy
3831
+ include Google::Apis::Core::Hashable
3832
+
3833
+ # ContentSecurity defines the content security related fields of a MCP policy.
3834
+ # Corresponds to the JSON property `contentSecurity`
3835
+ # @return [Google::Apis::ServiceusageV1::ContentSecurity]
3836
+ attr_accessor :content_security
3837
+
3838
+ # Output only. The time the policy was created. For singleton policies (such as
3839
+ # the `default` policy), this is the first touch of the policy.
3840
+ # Corresponds to the JSON property `createTime`
3841
+ # @return [String]
3842
+ attr_accessor :create_time
3843
+
3844
+ # An opaque tag indicating the current version of the policy, used for
3845
+ # concurrency control.
3846
+ # Corresponds to the JSON property `etag`
3847
+ # @return [String]
3848
+ attr_accessor :etag
3849
+
3850
+ # McpEnableRules contains MCP enablement related rules.
3851
+ # Corresponds to the JSON property `mcpEnableRules`
3852
+ # @return [Array<Google::Apis::ServiceusageV1::McpEnableRule>]
3853
+ attr_accessor :mcp_enable_rules
3854
+
3855
+ # Output only. The resource name of the policy. Only the `default` policy is
3856
+ # supported. We allow the following formats: `projects/`PROJECT_NUMBER`/
3857
+ # mcpPolicies/default`, `projects/`PROJECT_ID`/mcpPolicies/default`, `folders/`
3858
+ # FOLDER_ID`/mcpPolicies/default`, `organizations/`ORG_ID`/mcpPolicies/default`.
3859
+ # Corresponds to the JSON property `name`
3860
+ # @return [String]
3861
+ attr_accessor :name
3862
+
3863
+ # Output only. The time the policy was last updated.
3864
+ # Corresponds to the JSON property `updateTime`
3865
+ # @return [String]
3866
+ attr_accessor :update_time
3867
+
3868
+ def initialize(**args)
3869
+ update!(**args)
3870
+ end
3871
+
3872
+ # Update properties of this object
3873
+ def update!(**args)
3874
+ @content_security = args[:content_security] if args.key?(:content_security)
3875
+ @create_time = args[:create_time] if args.key?(:create_time)
3876
+ @etag = args[:etag] if args.key?(:etag)
3877
+ @mcp_enable_rules = args[:mcp_enable_rules] if args.key?(:mcp_enable_rules)
3878
+ @name = args[:name] if args.key?(:name)
3879
+ @update_time = args[:update_time] if args.key?(:update_time)
3880
+ end
3881
+ end
3882
+
3883
+ # McpService contains the service names that are enabled for MCP.
3884
+ class McpService
3885
+ include Google::Apis::Core::Hashable
3886
+
3887
+ # The names of the services that are enabled for MCP. Example: `services/library-
3888
+ # example.googleapis.com`
3889
+ # Corresponds to the JSON property `service`
3890
+ # @return [String]
3891
+ attr_accessor :service
3892
+
3893
+ def initialize(**args)
3894
+ update!(**args)
3895
+ end
3896
+
3897
+ # Update properties of this object
3898
+ def update!(**args)
3899
+ @service = args[:service] if args.key?(:service)
3900
+ end
3901
+ end
3902
+
3903
+ # Method represents a method of an API interface. New usages of this message as
3904
+ # an alternative to MethodDescriptorProto are strongly discouraged. This message
3905
+ # does not reliability preserve all information necessary to model the schema
3906
+ # and preserve semantics. Instead make use of FileDescriptorSet which preserves
3907
+ # the necessary information.
2792
3908
  class MethodProp
2793
3909
  include Google::Apis::Core::Hashable
2794
3910
 
3911
+ # The source edition string, only valid when syntax is SYNTAX_EDITIONS. This
3912
+ # field should be ignored, instead the edition should be inherited from Api.
3913
+ # This is similar to Field and EnumValue.
3914
+ # Corresponds to the JSON property `edition`
3915
+ # @return [String]
3916
+ attr_accessor :edition
3917
+
2795
3918
  # The simple name of this method.
2796
3919
  # Corresponds to the JSON property `name`
2797
3920
  # @return [String]
@@ -2824,7 +3947,8 @@ module Google
2824
3947
  # @return [String]
2825
3948
  attr_accessor :response_type_url
2826
3949
 
2827
- # The source syntax of this method.
3950
+ # The source syntax of this method. This field should be ignored, instead the
3951
+ # syntax should be inherited from Api. This is similar to Field and EnumValue.
2828
3952
  # Corresponds to the JSON property `syntax`
2829
3953
  # @return [String]
2830
3954
  attr_accessor :syntax
@@ -2835,6 +3959,7 @@ module Google
2835
3959
 
2836
3960
  # Update properties of this object
2837
3961
  def update!(**args)
3962
+ @edition = args[:edition] if args.key?(:edition)
2838
3963
  @name = args[:name] if args.key?(:name)
2839
3964
  @options = args[:options] if args.key?(:options)
2840
3965
  @request_streaming = args[:request_streaming] if args.key?(:request_streaming)
@@ -2845,10 +3970,52 @@ module Google
2845
3970
  end
2846
3971
  end
2847
3972
 
3973
+ # Defines policies applying to an RPC method.
3974
+ class MethodPolicy
3975
+ include Google::Apis::Core::Hashable
3976
+
3977
+ # Policies that are applicable to the request message.
3978
+ # Corresponds to the JSON property `requestPolicies`
3979
+ # @return [Array<Google::Apis::ServiceusageV1::FieldPolicy>]
3980
+ attr_accessor :request_policies
3981
+
3982
+ # Selects a method to which these policies should be enforced, for example, "
3983
+ # google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector for syntax
3984
+ # details. NOTE: This field must not be set in the proto annotation. It will be
3985
+ # automatically filled by the service config compiler .
3986
+ # Corresponds to the JSON property `selector`
3987
+ # @return [String]
3988
+ attr_accessor :selector
3989
+
3990
+ def initialize(**args)
3991
+ update!(**args)
3992
+ end
3993
+
3994
+ # Update properties of this object
3995
+ def update!(**args)
3996
+ @request_policies = args[:request_policies] if args.key?(:request_policies)
3997
+ @selector = args[:selector] if args.key?(:selector)
3998
+ end
3999
+ end
4000
+
2848
4001
  # Describes the generator configuration for a method.
2849
4002
  class MethodSettings
2850
4003
  include Google::Apis::Core::Hashable
2851
4004
 
4005
+ # List of top-level fields of the request message, that should be automatically
4006
+ # populated by the client libraries based on their (google.api.field_info).
4007
+ # format. Currently supported format: UUID4. Example of a YAML configuration:
4008
+ # publishing: method_settings: - selector: google.example.v1.ExampleService.
4009
+ # CreateExample auto_populated_fields: - request_id
4010
+ # Corresponds to the JSON property `autoPopulatedFields`
4011
+ # @return [Array<String>]
4012
+ attr_accessor :auto_populated_fields
4013
+
4014
+ # `BatchingConfigProto` defines the batching configuration for an API method.
4015
+ # Corresponds to the JSON property `batching`
4016
+ # @return [Google::Apis::ServiceusageV1::BatchingConfigProto]
4017
+ attr_accessor :batching
4018
+
2852
4019
  # Describes settings to use when generating API methods that use the long-
2853
4020
  # running operation pattern. All default values below are from those used in the
2854
4021
  # client library generators (e.g. [Java](https://github.com/googleapis/gapic-
@@ -2859,7 +4026,9 @@ module Google
2859
4026
  attr_accessor :long_running
2860
4027
 
2861
4028
  # The fully qualified name of the method, for which the options below apply.
2862
- # This is used to find the method to apply the options.
4029
+ # This is used to find the method to apply the options. Example: publishing:
4030
+ # method_settings: - selector: google.storage.control.v2.StorageControl.
4031
+ # CreateFolder # method settings for CreateFolder...
2863
4032
  # Corresponds to the JSON property `selector`
2864
4033
  # @return [String]
2865
4034
  attr_accessor :selector
@@ -2870,6 +4039,8 @@ module Google
2870
4039
 
2871
4040
  # Update properties of this object
2872
4041
  def update!(**args)
4042
+ @auto_populated_fields = args[:auto_populated_fields] if args.key?(:auto_populated_fields)
4043
+ @batching = args[:batching] if args.key?(:batching)
2873
4044
  @long_running = args[:long_running] if args.key?(:long_running)
2874
4045
  @selector = args[:selector] if args.key?(:selector)
2875
4046
  end
@@ -3042,6 +4213,11 @@ module Google
3042
4213
  # @return [String]
3043
4214
  attr_accessor :sample_period
3044
4215
 
4216
+ # The scope of the timeseries data of the metric.
4217
+ # Corresponds to the JSON property `timeSeriesResourceHierarchyLevel`
4218
+ # @return [Array<String>]
4219
+ attr_accessor :time_series_resource_hierarchy_level
4220
+
3045
4221
  def initialize(**args)
3046
4222
  update!(**args)
3047
4223
  end
@@ -3051,6 +4227,7 @@ module Google
3051
4227
  @ingest_delay = args[:ingest_delay] if args.key?(:ingest_delay)
3052
4228
  @launch_stage = args[:launch_stage] if args.key?(:launch_stage)
3053
4229
  @sample_period = args[:sample_period] if args.key?(:sample_period)
4230
+ @time_series_resource_hierarchy_level = args[:time_series_resource_hierarchy_level] if args.key?(:time_series_resource_hierarchy_level)
3054
4231
  end
3055
4232
  end
3056
4233
 
@@ -3184,7 +4361,7 @@ module Google
3184
4361
 
3185
4362
  # Required. The monitored resource type. For example, the type `"
3186
4363
  # cloudsql_database"` represents databases in Google Cloud SQL. For a list of
3187
- # types, see [Monitoring resource types](https://cloud.google.com/monitoring/api/
4364
+ # types, see [Monitored resource types](https://cloud.google.com/monitoring/api/
3188
4365
  # resources) and [Logging resource types](https://cloud.google.com/logging/docs/
3189
4366
  # api/v2/resource-list).
3190
4367
  # Corresponds to the JSON property `type`
@@ -3380,13 +4557,13 @@ module Google
3380
4557
  # @return [String]
3381
4558
  attr_accessor :name
3382
4559
 
3383
- # The normal response of the operation in case of success. If the original
3384
- # method returns no data on success, such as `Delete`, the response is `google.
3385
- # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
3386
- # the response should be the resource. For other methods, the response should
3387
- # have the type `XxxResponse`, where `Xxx` is the original method name. For
3388
- # example, if the original method name is `TakeSnapshot()`, the inferred
3389
- # response type is `TakeSnapshotResponse`.
4560
+ # The normal, successful response of the operation. If the original method
4561
+ # returns no data on success, such as `Delete`, the response is `google.protobuf.
4562
+ # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
4563
+ # response should be the resource. For other methods, the response should have
4564
+ # the type `XxxResponse`, where `Xxx` is the original method name. For example,
4565
+ # if the original method name is `TakeSnapshot()`, the inferred response type is
4566
+ # `TakeSnapshotResponse`.
3390
4567
  # Corresponds to the JSON property `response`
3391
4568
  # @return [Hash<String,Object>]
3392
4569
  attr_accessor :response
@@ -3425,7 +4602,9 @@ module Google
3425
4602
  end
3426
4603
 
3427
4604
  # A protocol buffer option, which can be attached to a message, field,
3428
- # enumeration, etc.
4605
+ # enumeration, etc. New usages of this message as an alternative to FileOptions,
4606
+ # MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions,
4607
+ # or MethodOptions are strongly discouraged.
3429
4608
  class Option
3430
4609
  include Google::Apis::Core::Hashable
3431
4610
 
@@ -3461,7 +4640,7 @@ module Google
3461
4640
  class Page
3462
4641
  include Google::Apis::Core::Hashable
3463
4642
 
3464
- # The Markdown content of the page. You can use (== include `path` ==) to
4643
+ # The Markdown content of the page. You can use ```(== include `path` ==)``` to
3465
4644
  # include content from a Markdown file. The content can be used to produce the
3466
4645
  # documentation page such as HTML format page.
3467
4646
  # Corresponds to the JSON property `content`
@@ -3506,6 +4685,16 @@ module Google
3506
4685
  # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
3507
4686
  attr_accessor :common
3508
4687
 
4688
+ # The package name to use in Php. Clobbers the php_namespace option set in the
4689
+ # protobuf. This should be used **only** by APIs who have already set the
4690
+ # language_settings.php.package_name" field in gapic.yaml. API teams should use
4691
+ # the protobuf php_namespace option where possible. Example of a YAML
4692
+ # configuration:: publishing: library_settings: php_settings: library_package:
4693
+ # Google\Cloud\PubSub\V1
4694
+ # Corresponds to the JSON property `libraryPackage`
4695
+ # @return [String]
4696
+ attr_accessor :library_package
4697
+
3509
4698
  def initialize(**args)
3510
4699
  update!(**args)
3511
4700
  end
@@ -3513,6 +4702,7 @@ module Google
3513
4702
  # Update properties of this object
3514
4703
  def update!(**args)
3515
4704
  @common = args[:common] if args.key?(:common)
4705
+ @library_package = args[:library_package] if args.key?(:library_package)
3516
4706
  end
3517
4707
  end
3518
4708
 
@@ -3565,7 +4755,7 @@ module Google
3565
4755
  # @return [Array<Google::Apis::ServiceusageV1::MethodSettings>]
3566
4756
  attr_accessor :method_settings
3567
4757
 
3568
- # Link to a place that API users can report issues. Example: https://
4758
+ # Link to a *public* URI where users can report issues. Example: https://
3569
4759
  # issuetracker.google.com/issues/new?component=190865&template=1161103
3570
4760
  # Corresponds to the JSON property `newIssueUri`
3571
4761
  # @return [String]
@@ -3576,6 +4766,18 @@ module Google
3576
4766
  # @return [String]
3577
4767
  attr_accessor :organization
3578
4768
 
4769
+ # Optional link to proto reference documentation. Example: https://cloud.google.
4770
+ # com/pubsub/lite/docs/reference/rpc
4771
+ # Corresponds to the JSON property `protoReferenceDocumentationUri`
4772
+ # @return [String]
4773
+ attr_accessor :proto_reference_documentation_uri
4774
+
4775
+ # Optional link to REST reference documentation. Example: https://cloud.google.
4776
+ # com/pubsub/lite/docs/reference/rest
4777
+ # Corresponds to the JSON property `restReferenceDocumentationUri`
4778
+ # @return [String]
4779
+ attr_accessor :rest_reference_documentation_uri
4780
+
3579
4781
  def initialize(**args)
3580
4782
  update!(**args)
3581
4783
  end
@@ -3591,6 +4793,8 @@ module Google
3591
4793
  @method_settings = args[:method_settings] if args.key?(:method_settings)
3592
4794
  @new_issue_uri = args[:new_issue_uri] if args.key?(:new_issue_uri)
3593
4795
  @organization = args[:organization] if args.key?(:organization)
4796
+ @proto_reference_documentation_uri = args[:proto_reference_documentation_uri] if args.key?(:proto_reference_documentation_uri)
4797
+ @rest_reference_documentation_uri = args[:rest_reference_documentation_uri] if args.key?(:rest_reference_documentation_uri)
3594
4798
  end
3595
4799
  end
3596
4800
 
@@ -3603,6 +4807,12 @@ module Google
3603
4807
  # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
3604
4808
  attr_accessor :common
3605
4809
 
4810
+ # Experimental features to be included during client library generation. These
4811
+ # fields will be deprecated once the feature graduates and is enabled by default.
4812
+ # Corresponds to the JSON property `experimentalFeatures`
4813
+ # @return [Google::Apis::ServiceusageV1::ExperimentalFeatures]
4814
+ attr_accessor :experimental_features
4815
+
3606
4816
  def initialize(**args)
3607
4817
  update!(**args)
3608
4818
  end
@@ -3610,6 +4820,7 @@ module Google
3610
4820
  # Update properties of this object
3611
4821
  def update!(**args)
3612
4822
  @common = args[:common] if args.key?(:common)
4823
+ @experimental_features = args[:experimental_features] if args.key?(:experimental_features)
3613
4824
  end
3614
4825
  end
3615
4826
 
@@ -3729,11 +4940,11 @@ module Google
3729
4940
  # @return [String]
3730
4941
  attr_accessor :name
3731
4942
 
3732
- # Specify the unit of the quota limit. It uses the same syntax as Metric.unit.
3733
- # The supported unit kinds are determined by the quota backend system. Here are
3734
- # some examples: * "1/min/`project`" for quota per minute per project. Note: the
3735
- # order of unit components is insignificant. The "1" at the beginning is
3736
- # required to follow the metric unit syntax.
4943
+ # Specify the unit of the quota limit. It uses the same syntax as
4944
+ # MetricDescriptor.unit. The supported unit kinds are determined by the quota
4945
+ # backend system. Here are some examples: * "1/min/`project`" for quota per
4946
+ # minute per project. Note: the order of unit components is insignificant. The "
4947
+ # 1" at the beginning is required to follow the metric unit syntax.
3737
4948
  # Corresponds to the JSON property `unit`
3738
4949
  # @return [String]
3739
4950
  attr_accessor :unit
@@ -3839,6 +5050,46 @@ module Google
3839
5050
  end
3840
5051
  end
3841
5052
 
5053
+ # Metadata for the `RemoveEnableRules` method.
5054
+ class RemoveEnableRulesMetadata
5055
+ include Google::Apis::Core::Hashable
5056
+
5057
+ def initialize(**args)
5058
+ update!(**args)
5059
+ end
5060
+
5061
+ # Update properties of this object
5062
+ def update!(**args)
5063
+ end
5064
+ end
5065
+
5066
+ # The response message of `RemoveEnableRules` method.
5067
+ class RemoveEnableRulesResponse
5068
+ include Google::Apis::Core::Hashable
5069
+
5070
+ # The parent consumer policy. It can be `projects/12345/consumerPolicies/default`
5071
+ # , or `folders/12345/consumerPolicies/default`, or `organizations/12345/
5072
+ # consumerPolicies/default`.
5073
+ # Corresponds to the JSON property `parent`
5074
+ # @return [String]
5075
+ attr_accessor :parent
5076
+
5077
+ # The values removed from the parent consumer policy.
5078
+ # Corresponds to the JSON property `removedValues`
5079
+ # @return [Array<String>]
5080
+ attr_accessor :removed_values
5081
+
5082
+ def initialize(**args)
5083
+ update!(**args)
5084
+ end
5085
+
5086
+ # Update properties of this object
5087
+ def update!(**args)
5088
+ @parent = args[:parent] if args.key?(:parent)
5089
+ @removed_values = args[:removed_values] if args.key?(:removed_values)
5090
+ end
5091
+ end
5092
+
3842
5093
  # Settings for Ruby client libraries.
3843
5094
  class RubySettings
3844
5095
  include Google::Apis::Core::Hashable
@@ -3858,6 +5109,39 @@ module Google
3858
5109
  end
3859
5110
  end
3860
5111
 
5112
+ # This message is used to configure the generation of a subset of the RPCs in a
5113
+ # service for client libraries.
5114
+ class SelectiveGapicGeneration
5115
+ include Google::Apis::Core::Hashable
5116
+
5117
+ # Setting this to true indicates to the client generators that methods that
5118
+ # would be excluded from the generation should instead be generated in a way
5119
+ # that indicates these methods should not be consumed by end users. How this is
5120
+ # expressed is up to individual language implementations to decide. Some
5121
+ # examples may be: added annotations, obfuscated identifiers, or other language
5122
+ # idiomatic patterns.
5123
+ # Corresponds to the JSON property `generateOmittedAsInternal`
5124
+ # @return [Boolean]
5125
+ attr_accessor :generate_omitted_as_internal
5126
+ alias_method :generate_omitted_as_internal?, :generate_omitted_as_internal
5127
+
5128
+ # An allowlist of the fully qualified names of RPCs that should be included on
5129
+ # public client surfaces.
5130
+ # Corresponds to the JSON property `methods`
5131
+ # @return [Array<String>]
5132
+ attr_accessor :methods_prop
5133
+
5134
+ def initialize(**args)
5135
+ update!(**args)
5136
+ end
5137
+
5138
+ # Update properties of this object
5139
+ def update!(**args)
5140
+ @generate_omitted_as_internal = args[:generate_omitted_as_internal] if args.key?(:generate_omitted_as_internal)
5141
+ @methods_prop = args[:methods_prop] if args.key?(:methods_prop)
5142
+ end
5143
+ end
5144
+
3861
5145
  # Service identity for a service. This is the identity that service producer
3862
5146
  # should use to access consumer resources.
3863
5147
  class ServiceIdentity
@@ -4059,10 +5343,19 @@ module Google
4059
5343
  end
4060
5344
  end
4061
5345
 
4062
- # A protocol buffer message type.
5346
+ # A protocol buffer message type. New usages of this message as an alternative
5347
+ # to DescriptorProto are strongly discouraged. This message does not reliability
5348
+ # preserve all information necessary to model the schema and preserve semantics.
5349
+ # Instead make use of FileDescriptorSet which preserves the necessary
5350
+ # information.
4063
5351
  class Type
4064
5352
  include Google::Apis::Core::Hashable
4065
5353
 
5354
+ # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
5355
+ # Corresponds to the JSON property `edition`
5356
+ # @return [String]
5357
+ attr_accessor :edition
5358
+
4066
5359
  # The list of fields.
4067
5360
  # Corresponds to the JSON property `fields`
4068
5361
  # @return [Array<Google::Apis::ServiceusageV1::Field>]
@@ -4100,6 +5393,7 @@ module Google
4100
5393
 
4101
5394
  # Update properties of this object
4102
5395
  def update!(**args)
5396
+ @edition = args[:edition] if args.key?(:edition)
4103
5397
  @fields = args[:fields] if args.key?(:fields)
4104
5398
  @name = args[:name] if args.key?(:name)
4105
5399
  @oneofs = args[:oneofs] if args.key?(:oneofs)
@@ -4124,6 +5418,32 @@ module Google
4124
5418
  end
4125
5419
  end
4126
5420
 
5421
+ # Metadata for the `UpdateConsumerPolicy` method.
5422
+ class UpdateConsumerPolicyMetadata
5423
+ include Google::Apis::Core::Hashable
5424
+
5425
+ def initialize(**args)
5426
+ update!(**args)
5427
+ end
5428
+
5429
+ # Update properties of this object
5430
+ def update!(**args)
5431
+ end
5432
+ end
5433
+
5434
+ # Metadata for the `UpdateMcpPolicy` method.
5435
+ class UpdateMcpPolicyMetadata
5436
+ include Google::Apis::Core::Hashable
5437
+
5438
+ def initialize(**args)
5439
+ update!(**args)
5440
+ end
5441
+
5442
+ # Update properties of this object
5443
+ def update!(**args)
5444
+ end
5445
+ end
5446
+
4127
5447
  # Configuration controlling usage of a service.
4128
5448
  class Usage
4129
5449
  include Google::Apis::Core::Hashable
@@ -4167,21 +5487,15 @@ module Google
4167
5487
  end
4168
5488
  end
4169
5489
 
4170
- # Usage configuration rules for the service. NOTE: Under development. Use this
4171
- # rule to configure unregistered calls for the service. Unregistered calls are
4172
- # calls that do not contain consumer project identity. (Example: calls that do
4173
- # not contain an API key). By default, API methods do not allow unregistered
4174
- # calls, and each method call must be identified by a consumer project identity.
4175
- # Use this rule to allow/disallow unregistered calls. Example of an API that
4176
- # wants to allow unregistered calls for entire service. usage: rules: - selector:
4177
- # "*" allow_unregistered_calls: true Example of a method that wants to allow
4178
- # unregistered calls. usage: rules: - selector: "google.example.library.v1.
4179
- # LibraryService.CreateBook" allow_unregistered_calls: true
5490
+ # Usage configuration rules for the service.
4180
5491
  class UsageRule
4181
5492
  include Google::Apis::Core::Hashable
4182
5493
 
4183
- # If true, the selected method allows unregistered calls, e.g. calls that don't
4184
- # identify any user or application.
5494
+ # Use this rule to configure unregistered calls for the service. Unregistered
5495
+ # calls are calls that do not contain consumer project identity. (Example: calls
5496
+ # that do not contain an API key). WARNING: By default, API methods do not allow
5497
+ # unregistered calls, and each method call must be identified by a consumer
5498
+ # project identity.
4185
5499
  # Corresponds to the JSON property `allowUnregisteredCalls`
4186
5500
  # @return [Boolean]
4187
5501
  attr_accessor :allow_unregistered_calls